|
ilCopyPixels has very simple behaviour. It simply copies a block of pixels from the Data buffer to the current image's data. XOff, YOff and ZOff can be used to skip a certain number of pixels in each respective direction. If XOff + Width, YOff + Height and/or ZOff + Depth is greater than the current image's width, height or depth, only the current image's width, height or depth number of pixels will be copied to the current image's data buffer.
| ILvoid ilSetPixels( 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 to in the x direction.
- YOff
- Where to begin copying pixels to in the y direction.
- ZOff
- Where to begin copying pixels to 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 format the input is.
- Type
- The type the input is.
- 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
|