Inside Macintosh: Apple Game Sprockets Guide /

Chapter 2 - DrawSprocket / DrawSprocket Reference

DrawSprocket Functions / Using Alternate Buffers

DSpAltBuffer_New

You can use the DSpAltBuffer_New function to create an alternate buffer for an underlay or overlay.

OSStatus DSpAltBuffer_New (
DSpContextReference inContext,
Boolean inVRAMBuffer,
DSpAltBufferReference *outAltBuffer);

inContext

A reference to the context to create an alternate buffer for.

inVRAMBuffer

A value of true requests that DrawSprocket create the buffer in VRAM if possible (it may be created in the current heap). A value of false means to create the buffer in the current heap.

outAltBuffer

On exit, an alternate buffer reference.

function result

A result code.

DESCRIPTION

This function creates an alternate buffer for the context specified in inContext and returns a reference to the buffer in the outAltBuffer parameter. The alternate buffer will have the same characteristics as the specified context. To request that DrawSprocket create the buffer in VRAM, set the inVRAMBuffer parameter to true. The alternate buffer may be created in VRAM or in the current heap. If the inVRAMBuffer parameter is false, DrawSprocket creates the alternate buffer in the current heap.

CALLING RESTRICTIONS

Do not call this function during an interrupt.