Attachment 71407 Details for Bug 57875 – MESA_depth_clip extension spec, try 2.

MESA_depth_clip extension spec, try 2.

MESA_depth_clip.txt (text/plain), 5.18 KB, created by Stefan Dösinger on 2012-12-12 20:29:29 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Stefan Dösinger

Created: 2012-12-12 20:29:29 UTC

Size: 5.18 KB

patch

obsolete

>Name
>
>    MESA_depth_clip
>
>Name Strings
>
>    GL_MESA_depth_clip
>
>Contributors
>
>    Stefan DÃ¶singer, CodeWeavers
>    Henri Verbeet, CodeWeavers
>
>Contact
>
>    Stefan DÃ¶singer (stefan 'at' codeweavers.com)
>
>Status
>
>    Draft
>    TODO: Token values
>    TODO: Formal language defining interaction with gl_FragCoord
>    TODO: Implementation dependent state
>    TODO: Number
>
>Version
>
>    Version 1, 2012/12/12
>
>Number
>
>    ???
>
>Dependencies
>
>    Written based on the wording of the OpenGL 3.1 specification.
>
>    ARB_depth_clamp interacts with this extension.
>
>Overview
>
>    This extension exposes the ability to disable the near and far clipping
>    planes in a way similar to ARB_depth_clamp without specifying clamping
>    behavior. It is intended to be used with orthogonal transformation matrices
>    and the depth test disabled. If ARB_depth_clamp is supported,
>    DEPTH_CLIP_MESA behaves like the inverse of DEPTH_CLAMP_ARB.
>
>    This extension guarantees that geometry outside the near and far planes of
>    the clip volume are rendered if the depth test is disabled and depth values
>    are passed to the fragment stage as specified in ARB_depth_clamp. Depth
>    testing behavior is undefined if the depth test is enabled.
>
>    This functionality is provided for porting applications that use another
>    popular 3D API and draw pre-transformed and pre-clipped geometry with the
>    depth test disabled.
>
>Issues
>
>    Should we reuse the DEPTH_CLAMP token?
>
>        UNRESOLVED: Probably not. The behavior is different and the two should
>        not be confused.
>
>        Applications that detect the presence of ARB_depth_clamp by enabling
>        DEPTH_CLAMP and check for an error may be misguided.
>
>    What are the interactions with the raster position?
>
>        RESOLVED: Use the behavior specified in ARB_depth_clamp.
>
>    What are the interactions with ARB_depth_clamp?
>
>        RESOLVED: DEPTH_CLIP_MESA behaves like the inverse of DEPTH_CLAMP
>        if both extensions are supported. Applications are advised to
>        prefer ARB_depth_clamp over this extension in that case.
>
>    Should the token be DEPTH_CLIP_MESA or DEPTH_CLIP_DISABLE_MESA?
>
>        UNRESOLVED: DEPTH_CLIP_DISABLE_MESA would be analogous to
>        DEPTH_CLAMP from ARB_depth_clamp. However, it would lead to somewhat
>        cumbersome inverse logic commands like
>        glEnable(GL_DEPTH_CLIP_DISABLE_MESA). Use DEPTH_CLIP_MESA for now, with
>        an initial value of True.
>
>New Procedures and Functions
>
>    None
>
>New Tokens
>
>    Accepted by the <cap> parameter of Enable, Disable, and IsEnabled,
>    and by the <pname> parameter of GetBooleanv, GetIntegerv,
>    GetFloatv, and GetDoublev:
>
>    DEPTH_CLIP_MESA                           0x????
>
>Additions to Chapter 2 of the OpenGL 3.1 Specification (OpenGL Operation)
>
> --  Section 2.17 "Clipping"
>
>    Add to the end of the 3rd paragraph:
>
>    "Depth clipping is enabled with the generic Enable command and
>    disabled with the Disable command. The value of the argument to
>    either command is DEPTH_CLIP_MESA. If depth clipping is disabled, the
>    "-w_c <= z_c <= w_c" plane equation are ignored by view volume
>    clipping (effectively, there is no near or far plane clipping)."
>
>    If and only if the ARB_compatibility extension is supported:
>
> --  Section 2.22 "Current Raster Position"
>
>    Add to the end of the 4th paragraph:
>
>    "If clipping (see section 2.17) is disabled, then raster
>    position z_w is first clamped to the range [min(n,f),max(n,f)],
>    where n and f are the current near and far depth range values (see
>    section 2.12.1)."
>
>Additions to Chapter 3 of the OpenGL 3.1 Specification (Rasterization)
>
>    None
>
>Additions to Chapter 4 of the OpenGL 3.1 Specification (Per-Fragment Operations
>and the Framebuffer)
>
>    If and only if the ARB_depth_clamp extension is not supported:
>
> --  Section 4.1.5 "Depth buffer test"
>
>    Add to the end of the 2nd paragraph:
>
>    "If depth clipping (see section 2.17) is disabled, and the depth test
>    is enabled, the results are undefined."
>
>    If and only if the ARB_depth_clamp extension is supported:
>
> --  Section 4.1.5 "Depth buffer test"
>
>    Add to the end of the 2nd paragraph:
>
>    "If depth clipping (see section 2.17) is disabled, before the
>    incoming fragment's z_w is compared z_w is clamped to the range
>    [min(n,f),max(n,f)], where n and f are the current near and far
>    depth range values (see section 2.12.1)."
>
>Additions to Chapter 5 of the OpenGL 3.1 Specification (Special Functions)
>
>    None
>
>Additions to Chapter 6 of the OpenGL 3.1 Specification (State and State Requests)
>
>    None
>
>Additions to the AGL/GLX/WGL Specifications
>
>    None
>
>GLX Protocol
>
>    None
>
>Errors
>
>    None
>
>New State
>
>Add to table 6.7, transformation state
>
>Get Value       Type  Get Command  Initial Value  Description     Sec      Attribute
>----------      ----  -----------  -------------  --------------  ------   ----------------
>DEPTH_CLIP_MESA B     IsEnabled    True           Depth clipping  2.12.2   transform/enable
>                                                  on/off
>
>New Implementation Dependent State
>
>    ???
>
>Interactions with ARB_compatibility
>
>    If ARB_compatibility is not supported, the language about current
>    raster position in section 2.22 is removed.

Actions: View

Attachments on bug 57875: 70995 | 71244 | 71407

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.