nngxFilterBlockImage Function

NNGX_APICALL void NNGX_APIENTRY nngxFilterBlockImage(
     const GLvoid * srcaddr,
     GLvoid * dstaddr,
     GLsizei width,
     GLsizei height,
     GLenum format
);

	Name	Description
in	srcaddr	Transfer source block image address.
in	dstaddr	Transfer destination address.
in	width	Transfer source image width.
in	height	Transfer source image height.
in	format	Block image pixel format.

There is no return value.

Issues a command to antialias-filter and transfer a block image.

These antialias-filter and transfer commands for block images accumulate in the current command list. Block images are either rendered images or PICA native format textures that are in 8-block addressing format. This operation transfers the image from the address specified in srcaddr to the address specified in dstaddr while applying a 2x2 antialias filter. The srcaddr and dstaddr addresses must be 8-byte aligned. For width and height, specify the dimensions of the transfer source image in pixels.

For format, specify one of the following pixel formats.

GL_RGBA8_OES	RGBA8888, 32-bit
GL_RGB8_OES	RGB888, 24-bit
GL_RGBA4	RGBA4444, 16-bit
GL_RGB5_A1	RGBA5551, 16-bit
GL_RGB565	RGB565, 16-bit

Depending on the format, there are restrictions on the possible settings for width and height. These are shown in the table below.

format	width	height
GL_RGBA8_OES, GL_RGB8_OES	Must be a value of 64 or larger and a multiple of 64	Must be a value of 64 or larger and a multiple of 8
GL_RGBA4, GL_RGB5_A1, GL_RGB565	Must be a value of 128 or larger and a multiple of 128	Must be a value of 128 or larger and a multiple of 8

The following errors occur with this function.

GL_ERROR_8068_DMP	0 is bound to the current command list, or the command request queue size is insufficient.
GL_ERROR_8069_DMP	srcaddr or dstaddr is not 8-byte aligned.
GL_ERROR_806A_DMP	width or height violate the restrictions imposed upon them by the specified format.
GL_ERROR_806B_DMP	The format argument is set to an invalid value.

2010/06/09

Initial version.