RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
467
Normal
List Command
set_pixel_line
Function activates the pixel output mode and defines various pixel output parameters
.
Call
set_pixel_line( Channel, HalfPeriod, dX, dY )
Parameters
Channel
Number of the analog output port (as an unsigned 32-bit value) that
should output the analog voltage levels defined by subsequent
set_pixel/set_n_pixel commands;
allowed range: [1, 2] (1: ANALOG OUT1, 2: ANALOG OUT2)
HalfPeriod
half pixel output period in bits as an unsigned 32-bit value.
1 bit equals 1/64 µs. Allowed range: [104 … (2
32
–1)]
dX, dY
distance in the X and Y directions between adjacent pixels in bits
(64-bit IEEE floating point values)
Comments • Each image line must start with the command set_pixel_line. This command should be
preceded by a jump or mark command to the start point of the image line.
•The set_pixel_line command is directly followed by the desired number of
set_pixel/set_n_pixel commands, which transmit the
PulseLength
and
AnalogOut
parameters.
• The first list command after set_pixel_line that is not a set_pixel/set_n_pixel
command will turn off the pixel output mode (the set_pixel_line command, too, ends
the pixel output mode before starting it again). In the process, a default pixel will be
inserted.
•If
Channel
< 1 or
Channel
> 2, then set_pixel_line will be replaced by a list_nop
(get_last_error return code
RTC5_PARAM_ERROR
) and the pixel output mode will not be
activated.
•Note that half the period length must be specified for
HalfPeriod
.
2 ·
HalfPeriod
is thus the chronological distance between individual pixels (see
page 192).
HalfPeriod
must not be smaller than 104 (otherwise it will be clipped). This
value corresponds to a pixel frequency of approx. 308 kHz.
• For pixel frequencies above around 100 kHz (i.e. for a
HalfPeriod
< approx. 320)
digital-to-analog conversion can’t always be fully completed. For such pixel frequencies,
the user must carefully verify that sufficient capability is available.
• The pixel output mode is incompatible with the softstart mode (see page 135).
• The pixel output mode should not be used in conjunction with automatic laser control
(see page 140) if automatic laser control readjusts the 12-bit output values at the
ANALOG OUT1 or ANALOG OUT2 output ports or pulse lengths (
PulseLength
) or
output periods (
HalfPeriod
) of the laser signals LASER1 and LASER2.
•
Also see
chapter 8.8 "Scanning Raster Images (Bitmaps)", page 192.
• You can combine pixel output mode with Processing-on-the-fly (see page 177), but not
with Wobbel (see page 167).