blob: 238959a46e498ea5833634ba0791121ebec16d9b [file] [log] [blame]
Name
QCOM_extended_get
Name Strings
GL_QCOM_extended_get
Contributors
Jukka Liimatta
James Ritts
Contact
Jukka Liimatta (jukka.liimatta 'at' qualcomm.com)
Notice
Copyright Qualcomm 2009.
IP Status
Qualcomm Proprietary.
Status
Complete.
Version
Last Modified Date: May 14, 2009
Revision: #1
Number
OpenGL ES Extension #62
Dependencies
OpenGL ES 1.0 or higher is required.
Overview
This extension enables instrumenting the driver for debugging of OpenGL ES
applications.
New Procedures and Functions
void ExtGetTexturesQCOM(uint* textures,
int maxTextures,
int* numTextures);
void ExtGetBuffersQCOM(uint* buffers,
int maxBuffers,
int* numBuffers);
void ExtGetRenderbuffersQCOM(uint* renderbuffers,
int maxRenderbuffers,
int* numRenderbuffers);
void ExtGetFramebuffersQCOM(uint* framebuffers,
int maxFramebuffers,
int* numFramebuffers);
void ExtGetTexLevelParameterivQCOM(uint texture, enum face, int level,
enum pname, int* params);
void ExtTexObjectStateOverrideiQCOM(enum target, enum pname, int param);
void ExtGetTexSubImageQCOM(enum target, int level,
int xoffset, int yoffset, int zoffset,
sizei width, sizei height, sizei depth,
enum format, enum type, void *texels);
void ExtGetBufferPointervQCOM(enum target, void **params)
New Tokens
Accepted by the <pname> parameter of ExtGetTexLevelParameterivQCOM
TEXTURE_WIDTH_QCOM 0x8BD2
TEXTURE_HEIGHT_QCOM 0x8BD3
TEXTURE_DEPTH_QCOM 0x8BD4
TEXTURE_INTERNAL_FORMAT_QCOM 0x8BD5
TEXTURE_FORMAT_QCOM 0x8BD6
TEXTURE_TYPE_QCOM 0x8BD7
TEXTURE_IMAGE_VALID_QCOM 0x8BD8
TEXTURE_NUM_LEVELS_QCOM 0x8BD9
TEXTURE_TARGET_QCOM 0x8BDA
TEXTURE_OBJECT_VALID_QCOM 0x8BDB
Accepted by the <target> parameter of ExtTexObjectStateOverrideiQCOM
TEXTURE_2D
TEXTURE_CUBE_MAP
TEXTURE_3D_OES
TEXTURE_EXTERNAL_OES
Accepted by the <pname> parameter of ExtTexObjectStateOverrideiQCOM
STATE_RESTORE 0x8BDC
TEXTURE_MIN_FILTER
TEXTURE_MAG_FILTER
TEXTURE_WIDTH_QCOM
TEXTURE_HEIGHT_QCOM
TEXTURE_DEPTH_QCOM
Accepted by the <target> parameter of ExtGetTexSubImageQCOM
TEXTURE_2D
TEXTURE_3D
TEXTURE_CUBE_MAP_POSITIVE_X
TEXTURE_CUBE_MAP_NEGATIVE_X
TEXTURE_CUBE_MAP_POSITIVE_Y
TEXTURE_CUBE_MAP_NEGATIVE_Y
TEXTURE_CUBE_MAP_POSITIVE_Z
TEXTURE_CUBE_MAP_NEGATIVE_Z
Accepted by the <format> parameter of ExtGetTexSubImageQCOM
ALPHA
LUMINANCE
LUMINANCE_ALPHA
RGB
RGBA
ATC_RGB_AMD
ATC_RGBA_EXPLICIT_ALPHA_AMD
ATC_RGBA_INTERPOLATED_ALPHA_AMD
Accepted by the <type> parameter of ExtGetTexSubImageQCOM
UNSIGNED_BYTE
UNSIGNED_SHORT_5_6_5
UNSIGNED_SHORT_5_5_5_1
UNSIGNED_SHORT_4_4_4_4
HALF_FLOAT_OES
FLOAT
Accepted by the <target> parameter of ExtGetBufferPointervQCOM
ARRAY_BUFFER
ELEMENT_ARRAY_BUFFER
Additions to OpenGL ES 1.1 Specification
The command
void ExtGetTexturesQCOM(uint* textures,
int maxTextures,
int* numTextures);
returns list of texture objects in the current render context.
The command
void ExtGetBuffersQCOM(uint* buffers,
int maxBuffers,
int* numBuffers);
returns list of buffer objects in the current render context.
The command
void ExtGetRenderbuffersQCOM(uint* renderbuffers,
int maxRenderbuffers,
int* numRenderbuffers);
returns list of render buffer objects in the current render context.
The command
void ExtGetFramebuffersQCOM(uint* framebuffers,
int maxFramebuffers,
int* numFramebuffers);
returns list of frame buffer objects in the current render context.
The command
void ExtGetTexLevelParameterivQCOM(uint texture, enum face, int level,
enum pname, int* params);
returns parameters for texture level chosen with <texture>, <face> and
<level>.
The command
void ExtTexObjectStateOverrideiQCOM(enum target, enum pname, int param);
overrides texture parameter for current texture in the <target>. The state
chosen with the <pname> argument is restored with <param> value
STATE_RESTORE. The STATE_RESTORE has the same effect as calling
TexParameteri(enum target, enum pname, int param).
The command
void ExtGetTexSubImageQCOM(enum target, int level,
int xoffset, int yoffset, int zoffset,
sizei width, sizei height, sizei depth,
enum format, enum type, void *texels);
copies texels from current texture in <target> to address in <texels>
parameter.
The command
void ExtGetBufferPointervQCOM(enum target, void **params)
returns pointer to the buffer chosen with <target>.
Errors
INVALID_VALUE error will be generated if the <texture> parameter to
ExtGetTexLevelParameterivQCOM does not reference to a valid texture object.
INVALID_ENUM error will be generated if the <texture> parameter to
ExtGetTexLevelParameterivQCOM does not reference to a valid texture target.
INVALID_VALUE error will be generated if the <face> parameter to cubemap
texture target in ExtGetTexLevelParameterivQCOM is not one of the allowable
values.
INVALID_VALUE error will be generated if the texture <level> parameter to
ExtGetTexLevelParameterivQCOM is not one of the allowable values.
INVALID_ENUM error will be generated if the <pname> parameter to
ExtGetTexLevelParameterivQCOM is not one of the allowable values.
INVALID_ENUM error will be generated if the <target> parameter to
ExtGetTexSubImageQCOM is not one of the allowable values.
INVALID_ENUM error will be generated if the <target> parameter to
ExtGetTexSubImageQCOM does not reference to a valid texture object.
INVALID_VALUE error will be generated if the selected region to
ExtGetTexSubImageQCOM is not inside the texture.
INVALID_VALUE error will be generated if the <level> parameter to
ExtGetTexSubImageQCOM does not reference to a valid texture level.
INVALID_ENUM error will be generated if the <format> or <type> parameters to
ExtGetTexSubImageQCOM are not one of the allowable values.
INVALID_ENUM error will be generated if the <target> parameter to
ExtGetBufferPointervQCOM is not one of the allowable values.
New State
None.
Revision History
#01 05/14/2009 Jukka Liimatta First draft.