Enumerations

enum {
  // Quesa constants
  kQ3ViewerStateEmpty                         = 0,
    kQ3ViewerStateHasModel                      = (1 << 0),
    kQ3ViewerStateHasUndo                       = (1 << 1),

  // QD3D constants - deprecated
#if QUESA_OS_MACINTOSH || QUESA_OS_WIN32
    kQ3ViewerEmpty                              = kQ3ViewerStateEmpty,
    kQ3ViewerHasModel                           = kQ3ViewerStateHasModel,
    kQ3ViewerHasUndo                            = kQ3ViewerStateHasUndo,
#endif // QUESA_OS_MACINTOSH || QUESA_OS_WIN32

    kQ3ViewerStateSize32                        = 0xFFFFFFFF
};

Discussion

state flags.

Constants

kQ3ViewerStateEmpty

Set if the viewer does not contain a model.

kQ3ViewerStateHasModel

Set if the viewer does contain a model.

kQ3ViewerStateHasUndo

Set if the viewer can undo the last action.

typedef enum TQ3ViewerCameraView {
    kQ3ViewerCameraRestore                      = 0,
    kQ3ViewerCameraFit                          = 1,
    kQ3ViewerCameraFront                        = 2,
    kQ3ViewerCameraBack                         = 3,
    kQ3ViewerCameraLeft                         = 4,
    kQ3ViewerCameraRight                        = 5,
    kQ3ViewerCameraTop                          = 6,
    kQ3ViewerCameraBottom                       = 7,
    kQ3ViewerCameraSize32                       = 0xFFFFFFFF
} TQ3ViewerCameraView;

Discussion

camera flags for Q3Viewer_SetCameraByView.

Constants

kQ3ViewerCameraRestore

Sets the camera view to its original position.

kQ3ViewerCameraFit

Sets the camera view so that the 3D model fits entirely within the window.

kQ3ViewerCameraFront

Sets the camera to look at the front of the model.

kQ3ViewerCameraBack

Sets the camera to look at the back of the model.

kQ3ViewerCameraLeft

Sets the camera to look at the left of the model.

kQ3ViewerCameraRight

Sets the camera to look at the right of the model.

kQ3ViewerCameraTop

Sets the camera to look at the top of the model.

kQ3ViewerCameraBottom

Sets the camera to look at the bottom of the model.

enum {
    kQ3ViewerFlagDefault                        = (1 << 0),
    kQ3ViewerFlagButtonCamera                   = (1 << 1),
    kQ3ViewerFlagButtonTruck                    = (1 << 2),
    kQ3ViewerFlagButtonOrbit                    = (1 << 3),
    kQ3ViewerFlagButtonZoom                     = (1 << 4),
    kQ3ViewerFlagButtonDolly                    = (1 << 5),
    kQ3ViewerFlagButtonReset                    = (1 << 6),
    kQ3ViewerFlagButtonOptions                  = (1 << 7),
    // 8 to 9, reserved for future buttons
    kQ3ViewerFlagDragMode                       = (1 << 10),
    kQ3ViewerFlagDraggingOff                    = (1 << 11),
    kQ3ViewerFlagDraggingInOff                  = (1 << 12),
    kQ3ViewerFlagDraggingOutOff                 = (1 << 13),
    kQ3ViewerFlagDrawFrame                      = (1 << 14),
    kQ3ViewerFlagDrawGrowBox                    = (1 << 15),
    kQ3ViewerFlagDrawDragBorder                 = (1 << 16),
    // 17 to 18, reserved for future expansion
    kQ3ViewerFlagControllerVisible              = (1 << 19),
    kQ3ViewerFlagActive                         = (1 << 20),
    kQ3ViewerFlagShowBadge                      = (1 << 21),
    kQ3ViewerFlagShowControlStrip               = (1 << 22),
    kQ3ViewerFlagOutputTextMode                 = (1 << 23),
    kQ3ViewerFlagPaneGrowBox                    = (1 << 24),
    // 25 to 31, reserved for future expansion
    kQ3ViewerFlagSize32                         = 0xFFFFFFFF
};

Discussion

flags.

Constants

kQ3ViewerFlagDefault

The default viewer configuration.

kQ3ViewerFlagButtonCamera

Displays the camera button in the control strip.

kQ3ViewerFlagButtonTruck

Displays the distance mode button in the control strip.

kQ3ViewerFlagButtonOrbit

Displays the orbit mode button in the control strip.

kQ3ViewerFlagButtonZoom

Displays the zoom mode button in the control strip.

kQ3ViewerFlagButtonDolly

Displays the move mode button in the control strip.

kQ3ViewerFlagButtonReset

Displays the camera reset button in the control strip.

kQ3ViewerFlagButtonOptions

Displays the viewer options button in the control strip

kQ3ViewerFlagDragMode

Enables drag and drop mode.

kQ3ViewerFlagDraggingOff

If set, disables drag and drop mode.

kQ3ViewerFlagDraggingInOff

If set, disables dragging in to the viewer.

kQ3ViewerFlagDraggingOutOff

If set, disables dragging out of the viewer.

kQ3ViewerFlagDrawFrame

Displays a one-pixel frame within the viewer.

kQ3ViewerFlagDrawGrowBox

Displays a grow box on the viewer window (Mac OS only).

kQ3ViewerFlagDrawDragBorder

Displays a drag border within the viewer.

kQ3ViewerFlagActive

Indicates the viewer is active.

kQ3ViewerFlagControllerVisible

Indicates the viewer controller is visible.

kQ3ViewerFlagShowBadge

Displays a badge when the control strip is hidden.

kQ3ViewerFlagShowControlStrip

Displays the control strip.

kQ3ViewerFlagOutputTextMode

If set, 3D data will be written/returned in text mode.

kQ3ViewerFlagPaneGrowBox

Displays a grow box within the viewer.

enum {
    Q3VNM_DROPFILES                             = 0x5000,
    Q3VNM_CANUNDO                               = 0x5001,
    Q3VNM_DRAWCOMPLETE                          = 0x5002,
    Q3VNM_SETVIEW                               = 0x5003,
    Q3VNM_SETVIEWNUMBER                         = 0x5004,
    Q3VNM_BUTTONSET                             = 0x5005,
    Q3VNM_BADGEHIT                              = 0x5006
};

Discussion

messages. Windows specific.

Constants

Q3VNM_DROPFILES

Files have been dropped on the viewer.

Q3VNM_CANUNDO

The viewer can undo.

Q3VNM_DRAWCOMPLETE

The viewer has finished drawing.

Q3VNM_SETVIEW

A new view has been set.

Q3VNM_SETVIEWNUMBER

A new view has been set by index.

Q3VNM_BUTTONSET

The active button has changed.

Q3VNM_BADGEHIT

The viewer badge has been clicked.

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