QuesaErrors.h


Discussion

Declares the Quesa error manager.

Functions


Q3Error_Get


( TQ3Error ) Q3Error_Get (
    TQ3Error *firstError
);
Discussion

Retrieve latest error codes from Quesa.

Retrieve the most recent error code, and optionally also the oldest unreported error code. After this call, the next Quesa call that is not part of the Error Manager will clear the error codes.

Parameter Descriptions
firstError
Pointer to variable to receive the oldest error code that has not yet been reported. May be NULL if you don't need that information.
function result
Most recent error code.

Q3Error_IsFatalError


( TQ3Boolean ) Q3Error_IsFatalError (
    TQ3Error error
);
Discussion

Determine whether a Quesa error code is fatal.

You can call this function from an error callback or after getting an error code with Q3Error_Get. If the error is fatal, your application should quit without calling any other Quesa routines.

Parameter Descriptions
error
A Quesa error code.
function result
True if the error is fatal.

Q3Error_PlatformGet


( TQ3Uns32 ) Q3Error_PlatformGet (
    TQ3Uns32 *firstErr
);
Discussion

Gets platform-specific error codes. This is a generalization of Q3MacintoshError_Get, and may be used in place of Q3MacintoshError_Get on the Macintosh platform.

If an error callback or Q3Error_Get returns one of the special error codes kQ3ErrorMacintoshError, kQ3ErrorWin32Error, kQ3ErrorUnixError, kQ3ErrorPlatformError, you can call this function to retrieve platform-specific error codes. After this call, the next Quesa call that is not part of the Error Manager will clear the platform-specific error codes.

This function is not available in QD3D.

Parameter Descriptions
firstErr
Pointer to variable to receive the oldest unreported platform-specific error code. May be NULL if you don't need that information.
function result
Most recent platform-specific error code.

Q3Error_PlatformPost


( void ) Q3Error_PlatformPost (
    TQ3Uns32 theErr
);
Discussion

Posts a platform-specific error code.

Normally this would be used only by Quesa plug-ins, not by application code.

This function is not available in QD3D.

Parameter Descriptions
theErr
A platform-specific error code.

Q3Error_Register


( TQ3Status ) Q3Error_Register (
    TQ3ErrorMethod errorPost,
    TQ3Int32 reference
);
Discussion

Install a callback to handle errors.

Use this function to register an error-handling function that will be called when Quesa detects an error condition that it can't handle. Your callback should not call Quesa except for Error Manager routines.

Parameter Descriptions
errorPost
Callback to receive error notifications.
reference
Constant passed to error callback.
function result
kQ3Success when the callback is installed.

Q3Error_ToString


( const char * ) Q3Error_ToString (
    TQ3Language theLanguage,
    TQ3Error theError
);
Discussion

Retrieve a string version of the error code.

This function is not available in QD3D.

Parameter Descriptions
theLanguage
Preferred language for the error string. Currently only English is supported.
theError
Quesa error code.
function result
Text version of the error code, as a NULL-terminated string.

Q3MacintoshError_Get


( OSErr ) Q3MacintoshError_Get (
    OSErr *firstMacErr
);
Discussion

Retrieve the most recent Macintosh error code, and optionally also the oldest unreported Mac error code. After this call, the next Quesa call that is not part of the Error Manager will clear the error codes.

Q3Error_PlatformGet may be used in place of this function.

Parameter Descriptions
firstMacErr
Pointer to variable to receive the oldest Mac error code that has not yet been reported. May be NULL if you don't need that information.
function result
Most recent Mac error code.

Q3Notice_Get


( TQ3Notice ) Q3Notice_Get (
    TQ3Notice *firstNotice
);
Discussion

Retrieve latest notice codes from Quesa.

Retrieve the most recent notice code, and optionally also the oldest unreported notice code. After this call, the next Quesa call that is not part of the Error Manager will clear the notice codes.

Parameter Descriptions
firstNotice
Pointer to variable to receive the oldest notice code that has not yet been reported. May be NULL if you don't need that information.
function result
Most recent notice code.

Q3Notice_Register


( TQ3Status ) Q3Notice_Register (
    TQ3NoticeMethod noticePost,
    TQ3Int32 reference
);
Discussion

Install a callback to handle notifications.

Use this function to register an warning-handling function that will be called when a Quesa routine generates a notice. This will only happen in debugging versions of Quesa. Your callback should not call Quesa except for Error Manager routines.

Parameter Descriptions
noticePost
Routine to be called to handle notices.
reference
Constant passed to notice callback.
function result
kQ3Success when the callback is installed.

Q3Notice_ToString


( const char * ) Q3Notice_ToString (
    TQ3Language theLanguage,
    TQ3Notice theError
);
Discussion

Retrieve a string version of the notice code.

This function is not available in QD3D.

Parameter Descriptions
theLanguage
Preferred language for the notice string. Currently only English is supported.
theWarning
Quesa notice code.
function result
Text version of the notice code, as a NULL-terminated string.

Q3Warning_Get


( TQ3Warning ) Q3Warning_Get (
    TQ3Warning *firstWarning
);
Discussion

Retrieve latest warning codes from Quesa.

Retrieve the most recent warning code, and optionally also the oldest unreported warning code. After this call, the next Quesa call that is not part of the Error Manager will clear the warning codes.

Parameter Descriptions
firstWarning
Pointer to variable to receive the oldest warning code that has not yet been reported. May be NULL if you don't need that information.
function result
Most recent warning code.

Q3Warning_Register


( TQ3Status ) Q3Warning_Register (
    TQ3WarningMethod warningPost,
    TQ3Int32 reference
);
Discussion

Install a callback to handle warnings.

Use this function to register an warning-handling function that will be called when a Quesa routine generates a warning that it can't handle. Your callback should not call Quesa except for Error Manager routines.

Parameter Descriptions
warningPost
Callback to receive warning notifications.
reference
Constant passed to warning callback.
function result
kQ3Success when the callback is installed.

Q3Warning_ToString


( const char * ) Q3Warning_ToString (
    TQ3Language theLanguage,
    TQ3Warning theWarning
);
Discussion

Retrieve a string version of the warning code.

This function is not available in QD3D.

Parameter Descriptions
theLanguage
Preferred language for the warning string. Currently only English is supported.
theWarning
Quesa warning code.
function result
Text version of the warning code, as a NULL-terminated string.

Typedefs


TQ3ErrorMethod


typedef Q3_CALLBACK_API_C (void, TQ3ErrorMethod) (
    TQ3Error firstError,
    TQ3Error lastError,
    TQ3Int32 userData
);

Discussion

Error Manager error callback.

Parameter Descriptions
firstError
The first error which has occurred since the last time the handler was invoked.
lastError
The most recent error which has occurred.
userData
The reference parameter passed to Q3Error_Register.

TQ3NoticeMethod


typedef Q3_CALLBACK_API_C (void, TQ3NoticeMethod) (
    TQ3Notice firstNotice,
    TQ3Notice lastNotice,
    TQ3Int32 userData
);

Discussion

Error Manager notice callback.

Parameter Descriptions
firstNotice
The first notice which has occurred since the last time the handler was invoked.
lastNotice
The most recent notice which has occurred.
userData
The reference parameter passed to Q3Notice_Register.

TQ3WarningMethod


typedef Q3_CALLBACK_API_C (void, TQ3WarningMethod) (
    TQ3Warning firstWarning,
    TQ3Warning lastWarning,
    TQ3Int32 userData
);

Discussion

Error Manager warning callback.

Parameter Descriptions
firstWarning
The first warning which has occurred since the last time the handler was invoked.
lastWarning
The most recent warning which has occurred.
userData
The reference parameter passed to Q3Warning_Register.

Enumerations


TQ3Error


typedef enum {
    kQ3ErrorNone                                = 0,
    kQ3ErrorFirst                               = -28500,
    kQ3ErrorInternalError                       = -28500,
    kQ3ErrorNoRecovery                          = -28499,
    kQ3ErrorLastFatalError                      = -28498,
    kQ3ErrorNotUsedByQD3D_1                     = -28497,
    kQ3ErrorNotUsedByQD3D_2                     = -28496,
    kQ3ErrorNotUsedByQD3D_3                     = -28495,
    kQ3ErrorNotUsedByQD3D_4                     = -28494,
    kQ3ErrorNotUsedByQD3D_5                     = -28493,
    kQ3ErrorNotUsedByQD3D_6                     = -28492,
    kQ3ErrorNotUsedByQD3D_7                     = -28491,
    kQ3ErrorNotInitialized                      = -28490,
    kQ3ErrorAlreadyInitialized                  = -28489,
    kQ3ErrorUnimplemented                       = -28488,
    kQ3ErrorRegistrationFailed                  = -28487,
    kQ3ErrorUnixError                           = -28486,
    kQ3ErrorMacintoshError                      = -28485,
    kQ3ErrorX11Error                            = -28484,
    kQ3ErrorMemoryLeak                          = -28483,
    kQ3ErrorOutOfMemory                         = -28482,
    kQ3ErrorNULLParameter                       = -28481,
    kQ3ErrorParameterOutOfRange                 = -28480,
    kQ3ErrorInvalidParameter                    = -28479,
    kQ3ErrorInvalidData                         = -28478,
    kQ3ErrorAcceleratorAlreadySet               = -28477,
    kQ3ErrorVector3DNotUnitLength               = -28476,
    kQ3ErrorVector3DZeroLength                  = -28475,
    kQ3ErrorInvalidObject                       = -28474,
    kQ3ErrorInvalidObjectClass                  = -28473,
    kQ3ErrorInvalidObjectType                   = -28472,
    kQ3ErrorInvalidObjectName                   = -28471,
    kQ3ErrorObjectClassInUse                    = -28470,
    kQ3ErrorAccessRestricted                    = -28469,
    kQ3ErrorMetaHandlerRequired                 = -28468,
    kQ3ErrorNeedRequiredMethods                 = -28467,
    kQ3ErrorNoSubClassType                      = -28466,
    kQ3ErrorUnknownElementType                  = -28465,
    kQ3ErrorNotSupported                        = -28464,
    kQ3ErrorNoExtensionsFolder                  = -28463,
    kQ3ErrorExtensionError                      = -28462,
    kQ3ErrorPrivateExtensionError               = -28461,
    kQ3ErrorDegenerateGeometry                  = -28460,
    kQ3ErrorGeometryInsufficientNumberOfPoints  = -28459,
    kQ3ErrorNoStorageSetForFile                 = -28458,
    kQ3ErrorEndOfFile                           = -28457,
    kQ3ErrorFileCancelled                       = -28456,
    kQ3ErrorInvalidMetafile                     = -28455,
    kQ3ErrorInvalidMetafilePrimitive            = -28454,
    kQ3ErrorInvalidMetafileLabel                = -28453,
    kQ3ErrorInvalidMetafileObject               = -28452,
    kQ3ErrorInvalidMetafileSubObject            = -28451,
    kQ3ErrorInvalidSubObjectForObject           = -28450,
    kQ3ErrorUnresolvableReference               = -28449,
    kQ3ErrorUnknownObject                       = -28448,
    kQ3ErrorStorageInUse                        = -28447,
    kQ3ErrorStorageAlreadyOpen                  = -28446,
    kQ3ErrorStorageNotOpen                      = -28445,
    kQ3ErrorStorageIsOpen                       = -28444,
    kQ3ErrorFileAlreadyOpen                     = -28443,
    kQ3ErrorFileNotOpen                         = -28442,
    kQ3ErrorFileIsOpen                          = -28441,
    kQ3ErrorBeginWriteAlreadyCalled             = -28440,
    kQ3ErrorBeginWriteNotCalled                 = -28439,
    kQ3ErrorEndWriteNotCalled                   = -28438,
    kQ3ErrorReadStateInactive                   = -28437,
    kQ3ErrorStateUnavailable                    = -28436,
    kQ3ErrorWriteStateInactive                  = -28435,
    kQ3ErrorSizeNotLongAligned                  = -28434,
    kQ3ErrorFileModeRestriction                 = -28433,
    kQ3ErrorInvalidHexString                    = -28432,
    kQ3ErrorWroteMoreThanSize                   = -28431,
    kQ3ErrorWroteLessThanSize                   = -28430,
    kQ3ErrorReadLessThanSize                    = -28429,
    kQ3ErrorReadMoreThanSize                    = -28428,
    kQ3ErrorNoBeginGroup                        = -28427,
    kQ3ErrorSizeMismatch                        = -28426,
    kQ3ErrorStringExceedsMaximumLength          = -28425,
    kQ3ErrorValueExceedsMaximumSize             = -28424,
    kQ3ErrorNonUniqueLabel                      = -28423,
    kQ3ErrorEndOfContainer                      = -28422,
    kQ3ErrorUnmatchedEndGroup                   = -28421,
    kQ3ErrorFileVersionExists                   = -28420,
    kQ3ErrorViewNotStarted                      = -28419,
    kQ3ErrorViewIsStarted                       = -28418,
    kQ3ErrorRendererNotSet                      = -28417,
    kQ3ErrorRenderingIsActive                   = -28416,
    kQ3ErrorImmediateModeUnderflow              = -28415,
    kQ3ErrorDisplayNotSet                       = -28414,
    kQ3ErrorCameraNotSet                        = -28413,
    kQ3ErrorDrawContextNotSet                   = -28412,
    kQ3ErrorNonInvertibleMatrix                 = -28411,
    kQ3ErrorRenderingNotStarted                 = -28410,
    kQ3ErrorPickingNotStarted                   = -28409,
    kQ3ErrorBoundsNotStarted                    = -28408,
    kQ3ErrorDataNotAvailable                    = -28407,
    kQ3ErrorNothingToPop                        = -28406,
    kQ3ErrorUnknownStudioType                   = -28405,
    kQ3ErrorAlreadyRendering                    = -28404,
    kQ3ErrorStartGroupRange                     = -28403,
    kQ3ErrorUnsupportedGeometryType             = -28402,
    kQ3ErrorInvalidGeometryType                 = -28401,
    kQ3ErrorUnsupportedFunctionality            = -28400,
    kQ3ErrorInvalidPositionForGroup             = -28399,
    kQ3ErrorInvalidObjectForGroup               = -28398,
    kQ3ErrorInvalidObjectForPosition            = -28397,
    kQ3ErrorScaleOfZero                         = -28396,
    kQ3ErrorBadStringType                       = -28395,
    kQ3ErrorAttributeNotContained               = -28394,
    kQ3ErrorAttributeInvalidType                = -28393,
    kQ3ErrorInvalidCameraValues                 = -28392,
    kQ3ErrorBadDrawContextType                  = -28391,
    kQ3ErrorBadDrawContextFlag                  = -28390,
    kQ3ErrorBadDrawContext                      = -28389,
    kQ3ErrorUnsupportedPixelDepth               = -28388,
    kQ3ErrorController                          = -28387,
    kQ3ErrorTracker                             = -28386,
    kQ3ErrorWin32Error                          = -28385,
    kQ3ErrorTypeAlreadyExistsAndHasSubclasses           = -28384,
    kQ3ErrorTypeAlreadyExistsAndOtherClassesDependOnIt  = -28383,
    kQ3ErrorTypeAlreadyExistsAndHasObjectInstances      = -28382,
    kQ3ErrorPickingLoopFailed                   = -28381,
    kQ3ErrorRenderingLoopFailed                 = -28380,
    kQ3ErrorWritingLoopFailed                   = -28379,
    kQ3ErrorBoundingLoopFailed                  = -28378,

    kQ3ErrorPlatformError                       = -28377,
    kQ3ErrorInfiniteRationalPoint        = -28376,
#endif // QUESA_ALLOW_QD3D_EXTENSIONS

    kQ3ErrorLast,
    kQ3ErrorSize32                              = 0x7FFFFFFF
} TQ3Error;
Discussion

Quesa error constants.

Constants

kQ3ErrorNone
No error.
kQ3ErrorInternalError
Internal error.
kQ3ErrorNoRecovery
No recovery.
kQ3ErrorLastFatalError
Last fatal error.
kQ3ErrorNotInitialized
Not initialized.
kQ3ErrorAlreadyInitialized
Already initialized.
kQ3ErrorUnimplemented
Unimplemented.
kQ3ErrorRegistrationFailed
Registration failed.
kQ3ErrorUnixError
Unix error.
kQ3ErrorMacintoshError
Macintosh error.
kQ3ErrorX11Error
X11 error.
kQ3ErrorMemoryLeak
Memory leak.
kQ3ErrorOutOfMemory
Out of memory.
kQ3ErrorNULLParameter
NULL parameter.
kQ3ErrorParameterOutOfRange
Parameter out of range.
kQ3ErrorInvalidParameter
Invalid parameter.
kQ3ErrorInvalidData
Invalid data.
kQ3ErrorAcceleratorAlreadySet
Accelerator already set.
kQ3ErrorVector3DNotUnitLength
Vector3D not unit length.
kQ3ErrorVector3DZeroLength
Vector3D zero length.
kQ3ErrorInvalidObject
Invalid object.
kQ3ErrorInvalidObjectClass
Invalid object class.
kQ3ErrorInvalidObjectType
Invalid object type.
kQ3ErrorInvalidObjectName
Invalid object name.
kQ3ErrorObjectClassInUse
Object class in use.
kQ3ErrorAccessRestricted
Access restricted.
kQ3ErrorMetaHandlerRequired
Meta handler required.
kQ3ErrorNeedRequiredMethods
Need required methods.
kQ3ErrorNoSubClassType
No sub class type.
kQ3ErrorUnknownElementType
Unknown element type.
kQ3ErrorNotSupported
Not supported.
kQ3ErrorNoExtensionsFolder
No extensions folder.
kQ3ErrorExtensionError
Extension error.
kQ3ErrorPrivateExtensionError
Private extension error.
kQ3ErrorDegenerateGeometry
Degenerate geometry detected.
kQ3ErrorGeometryInsufficientNumberOfPoints
Geometry has an insufficient number of points.
kQ3ErrorNoStorageSetForFile
No storage set for file.
kQ3ErrorEndOfFile
End of file.
kQ3ErrorFileCancelled
File cancelled.
kQ3ErrorInvalidMetafile
Invalid metafile.
kQ3ErrorInvalidMetafilePrimitive
Invalid metafile primitive.
kQ3ErrorInvalidMetafileLabel
Invalid metafile label.
kQ3ErrorInvalidMetafileObject
Invalid metafile object.
kQ3ErrorInvalidMetafileSubObject
Invalid metafile sub object.
kQ3ErrorInvalidSubObjectForObject
Invalid sub object for object.
kQ3ErrorUnresolvableReference
Unresolvable reference.
kQ3ErrorUnknownObject
Unknown object.
kQ3ErrorStorageInUse
Storage in use.
kQ3ErrorStorageAlreadyOpen
Storage already open.
kQ3ErrorStorageNotOpen
Storage not open.
kQ3ErrorStorageIsOpen
Storage is open.
kQ3ErrorFileAlreadyOpen
File already open.
kQ3ErrorFileNotOpen
File not open.
kQ3ErrorFileIsOpen
File is open.
kQ3ErrorBeginWriteAlreadyCalled
Begin write already called.
kQ3ErrorBeginWriteNotCalled
Begin write not called.
kQ3ErrorEndWriteNotCalled
End write not called.
kQ3ErrorReadStateInactive
Read state inactive.
kQ3ErrorStateUnavailable
State unavailable.
kQ3ErrorWriteStateInactive
Write state inactive.
kQ3ErrorSizeNotLongAligned
Size not long aligned.
kQ3ErrorFileModeRestriction
File mode restriction.
kQ3ErrorInvalidHexString
Invalid hex string.
kQ3ErrorWroteMoreThanSize
Wrote more than size.
kQ3ErrorWroteLessThanSize
Wrote less than size.
kQ3ErrorReadLessThanSize
Read less than size.
kQ3ErrorReadMoreThanSize
Read more than size.
kQ3ErrorNoBeginGroup
No begin group.
kQ3ErrorSizeMismatch
Size mismatch.
kQ3ErrorStringExceedsMaximumLength
String exceeds maximum length.
kQ3ErrorValueExceedsMaximumSize
Value exceeds maximum size.
kQ3ErrorNonUniqueLabel
Non unique label.
kQ3ErrorEndOfContainer
End of container.
kQ3ErrorUnmatchedEndGroup
Unmatched end group.
kQ3ErrorFileVersionExists
File version exists.
kQ3ErrorViewNotStarted
View not started.
kQ3ErrorViewIsStarted
View is started.
kQ3ErrorRendererNotSet
Renderer not set.
kQ3ErrorRenderingIsActive
Rendering is active.
kQ3ErrorImmediateModeUnderflow
Immediate mode underflow.
kQ3ErrorDisplayNotSet
Display not set.
kQ3ErrorCameraNotSet
Camera not set.
kQ3ErrorDrawContextNotSet
Draw context not set.
kQ3ErrorNonInvertibleMatrix
Non invertible matrix.
kQ3ErrorRenderingNotStarted
Rendering not started.
kQ3ErrorPickingNotStarted
Picking not started.
kQ3ErrorBoundsNotStarted
Bounds not started.
kQ3ErrorDataNotAvailable
Data not available.
kQ3ErrorNothingToPop
Nothing to pop.
kQ3ErrorUnknownStudioType
Unknown studio type.
kQ3ErrorAlreadyRendering
Already rendering.
kQ3ErrorStartGroupRange
Start group range.
kQ3ErrorUnsupportedGeometryType
Unsupported geometry type.
kQ3ErrorInvalidGeometryType
Invalid geometry type.
kQ3ErrorUnsupportedFunctionality
Unsupported functionality.
kQ3ErrorInvalidPositionForGroup
Invalid position for group.
kQ3ErrorInvalidObjectForGroup
Invalid object for group.
kQ3ErrorInvalidObjectForPosition
Invalid object for position.
kQ3ErrorScaleOfZero
Scale of zero.
kQ3ErrorBadStringType
Bad string type.
kQ3ErrorAttributeNotContained
Attribute not contained.
kQ3ErrorAttributeInvalidType
Attribute invalid type.
kQ3ErrorInvalidCameraValues
Invalid camera values.
kQ3ErrorBadDrawContextType
Bad draw context type.
kQ3ErrorBadDrawContextFlag
Bad draw context flag.
kQ3ErrorBadDrawContext
Bad draw context.
kQ3ErrorUnsupportedPixelDepth
Unsupported pixel depth.
kQ3ErrorController
Controller error.
kQ3ErrorTracker
Tracker error.
kQ3ErrorWin32Error
Windows error.
kQ3ErrorTypeAlreadyExistsAndHasSubclasses
Type already exists and has subclasses.
kQ3ErrorTypeAlreadyExistsAndOtherClassesDependOnIt
Type already exists and other classes depend on it.
kQ3ErrorTypeAlreadyExistsAndHasObjectInstances
Type already exists and has object instances.
kQ3ErrorPickingLoopFailed
Picking loop failed.
kQ3ErrorRenderingLoopFailed
Rendering loop failed.
kQ3ErrorWritingLoopFailed
Writing loop failed.
kQ3ErrorBoundingLoopFailed
Bounding loop failed.
kQ3ErrorPlatformError
Platform-specific error. Not available in QD3D.
kQ3ErrorInfiniteRationalPoint
Infinite rational point. Not available in QD3D.

TQ3Notice


typedef enum {
    kQ3NoticeNone                               = 0,
    kQ3NoticeFirst                              = -28100,
    kQ3NoticeDataAlreadyEmpty                   = -28100,
    kQ3NoticeMethodNotSupported                 = -28099,
    kQ3NoticeObjectAlreadySet                   = -28098,
    kQ3NoticeParameterOutOfRange                = -28097,
    kQ3NoticeFileAliasWasChanged                = -28096,
    kQ3NoticeMeshVertexHasNoComponent           = -28095,
    kQ3NoticeMeshInvalidVertexFacePair          = -28094,
    kQ3NoticeMeshEdgeVertexDoNotCorrespond      = -28093,
    kQ3NoticeMeshEdgeIsNotBoundary              = -28092,
    kQ3NoticeDrawContextNotSetUsingInternalDefaults         = -28091,
    kQ3NoticeInvalidAttenuationTypeUsingInternalDefaults    = -28090,
    kQ3NoticeBrightnessGreaterThanOne           = -28089,
    kQ3NoticeScaleContainsZeroEntries           = -28088,
    kQ3NoticeSystemAlreadyInitialized           = -28087,
    kQ3NoticeViewSyncCalledAgain                = -28086,
    kQ3NoticeFileCancelled                      = -28085,

    kQ3NoticeBrightnessLessThanZero             = -28084,
#endif // QUESA_ALLOW_QD3D_EXTENSIONS

    kQ3NoticeLast,
    kQ3NoticeSize32                             = 0x7FFFFFFF
} TQ3Notice;
Discussion

Quesa notice constants.

Constants

kQ3NoticeNone
No notice.
kQ3NoticeDataAlreadyEmpty
Data already empty.
kQ3NoticeMethodNotSupported
Method not supported.
kQ3NoticeObjectAlreadySet
Object already set.
kQ3NoticeParameterOutOfRange
Parameter out of range.
kQ3NoticeFileAliasWasChanged
File alias was changed.
kQ3NoticeMeshVertexHasNoComponent
Mesh vertex has no component.
kQ3NoticeMeshInvalidVertexFacePair
Mesh invalid vertex face pair.
kQ3NoticeMeshEdgeVertexDoNotCorrespond
Mesh edge vertex do not correspond.
kQ3NoticeMeshEdgeIsNotBoundary
Mesh edge is not boundary.
kQ3NoticeDrawContextNotSetUsingInternalDefaults
Draw context not set using internal defaults.
kQ3NoticeInvalidAttenuationTypeUsingInternalDefaults
Invalid attenuation type using internal defaults.
kQ3NoticeBrightnessGreaterThanOne
Brightness greater than 1.0.
kQ3NoticeScaleContainsZeroEntries
Scale contains zero entries.
kQ3NoticeSystemAlreadyInitialized
System already initialized.
kQ3NoticeViewSyncCalledAgain
View sync called again.
kQ3NoticeFileCancelled
File cancelled.
kQ3NoticeBrightnessLessThanZero
Brightness less than 0.0. Not available in QD3D.

TQ3Warning


typedef enum {
    kQ3WarningNone                              = 0,
    kQ3WarningFirst                             = -28300,
    kQ3WarningInternalException                 = -28300,
    kQ3WarningNoObjectSupportForDuplicateMethod = -28299,
    kQ3WarningNoObjectSupportForDrawMethod      = -28298,
    kQ3WarningNoObjectSupportForWriteMethod     = -28297,
    kQ3WarningNoObjectSupportForReadMethod      = -28296,
    kQ3WarningUnknownElementType                = -28295,
    kQ3WarningTypeAndMethodAlreadyDefined       = -28294,
    kQ3WarningTypeIsOutOfRange                  = -28293,
    kQ3WarningTypeHasNotBeenRegistered          = -28292,
    kQ3WarningVector3DNotUnitLength             = -28291,
    kQ3WarningInvalidSubObjectForObject         = -28290,
    kQ3WarningInvalidHexString                  = -28289,
    kQ3WarningUnknownObject                     = -28288,
    kQ3WarningInvalidMetafileObject             = -28287,
    kQ3WarningUnmatchedBeginGroup               = -28286,
    kQ3WarningUnmatchedEndGroup                 = -28285,
    kQ3WarningInvalidTableOfContents            = -28284,
    kQ3WarningUnresolvableReference             = -28283,
    kQ3WarningNoAttachMethod                    = -28282,
    kQ3WarningInconsistentData                  = -28281,
    kQ3WarningReadLessThanSize                  = -28280,
    kQ3WarningFilePointerResolutionFailed       = -28279,
    kQ3WarningFilePointerRedefined              = -28278,
    kQ3WarningStringExceedsMaximumLength        = -28277,
    kQ3WarningLowMemory                         = -28276,
    kQ3WarningPossibleMemoryLeak                = -28275,
    kQ3WarningViewTraversalInProgress           = -28274,
    kQ3WarningNonInvertibleMatrix               = -28273,
    kQ3WarningQuaternionEntriesAreZero          = -28272,
    kQ3WarningFunctionalityNotSupported         = -28271,
    kQ3WarningInvalidPaneDimensions             = -28270,
    kQ3WarningPickParamOutside                  = -28269,
    kQ3WarningScaleEntriesAllZero               = -28268,
    kQ3WarningScaleContainsNegativeEntries      = -28267,
    kQ3WarningParameterOutOfRange               = -28266,
    kQ3WarningExtensionNotLoading               = -28265,
    kQ3WarningTypeAlreadyRegistered             = -28264,
    kQ3WarningTypeSameVersionAlreadyRegistered  = -28263,
    kQ3WarningTypeNewerVersionAlreadyRegistered = -28262,
    kQ3WarningInvalidObjectInGroupMetafile      = -28261,

  kQ3WarningQuaternionNotNormalized           = -28260,
  kQ3WarningNormalCanNotBeFlipped             = -28259,
  kQ3WarningTriangleNotNormalized             = -28258,
  kQ3WarningVertexNotNormalized               = -28257,
    kQ3WarningReadInfiniteFloatingPointNumber   = -28256,
    kQ3WarningReadBadNormalVector               = -28255,
    kQ3WarningUnsupportedSubdivisionStyle       = -28254,
    kQ3WarningVertexShaderCompileFailed         = -28253,
    kQ3WarningFragmentShaderCompileFailed       = -28252,
    kQ3WarningShaderProgramLinkFailed           = -28251,
    kQ3WarningCannotAcceleratePixmap            = -28250,
    kQ3WarningNoOffscreenHardwareStencil        = -28249,
#endif // QUESA_ALLOW_QD3D_EXTENSIONS

    kQ3WarningLast,
    kQ3WarningSize32                            = 0x7FFFFFFF
} TQ3Warning;
Discussion

Quesa warning constants.

Constants

kQ3WarningNone
No warning.
kQ3WarningInternalException
Internal exception.
kQ3WarningNoObjectSupportForDuplicateMethod
No object support for duplicate method.
kQ3WarningNoObjectSupportForDrawMethod
No object support for draw method.
kQ3WarningNoObjectSupportForWriteMethod
No object support for write method.
kQ3WarningNoObjectSupportForReadMethod
No object support for read method.
kQ3WarningUnknownElementType
Unknown element type.
kQ3WarningTypeAndMethodAlreadyDefined
Type and method already defined.
kQ3WarningTypeIsOutOfRange
Type is out of range.
kQ3WarningTypeHasNotBeenRegistered
Type has not been registered.
kQ3WarningVector3DNotUnitLength
Vector3D not unit length.
kQ3WarningInvalidSubObjectForObject
Invalid sub object for object.
kQ3WarningInvalidHexString
Invalid hex string.
kQ3WarningUnknownObject
Unknown object.
kQ3WarningInvalidMetafileObject
Invalid metafile object.
kQ3WarningUnmatchedBeginGroup
Unmatched begin group.
kQ3WarningUnmatchedEndGroup
Unmatched end group.
kQ3WarningInvalidTableOfContents
Invalid table of contents.
kQ3WarningUnresolvableReference
Unresolvable reference.
kQ3WarningNoAttachMethod
No attach method.
kQ3WarningInconsistentData
Inconsistent data.
kQ3WarningReadLessThanSize
Read less than size.
kQ3WarningFilePointerResolutionFailed
File pointer resolution failed.
kQ3WarningFilePointerRedefined
File pointer redefined.
kQ3WarningStringExceedsMaximumLength
String exceeds maximum length.
kQ3WarningLowMemory
Low memory.
kQ3WarningPossibleMemoryLeak
Possible memory leak.
kQ3WarningViewTraversalInProgress
View traversal in progress.
kQ3WarningNonInvertibleMatrix
Non invertible matrix.
kQ3WarningQuaternionEntriesAreZero
Quaternion entries are zero.
kQ3WarningFunctionalityNotSupported
Functionality not supported.
kQ3WarningInvalidPaneDimensions
Invalid pane dimensions.
kQ3WarningPickParamOutside
Pick param outside.
kQ3WarningScaleEntriesAllZero
Scale entries all zero.
kQ3WarningScaleContainsNegativeEntries
Scale contains negative entries.
kQ3WarningParameterOutOfRange
Parameter out of range.
kQ3WarningExtensionNotLoading
Extension not loading.
kQ3WarningTypeAlreadyRegistered
Type already registered.
kQ3WarningTypeSameVersionAlreadyRegistered
Type same version already registered.
kQ3WarningTypeNewerVersionAlreadyRegistered
Type newer version already registered.
kQ3WarningInvalidObjectInGroupMetafile
Invalid object in group metafile.
kQ3WarningQuaternionNotNormalized
Quaternion is not normalized. Not available in QD3D.
kQ3WarningNormalCanNotBeFlipped
Normal can not be flipped as they would under QD3D. Not available in QD3D.
kQ3WarningTriangleNotNormalized
Triangle normal is not normalized. Not available in QD3D.
kQ3WarningVertexNotNormalized
Vertex normal is not normalized. Not available in QD3D.
kQ3WarningReadInfiniteFloatingPointNumber
Floating-point number read from file was infinite or NaN. Not available in QD3D.
kQ3WarningReadBadNormalVector
A supposed normal vector has components so large or small that it cannot be normalized. Not available in QD3D.
kQ3WarningUnsupportedSubdivisionStyle
A geometry does not support the current subdivision style.
kQ3WarningVertexShaderCompileFailed
Per-pixel lighting failed because the vertex shader did not compile.
kQ3WarningFragmentShaderCompileFailed
Per-pixel lighting is not fully functional because a fragment shader did not compile.
kQ3WarningShaderProgramLinkFailed
Per-pixel lighting failed because the shader program did not link.
kQ3WarningCannotAcceleratePixmap
It was not possible to set up the requested hardware-accelerated offscreen rendering.
kQ3WarningNoOffscreenHardwareStencil
It was not possible to set up a stencil buffer (needed for rendering shadows) in a hardware-accelerated pixmap draw context.

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