Microsoft DirectX 9.0 SDK Update (October 2004)

Device.SetGammaRamp Method

Language:

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

Sets the gamma correction ramp for the implicit swap chain.

Definition

Visual Basic .NET Public Sub SetGammaRamp( _
    ByVal swapChain As Integer, _
    ByVal calibrate As Boolean, _
    ByVal ramp As GammaRamp _
)
C# public void SetGammaRamp(
    int swapChain,
    bool calibrate,
    GammaRamp ramp
);
Managed C++ public: void SetGammaRamp(
    int swapChain,
    bool calibrate,
    GammaRamp ramp
);
JScript .NET public function SetGammaRamp(
    swapChain : int,
    calibrate : boolean,
    ramp : GammaRamp
);

Parameters

swapChain System.Int32. Unsigned integer that specifies the swap chain.
calibrate System.Boolean. Set to true to indicate that correction should be applied. Set to false to indicate that no gamma correction should be applied. The supplied gamma table is transferred directly to the device.
ramp Microsoft.DirectX.Direct3D.GammaRamp. A GammaRamp structure that represents the gamma correction ramp to set for the implicit swap chain.

Remarks

Each device always has at least one swap chain (the implicit swap chain), because Microsoft® DirectX® 9.0 sets a swap chain as a device property.

Gamma correction results in a more consistent display, but can incur processing overhead and should not be used frequently. Short-duration effects, such as flashing the entire screen red, should not be calibrated, but long-duration gamma changes should be. If a gamma calibrator is installed, the ramp is modified before being sent to the device to account for the system and monitor response curves. If no calibrator is installed, the ramp is passed directly to the device.

For windowed gamma correction presentation, use SwapChain.Present if the hardware supports the feature.

The gamma ramp takes effect immediately. No wait for a vertical sync operation is performed.

If the device does not support gamma ramps in the swap chain's current presentation mode (full-screen or windowed), no error is returned. Applications can check DriverCaps.SupportsFullscreenGamma and DriverCaps.CanCalibrateGamma to determine the capabilities of the device and whether a calibrator is installed.

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