Syntax
INT is_EnableMessage (HIDS hCam, INT which, HWND hWnd)
Description
Using is_EnableMessage(), you can enable Windows messages. If a particular event occurs, the messages are sent to the application.
Each message is structured as follows:
•Message: IS_UEYE_MESSAGE
•wParam: Event (see table)
•lParam: uEye camera handle associated with the message
|
You have to deactivate Windows messages with hWnd == NULL before you free the uEye API library. Otherwise the application may not close properly.
|
Input parameters
hCam
|
Camera handle
|
| which: ID of the message to be enabled/disabled |
IS_AUTOBRIGHTNESS_FINISHED
|
Automatic brightness control is completed (only if this control was started using the IS_SET_AUTO_BRIGHTNESS_ONCE function).
|
IS_AUTOFOCUS_FINISHED
|
Automatic focus control is finished (see is_Focus()).
|
IS_CAMERA_MEMORY
|
In the camera memory mode an image acquisition iteration is finished (see is_ImageBuffer()).
|
IS_CAPTURE_STATUS
|
An error occurred during the data transfer, see is_CaptureStatus().
The parameter IS_CAPTURE_STATUS replaces the previous parameter IS_TRANSFER_FAILED.
The parameter IS_TRANSFER_FAILED was moved into the new header file ueye_deprecated.h, which contains all obsolete function definitions and constants. If necessary the header file ueye_deprecated.h can be included in addition to the header file ueye.h.
|
IS_CONNECTIONSPEED_CHANGED
|
The connection speed of a USB 3.x camera has been reduced to USB 2.0 speed or has been increased.
|
IS_DEVICE_PLUGGED_IN
|
Requirement: the camera is operated in trusted pairing mode (see is_Configuration()):
An already paired GigE uEye camera was reconnected to the network.
|
IS_DEVICE_UNPLUGGED
|
Requirement: the camera is operated in trusted pairing mode (see is_Configuration()):
A paired GigE uEye camera was disconnected from the network.
|
IS_DEVICE_RECONNECTED
|
A camera initialized with is_InitCamera() and disconnected afterwards was reconnected.
|
IS_DEVICE_REMOVAL
|
A camera was removed.
|
IS_DEVICE_REMOVED
|
A camera initialized with is_InitCamera() was disconnected.
|
IS_END_OF_EXPOSURE
|
The exposure is finished. This event is triggered after the sensor exposure time has expired. The time between the exposure end and the software event signal is typically < 1 ms.
|
IS_FIRST_PACKET_RECEIVED
|
The first data packet of the image was transferred to the PC.
|
IS_FRAME
|
A new image is available.
|
IS_FRAME_RECEIVED
|
Signaled when a new image has arrived in the API before post-processing is performed.
|
IS_NEW_DEVICE
|
A camera was newly connected.
|
IS_OVERLAY_DATA_LOST
|
Direct3D/OpenGL mode: Because of a re-programming the parameters of the overlay are invalid. The overlay must be draw new.
|
IS_PMC_IMAGE_PARAMS_CHANGED
|
Multicast mode: The master has changed camera parameters which affect the data format like image size or color format. The client must reconfigure the virtual camera.
|
IS_SEQUENCE
|
The sequence is completed (see is_AddToSequence()).
|
IS_STEAL_VIDEO
|
An image extracted from the overlay is available (see is_DirectRenderer()).
|
IS_TEMPERATURE_STATUS
|
USB 3 uEye CP Rev. 2/GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4 only:
The temperature state of the camera has changed, see Querying the temperature state
|
IS_TRIGGER
|
An image which was captured following the arrival of a trigger has been transferred completely.
This is the earliest possible moment for a new capturing process. The image must then be post-processed by the driver and is available after the IS_FRAME message has occurred.
|
IS_WB_FINISHED
|
Automatic white balance control is completed (only if this control was started using the IS_SET_AUTO_WB_ONCE function).
|
|
hWnd
|
Application window for receiving the message.
NULL disables the message designated by the which parameter.
|
Return values
IS_INVALID_CAMERA_HANDLE
|
Invalid camera handle
|
IS_INVALID_PARAMETER
|
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.
|
IS_NO_SUCCESS
|
General error message
|
IS_SUCCESS
|
Function executed successfully
|
Related functions
•is_Event()