Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 462 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
462
innovators for industry
Variable
List Command set_n_pixel
Function in pixel output mode, this command defines the laser control parameters (pulse length
and analog voltage level) for multiple directly successive identical pixels in an image line.
Call
set_n_pixel( PulseLength, AnalogOut, Number )
Parameters
PulseLength
pixel pulse length (as an unsigned 32-bit value). 1 bit equals 1/64 µ s.
Allowed range: [0 … (2
32
–
1)]
AnalogOut
12-bit output value (analog voltage level at the analog output port
selected with
set_pixel_line ) for the pixel as an unsigned 32-bit value.
Higher bits are ignored (also see write_da_x ).
Number
number of pixels (as an unsigned 32-bit value)
Allowed range: [1 … (2
32
–
1)], 0 will be automatically clipped to 1.
Comments • For usage of this command, see chapter 8.8 "Scanning Raster Images (Bitmaps)",
page 192 .
• Before the first set_n_pixel command of a line, a set_pixel_line command must be
issued.
• The set_n_pixel command defines parameters for the subsequent
Number
of (identical)
pixels in an image line. Each set_n_pixel command must follow immediately after the
command set_pixel_line or after another set_n_pixel command. No other commands
must be written into the list until the image line is completed. The first command in the
list following a
set_pixel_line command which is not a set_n_pixel command turns off
the pixel output mode.
• If only an individual pixel needs to be defined, then set_pixel can be used as an alter-
native to set_n_pixel . This command is synonymous with set_n_pixel with parameter
Number
= 1.
• If not in pixel output mode (if the command is not directly preceded by set_pixel_line
or set_n_pixel ), set_n_pixel will be a short list command and otherwise ignored. Under
some circumstances, a list_nop might be inserted (see page 217 ).
• At the end of the image line (at the beginning of the default pixel), the pixel pulse
length
PulseLength
and the analog output value
AnalogOut
will be set to a default
value, each. The default pixel pulse length value is 0 unless another value was defined
via
set_default_pixel or set_default_pixel_list . The default analog output value is
0xFFF (=4095) unless another value was defined via set_port_default or
set_laser_off_default .
RTC
®
4

RTC
®
5 new command
for RTC
®
4 compatibility mode: see set_pixel
References set_pixel , set_pixel_line , set_pixel_line_3d