BaseTexture.SetLevelOfDetail(Int32) Method (Microsoft.DirectX.Direct3D)

  • Article

Sets the most detailed level of detail (LOD) for a managed texture.

Definition

Visual Basic Public Function SetLevelOfDetail( _
    ByVal lodNew As Integer _
) As Integer
C# public int SetLevelOfDetail(
    int lodNew
);
C++ public:
int SetLevelOfDetail(
    int lodNew
);
JScript public function SetLevelOfDetail(
    lodNew : int
) : int;

Parameters

lodNew System.Int32
Most detailed LOD value to set for the chain.

Return Value

System.Int32
An Int32Leave Site value, clamped to the maximum LOD value (one less than the total number of levels). Subsequent calls to this method return the maximum value, not the previously set LOD value.

Remarks

The BaseTexture.SetLevelOfDetail method is used for LOD control of managed textures. The method communicates to the Microsoft Direct3D texture manager the most detailed mipmap in the chain that should be loaded into local video memory. For example, in a five-level mipmap chain, setting param_Int32_lodNew to 2 indicates that the texture manager should load only mipmap levels 2 through 4 into local video memory at any given time.

More specifically, if the texture was created with the dimensions of 256x256, setting the most detailed level to 0 indicates that 256x256 is the largest mipmap available, setting the most detailed level to 1 indicates that 128x128 is the largest mipmap available, and so on, up to the most detailed mip level (the smallest texture size) for the chain.

Applies To

CubeTexture, Texture, VolumeTexture

See Also