Inside Macintosh: Apple Game Sprockets Guide /

Chapter 2 - DrawSprocket / DrawSprocket Reference

DrawSprocket Functions / Drawing and Double Buffering

DSpContext_SetScale

Use the DSpContext_SetScale function to scale the back buffer for a context.

OSStatus DSpContext_SetScale (
DSpContextReference inContext,
DSpBufferScale inScale);

inContext

A reference to a context whose back buffer you want to scale.

inScale

The amount by which to scale the back buffer. See "Pixel Scaling" (page 2-25) for a description of the available settings.

function result

A result code.

DESCRIPTION

You pass the function a reference to a context in the inContext parameter and, in the inScale parameter, the amount by which to scale the context's back buffer. When scaling is activated, the resolution of the context remains the same but the area of the back buffer that is used is reduced. That area is then expanded vertically and horizontally to fill the entire display.

CALLING RESTRICTIONS

Do not call this function during an interrupt.