Is_Setimagepos - THORLABS DCU223x Operation Manual And Sdk

4.5.40 is_SetImagePos

USB 2.0
Syntax
INT is_SetImagePos (HIDS hCam, INT x, INT y)
Description
Attention
This function is obsolete and should not be used anymore. We recommend to use the
instead (see also Obsolete functions
is_SetImagePos() determines the position of an area of interest (AOI) in the display window. When used
together with the
is_SetAOI()
To avoid a positional mismatch between the display area and the image area, make sure to call the functions in the
correct order. Starting from the original image, it is mandatory to keep to the following order:
1.
is_SetAOI()
414
2. is_SetImagePos()
Attention
Changes to the image geometry or pixel clock affect the value ranges of the frame rate and exposure time. After
executing is_SetImagePos(), calling the following functions is recommended in order to keep the defined
camera settings:
is_SetFrameRate()
is_SetExposureTime()
If you are using the DCx Camera's flash function:
Input parameters
The x and y parameters represent an offset with respect to the upper left image corner. The cut window is copied to
the start position in the memory. If you want the image to be copied to the same offset within the memory, you can
link the new position with a logical OR to the IS_SET_IMAGE_POS_X_ABS and IS_SET_IMAGE_POS_Y_ABS
parameters.
hCam
x
0...xMax
0...xMax
| IS_SET_IMAGE_POS_X_ABS
IS_GET_IMAGE_POS_X
IS_GET_IMAGE_POS_X_MIN
IS_GET_IMAGE_POS_X_MAX
IS_GET_IMAGE_POS_X_INC
IS_GET_IMAGE_POS_X_ABS
IS_GET_IMAGE_POS_Y
IS_GET_IMAGE_POS_Y_MIN
IS_GET_IMAGE_POS_Y_MAX
IS_GET_IMAGE_POS_Y_INC
IS_GET_IMAGE_POS_Y_ABS
© 2013 Thorlabs GmbH
USB 2.0
).
379
function, you can cut out an area of interest of the full video image.
414
329
427
is_SetFlashStrobe()
Camera handle
Sets the horizontal position
Applies the absolute position to the memory as well.
Returns the current x position.
Returns the minimum value for the horizontal AOI
position.
Returns the maximum value for the horizontal AOI
position.
Returns the increment for the horizontal AOI position.
Returns the absolute horizontal position in the memory.
Returns the current Y position.
Returns the minimum value for the vertical AOI position.
Returns the maximum value for the vertical AOI
position.
Returns the increment for the vertical AOI position.
Returns the absolute vertical position in the memory.
4 Programming (SDK)
is_AOI()
431
function
159
435