RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
467
innovators for industry
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
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
commands, which transmit the
PulseLength
and
AnalogOut
parameters.
• The first list command after
set_pixel_line
that is
not
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
(
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
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
• The pixel output mode should
not
be used in conjunction with automatic laser control
(see
) 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.
chapter 8.8 "Scanning Raster Images (Bitmaps)", page 192
.
• You can combine pixel output mode with Processing-on-the-fly (see
), but not
with Wobbel (see
).
