DIPlib Documentation - ©1995-2014 Quantitative Imaging Group, Delft University of Technology.

ImageGetData

Get the data pointers of a set of images

SYNOPSIS

dip_Error dip_ImageGetData( in, idp, iflags, out, odp, oflags, flags, resources )

FUNCTION

Get the data pointers of a set of images. This function should not be called before the clean up of the previous invocation (by ResourcesFree) has been performed. Currently no clean up is required by ImageGetData, but any data pointers obtained by a previous call to this function should be considered invalid when calling this function. The iflags, oflags, and flags parameters are not used in the current version. These fields should be set to zero. The resources parameter is mandatory. Any of the image arrays' elements may be set to zero, indicating that it is to be ignored.

No functions that will possibly modify an image should be called after the call to ImageGetData and before its clean up. The proper time to call ImageGetPlane and ImageGetStride is right after the call to ImageGetData.

ARGUMENTS

Data typeNameDescription
dip_ImageArrayinArray of input images
dip_VoidPointerArray *idpReturns input data pointers
dipf_ImageGetDataArrayiflagsFlags for input images
dip_ImageArrayoutArray of output images
dip_VoidPointerArray *odpReturns output data pointers
dipf_ImageGetDataArrayoflagsFlags for output images
dipf_ImageGetDataflagsFlags for all images
dip_ResourcesresourcesResources tracking structure. See ResourcesNew

SEE ALSO

The image structure

ImageGetPlane, ImageGetStride