© 2016 Thorlabs Scientific Imaging412
DCx Camera Functional Description and SDK Manual
4.4.19 isavi_SetImageSize
Syntax
INT isavi_SetImageSize (INT nAviID, INT cMode, INT Width, INT Height,
INT PosX, INT PosY, INT LineOffset)
Description
isavi_SetImageSize() sets the size and position of the area of interest which will be saved to the
AVI file. Only the defined area of interest of each frame will be saved. In addition, this function
specifies the input color format of the frames. You define these settings only once for the entire
video.
Note
The supported input color formats are RGB32, RGB24, Y8 and raw Bayer. The output file will
always be in RGB24 format, regardless of the input data format. For further information on the
structure of the different color formats, see the Appendix: Color and memory formats section.
Attention
When an area of interest is used, the width (Width) and height (Height) of the AOI must be at least
16 pixel. The AOI width must be a multiple of 8.
Input parameters
Instance ID set by the isavi_InitAVI() function.
Color format of the input frames captured by the DCx
Camera.
Width of the entire frame or of the area of interest.
Height of the entire frame or of the area of interest.
X position (offset) of the area of interest.
Y position (offset) of the area of interest.
Line increment.
The line increment is the difference between the width of
the entire frame (in pixel) and the area of interest (in pixel).
Return values
Function executed successfully.
The indicated AVI instance could not be found.
Either the AVI ID is invalid or the instance has
already been deleted using isavi_ExitAVI().
The file has no valid AVI format.
IS_AVI_ERR_CAPTURE_RUNNING
Another capturing operation is in progress or an
AVI file is still open.
No memory could be allocated.
The submitted color mode is not supported for
AVI capturing.