Extract page from original game help files (NDL Gamebryo 1.1)
NiTexturingProperty specifies the primary and secondary images to be used for texture mapping onto NiGeometry objects. These properties establish how the texture mapped onto a surface is to be modulated by the final vertex colors, the way the textures are filtered as they are applied, how they are clamped/wrapped to the surface, and, for mipmapping on the PlayStation2, whick L and K values to use. See the System Details manuals on Texturing for much greater detail on the usage of this property.
Texturing Details
For detailed documentation on the use of texturing and multi-texturing, please see the Gamebryo texturing documentation.
Texture Clamping Modes
The table below lists the four texture clamping modes that are supported by Gamebryo and their corresponding behaviors. Specific renderers may or may not be able to support a specific texture-clamping mode--see the Texturing document for details. Note that all clamping modes are declared in the scope of NiTexturingProperty, and the names must be qualified as such.
Clamping Mode
Behavior
CLAMP_S_CLAMP_T
Causes edge-replication to infinity in both dimensions.
CLAMP_S_WRAP_T
Causes edge-replication to infinity in the horizontal texture direction, and infinite tiling in the vertical texture direction.
WRAP_S_CLAMP_T
Causes edge-replication to infinity in the vertical texture direction, and infinite tiling in the horizontal texture direction.
WRAP_S_WRAP_T
Causes infinite tiling of texture in both dimensions.
Texture Apply Modes
The table below lists the five texture-apply modes that are supported by Gamebryo and their corresponding equations. Specific renderers may or may not be able to support a specific apply mode -- see the Texturing document for details.
Note that all apply modes are declared in the scope of NiTexturingProperty, and the names must be qualified as such.
Apply Mode
Color & Alpha: Common Application
APPLY_REPLACE
CR = CT, AR = AT: Basic texturing without any dynamic or static vertex-based lighting.
APPLY_DECAL
CR = CT * AT + CV * (1-AT), AR = AV: Decal or bullet-hole textures on a base untextured surface.
APPLY_MODULATE
CR = CT * CV, AR = AT * AV: Texture and final vertex colors and alpha values are multiplied component-by-component. In predecessors of Gamebryo, this mode was known as APPLY_MULTALPHA.
APPLY_HILIGHT
This mode is a PS2-only mode that maps directly to the PS2 hardware mode of the same name.
APPLY_HILIGHT2
This mode is a PS2-only mode that maps directly to the PS2 hardware mode of the same name.
Texture Filter Modes
Gamebryo supports the following texture filter modes, although specific renderers may or may not be able to support all of them in all texture modes. See the Texturing document for details.
Note that all filter modes are declared in the scope of NiTexturingProperty, and the names must be qualified as such.
Filter Mode
Description
FILTER_NEAREST
Uses nearest texel, with no mipmapping.
FILTER_BILERP
Uses linear interpolation with no mipmapping.
FILTER_TRILERP
Linearly interpolates between the eight texels (the 4 closest texels on each of the two closest mipmap levels).
FILTER_NEAREST_MIPNEAREST
Selects nearest mipmap level, then uses nearest texel on that level.
FILTER_NEAREST_MIPLERP
Selects nearest texel on each of the two nearest mipmap levels and linearly interpolates between them.
FILTER_BILERP_MIPNEAREST
Selects nearest mipmap level, then linearly interpolates on it.
