VDG_SetLineData

NI 5431 Composite Video Generator

NI 5431 Composite Video Generator
VDG_SetLineData

This advanced VI inserts an input array with luma data into the active part of a specific video line. The input data can be either 8-bit unsigned (U8), 16-bit unsigned (U16) or single-precision (SGL) values. The scaling of the input data depends on the data type.

  • For U8 input format, 0 corresponds to the setup level (black), while 255 corresponds to 100 IRE (white).
  • The scaling for 16-bit input data is controlled by the 2 attributes Input gain (Default = 100 IRE/65536) and Input offset (Default = 0). By default, input value 0 corresponds to the setup level (black level), while 65535 corresponds to 100 IRE (white level).
  • For SGL input format, the data will be represented directly in IRE.

The data correspond to the test signal sampled at the rate returned by the attribute Sampling frequency (MHz). The length of each array should correspond to the active part of the video line (value returned by the attribute Image duration (us)), so the number of elements in each array should be:

Size = Round [Sampling frequency (MHz) × Image duration (us)]

Default sizes: M-NTSC = 1044
B-PAL = 1040
M-PAL = 1042

Line number specifies the video line where the insertion test signal data is to be inserted.
U8 Data inputs the insertion test signal data to the video line defined by the Line number control.
U16 Data inputs the insertion test signal data to the video line defined by the Line number control.
SGL Data inputs the insertion test signal data to the video line defined by the Line number control.
error in is a cluster that describes the error status before this VI executes. If error in indicates that an error occurred before this VI was called, this VI may choose not to execute its function, but just pass the error through to its error out cluster. If no error has occurred, then this VI executes normally and sets its own corresponding error message. Using error in and error out clusters is a convenient way to check errors and to specify execution order by wiring the error output from one subVI to the error input of the next.
error out is a cluster that describes the error status after this VI executes. If an error occurred before this VI was called, error out is the same as error in. Otherwise, error out shows the error, if any, that occurred in this VI. Use the error handler VIs to look up the error code and to display the corresponding error message. Using error in and error out clusters is a convenient way to check errors and to specify execution order by wiring the error output from one subVI to the error input of the next.