Microsoft DirectX 8.0 (Visual Basic)

D3DX8.FilterVolumeTexture

Filters mipmap levels of a volume texture.

object.FilterVolumeTexture( _ 
    VolumeTexture As Direct3DVolume8, _ 
    Palette As Any, _ 
    SrcLevel As Long, _ 
    MipFilter As Long)

Parts

object
Object expression that resolves to a D3DX8 object.
VolumeTexture
Direct3DVolume8 object representing the volume 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.