D3DMULTISAMPLE_TYPE-Enumeration

Artikel
06/13/2023

Definiert die Ebenen des Vollszenen-Multisamplings, die das Gerät anwenden kann.

Syntax

typedef enum D3DMULTISAMPLE_TYPE { 
  D3DMULTISAMPLE_NONE          = 0,
  D3DMULTISAMPLE_NONMASKABLE   = 1,
  D3DMULTISAMPLE_2_SAMPLES     = 2,
  D3DMULTISAMPLE_3_SAMPLES     = 3,
  D3DMULTISAMPLE_4_SAMPLES     = 4,
  D3DMULTISAMPLE_5_SAMPLES     = 5,
  D3DMULTISAMPLE_6_SAMPLES     = 6,
  D3DMULTISAMPLE_7_SAMPLES     = 7,
  D3DMULTISAMPLE_8_SAMPLES     = 8,
  D3DMULTISAMPLE_9_SAMPLES     = 9,
  D3DMULTISAMPLE_10_SAMPLES    = 10,
  D3DMULTISAMPLE_11_SAMPLES    = 11,
  D3DMULTISAMPLE_12_SAMPLES    = 12,
  D3DMULTISAMPLE_13_SAMPLES    = 13,
  D3DMULTISAMPLE_14_SAMPLES    = 14,
  D3DMULTISAMPLE_15_SAMPLES    = 15,
  D3DMULTISAMPLE_16_SAMPLES    = 16,
  D3DMULTISAMPLE_FORCE_DWORD   = 0xffffffff
} D3DMULTISAMPLE_TYPE, *LPD3DMULTISAMPLE_TYPE;

Konstanten

D3DMULTISAMPLE_NONE: Es ist kein Vollszenen-Multisampling verfügbar.
D3DMULTISAMPLE_NONMASKABLE: Aktiviert den Multisampelqualitätswert. Siehe Hinweise.
D3DMULTISAMPLE_2_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_3_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_4_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_5_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_6_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_7_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_8_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_9_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_10_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_11_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_12_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_13_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_14_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_15_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_16_SAMPLES: Ebene des Vollszenen-Multisamplings verfügbar.
D3DMULTISAMPLE_FORCE_DWORD: Erzwingt, dass diese Enumeration in eine Größe von 32 Bits kompiliert wird. Ohne diesen Wert erlauben einige Compiler es dieser Enumeration, eine andere Größe als 32 Bits zu kompilieren. Dieser Wert wird nicht verwendet.

Bemerkungen

Zusätzlich zum Aktivieren des Vollszenen-Multisamplings bei IDirect3DDevice9::Reset time gibt es Renderzustände, die verschiedene Aspekte mit fein abgestuften Ebenen ein- und ausschalten.

Multisampling ist nur für eine Swapchain gültig, die mit dem D3DSWAPEFFECT_DISCARD Auslagerungseffekt erstellt oder zurückgesetzt wird.

Der Multisampel-Antialiasing-Wert kann mit den Parametern (oder Unterparametern) in den folgenden Methoden festgelegt werden.

Methode	Parameter	Unterparameter
IDirect3D9::CheckDeviceMultiSampleType	MultiSampleType und pQualityLevels
IDirect3D9::CreateDevice	pPresentationParameters	MultiSampleType und pQualityLevels
IDirect3DDevice9::CreateAdditionalSwapChain	pPresentationParameters	MultiSampleType und pQualityLevels
IDirect3DDevice9::CreateDepthStencilSurface	MultiSampleType und pQualityLevels
IDirect3DDevice9::CreateRenderTarget	MultiSampleType und pQualityLevels
IDirect3DDevice9::Reset	pPresentationParameters	MultiSampleType und pQualityLevels

Es ist nicht ratsam, von einem Multisampeltyp zu einem anderen zu wechseln, um die Qualität der Antialiasing zu erhöhen.

D3DMULTISAMPLE_NONE ermöglicht andere Auslagerungseffekte als Verwerfen, Sperren usw.

Unabhängig davon, ob das Anzeigegerät maskierbares Multisampling (mehr als ein Beispiel für ein Renderzielformat mit mehreren Beispielen plus Antialiasunterstützung) oder nur nicht maskierbares Multisampling (nur Antialiasunterstützung) unterstützt, stellt der Treiber für das Gerät die Anzahl der Qualitätsstufen für den D3DMULTISAMPLE_NONMASKABLE Typ mit mehreren Beispielen bereit. Anwendungen, die nur Multisampling für Antialiasingzwecke verwenden, müssen nur die Anzahl der nicht maskierbaren Qualitätsstufen mit mehreren Stichproben abfragen, die der Treiber unterstützt.

Die vom Gerät unterstützten Qualitätsstufen können mit dem Parameter pQualityLevels von IDirect3D9::CheckDeviceMultiSampleType abgerufen werden. Die von der Anwendung verwendeten Qualitätsstufen werden mit dem MultiSampleQuality-Parameter von IDirect3DDevice9::CreateDepthStencilSurface und IDirect3DDevice9::CreateRenderTarget festgelegt.

Informationen zum maskierbaren Multisampling finden Sie unter D3DRS_MULTISAMPLEMASK.

Anforderungen

Anforderung	Wert
Header	D3D9Types.h

Siehe auch

Direct3D-Enumerationen
D3DPRESENT_PARAMETERS
D3DSURFACE_DESC

Share via