IDirect3DBaseTexture9::SetAutoGenFilterType-Methode (d3d9helper.h)

Legen Sie den Filtertyp fest, der für automatisch generierte mipmap-Unterebenen verwendet wird.

Syntax

HRESULT SetAutoGenFilterType(
  [in] D3DTEXTUREFILTERTYPE FilterType
);

Parameter

[in] FilterType

Typ: D3DTEXTUREFILTERTYPE

Filtertyp. Siehe D3DTEXTUREFILTERTYPE. Diese Methode schlägt fehl, wenn der Filtertyp ungültig ist oder nicht unterstützt wird.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Das Ändern des Filtertyps "dirties" der mipmap-Unterebenen und bewirkt, dass sie neu generiert werden.

Der (Standard-)Filtertyp, der zum Zeitpunkt der Texturerstellung festgelegt wurde, ist D3DTEXF_LINEAR. Wenn der Treiber keinen linearen Filter unterstützt, wird der Filtertyp auf D3DTEXF_POINT festgelegt. Alle Filtertypen, die vom Treiber für die reguläre Texturfilterung unterstützt werden, werden für die automatische Generierung mit Ausnahme von D3DTEXF_NONE unterstützt. SetAutoGenFilterType schlägt fehl, es sei denn, der Treiber legt die entsprechenden D3DPTFILTERCAPS_MINFxxx Caps fest. Diese Werte werden in den Membern TextureFilterCaps und/oder CubeTextureFilterCaps von D3DCAPS9 angegeben.

Weitere Informationen zu Texturfiltertypen finden Sie unter D3DTEXTUREFILTERTYPE.

Diese Methode hat keine Auswirkung, wenn die Textur nicht mit D3DUSAGE_AUTOGENMIPMAP erstellt wird. In diesem Fall wird kein Fehler zurückgegeben. Weitere Informationen zu Verwendungskonstanten finden Sie unter D3DUSAGE.

Anforderungen

Zielplattform	Windows
Kopfzeile	d3d9helper.h (einschließlich D3D9.h)
Bibliothek	D3D9.lib

Weitere Informationen

GenerateMipSubLevels

GetAutoGenFilterType

IDirect3DBaseTexture9