Microsoft DirectX 8.0 (Visual Basic)

D3DX8.FilterTexture

Filters mipmap levels of a texture.

object.FilterTexture( _ 
    Texture As Direct3DTexturep8, _ 
    Palette As Any, _ 
    SrcLevel As Long, _ 
    MipFilter As Long)

Parts

object
Object expression that resolves to a D3DX8 object.
Texture
Direct3DTexture8 object representing the texture to filter.
Palette
The first element of an array of 256 PALETTEENTRY types to fill in, or ByVal 0 for nonpalletized formats. If a palette is not specified, the default Microsoft® Direct3D® palette (an all opaque white palette) is provided. See Remarks.
SrcLevel
The level whose image is used to generate the subsequent levels. Specifying D3DX_DEFAULT for this parameter is equivalent to specifying 0.
MipFilter
A combination of one or more filter flags defined by the CONST_D3DXENUM enumeration, controlling how the mipmap is filtered. Specifying D3DX_DEFAULT for this parameter is the equivalent of specifying D3DX_FILTER_BOX.

Error Codes

If the method fails, an error is raised and Err.Number can be set to D3DERR_INVALIDCALL.

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

For more information on PALETTEENTRY see the Microsoft Platform Software Development Kit (SDK). Note that as of Microsoft DirectX® 8.0, the peFlags member of the PALETTEENTRY structure does not work the way it is documented in the Platform SDK. The peFlags member is now the alpha channel for 8-bit palletized formats.

Box-filter is recursively applied to each texture level to generate the next texture level.