topical media & game development
lib-of-vs-libs-QTDevWin-CIncludes-QD3DErrors.h / h
/*
File: QD3DErrors.h
Contains: Error API and error codes
Version: Technology: Quickdraw 3D 1.6
Release: QuickTime 6.0.2
Copyright: (c) 1995-2001 by Apple Computer, Inc., all rights reserved.
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
ifndef __QD3DERRORS__
define __QD3DERRORS__
ifndef __QD3D__
include <QD3D.h>
endif
if TARGET_OS_MAC
ifndef __MACTYPES__
include <MacTypes.h>
endif
endif /* TARGET_OS_MAC */
if PRAGMA_ONCE
#pragma once
endif
ifdef __cplusplus
extern "C" {
endif
if PRAGMA_IMPORT
#pragma import on
endif
if PRAGMA_STRUCT_ALIGN
#pragma options align=power
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
#pragma pack(2)
endif
if PRAGMA_ENUM_ALWAYSINT
#if defined(__fourbyteints__) && !__fourbyteints__
#define __QD3DERRORS__RESTORE_TWOBYTEINTS
#pragma fourbyteints on
#endif
#pragma enumsalwaysint on
#elif PRAGMA_ENUM_OPTIONS
#pragma option enum=int
#elif PRAGMA_ENUM_PACK
#if __option(pack_enums)
#define __QD3DERRORS__RESTORE_PACKED_ENUMS
#pragma options(!pack_enums)
#endif
endif
****************************************************************************
* **
* Error Types and Codes **
* **
***************************************************************************
enum TQ3Error {
kQ3ErrorNone = 0, /* Fatal Errors */
kQ3ErrorInternalError = -28500,
kQ3ErrorNoRecovery = -28499,
kQ3ErrorLastFatalError = -28498, /* System Errors */
kQ3ErrorNotInitialized = -28490,
kQ3ErrorAlreadyInitialized = -28489,
kQ3ErrorUnimplemented = -28488,
kQ3ErrorRegistrationFailed = -28487, /* OS Errors */
kQ3ErrorUnixError = -28486,
kQ3ErrorMacintoshError = -28485,
kQ3ErrorX11Error = -28484, /* Memory Errors */
kQ3ErrorMemoryLeak = -28483,
kQ3ErrorOutOfMemory = -28482, /* Parameter errors */
kQ3ErrorNULLParameter = -28481,
kQ3ErrorParameterOutOfRange = -28480,
kQ3ErrorInvalidParameter = -28479,
kQ3ErrorInvalidData = -28478,
kQ3ErrorAcceleratorAlreadySet = -28477,
kQ3ErrorVector3DNotUnitLength = -28476,
kQ3ErrorVector3DZeroLength = -28475, /* Object Errors */
kQ3ErrorInvalidObject = -28474,
kQ3ErrorInvalidObjectClass = -28473,
kQ3ErrorInvalidObjectType = -28472,
kQ3ErrorInvalidObjectName = -28471,
kQ3ErrorObjectClassInUse = -28470,
kQ3ErrorAccessRestricted = -28469,
kQ3ErrorMetaHandlerRequired = -28468,
kQ3ErrorNeedRequiredMethods = -28467,
kQ3ErrorNoSubClassType = -28466,
kQ3ErrorUnknownElementType = -28465,
kQ3ErrorNotSupported = -28464, /* Extension Errors */
kQ3ErrorNoExtensionsFolder = -28463,
kQ3ErrorExtensionError = -28462,
kQ3ErrorPrivateExtensionError = -28461, /* Geometry Errors */
kQ3ErrorDegenerateGeometry = -28460,
kQ3ErrorGeometryInsufficientNumberOfPoints = -28459, /* IO Errors */
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, /* View errors */
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, /* Renderer Errors */
kQ3ErrorUnknownStudioType = -28405,
kQ3ErrorAlreadyRendering = -28404,
kQ3ErrorStartGroupRange = -28403,
kQ3ErrorUnsupportedGeometryType = -28402,
kQ3ErrorInvalidGeometryType = -28401,
kQ3ErrorUnsupportedFunctionality = -28400, /* Group Errors */
kQ3ErrorInvalidPositionForGroup = -28399,
kQ3ErrorInvalidObjectForGroup = -28398,
kQ3ErrorInvalidObjectForPosition = -28397, /* Transform Errors */
kQ3ErrorScaleOfZero = -28396, /* String Errors */
kQ3ErrorBadStringType = -28395, /* Attribute Errors */
kQ3ErrorAttributeNotContained = -28394,
kQ3ErrorAttributeInvalidType = -28393, /* Camera Errors */
kQ3ErrorInvalidCameraValues = -28392, /* DrawContext Errors */
kQ3ErrorBadDrawContextType = -28391,
kQ3ErrorBadDrawContextFlag = -28390,
kQ3ErrorBadDrawContext = -28389,
kQ3ErrorUnsupportedPixelDepth = -28388, /* Controller Errors */
kQ3ErrorController = -28387, /* Tracker Errors */
kQ3ErrorTracker = -28386, /* Another OS Error */
kQ3ErrorWin32Error = -28385, /* Object Errors */
kQ3ErrorTypeAlreadyExistsAndHasSubclasses = -28384,
kQ3ErrorTypeAlreadyExistsAndOtherClassesDependOnIt = -28383,
kQ3ErrorTypeAlreadyExistsAndHasObjectInstances = -28382, /* submit loop errors: if you ever get one of these check the previous*/
/* error posted, it may be kQ3ErrorOutOfMemory. If so you *may* be able*/
/* to recover by freeing up some memory and trying again*/
kQ3ErrorPickingLoopFailed = -28381,
kQ3ErrorRenderingLoopFailed = -28380,
kQ3ErrorWritingLoopFailed = -28379,
kQ3ErrorBoundingLoopFailed = -28378
};
typedef enum TQ3Error TQ3Error;
enum TQ3Warning {
kQ3WarningNone = 0, /* General System */
kQ3WarningInternalException = -28300, /* Object Warnings */
kQ3WarningNoObjectSupportForDuplicateMethod = -28299,
kQ3WarningNoObjectSupportForDrawMethod = -28298,
kQ3WarningNoObjectSupportForWriteMethod = -28297,
kQ3WarningNoObjectSupportForReadMethod = -28296,
kQ3WarningUnknownElementType = -28295,
kQ3WarningTypeAndMethodAlreadyDefined = -28294,
kQ3WarningTypeIsOutOfRange = -28293,
kQ3WarningTypeHasNotBeenRegistered = -28292, /* Parameter Warnings */
kQ3WarningVector3DNotUnitLength = -28291, /* IO Warnings */
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, /* Memory Warnings */
kQ3WarningLowMemory = -28276,
kQ3WarningPossibleMemoryLeak = -28275, /* View Warnings */
kQ3WarningViewTraversalInProgress = -28274,
kQ3WarningNonInvertibleMatrix = -28273, /* Quaternion Warning */
kQ3WarningQuaternionEntriesAreZero = -28272, /* Renderer Warning */
kQ3WarningFunctionalityNotSupported = -28271, /* DrawContext Warning */
kQ3WarningInvalidPaneDimensions = -28270, /* Pick Warning */
kQ3WarningPickParamOutside = -28269, /* Scale Warnings */
kQ3WarningScaleEntriesAllZero = -28268,
kQ3WarningScaleContainsNegativeEntries = -28267, /* Generic Warnings */
kQ3WarningParameterOutOfRange = -28266, /* Extension Warnings */
kQ3WarningExtensionNotLoading = -28265, /* Object Warnings */
kQ3WarningTypeAlreadyRegistered = -28264,
kQ3WarningTypeSameVersionAlreadyRegistered = -28263,
kQ3WarningTypeNewerVersionAlreadyRegistered = -28262, /* Invalid Group Object */
kQ3WarningInvalidObjectInGroupMetafile = -28261
};
typedef enum TQ3Warning TQ3Warning;
enum TQ3Notice {
kQ3NoticeNone = 0,
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
};
typedef enum TQ3Notice TQ3Notice;
typedef CALLBACK_API_C( void , TQ3ErrorMethod )(TQ3Error firstError, TQ3Error lastError, long reference);
typedef CALLBACK_API_C( void , TQ3WarningMethod )(TQ3Warning firstWarning, TQ3Warning lastWarning, long reference);
typedef CALLBACK_API_C( void , TQ3NoticeMethod )(TQ3Notice firstNotice, TQ3Notice lastNotice, long reference);
****************************************************************************
* **
* Error Routines **
* **
***************************************************************************
if CALL_NOT_IN_CARBON
EXTERN_API_C( TQ3Status )
Q3Error_Register (TQ3ErrorMethod errorPost,
long reference);
EXTERN_API_C( TQ3Status )
Q3Warning_Register (TQ3WarningMethod warningPost,
long reference);
EXTERN_API_C( TQ3Status )
Q3Notice_Register (TQ3NoticeMethod noticePost,
long reference);
/*
* Getting error codes -
* Clears error type on next entry into system (except all of these
* error calls), and returns the last error, and optionally the
* first error. The parameter to these "_Get" calls may be NULL.
*/
EXTERN_API_C( TQ3Error )
Q3Error_Get (TQ3Error * firstError);
EXTERN_API_C( TQ3Boolean )
Q3Error_IsFatalError (TQ3Error error);
EXTERN_API_C( TQ3Warning )
Q3Warning_Get (TQ3Warning * firstWarning);
EXTERN_API_C( TQ3Notice )
Q3Notice_Get (TQ3Notice * firstNotice);
endif /* CALL_NOT_IN_CARBON */
if TARGET_OS_MAC
if CALL_NOT_IN_CARBON
EXTERN_API_C( OSErr )
Q3MacintoshError_Get (OSErr * firstMacErr);
endif /* CALL_NOT_IN_CARBON */
endif /* TARGET_OS_MAC */
if PRAGMA_ENUM_ALWAYSINT
#pragma enumsalwaysint reset
#ifdef __QD3DERRORS__RESTORE_TWOBYTEINTS
#pragma fourbyteints off
#endif
#elif PRAGMA_ENUM_OPTIONS
#pragma option enum=reset
#elif defined(__QD3DERRORS__RESTORE_PACKED_ENUMS)
#pragma options(pack_enums)
endif
if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
#pragma pack()
endif
ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
endif
ifdef __cplusplus
}
endif
endif /* __QD3DERRORS__ */
(C) Æliens
04/09/2009
You may not copy or print any of this material without explicit permission of the author or the publisher.
In case of other copyright issues, contact the author.
