NAME

DoTextureExtendUV − Create a texture attribute object that controls texturing behavior beyond the boundary of a 2-dimensional texture

SYNOPSIS

C:

DtObject DoTextureExtendUV(umode, vmode)
DtExtendMode umode;
DtExtendMode vmode;

FORTRAN:

INTEGER∗4 DOTXUV(UMODE, VMODE)
INTEGER∗4 UMODE
INTEGER∗4 VMODE

DESCRIPTION

DoTextureExtendUV creates a texture attribute object that specifies what happens to the texture value when the u or v coordinates of the primitive object extend beyond the limits of a 2-dimensional texture.  The parameter umode specifies the extension mode in the u direction and vmode specifies the extension mode in the v direction. 

The possible values of umode and vmode are:

DcExtendNone <DCXNON>
If the coordinate is outside the range [0..1] then no texture mapping is done. It is as if no texture map had been specified.

DcExtendBlack <DCXBLK>
If the coordinate is outside the range [0..1] then the value computed by the texture will be zero for every channel of data.

DcExtendClamp <DCXCLP>
If the coordinate is outside the range [0..1] then the value computed by the texture is the value at the nearest edge. For example, if u is 3.5 then u is clamped to 1.0, thus the edge values are extended. 

DcExtendRepeat <DCXRP>
If the coordinate is outside the range [0..1] then the texture is repeated. Effectively, if the coordinate is u then the texture coordinate used for mapping would be (u - floor(u)). 

DEFAULTS

The default value for DoTextureExtendUV is DcExtendNone <DCXNON> for both modes. 

SEE ALSO

DoTextureExtendUVW(3D), DoTextureMapDiffuseColor(3D), DoTextureMapEnviron(3D), DoTextureMapBump(3D), DoTextureMapTranspIntens(3D)

September 02, 1992