Is_Getimagemempitch - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.46 is_GetImageMemPitch

USB 2.0
USB 3.0
Syntax
INT is_GetImageMemPitch (HIDS hCam, INT* pPitch)
Description
is_GetImageMemPitch() returns the line increment (in bytes). The line increment is defined as the number of
bytes from the beginning of a line to the beginning of the next line. It may be greater than suggested by the
parameters passed when calling
divided by 4.
The line increment is calculated as:
line = width * int[(bitspixel + 7) / 8]
lineinc = line + adjust
adjust = 0 – if line can be divided by 4 without remainder
adjust = 4 - rest(line / 4) if line cannot be divided by 4 without remainder
Input parameters
hCam
pPitch
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_INVALID_CAMERA_HANDLE
IS_INVALID_MEMORY_POINTER
IS_INVALID_PARAMETER
IS_IO_REQUEST_FAILED
IS_NO_SUCCESS
IS_SUCCESS
Related functions
is_GetImageMem()
is_AllocImageMem()
is_AddToSequence()
is_SetImageMem()
is_SetAllocatedImageMem()
248
USB 2.0
USB 3.0
is_AllocImageMem()
247
157
156
337
301
. The line increment is always a number that can be
157
Camera handle
Pointer to the variable containing the line increment
Communication with the driver failed because no driver
has been loaded.
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
Invalid camera handle
Invalid pointer or invalid memory ID
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
available in this mode.
An IO request from the uc480 driver failed. Possibly the
versions of the uc480_api.dll (API) and the driver file
(uc480_usb.sys) do not match.
General error message
Function executed successfully
© 2013 Thorlabs GmbH