Name

    OES_depth_texture_cube_map

Name Strings

    GL_OES_depth_texture_cube_map

Contact

    Daniel Koch (daniel 'at' transgaming 'dot' com)

Status

    Recommended by the OpenGL ES Working Group, September 12, 2012

Version

    Last Modifed Date: January 29, 2012
    Version 1

Number

    OpenGL ES Extension #136

Dependencies

    OpenGL ES 2.0 is required.

    OES_depth_texture is required. 

    This extension is written against the OpenGL ES 2.0 specification

    OES_packed_depth_stencil affects the definition of this extension.

Overview

    This extension extends OES_depth_texture and OES_packed_depth_stencil
    to support depth and depth-stencil cube-map textures.
   
Issues

    None
 
New Procedures and Functions

    None

New Tokens

    Accepted by the <format> parameter of TexImage2D and TexSubImage2D and
    <internalFormat> parameter of TexImage2D when <target> is one of the
    TEXTURE_CUBE_MAP_* targets:
    
        DEPTH_COMPONENT          0x1902
        DEPTH_STENCIL_OES        0x84F9
        
    Accepted by the <type> parameter of TexImage2D, TexSubImage2D when
    <target> is one of the TEXTURE_CUBE_MAP_* targets:

        UNSIGNED_SHORT           0x1403
        UNSIGNED_INT             0x1405
        DEPTH24_STENCIL8_OES     0x88F0

Additions to Chapter 2 of the OpenGL ES 2.0 Specification (OpenGL Operation)

    None

Modifications to Chapter 3, section 3.8 of the OpenGL ES 2.0 specification

    Delete the following paragraph which was added by OES_depth_texture:

    "Textures with a base internal format of DEPTH_COMPONENT are supported
    by texture image specification commands only if <target> is TEXTURE_2D.
    Using this format in conjunction with any other <target> will result in
    an INVALID_OPERATION error."

    Delete the following paragraph which was added by OES_packed_depth_stencil:

    "Textures with a base internal format of DEPTH_COMPONENT or DEPTH_STENCIL_OES
    are supported by texture image specification commands only if <target> is
    TEXTURE_2D.  Using this format in conjunction with any other <target> will
    result in an INVALID_OPERATION error."

Additions to Chapter 4, of the OpenGL ES 2.0 specification

    None

Interactions with OES_packed_depth_stencil

    If OES_packed_depth_stencil is not available, any modifications based on 
    OES_packed_depth_stencil and any mention of DEPTH_STENCIL_OES
    and DEPTH24_STENCIL8_OES are omitted.

Errors

    Change the error for <targets> accepted by TexImage2D and TexSubImage2D to:

    "The error INVALID_OPERATION is generated if <target> is not TEXTURE_2D, or
    one of the TEXTURE_CUBE_MAP_* targets."

New State

    None.

Revision History
 
    01/29/2012   First Draft, split from OES_depth_texture.