DevIL Documentation Previous | IL | Next

 

ilCopyPixels

 

s width, height or depth number of pixels will be copied to Data.

 

ILvoid ilCopyPixels(
  ILuint XOff, ILuint YOff, ILuint ZOff, ILuint Width, ILuint Height, ILuint Depth, ILenum Format, ILenum Type, ILvoid * Data );


Parameters

 
XOff
Where to begin copying pixels from in the x direction.
YOff
Where to begin copying pixels from in the y direction.
ZOff
Where to begin copying pixels from in the z direction.
Width
How many pixels to copy in the x direction.
Height
How many pixels to copy in the y direction.
Depth
How many pixels to copy in the z direction.
Format
The desired format the output should be.
Type
The desired type the output should be.
Data
User-defined buffer to copy the image data to.


Errors

 
IL_ILLEGAL_OPERATION
The operation attempted is not allowable in the current state. The function returns with no ill side effects. Generally there is currently no image bound or it has been deleted via ilDeleteImages. You should use ilGenImages and ilBindImage before calling the function.
IL_INVALID_CONVERSION
Format did not match the current image's format. Use ilGetInteger to obtain the current image's format.

See Also

 
ilBindImage, ilGenImages, ilGetInteger,