3156B User Manual
Racal Instrument © 2005
Programming Reference 5-169
waveCADdigitalPatternDataFileName
ViString
Points to a file name already stored in your computer’s
memory. Full path is required. File extension is *.pat for
freerun mode and *.sti for stimulus mode
digPatternStimListSize
ViInt32
Defines the number of digital pattern steps are included
in the table. This number must match the number of
patterns in the data and in the hold count arrays.
Valid Range: 1 to 523264
Return Values
Displays the return status of the function call. If the function was successful, it will return a status of
VI_SUCCESS, otherwise it will return an error code. Passing the error code into the function
"ri3156B_error_message()" will return a string describing the error.
Ri3156b_load_wavecad_video_data_file
Description
This function is similar to the ri3156b_load_video_str_pattern_data function except it points to a file name that
was already prepared and stored on your computer. The complete path to the file location is required. This
function will download the data arrays to generate video character. Data is loaded to both channels
simultaneously. Note that the pattern number is equivalent to the segment number that you download for
arbitrary waveform segment and therefore, be careful, if you use the same numbers, video patterns may not
share the same numbers as you use for arbitrary waveforms. The pattern number is selected using the
videoStrokePatterNumber variable. The character will be generated only if the 3156B was programmed to
output video stroke patterns.
Channel Dependency: Common
C Syntax
ViStatus ri3156b_load_wavecad_video_data_file (ViSession instrHandle, ViInt16 videoStrokePatternNumber,
ViString waveCADPatternDataCh1File, ViString waveCADPatternDataCh2File, ViInt32 videoStrokePatternSize)
Parameters
Name
Variable
Type
Description
instrHandle
ViSession
The Instrument Handle is used to identify the unique
session or communication channel between the driver
and the instrument. If more than one instrument of the
model type is used, this will be used to differentiate
between them. Note that the initialize function may be
used to associate multiple instrument handles with a
single instrument.
