SU320CSX
4110-0446, Rev. C
Page 82 of 96
© 2017 UTC
Aerospace Systems
Date Printed: 3-Jan-2017
This document does not contain any export controlled technical data.
Example
MACRO:PLAY OFF 0
5.21.
Windowing Commands
The CSX camera allows for windowing of an image to a user's region of interest (ROI). Windowing is
typically used to trade image resolution for frame rate. The smaller the window chosen, the shorter the
readout time for the frame and, hence, the higher the frame rate that can be achieved. The display
enhancements should be turned off (ENH:ENABLE OFF, see Section 5.10.1) and the AGC should be
turned off (AGC:ENABLE OFF, see Section 5.9.1) when windowing. This is recommended because
enhancements and AGC use the full frame statistics, not the window statistics.
Note that a 320x256 array includes commands to point 0,0 and thus the maximum ‘logical’ extent is 319,
255. When inputting specific pixel locations to the camera firmware, the logic notation applies and the
array maximum is 319x255. The concept of ‘odd’ and ‘even’ is defined on the logic value of the pixel
notation, so the origin 0 of (0,0) is an even number, and 319 of (319,255) is an odd number, regardless
that these refer to the 1
st
pixel and 320
th
pixel.
The WIN:ROW and WIN:COL commands can be used to define each corner of the window individually.
Alternatively, the WIN:RECT command can be used to define the window with a single command.
Windowing speed advantage applies to rows only (i.e. the number of columns is fixed at 320 [319]).
Selecting the start and stop row addresses sets the size and location for the ROI window. There are two
individual commands that set start and stop addresses for rows. The start row address must be an EVEN
number while the stop row address must be an ODD number. Additionally, the resulting height of the
window must be greater than 2; because of the start or stop needing to be an EVEN or ODD number, a
minimum size is thus 4. The WIN commands must specify start addresses lower or equal to
corresponding stop addresses and must be within the allowed range for the supported FPA for these
commands to complete without error.
A smaller column number may be set, even as there is no speed improvement. This will allow the user to
save smaller images and video sets.
5.21.1.
Set Window Column Start Number
Description
Sets the start column number for the ROI. The value must be an
EVEN number and compatible with the current column stop
number for the command to complete without error.
Setting Type
Operational
Command
WIN:COL:START
value
Parameters
value
Return Values
none
Range
0 to 316
Type
unsigned integer
Example
WIN:COL:START 10 -- start read at col 10