|
|
/*
File: QD3DErrors.h Contains: Error API and error codes Version: Technology: Quickdraw 3D 1.6 Release: QuickTime 7.3 Copyright: (c) 2007 (c) 1995-1998 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
/*
* Q3Error_Register() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */EXTERN_API_C( TQ3Status )Q3Error_Register( TQ3ErrorMethod errorPost, long reference);
/*
* Q3Warning_Register() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */EXTERN_API_C( TQ3Status )Q3Warning_Register( TQ3WarningMethod warningPost, long reference);
/*
* Q3Notice_Register() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */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. *//*
* Q3Error_Get() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */EXTERN_API_C( TQ3Error )Q3Error_Get(TQ3Error * firstError);
/*
* Q3Error_IsFatalError() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */EXTERN_API_C( TQ3Boolean )Q3Error_IsFatalError(TQ3Error error);
/*
* Q3Warning_Get() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */EXTERN_API_C( TQ3Warning )Q3Warning_Get(TQ3Warning * firstWarning);
/*
* Q3Notice_Get() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */EXTERN_API_C( TQ3Notice )Q3Notice_Get(TQ3Notice * firstNotice);
#endif /* CALL_NOT_IN_CARBON */
#if TARGET_OS_MAC
#if CALL_NOT_IN_CARBON
/*
* Q3MacintoshError_Get() * * Availability: * Non-Carbon CFM: not available * CarbonLib: not available * Mac OS X: not available */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__ */
|
