Structs

typedef struct TQ3AcceleratedOffscreenPropertyData {
    TQ3Object    masterDrawContext;
    TQ3Boolean    copyFromPixmapAtFrameStart;
    TQ3Boolean    copyToPixmapAtFrameEnd;
} TQ3AcceleratedOffscreenPropertyData;

Discussion

To request that a pixmap draw context be rendered using hardware acceleration, attach this data, with the property type kQ3DrawContextPropertyAcceleratedOffscreen, to the draw context before rendering anything. The masterDrawContext member must be an on-screen context that has been rendered, and must continue to exist while the pixmap context exists. If there are multiple monitors being handled by multiple video cards, the masterDrawContext determines which video card will handle the hardware acceleration for the pixmap context.

Field Descriptions

masterDrawContext

An on-screen draw context, see discussion.

copyFromPixmapAtFrameStart

Whether to copy the pixmap to the rendering context at the beginning of each frame. This could be useful if using a pixmap as a background image.

copyToPixmapAtFrameEnd

Whether to copy the rendered image to the pixmap at the end of the last pass of each frame.

typedef struct TQ3CocoaDrawContextData {
    TQ3DrawContextData                          drawContextData;
    void                                        *nsView;
} TQ3CocoaDrawContextData;

Discussion

Describes the state for a Cocoa draw context.

Field Descriptions

drawContextData

The common state for the draw context.

nsView

The NSView to render to.

typedef struct TQ3DDSurfaceDescriptor {
    TQ3DirectDrawObjectSelector                 objectSelector;
    union {
    LPDIRECTDRAW                            lpDirectDraw;
    LPDIRECTDRAW2                           lpDirectDraw2;
    
} ;

Discussion

Describes the type of DirectDraw objects to be used for rendering.

Field Descriptions

objectSelector

Indicates the type of interface which has been supplied.

lpDirectDraw

A DIRECTDRAW interface object.

lpDirectDraw2

A DIRECTDRAW2 interface object.

lpDirectDrawSurface

A DIRECTDRAWSURFACE interface object.

lpDirectDrawSurface2

A DIRECTDRAWSURFACE2 interface object.

typedef struct TQ3DDSurfaceDrawContextData {
    TQ3DrawContextData                          drawContextData;
    TQ3DDSurfaceDescriptor                      ddSurfaceDescriptor;
} TQ3DDSurfaceDrawContextData;

Discussion

Describes the state for a Windows DirectDraw draw context.

Field Descriptions

drawContextData

The common state for the draw context.

ddSurfaceDescriptor

Describes the DirectDraw surface to render to.

typedef struct TQ3DrawContextData {
    TQ3DrawContextClearImageMethod              clearImageMethod;
    TQ3ColorARGB                                clearImageColor;
    TQ3Area                                     pane;
    TQ3Boolean                                  paneState;
    TQ3Bitmap                                   mask;
    TQ3Boolean                                  maskState;
    TQ3Boolean                                  doubleBufferState;
} TQ3DrawContextData;

Discussion

Describes the common state for a draw context.

If paneState is false, the draw context has an implicit pane which fills the entire window/destination surface. Under Quesa, querying a draw context object with Q3DrawContext_GetPane will return this implicit pane if not pane has been assigned (this feature is not available in QD3D).

The mask and maskState fields are currently ignored by Quesa's interactive renderers.

Field Descriptions

clearImageMethod

How the draw context should be cleared on each frame.

clearImageColor

The clear colour to use if clearImageMethod is kQ3ClearMethodWithColor.

pane

The area within the draw context which will be rendered to.

paneState

Indicates if the pane field is used.

mask

The clipping mask to be applied for rendering.

maskState

indicates if the clipping mask is used.

doubleBufferState

Indicates if rendering will be double-buffered.

typedef struct TQ3MacDrawContextData {
    TQ3DrawContextData                          drawContextData;
    CWindowPtr                                  window;
    TQ3MacDrawContext2DLibrary                  library;
    gxViewPort                                  viewPort;
    CGrafPtr                                    grafPort;
} TQ3MacDrawContextData;

Discussion

Describes the state for a Mac OS draw context.

The library and viewPort fields are not supported by Quesa.

To render to the screen, either the window or grafPort fields must be valid. Rendering to an off-screen buffer (e.g., a GWorld) should be achieved by rendering to a suitably constructed Pixmap draw context.

If a window is supplied, its port will be obtained internally by Quesa and the grafPort field should be NULL. When rendering to a port which does not correspond to a valid WindowRef (e.g., a QD port constructed from a CoreGraphics context), the window field should be NULL and the port to render to supplied in the grafPort field.

Field Descriptions

drawContextData

The common state for the draw context.

window

The window to render to.

library

The library to use for rendering. Should be kQ3Mac2DLibraryNone.

viewPort

The QuickDraw GX port to render to. Should be NULL.

grafPort

The QuickDraw port to render to.

typedef struct TQ3PixmapDrawContextData {
    TQ3DrawContextData                          drawContextData;
    TQ3Pixmap                                   pixmap;
} TQ3PixmapDrawContextData;

Discussion

Describes the state for a pixmap draw context.

Field Descriptions

drawContextData

The common state for the draw context.

pixmap

The pixmap to render to.

typedef struct TQ3Win32DCDrawContextData {
    TQ3DrawContextData                          drawContextData;
    HDC                                         hdc;
} TQ3Win32DCDrawContextData;

Discussion

Describes the state for a Windows HDC draw context.

Field Descriptions

drawContextData

The common state for the draw context.

hdc

The HDC to render to.

typedef struct TQ3XColormapData {
    TQ3Int32                                    baseEntry;
    TQ3Int32                                    maxRed;
    TQ3Int32                                    maxGreen;
    TQ3Int32                                    maxBlue;
    TQ3Int32                                    multRed;
    TQ3Int32                                    multGreen;
    TQ3Int32                                    multBlue;
} TQ3XColormapData;

Discussion

The colormap entry for an X11 draw context.

Note - no QD3D documentation could be found for this type. The purpose of the fields have been assumed.

Field Descriptions

baseEntry

The base entry.

maxRed

The maximum red value.

maxGreen

The maximum green value.

maxBlue

The maximum blue value.

multRed

The red multiplier value.

multGreen

The green multiplier value.

multBlue

The blue multiplier value.

typedef struct TQ3XDrawContextData {
    TQ3DrawContextData                          contextData;
    Display                                     *display;
    Drawable                                    drawable;
    Visual                                      *visual;
    Colormap                                    cmap;
    TQ3XColormapData                            *colorMapData;
} TQ3XDrawContextData;

Discussion

Describes the state for an X11 DirectDraw draw context.

Note - no QD3D documentation could be found for this type. The purpose of the fields have been assumed.

Field Descriptions

drawContextData

The common state for the draw context.

display

The X11 Display.

drawable

The X11 Drawable.

visual

The X11 Visual.

cmap

The X11 color map.

colorMapData

The X11 color map data.

© 1999-2008 Quesa Developers (Last Updated 5/10/2008)