Syntax
is_SetCaptureMode (HIDS hf, INT Mode)
Description
is_SetCaptureMode() sets the required digitizing mode. The acquisition of even or uneven fields and totally interlaced video frames is supported. If the acquisition of half images is required and at the same time these images are to be displayed under one another, the IS_SET_CM_NONINTERLACED parameter can be used. Parameter IS_SET_CM_FRAME_STEREO turns on stereo mode. In stereo mode the cameras connected to video input 1 and 2 must be synchronized. During image acquisition FALCON/EAGLE switches over to the other camera at every VSYNC pulse. And thus the first field is always from camera 1, the second from camera 2. In the interlaced mode a 3-dimensional image can be regarded with 3-dim. sutter glasses.
IS_SET_CM_BOTHFIELDS saves both half images in the same memory. Thus however a half-image processing with double field rate is possible with "switching" half-images (50Hz with PAL, 60Hz with NTSC). In connection with the DirectDraw primary surface mode "switching" of the second half-image can occur, if an update of the representation area is executed by the driver.
Using IS_SET_CM_ODD | IS_SET_CM_NONINTERLACED or IS_SET_CM_EVEN | IS_SET_CM_NONINTERLACED memory has to be allocated for a full image.
Parameters
hf |
Frame grabber handle |
Mode |
|
IS_SET_CM_ODD |
Acquires odd half images |
IS_SET_CM_EVEN |
Acquires even half images |
IS_SET_CM_FRAME |
Acquires interlaced video (first the odd field, then the even field) |
IS_SET_CM_NONINTERLACED |
Acquires non-interlaced video. Software solution, non interlaced cameras cannot be used. The first field is written in top of the memory and the second field into the lower part of the memory. |
IS_SET_CM_NEXT_FRAME |
Acquires next interlaced video beginning with next field (odd or even) |
IS_SET_CM_NEXT_FIELD |
Acquires next half image (odd or even) |
IS_SET_CM_BOTHFIELDS |
Acquires both fields with double field rate. Odd- and even-fields are acquired in the same memory area. Image size e.g.. 768x288 pixel, frame rate 50Hz. |
IS_SET_CM_FRAME_STEREO |
Acquires stereo video. Before the video channel IS_SET_VIDEO_IN_1 must have been set with is_SetVideoInput(). |
IS_GET_CAPTURE_MODE |
Returns the current setting |
Return value
Current setting when called with IS_GET_CAPTURE_MODE, else IS_SUCCESS, IS_NO_SUCCESS
