Home > C: Programming > Obsolete Functions > | History back Previous chapter Next chapter Print |
is_SetImagePos |
uEye Camera Manual Version 3.80
is_SetImagePos
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_SetImagePos (HIDS hCam, INT x, INT y)
Description
|
is_SetImagePos() determines the position of an area of interest (AOI) in the display window. When used together with the is_SetAOI() function, you can cut out an area of interest of the full video image.
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() |
2. | is_SetImagePos() |
|
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 |
Camera handle |
x |
|
0...xMax |
Sets the horizontal position |
0...xMax |
Applies the absolute position to the memory as well. |
IS_GET_IMAGE_POS_X |
Returns the current x position. |
IS_GET_IMAGE_POS_X_MIN |
Returns the minimum value for the horizontal AOI position. |
IS_GET_IMAGE_POS_X_MAX |
Returns the maximum value for the horizontal AOI position. |
IS_GET_IMAGE_POS_X_INC |
Returns the increment for the horizontal AOI position. |
IS_GET_IMAGE_POS_X_ABS |
Returns the absolute horizontal position in the memory. |
IS_GET_IMAGE_POS_Y |
Returns the current Y position. |
IS_GET_IMAGE_POS_Y_MIN |
Returns the minimum value for the vertical AOI position. |
IS_GET_IMAGE_POS_Y_MAX |
Returns the maximum value for the vertical AOI position. |
IS_GET_IMAGE_POS_Y_INC |
Returns the increment for the vertical AOI position. |
IS_GET_IMAGE_POS_Y_ABS |
Returns the absolute vertical position in the memory. |
y |
|
0...yMax |
Sets the vertical position |
0...yMax |
Applies the absolute position to the memory as well. |
0 |
When returning settings via parameter x (s. above) |
Return Values
IS_SUCCESS |
Function executed successfully |
IS_NO_SUCCESS |
General error message |
IS_INVALID_PARAMETER |
Parameters x or y are invalid (x, y < 0) |
Current setting when used together with |
|
IS_INVALID_MODE |
Camera is in standby mode, function not allowed. |
Related Functions
Example
Figure 153: Examples for is_SetImagePos