Instruction manual

DESCRIPTION: Sets a camera defined in the camera file.
RETURN VALUE:
0 if OK
-1 if ERROR. See el_GetErrorCode for details.
SEE ALSO: el_GetSelectedCamera
EXAMPLE:
//
// Get camera name
//
szCameraName = new char [50];
nRc = el_GetSelectedCamera(nBoardID, szCameraName, 50);
if (0 != nRc) {
ReportError( "el_GetSelectedCamera" );
return;
}
5.2.28. el_SetAcqWindow
long
el_SetAcqWindow ( long BoardId, long StartX, long StartY, long SizeX, long
SizeY );
PARAMETERS:
BoardId : board ID returned by el_OpenHW
StartX : hor. start of image
StartY : vert. start of image
SizeX : hor. size of image
SizeY : vert. size of image
DESCRIPTION: Sets acquisition window relative to camera image (video-timing) in units of pixels. The
absolute start position within video timing is calculated internally by the DLL and depends on the camera
type selected with el_SelectCamera . Therefore, the DLL makes the necessary post-settings for each
camera to ajust the upper and the left margin. If StartX and StartY are set to '0', the acquisition window
starts with the first valid upper left pixel of the camera. Therefore, the caller does not have to care about
invalid pixels (black front porch) in the camera timing.
RETURN VALUE:
0 if OK
-1 if ERROR. See el_GetErrorCode for details.
SizeX and SizeY specify the amount of pixels that should be acquired and transferred to the frame buffers
allocated. If the allocated frame buffers are smaller than SizeX * SizeY, an error is returned. StartX +
SizeX resp. StartY + SizeY must not be smaller than the limits imposed by the camera. The maximum
values for SizeX/SizeY can be inquired with el_GetSetting .
74