Inside Macintosh: Apple Game Sprockets Guide /

Chapter 2 - DrawSprocket / DrawSprocket Reference

DrawSprocket Functions / Drawing and Double Buffering

DSpContext_FadeGammaIn

You can use the DSpContext_FadeGammaIn function to completely fade in a display to a color of your choice.

OSStatus DSpContext_FadeGammaIn (
DSpContextReference inContext,
RGBColor *inZeroIntensityColor);

inContext

A reference to the context whose display is to be faded. If you pass NULL for this parameter, the fade operation applies simultaneously to all displays.

inZeroIntensityColor

The color that is to correspond to zero intensity. If you pass NULL for this parameter, the zero-intensity color is black.

function result

A result code.

DESCRIPTION

The DSpContext_FadeGammaIn function automatically performs a gamma fade on the display of the context specified in the inContext parameter. It fades the display from 0 percent to 100 percent intensity over a period of one second. You specify the zero-intensity color in the inZeroIntensityColor parameter. A key press or a mouse-button click will jump the fade to its end point immediately.

You can perform a manual fade with the DSpContext_FadeGamma function (page 2-45). For a complete discussion of gamma fades see "Gamma Fading" (page 2-9).

CALLING RESTRICTIONS

Do not call this function during an interrupt.