ADC Home > Reference Library > Technical Q&As > Games > Graphics & Imaging >

Carbon Full Screen Conundrums


Q: What is the support for DrawSprocket under Mac OS X?

A: DrawSprocket has been brought forward to Mac OS X to support developers working on Carbon full screen applications. The great majority of the functionality works for Mac OS X and Mac OS 9 including: context operations, gamma fading, CLUT setting, buffer swapping and event loop integration. Some less used functions were deprecated including: alt buffer operations, callback functionality, underlay support, blitting functions, and dirty rectangle handling.

DrawSprocket support is fully function from Mac OS X 10.0.3 onward. This can be verified by checking the Mac OS version number or looking for DrawSprocket version 1.99 or later.

DrawSprocket functions supported in Mac OS X:

DSpStartup
DSpShutdown
DSpGetVersion
DSpGetFirstContext
DSpGetNextContext
DSpGetCurrentContext
DSpFindBestContext
DSpFindBestContextOnDisplayID
DSpProcessEvent
DSpSetBlankingColor
DSpSetDebugMode
DSpFindContextFromPoint
DSpGetMouse
DSpContext_GetAttributes
DSpContext_Reserve
DSpContext_Queue
DSpContext_Switch
DSpContext_Release
DSpContext_Dispose
DSpContext_GetDisplayID
DSpContext_GlobalToLocal
DSpContext_LocalToGlobal
DSpContext_GetMonitorFrequency
DSpContext_SetState
DSpContext_GetState
DSpContext_IsBusy
DSpContext_FadeGammaOut
DSpContext_FadeGammaIn
DSpContext_FadeGamma
DSpContext_SwapBuffers
DSpContext_GetBackBuffer
DSpContext_GetFrontBuffer
DSpContext_SetCLUTEntries
DSpContext_GetCLUTEntries


DrawSprocket functions not supported in Mac OS X:

NewDSpEventUPP
NewDSpCallbackUPP
DisposeDSpEventUPP
DisposeDSpCallbackUPP
InvokeDSpEventUPP
InvokeDSpCallbackUPP
DSpCanUserSelectContext
DSpUserSelectContext
DSpAltBuffer_New
DSpAltBuffer_Dispose
DSpAltBuffer_InvalRect
DSpAltBuffer_GetCGrafPtr
DSpContext_SetVBLProc
DSpContext_GetFlattenedSize
DSpContext_Flatten
DSpContext_Restore
DSpContext_SetMaxFrameRate
DSpContext_GetMaxFrameRate
DSpContext_SetDirtyRectGridSize
DSpContext_GetDirtyRectGridSize
DSpContext_GetDirtyRectGridUnits
DSpContext_InvalBackBufferRect
DSpContext_SetUnderlayAltBuffer
DSpContext_GetUnderlayAltBuffer
DSpBlit_Faster
DSpBlit_Fastest



[Aug 20 2001]


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.