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_script), 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.

Chapter 2. ICL 27

Page 33
Image 33
Roper Photometric manual Icl