énumération D3DMULTISAMPLE_TYPE

Article
06/13/2023

Définit les niveaux d’échantillonnage multi-scène complet que l’appareil peut appliquer.

Syntaxe

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;

Constantes

D3DMULTISAMPLE_NONE: Aucun niveau d’échantillonnage multi-scène complet n’est disponible.
D3DMULTISAMPLE_NONMASKABLE: Active la valeur de qualité multi-échantillon. Consultez la section Notes.
D3DMULTISAMPLE_2_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_3_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_4_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_5_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_6_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_7_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_8_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_9_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_10_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_11_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_12_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_13_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_14_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_15_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_16_SAMPLES: Niveau d’échantillonnage multi-scène complet disponible.
D3DMULTISAMPLE_FORCE_DWORD: Force cette énumération à compiler à une taille de 32 bits. Sans cette valeur, certains compilateurs autoriseraient cette énumération à compiler à une taille autre que 32 bits. Cette valeur n'est pas utilisée.

Notes

En plus d’activer l’échantillonnage multi-scène complet à l’heure IDirect3DDevice9::Reset , il existe des états de rendu qui activent et désactivent différents aspects à des niveaux précis.

L’échantillonnage multiple est valide uniquement sur une chaîne d’échange en cours de création ou de réinitialisation avec l’effet d’échange D3DSWAPEFFECT_DISCARD.

La valeur d’anticrénelage à échantillonnage multiple peut être définie avec les paramètres (ou sous-paramètres) dans les méthodes suivantes.

Méthode	Paramètres	Sous-paramètres
IDirect3D9::CheckDeviceMultiSampleType	MultiSampleType et pQualityLevels
IDirect3D9::CreateDevice	pPresentationParameters	MultiSampleType et pQualityLevels
IDirect3DDevice9::CreateAdditionalSwapChain	pPresentationParameters	MultiSampleType et pQualityLevels
IDirect3DDevice9::CreateDepthStencilSurface	MultiSampleType et pQualityLevels
IDirect3DDevice9::CreateRenderTarget	MultiSampleType et pQualityLevels
IDirect3DDevice9::Reset	pPresentationParameters	MultiSampleType et pQualityLevels

Il n’est pas recommandé de passer d’un type multi-échantillonnage à un autre pour augmenter la qualité de l’anticrénelage.

D3DMULTISAMPLE_NONE active des effets d’échange autres que l’abandon, le verrouillage, etc.

Que le périphérique d’affichage prenne en charge l’échantillonnage multiple masquable (plus d’un échantillon pour un format cible de rendu à plusieurs exemples plus la prise en charge des anticrénelies) ou simplement l’échantillonnage multiple non masquable (uniquement la prise en charge des antialias), le pilote de l’appareil fournit le nombre de niveaux de qualité pour le D3DMULTISAMPLE_NONMASKABLE type d’échantillon multiple. Les applications qui utilisent simplement l’échantillonnage multiple à des fins d’anticrénelage doivent uniquement interroger le nombre de niveaux de qualité d’échantillons multiples non masquables pris en charge par le pilote.

Les niveaux de qualité pris en charge par l’appareil peuvent être obtenus avec le paramètre pQualityLevels de IDirect3D9::CheckDeviceMultiSampleType. Les niveaux de qualité utilisés par l’application sont définis avec le paramètre MultiSampleQuality de IDirect3DDevice9::CreateDepthStencilSurface et IDirect3DDevice9::CreateRenderTarget.

Pour plus d’informations sur l’échantillonnage multimasquable, consultez D3DRS_MULTISAMPLEMASK.

Spécifications

Condition requise	Valeur
En-tête	D3D9Types.h

Voir aussi

Énumérations Direct3D
D3DPRESENT_PARAMETERS
D3DSURFACE_DESC

Partager via