3156B User Manual
Programming Reference 5-142
Racal Instrument © 2005
ri3156b_set(query)_video_character
Description
This selects a video character from a built-in library of 10 standard characters. The characters are moved about
the video screen in increments set by the ri3156B_set_video_offset_step () function through the range set by
the ri3156B_set_video_offset_range () function. Both channels drive the XY coordinate simultaneously.
Channel Dependency: Common
C Syntax
ViStatus ri3156b_set_video_character (ViSession instrHandle, ViInt16 videoStrokeCharacter)
ViStatus ri3156b_query_video_character (ViSession instrHandle, ViInt16 * videoStrokeCharacter)
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.
videoStrokeCharacter
ViInt16
Selects a video character to be output.
Valid Range: 0 to 9
0 – selects cross locator character
1 – selects cross hair character
2 – selects positioned square character
3 – selects vertical marker line character
4 – selects horizontal marker line character
5 – selects right-hand arrow character
6 – selects left-hand arrow character
7 – selects diamond overlay character
8 – selects inverted triangle character
9 – selects upright triangle character
Default Value: 0
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.