15bd8deadSopenharmony_ciName
25bd8deadSopenharmony_ci
35bd8deadSopenharmony_ci    QCOM_extended_get
45bd8deadSopenharmony_ci
55bd8deadSopenharmony_ciName Strings
65bd8deadSopenharmony_ci
75bd8deadSopenharmony_ci    GL_QCOM_extended_get
85bd8deadSopenharmony_ci
95bd8deadSopenharmony_ciContributors
105bd8deadSopenharmony_ci
115bd8deadSopenharmony_ci    Jukka Liimatta
125bd8deadSopenharmony_ci    James Ritts
135bd8deadSopenharmony_ci
145bd8deadSopenharmony_ciContact
155bd8deadSopenharmony_ci
165bd8deadSopenharmony_ci    Jukka Liimatta (jukka.liimatta 'at' qualcomm.com)
175bd8deadSopenharmony_ci
185bd8deadSopenharmony_ciNotice
195bd8deadSopenharmony_ci
205bd8deadSopenharmony_ci    Copyright Qualcomm 2009.
215bd8deadSopenharmony_ci
225bd8deadSopenharmony_ciIP Status
235bd8deadSopenharmony_ci
245bd8deadSopenharmony_ci    Qualcomm Proprietary.
255bd8deadSopenharmony_ci
265bd8deadSopenharmony_ciStatus
275bd8deadSopenharmony_ci
285bd8deadSopenharmony_ci    Complete.
295bd8deadSopenharmony_ci
305bd8deadSopenharmony_ciVersion
315bd8deadSopenharmony_ci
325bd8deadSopenharmony_ci    Last Modified Date: May 14, 2009
335bd8deadSopenharmony_ci    Revision: #1
345bd8deadSopenharmony_ci
355bd8deadSopenharmony_ciNumber
365bd8deadSopenharmony_ci
375bd8deadSopenharmony_ci    OpenGL ES Extension #62
385bd8deadSopenharmony_ci
395bd8deadSopenharmony_ciDependencies
405bd8deadSopenharmony_ci
415bd8deadSopenharmony_ci    OpenGL ES 1.0 or higher is required.
425bd8deadSopenharmony_ci
435bd8deadSopenharmony_ciOverview
445bd8deadSopenharmony_ci
455bd8deadSopenharmony_ci    This extension enables instrumenting the driver for debugging of OpenGL ES 
465bd8deadSopenharmony_ci    applications.
475bd8deadSopenharmony_ci
485bd8deadSopenharmony_ciNew Procedures and Functions
495bd8deadSopenharmony_ci
505bd8deadSopenharmony_ci    void ExtGetTexturesQCOM(uint* textures,
515bd8deadSopenharmony_ci                            int maxTextures,
525bd8deadSopenharmony_ci                            int* numTextures);
535bd8deadSopenharmony_ci
545bd8deadSopenharmony_ci    void ExtGetBuffersQCOM(uint* buffers,
555bd8deadSopenharmony_ci                           int maxBuffers,
565bd8deadSopenharmony_ci                           int* numBuffers);
575bd8deadSopenharmony_ci
585bd8deadSopenharmony_ci    void ExtGetRenderbuffersQCOM(uint* renderbuffers,
595bd8deadSopenharmony_ci                                 int maxRenderbuffers,
605bd8deadSopenharmony_ci                                 int* numRenderbuffers);
615bd8deadSopenharmony_ci
625bd8deadSopenharmony_ci    void ExtGetFramebuffersQCOM(uint* framebuffers,
635bd8deadSopenharmony_ci                                int maxFramebuffers,
645bd8deadSopenharmony_ci                                int* numFramebuffers);
655bd8deadSopenharmony_ci
665bd8deadSopenharmony_ci    void ExtGetTexLevelParameterivQCOM(uint texture, enum face, int level,
675bd8deadSopenharmony_ci                                       enum pname, int* params);
685bd8deadSopenharmony_ci
695bd8deadSopenharmony_ci    void ExtTexObjectStateOverrideiQCOM(enum target, enum pname, int param);
705bd8deadSopenharmony_ci
715bd8deadSopenharmony_ci    void ExtGetTexSubImageQCOM(enum target, int level,
725bd8deadSopenharmony_ci                               int xoffset, int yoffset, int zoffset,
735bd8deadSopenharmony_ci                               sizei width, sizei height, sizei depth,
745bd8deadSopenharmony_ci                               enum format, enum type, void *texels);
755bd8deadSopenharmony_ci
765bd8deadSopenharmony_ci    void ExtGetBufferPointervQCOM(enum target, void **params)
775bd8deadSopenharmony_ci
785bd8deadSopenharmony_ciNew Tokens
795bd8deadSopenharmony_ci
805bd8deadSopenharmony_ci    Accepted by the <pname> parameter of ExtGetTexLevelParameterivQCOM
815bd8deadSopenharmony_ci
825bd8deadSopenharmony_ci        TEXTURE_WIDTH_QCOM                         0x8BD2
835bd8deadSopenharmony_ci        TEXTURE_HEIGHT_QCOM                        0x8BD3
845bd8deadSopenharmony_ci        TEXTURE_DEPTH_QCOM                         0x8BD4
855bd8deadSopenharmony_ci        TEXTURE_INTERNAL_FORMAT_QCOM               0x8BD5
865bd8deadSopenharmony_ci        TEXTURE_FORMAT_QCOM                        0x8BD6
875bd8deadSopenharmony_ci        TEXTURE_TYPE_QCOM                          0x8BD7
885bd8deadSopenharmony_ci        TEXTURE_IMAGE_VALID_QCOM                   0x8BD8
895bd8deadSopenharmony_ci        TEXTURE_NUM_LEVELS_QCOM                    0x8BD9
905bd8deadSopenharmony_ci        TEXTURE_TARGET_QCOM                        0x8BDA
915bd8deadSopenharmony_ci        TEXTURE_OBJECT_VALID_QCOM                  0x8BDB
925bd8deadSopenharmony_ci
935bd8deadSopenharmony_ci    Accepted by the <target> parameter of ExtTexObjectStateOverrideiQCOM
945bd8deadSopenharmony_ci
955bd8deadSopenharmony_ci        TEXTURE_2D
965bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP
975bd8deadSopenharmony_ci        TEXTURE_3D_OES
985bd8deadSopenharmony_ci        TEXTURE_EXTERNAL_OES
995bd8deadSopenharmony_ci
1005bd8deadSopenharmony_ci    Accepted by the <pname> parameter of ExtTexObjectStateOverrideiQCOM
1015bd8deadSopenharmony_ci
1025bd8deadSopenharmony_ci        STATE_RESTORE                              0x8BDC
1035bd8deadSopenharmony_ci        TEXTURE_MIN_FILTER
1045bd8deadSopenharmony_ci        TEXTURE_MAG_FILTER
1055bd8deadSopenharmony_ci        TEXTURE_WIDTH_QCOM
1065bd8deadSopenharmony_ci        TEXTURE_HEIGHT_QCOM
1075bd8deadSopenharmony_ci        TEXTURE_DEPTH_QCOM
1085bd8deadSopenharmony_ci
1095bd8deadSopenharmony_ci    Accepted by the <target> parameter of ExtGetTexSubImageQCOM
1105bd8deadSopenharmony_ci
1115bd8deadSopenharmony_ci        TEXTURE_2D
1125bd8deadSopenharmony_ci        TEXTURE_3D
1135bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP_POSITIVE_X
1145bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP_NEGATIVE_X
1155bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP_POSITIVE_Y
1165bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP_NEGATIVE_Y
1175bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP_POSITIVE_Z
1185bd8deadSopenharmony_ci        TEXTURE_CUBE_MAP_NEGATIVE_Z
1195bd8deadSopenharmony_ci
1205bd8deadSopenharmony_ci    Accepted by the <format> parameter of ExtGetTexSubImageQCOM
1215bd8deadSopenharmony_ci
1225bd8deadSopenharmony_ci        ALPHA
1235bd8deadSopenharmony_ci        LUMINANCE
1245bd8deadSopenharmony_ci        LUMINANCE_ALPHA
1255bd8deadSopenharmony_ci        RGB
1265bd8deadSopenharmony_ci        RGBA
1275bd8deadSopenharmony_ci        ATC_RGB_AMD
1285bd8deadSopenharmony_ci        ATC_RGBA_EXPLICIT_ALPHA_AMD
1295bd8deadSopenharmony_ci        ATC_RGBA_INTERPOLATED_ALPHA_AMD
1305bd8deadSopenharmony_ci
1315bd8deadSopenharmony_ci    Accepted by the <type> parameter of ExtGetTexSubImageQCOM
1325bd8deadSopenharmony_ci
1335bd8deadSopenharmony_ci        UNSIGNED_BYTE
1345bd8deadSopenharmony_ci        UNSIGNED_SHORT_5_6_5
1355bd8deadSopenharmony_ci        UNSIGNED_SHORT_5_5_5_1
1365bd8deadSopenharmony_ci        UNSIGNED_SHORT_4_4_4_4
1375bd8deadSopenharmony_ci        HALF_FLOAT_OES
1385bd8deadSopenharmony_ci        FLOAT
1395bd8deadSopenharmony_ci
1405bd8deadSopenharmony_ci    Accepted by the <target> parameter of ExtGetBufferPointervQCOM
1415bd8deadSopenharmony_ci
1425bd8deadSopenharmony_ci        ARRAY_BUFFER
1435bd8deadSopenharmony_ci        ELEMENT_ARRAY_BUFFER
1445bd8deadSopenharmony_ci
1455bd8deadSopenharmony_ciAdditions to OpenGL ES 1.1 Specification
1465bd8deadSopenharmony_ci
1475bd8deadSopenharmony_ci    The command
1485bd8deadSopenharmony_ci
1495bd8deadSopenharmony_ci        void ExtGetTexturesQCOM(uint* textures,
1505bd8deadSopenharmony_ci                                int maxTextures,
1515bd8deadSopenharmony_ci                                int* numTextures);
1525bd8deadSopenharmony_ci
1535bd8deadSopenharmony_ci    returns list of texture objects in the current render context.
1545bd8deadSopenharmony_ci
1555bd8deadSopenharmony_ci    The command
1565bd8deadSopenharmony_ci
1575bd8deadSopenharmony_ci        void ExtGetBuffersQCOM(uint* buffers,
1585bd8deadSopenharmony_ci                               int maxBuffers,
1595bd8deadSopenharmony_ci                               int* numBuffers);
1605bd8deadSopenharmony_ci
1615bd8deadSopenharmony_ci    returns list of buffer objects in the current render context.
1625bd8deadSopenharmony_ci
1635bd8deadSopenharmony_ci    The command
1645bd8deadSopenharmony_ci
1655bd8deadSopenharmony_ci        void ExtGetRenderbuffersQCOM(uint* renderbuffers,
1665bd8deadSopenharmony_ci                                     int maxRenderbuffers,
1675bd8deadSopenharmony_ci                                     int* numRenderbuffers);
1685bd8deadSopenharmony_ci
1695bd8deadSopenharmony_ci    returns list of render buffer objects in the current render context.
1705bd8deadSopenharmony_ci
1715bd8deadSopenharmony_ci    The command
1725bd8deadSopenharmony_ci
1735bd8deadSopenharmony_ci        void ExtGetFramebuffersQCOM(uint* framebuffers,
1745bd8deadSopenharmony_ci                                    int maxFramebuffers,
1755bd8deadSopenharmony_ci                                    int* numFramebuffers);
1765bd8deadSopenharmony_ci
1775bd8deadSopenharmony_ci    returns list of frame buffer objects in the current render context.
1785bd8deadSopenharmony_ci
1795bd8deadSopenharmony_ci    The command
1805bd8deadSopenharmony_ci
1815bd8deadSopenharmony_ci        void ExtGetTexLevelParameterivQCOM(uint texture, enum face, int level,
1825bd8deadSopenharmony_ci                                           enum pname, int* params);
1835bd8deadSopenharmony_ci
1845bd8deadSopenharmony_ci    returns parameters for texture level chosen with <texture>, <face> and 
1855bd8deadSopenharmony_ci    <level>.
1865bd8deadSopenharmony_ci
1875bd8deadSopenharmony_ci    The command
1885bd8deadSopenharmony_ci
1895bd8deadSopenharmony_ci        void ExtTexObjectStateOverrideiQCOM(enum target, enum pname, int param);
1905bd8deadSopenharmony_ci
1915bd8deadSopenharmony_ci    overrides texture parameter for current texture in the <target>. The state 
1925bd8deadSopenharmony_ci    chosen with the <pname> argument is restored with <param> value 
1935bd8deadSopenharmony_ci    STATE_RESTORE. The STATE_RESTORE has the same effect as calling 
1945bd8deadSopenharmony_ci    TexParameteri(enum target, enum pname, int param).
1955bd8deadSopenharmony_ci
1965bd8deadSopenharmony_ci    The command
1975bd8deadSopenharmony_ci
1985bd8deadSopenharmony_ci        void ExtGetTexSubImageQCOM(enum target, int level,
1995bd8deadSopenharmony_ci                                   int xoffset, int yoffset, int zoffset,
2005bd8deadSopenharmony_ci                                   sizei width, sizei height, sizei depth,
2015bd8deadSopenharmony_ci                                   enum format, enum type, void *texels);
2025bd8deadSopenharmony_ci
2035bd8deadSopenharmony_ci    copies texels from current texture in <target> to address in <texels> 
2045bd8deadSopenharmony_ci    parameter.
2055bd8deadSopenharmony_ci
2065bd8deadSopenharmony_ci    The command
2075bd8deadSopenharmony_ci
2085bd8deadSopenharmony_ci        void ExtGetBufferPointervQCOM(enum target, void **params)
2095bd8deadSopenharmony_ci
2105bd8deadSopenharmony_ci    returns pointer to the buffer chosen with <target>.
2115bd8deadSopenharmony_ci
2125bd8deadSopenharmony_ciErrors
2135bd8deadSopenharmony_ci
2145bd8deadSopenharmony_ci    INVALID_VALUE error will be generated if the <texture> parameter to
2155bd8deadSopenharmony_ci    ExtGetTexLevelParameterivQCOM does not reference to a valid texture object.
2165bd8deadSopenharmony_ci
2175bd8deadSopenharmony_ci    INVALID_ENUM error will be generated if the <texture> parameter to
2185bd8deadSopenharmony_ci    ExtGetTexLevelParameterivQCOM does not reference to a valid texture target.
2195bd8deadSopenharmony_ci
2205bd8deadSopenharmony_ci    INVALID_VALUE error will be generated if the <face> parameter to cubemap 
2215bd8deadSopenharmony_ci    texture target in ExtGetTexLevelParameterivQCOM is not one of the allowable 
2225bd8deadSopenharmony_ci    values.
2235bd8deadSopenharmony_ci
2245bd8deadSopenharmony_ci    INVALID_VALUE error will be generated if the texture <level> parameter to
2255bd8deadSopenharmony_ci    ExtGetTexLevelParameterivQCOM is not one of the allowable values.
2265bd8deadSopenharmony_ci
2275bd8deadSopenharmony_ci    INVALID_ENUM error will be generated if the <pname> parameter to
2285bd8deadSopenharmony_ci    ExtGetTexLevelParameterivQCOM is not one of the allowable values.
2295bd8deadSopenharmony_ci
2305bd8deadSopenharmony_ci    INVALID_ENUM error will be generated if the <target> parameter to
2315bd8deadSopenharmony_ci    ExtGetTexSubImageQCOM is not one of the allowable values.
2325bd8deadSopenharmony_ci
2335bd8deadSopenharmony_ci    INVALID_ENUM error will be generated if the <target> parameter to
2345bd8deadSopenharmony_ci    ExtGetTexSubImageQCOM does not reference to a valid texture object.
2355bd8deadSopenharmony_ci
2365bd8deadSopenharmony_ci    INVALID_VALUE error will be generated if the selected region to
2375bd8deadSopenharmony_ci    ExtGetTexSubImageQCOM is not inside the texture.
2385bd8deadSopenharmony_ci
2395bd8deadSopenharmony_ci    INVALID_VALUE error will be generated if the <level> parameter to
2405bd8deadSopenharmony_ci    ExtGetTexSubImageQCOM does not reference to a valid texture level.
2415bd8deadSopenharmony_ci
2425bd8deadSopenharmony_ci    INVALID_ENUM error will be generated if the <format> or <type> parameters to
2435bd8deadSopenharmony_ci    ExtGetTexSubImageQCOM are not one of the allowable values.
2445bd8deadSopenharmony_ci
2455bd8deadSopenharmony_ci    INVALID_ENUM error will be generated if the <target> parameter to
2465bd8deadSopenharmony_ci    ExtGetBufferPointervQCOM is not one of the allowable values.
2475bd8deadSopenharmony_ci
2485bd8deadSopenharmony_ciNew State
2495bd8deadSopenharmony_ci
2505bd8deadSopenharmony_ci    None.
2515bd8deadSopenharmony_ci
2525bd8deadSopenharmony_ciRevision History
2535bd8deadSopenharmony_ci
2545bd8deadSopenharmony_ci    #01    05/14/2009    Jukka Liimatta       First draft.
255