enumerazione D3DMULTISAMPLE_TYPE

Articolo
06/13/2023

Definisce i livelli di multicampionamento full-scene che il dispositivo può applicare.

Sintassi

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;

Costanti

D3DMULTISAMPLE_NONE: Non è disponibile alcun livello di multicampionamento a scena completa.
D3DMULTISAMPLE_NONMASKABLE: Abilita il valore di qualità multisample. Vedere la sezione Osservazioni.
D3DMULTISAMPLE_2_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_3_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_4_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_5_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_6_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_7_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_8_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_9_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_10_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_11_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_12_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_13_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_14_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_15_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_16_SAMPLES: Livello di multicampionamento full-scene disponibile.
D3DMULTISAMPLE_FORCE_DWORD: Forza questa enumerazione per la compilazione in 32 bit di dimensioni. Senza questo valore, alcuni compilatori consentono la compilazione di questa enumerazione in una dimensione diversa da 32 bit. Questo valore non viene utilizzato.

Commenti

Oltre all'abilitazione di multicampionamento full-scene in IDirect3DDevice9::Reset time, verranno attivati vari aspetti e disattivati a livelli con granularità fine.

Il multicampionamento è valido solo in una catena di scambio creata o reimpostata con l'effetto di scambio D3DSWAPEFFECT_DISCARD.

Il valore antialiasing multisample può essere impostato con i parametri (o i parametri secondari) nei metodi seguenti.

Metodo	Parametri	Parametri secondari
IDirect3D9::CheckDeviceMultiSampleType	MultiSampleType e pQualityLevels
IDirect3D9::CreateDevice	pPresentationParameters	MultiSampleType e pQualityLevels
IDirect3DDevice9::CreateAdditionalSwapChain	pPresentationParameters	MultiSampleType e pQualityLevels
IDirect3DDevice9::CreateDepthStencilSurface	MultiSampleType e pQualityLevels
IDirect3DDevice9::CreateRenderTarget	MultiSampleType e pQualityLevels
IDirect3DDevice9::Reset	pPresentationParameters	MultiSampleType e pQualityLevels

Non è consigliabile passare da un tipo multisample a un altro per aumentare la qualità dell'antialiasing.

D3DMULTISAMPLE_NONE abilita gli effetti di scambio diversi dall'eliminazione, dal blocco e così via.

Se il dispositivo di visualizzazione supporta multicampionamento mascherabile (più di un esempio per un formato di destinazione di rendering multiplo e antialias supportato) o semplicemente multicampionamento non mascherabile (solo supporto antialias), il driver per il dispositivo fornisce il numero di livelli di qualità per il D3DMULTISAMPLE_NONMASKABLE tipo di campione multiplo. Le applicazioni che usano solo multicampionamento per scopi antialiasing devono eseguire una query solo per il numero di livelli di qualità a più campioni non mascherabili supportati dal driver.

I livelli di qualità supportati dal dispositivo possono essere ottenuti con il parametro pQualityLevels di IDirect3D9::CheckDeviceMultiSampleType. I livelli di qualità usati dall'applicazione vengono impostati con il parametro MultiSampleQuality di IDirect3DDevice9::CreateDepthStencilSurface e IDirect3DDevice9::CreateRenderTarget.

Vedere D3DRS_MULTISAMPLEMASK per la discussione sulla multicampionamento mascherabile.

Requisiti

Requisito	Valore
Intestazione	D3D9Types.h

Vedi anche

Enumerazione Direct3D
D3DPRESENT_PARAMETERS
D3DSURFACE_DESC

Condividi tramite