Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_GetImageMemPitch

uEye Camera Manual Version 3.80

is_GetImageMemPitch

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

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 * [(bitspixel + 1)  / 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

Camera handle

pPitch

Pointer to the variable containing the line increment

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related Functions

is_GetImageMem()
is_AllocImageMem()
is_AddToSequence()
is_SetImageMem()
is_SetAllocatedImageMem()

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com