NAME

DdInqPixelData − Return pixel information about an image on a given device

SYNOPSIS

C:

DtFlag DdInqPixelData(device, requesttype, width,
height, type, data, userdelete)
DtObject device;
DtRasterType requesttype;
DtInt ∗width;
DtInt ∗height;
DtRasterType ∗type;
DtPtr ∗data;
DtFlag ∗userdelete;

FORTRAN:

INTEGER∗4 DDQPXD(DEVICE, REQTYP, WIDTH,
HEIGHT, TYPE, DATA, USRDEL)
INTEGER∗4 DEVICE
INTEGER∗4 REQTYP
INTEGER∗4 WIDTH
INTEGER∗4 HEIGHT
INTEGER∗4 TYPE
INTEGER∗4 DATA
INTEGER∗4 USRDEL

DESCRIPTION

DdInqPixelData returns pixel information about an image on the device device.  This information can be used to create a raster object with DoRaster <DORS>.  DdInqPixelData will return DcFalse <DCFALS> if the device cannot return the pixel information. 

The return parameters width and height are the dimensions of the image. 

The parameter requesttype is the type and format of pixel information requested.  The return parameter type is the type and format of the pixel information returned.  Possible values for requesttype and type are:

DcRasterABGR <DCRAR>
Each pixel has alpha, blue, green, and red information.

DcRasterRGB <DCRGB>
Each pixel has red, green, and blue information.

DcRasterRGBA <DCRRA>
Each pixel has red, green, blue and alpha information.

DcRasterRGBAZ <DCRRAZ>
Each pixel has red, green, blue, alpha and z information.

DcRasterRGBZ <DCRRZ>
Each pixel has red, green, blue and z information.

DcRasterA <DCRA>
Each pixel has alpha information.

DcRasterZ <DCRZ>
Each pixel has z information.

The return parameter data is a pointer to the pixel data.  The return parameter userdelete is a flag specifying whether the application is responsible for deallocating the space pointed to by data.  Possible values for userdelete are:

DcTrue <DCTRUE>
The application is responsible for deleting the space pointed to by data when it no longer needs the data. 

DcFalse <DCFALS>
The application must not delete the space pointed to by data. 

ERRORS

DdInqPixelData will fail if passed an invalid device handle. 

[WARNING - invalid device handle]

SEE ALSO

DoRaster(3D)

September 02, 1992