Microsoft DirectX 9.0 SDK Update (October 2004)

MultiSampleType Enumeration

Language:

Note: This documentation is preliminary and is subject to change.

Defines the levels of full-scene multisampling that the device can apply.

Definition

Visual Basic .NET Public Enum MultiSampleType
C# public enum MultiSampleType
Managed C++ __value public enum MultiSampleType
JScript .NET public enum MultiSampleType

Members

Member Value Description
SixteenSamples 16 Enables 16 levels of full-scene multisampling.
FifteenSamples 15 Enables 15 levels of full-scene multisampling.
FourteenSamples 14 Enables 14 levels of full-scene multisampling.
ThirteenSamples 13 Enables 13 levels of full-scene multisampling.
TwelveSamples 12 Enables 12 levels of full-scene multisampling.
ElevenSamples 11 Enables 11 levels of full-scene multisampling.
TenSamples 10 Enables 10 levels of full-scene multisampling.
NineSamples 9 Enables nine levels of full-scene multisampling.
EightSamples 8 Enables eight levels of full-scene multisampling.
SevenSamples 7 Enables seven levels of full-scene multisampling.
SixSamples 6 Enables six levels of full-scene multisampling.
FiveSamples 5 Enables five levels of full-scene multisampling.
FourSamples 4 Enables four levels of full-scene multisampling.
ThreeSamples 3 Enables three levels of full-scene multisampling.
TwoSamples 2 Enables two levels of full-scene multisampling.
NonMaskable 1 Enables the multisample quality value.
None 0 Specifies no full-scene multisampling, and enables swap effects other than SwapEffect.Discard.

Remarks

When multisampling is enabled, all subsamples of a pixel are updated in one pass. However, when subsamples are used for other effects that involve multiple rendering passes, the application can specify that only some of them be affected by a given rendering pass. This latter approach enables simulation of motion blur, depth-of-field focus effects, reflection blur, and other effects.

In addition to enabling full-scene multisampling when a Device.Reset occurs, there are render states that turn various multisampling aspects on and off at fine-grained levels. For more information, see RenderStateManager.

Multisampling is valid only on a swap chain that is created or reset with SwapEffect.Discard.

The multisampling antialiasing value can be set with the parameters or sub-parameters in the following methods.

Module Parameters Sub-Parameters
Manager.CheckDeviceMultiSampleType multiSampleType, qualityLevels None
Device.CreateDepthStencilSurface multiSample, multiSampleQuality None
Device.CreateRenderTarget multiSample, multiSampleQuality None
SwapChain.SwapChain presentationParameters multiSample, multiSampleQuality
Device.Device presentationParameters multiSample, multiSampleQuality
Device.Reset presentationParameters multiSample, multiSampleQuality

Enumeration Information

Namespace Microsoft.DirectX.Direct3D
Assembly Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)
Strong Name Microsoft.DirectX.Direct3D,  Version=1.0.2902.0,  Culture=neutral,  PublicKeyToken=31bf3856ad364e35

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center