NVIDIA DRIVE 5.0 Linux SDK API Reference

5.0.10.3 Release

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
GL_EXT_texture_filter_anisotropic
Name
    
    EXT_texture_filter_anisotropic

Name Strings

    GL_EXT_texture_filter_anisotropic

Notice

    Copyright NVIDIA Corporation, 1999.

Version

    NVIDIA Date: April 25, 2000
    $Date$ $Revision$

Number

    OpenGL Extension #187
    OpenGL ES Extension #41

Dependencies

    Written based on the wording of the OpenGL 1.2 specification.

Overview

    Texture mapping using OpenGL's existing mipmap texture filtering
    modes assumes that the projection of the pixel filter footprint into
    texture space is a square (ie, isotropic).  In practice however, the
    footprint may be long and narrow (ie, anisotropic).  Consequently,
    mipmap filtering severely blurs images on surfaces angled obliquely
    away from the viewer.

    Several approaches exist for improving texture sampling by accounting
    for the anisotropic nature of the pixel filter footprint into texture
    space.  This extension provides a general mechanism for supporting
    anisotropic texturing filtering schemes without specifying a
    particular formulation of anisotropic filtering.

    The extension permits the OpenGL application to specify on
    a per-texture object basis the maximum degree of anisotropy to
    account for in texture filtering.

    Increasing a texture object's maximum degree of anisotropy may
    improve texture filtering but may also significantly reduce the
    implementation's texture filtering rate.  Implementations are free
    to clamp the specified degree of anisotropy to the implementation's
    maximum supported degree of anisotropy.

    A texture's maximum degree of anisotropy is specified independent
    from the texture's minification and magnification filter (as
    opposed to being supported as an entirely new filtering mode).
    Implementations are free to use the specified minification and
    magnification filter to select a particular anisotropic texture
    filtering scheme.  For example, a NEAREST filter with a maximum
    degree of anisotropy of two could be treated as a 2-tap filter that
    accounts for the direction of anisotropy.  Implementations are also
    permitted to ignore the minification or magnification filter and
    implement the highest quality of anisotropic filtering possible.

    Applications seeking the highest quality anisotropic filtering
    available are advised to request a LINEAR_MIPMAP_LINEAR minification
    filter, a LINEAR magnification filter, and a large maximum degree
    of anisotropy.

Issues

    Should there be a particular anisotropic texture filtering minification
    and magnification mode?

      RESOLUTION:  NO.  The maximum degree of anisotropy should control
      when anisotropic texturing is used.  Making this orthogonal to
      the minification and magnification filtering modes allows these
      settings to influence the anisotropic scheme used.  Yes, such
      an anisotropic filtering scheme exists in hardware.

    What should the minimum value for MAX_TEXTURE_MAX_ANISTROPY_EXT be?

      RESOLUTION:  2.0.  To support this extension, at least 2 to 1
      anisotropy should be supported.

    Should an implementation-defined limit for the maximum maximum degree of
    anisotropy be "get-able"?

      RESOLUTION:  YES.  But you should not assume that a high maximum
      maximum degree of anisotropy implies anything about texture
      filtering performance or quality.

    Should anything particular be said about anisotropic 3D texture filtering?

      Not sure.  Does the implementation example shown in the spec for
      2D anisotropic texture filtering readily extend to 3D anisotropic
      texture filtering?

New Procedures and Functions

    None

New Tokens

    Accepted by the <pname> parameters of GetTexParameterfv,
    GetTexParameteriv, TexParameterf, TexParameterfv, TexParameteri,
    and TexParameteriv:

        TEXTURE_MAX_ANISOTROPY_EXT          0x84FE

    Accepted by the <pname> parameters of GetBooleanv, GetDoublev,
    GetFloatv, and GetIntegerv:

        MAX_TEXTURE_MAX_ANISOTROPY_EXT      0x84FF

Additions to Chapter 2 of the 1.2 Specification (OpenGL Operation)

     None

Additions to Chapter 3 of the 1.2 Specification (Rasterization)

 --  Sections 3.8.3 "Texture Parameters"

     Add the following entry to the end of Table 3.17:

     Name                         Type    Legal Values
     --------------------------   ------  --------------------------
     TEXTURE_MAX_ANISOTROPY_EXT   float   greater or equal to 1.0


 --  Sections 3.8.5 "Texture Minification" and 3.8.6 "Texture Magnification"

     After the first paragraph in Section 3.8.5:
 
     "When the texture's value of TEXTURE_MAX_ANISOTROPY_EXT is equal to 1.0,
     the GL uses an isotropic texture filtering approach as described in
     this section and Section 3.8.6.  However, when the texture's value
     of TEXTURE_MAX_ANISOTROPY_EXT is greater than 1.0, the GL implementation
     should use a texture filtering scheme that accounts for a degree
     of anisotropy up to the smaller of the texture's value of
     TEXTURE_MAX_ANISTROPY_EXT or the implementation-defined value of
     MAX_TEXTURE_MAX_ANISTROPY_EXT.

     The particular scheme for anisotropic texture filtering is
     implementation dependent.  Additionally, implementations are free
     to consider the current texture minification and magnification modes
     to control the specifics of the anisotropic filtering scheme used.

     The anisotropic texture filtering scheme may only access mipmap
     levels if the minification filter is one that requires mipmaps.
     Additionally, when a minification filter is specified, the
     anisotropic texture filtering scheme may only access texture mipmap
     levels between the texture's values for TEXTURE_BASE_LEVEL and
     TEXTURE_MAX_LEVEL, inclusive.  Implementations are also recommended
     to respect the values of TEXTURE_MAX_LOD and TEXTURE_MIN_LOD to
     whatever extent the particular anisotropic texture filtering
     scheme permits this."

     The following describes one particular approach to implementing
     anisotropic texture filtering for the 2D texturing case:

     "Anisotropic texture filtering substantially changes Section 3.8.5.
     Previously a single scale factor P was determined based on the
     pixel's projection into texture space.  Now two scale factors,
     Px and Py, are computed.

       Px = sqrt(dudx^2 + dvdx^2)
       Py = sqrt(dudy^2 + dvdy^2)

       Pmax = max(Px,Py)
       Pmin = min(Px,Py)

       N = min(ceil(Pmax/Pmin),maxAniso)
       Lamda' = log2(Pmax/N)

     where maxAniso is the smaller of the texture's value of
     TEXTURE_MAX_ANISOTROPY_EXT or the implementation-defined value of
     MAX_TEXTURE_MAX_ANISOTROPY_EXT.

     It is acceptable for implementation to round 'N' up to the nearest
     supported sampling rate.  For example an implementation may only
     support power-of-two sampling rates.

     It is also acceptable for an implementation to approximate the ideal
     functions Px and Py with functions Fx and Fy subject to the following
     conditions:

       1.  Fx is continuous and monotonically increasing in |du/dx| and |dv/dx|.
           Fy is continuous and monotonically increasing in |du/dy| and |dv/dy|.

       2.  max(|du/dx|,|dv/dx|} <= Fx <= |du/dx| + |dv/dx|.
           max(|du/dy|,|dv/dy|} <= Fy <= |du/dy| + |dv/dy|.

     Instead of a single sample, Tau, at (u,v,Lamda), 'N' locations in the mipmap
     at LOD Lamda, are sampled within the texture footprint of the pixel.

     Instead of a single sample, Tau, at (u,v,lambda), 'N' locations in
     the mipmap at LOD Lamda are sampled within the texture footprint of
     the pixel.  This sum TauAniso is defined using the single sample Tau.
     When the texture's value of TEXTURE_MAX_ANISOTROPHY_EXT is greater
     than 1.0, use TauAniso instead of Tau to determine the fragment's
     texture value.

                    i=N
                    ---
     TauAniso = 1/N \ Tau(u(x - 1/2 + i/(N+1), y), v(x - 1/2 + i/(N+1), y)),  Px > Py
                    /
                    ---
                    i=1

                    i=N
                    ---
     TauAniso = 1/N \ Tau(u(x, y - 1/2 + i/(N+1)), v(x, y - 1/2 + i/(N+1))),  Py >= Px
                    /
                    ---
                    i=1


     It is acceptable to approximate the u and v functions with equally spaced
     samples in texture space at LOD Lamda:

                    i=N
                    ---
     TauAniso = 1/N \ Tau(u(x,y)+dudx(i/(N+1)-1/2), v(x,y)+dvdx(i/(N+1)-1/2)), Px > Py
                    /
                    ---
                    i=1

                    i=N
                    ---
     TauAniso = 1/N \ Tau(u(x,y)+dudy(i/(N+1)-1/2), v(x,y)+dvdy(i/(N+1)-1/2)), Py >= Px
                    /
                    ---
                    i=1 

     "

Additions to Chapter 4 of the 1.2 Specification (Per-Fragment Operations
and the Frame Buffer)

     None

Additions to Chapter 5 of the 1.2 Specification (Special Functions)

     None

Additions to Chapter 6 of the 1.2 Specification (State and State Requests)

     None

Additions to the GLX Specification

     None

Errors

     INVALID_VALUE is generated when TexParameter is called with <pname>
     of TEXTURE_MAX_ANISOTROPY_EXT and a <param> value or value of what
     <params> points to less than 1.0.

New State

(table 6.13, p203) add the entry:

Get Value                   Type  Get Command        Initial Value   Description      Sec     Attribute
--------------------------  ----  -----------------  --------------  ---------------  -----   ---------
TEXTURE_MAX_ANISOTROPY_EXT   R    GetTexParameterfv  1.0             Maximum degree   3.8.5    texture
                                                                     of anisotropy

New Implementation State

(table 6.25, p215) add the entry:

Get Value                       Type  Get Command   Minimum Value   Description      Sec     Attribute
------------------------------  ----  ------------  --------------  ---------------  -----   ---------
MAX_TEXTURE_MAX_ANISOTROPY_EXT   R    GetFloatv     2.0             Limit of         3.8.5    -
                                                                    maximum degree
                                                                    of anisotropy

Revision History

  9/26/07 (Jon Leech) - assigned OpenGL ES extension number so
  the extension can live in both API registries.

  4/25/00 - clarify that TexParameterf and TexParameteri accept
  TEXTURE_MAX_ANISTROPY_EXT as a pname.