Roper Photometric - Manual (Page 33)

Chapter 2. ICL 27
Decoding Decoding (defined as decoding the pixel stream to display one or more images)
must be simple enough to easily use, yet, powerful enough to display most
experiments. To satisfy both needs, the scripts can contain any number of pixel
display statements. Each of these statements must specify a rectangular array of
pixels to be decoded and displayed. In addition, these instructions can be
contained inside of loops, making them much more powerful and flexible.
Decoding the ICL To decode the ICL, the scripting functions process, whitespace and the following
commands:
script_begin();
loop_begin(
loop_count);
pixel_display( x,y);
loop_end() ;
script_end(
contin_clear);
Particular attention is paid to processing display commands inside of loops and
loops inside of loops (loop nesting).
Once the script has been processed (through the call to
pl_exp_setup_scrip t), all display instructions have been examined and
recorded. Application programmers can obtain the total number to display from
the
pl_exp_setup_script command. More detailed information is available
from the pl_exp_display_script command.
Image Display The image display method depends on the application. You should perform the
extraction and display tasks using the same method you are currently using to
process the pixel stream and display images with conventional PVCAM. In
other words, if you already have a working application, you need to apply the
same techniques used in that application to the image display. (See
pl_exp_display_script for more information.)
Although the decoding and display must logically match the experimental
setup, the
pixel_display calls do not have to be in a one-to-one
correspondence to the pixel_readout calls. The example scripts (see the
Example Scripts section) illustrate situations where the readout and display are
handled in very different ways inside the same script.
While the individual calls don’t need to match, the total number of pixels
collected must match the total number of pixels being displayed. The script
processor (
pl_exp_setup_script ) checks for this matching and generates an
error if there is any disagreement.
For more information concerning image display, please consult the
pl_exp_setup_script and pl_exp_display_script functions.