© 2016 Thorlabs Scientific Imaging246
DCx Camera Functional Description and SDK Manual
4.3.47 is_GetImageMemPitch
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 is_AllocImageMem(). The line increment is
always a number that can be 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
Pointer to the variable containing the line
increment
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
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).
IS_INVALID_MEMORY_POINTER
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.dll (API) and
the driver file (uc480_usb.sys) do not match.
Function executed successfully
Related functions
is_GetImageMem()
is_AllocImageMem()
is_AddToSequence()