开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
QD3DIO.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：32k
源码类别：

多媒体编程

开发平台：

Visual C++

QD3DIO.h：源码内容
  1. /*
  2.      File:       QD3DIO.h
  3.  
  4.      Contains:   QuickDraw 3D IO API
  5.  
  6.      Version:    Technology: Quickdraw 3D 1.6
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1995-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __QD3DIO__
  18. #define __QD3DIO__
  20. #ifndef __QD3D__
  21. #include "QD3D.h"
  22. #endif
  25. #ifndef __QD3DDRAWCONTEXT__
  26. #include "QD3DDrawContext.h"
  27. #endif
  29. #ifndef __QD3DVIEW__
  30. #include "QD3DView.h"
  31. #endif
  36. #if PRAGMA_ONCE
  37. #pragma once
  38. #endif
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  44. #if PRAGMA_IMPORT
  45. #pragma import on
  46. #endif
  48. #if PRAGMA_STRUCT_ALIGN
  49.     #pragma options align=power
  50. #elif PRAGMA_STRUCT_PACKPUSH
  51.     #pragma pack(push, 2)
  52. #elif PRAGMA_STRUCT_PACK
  53.     #pragma pack(2)
  54. #endif
  56. #if PRAGMA_ENUM_ALWAYSINT
  57.     #if defined(__fourbyteints__) && !__fourbyteints__ 
  58.         #define __QD3DIO__RESTORE_TWOBYTEINTS
  59.         #pragma fourbyteints on
  60.     #endif
  61.     #pragma enumsalwaysint on
  62. #elif PRAGMA_ENUM_OPTIONS
  63.     #pragma option enum=int
  64. #elif PRAGMA_ENUM_PACK
  65.     #if __option(pack_enums)
  66.         #define __QD3DIO__RESTORE_PACKED_ENUMS
  67.         #pragma options(!pack_enums)
  68.     #endif
  69. #endif
  71. /******************************************************************************
  72.  **                                                                          **
  73.  **                                 Basic Types                              **                                                 
  74.  **                                                                          **
  75.  *****************************************************************************/
  76. typedef unsigned char                   TQ3Uns8;
  77. typedef signed char                     TQ3Int8;
  78. typedef unsigned short                  TQ3Uns16;
  79. typedef signed short                    TQ3Int16;
  80. typedef unsigned long                   TQ3Uns32;
  81. typedef signed long                     TQ3Int32;
  82. #if TARGET_RT_BIG_ENDIAN
  84. struct TQ3Uns64 {
  85.     unsigned long                   hi;
  86.     unsigned long                   lo;
  87. };
  88. typedef struct TQ3Uns64                 TQ3Uns64;
  90. struct TQ3Int64 {
  91.     signed long                     hi;
  92.     unsigned long                   lo;
  93. };
  94. typedef struct TQ3Int64                 TQ3Int64;
  95. #else
  97. struct TQ3Uns64 {
  98.     unsigned long                   lo;
  99.     unsigned long                   hi;
  100. };
  101. typedef struct TQ3Uns64                 TQ3Uns64;
  103. struct TQ3Int64 {
  104.     unsigned long                   lo;
  105.     signed long                     hi;
  106. };
  107. typedef struct TQ3Int64                 TQ3Int64;
  108. #endif  /* TARGET_RT_BIG_ENDIAN */
  111. typedef float                           TQ3Float32;
  112. typedef double                          TQ3Float64;
  113. typedef TQ3Uns32                        TQ3Size;
  114. /******************************************************************************
  115.  **                                                                          **
  116.  **                                 File Types                               **
  117.  **                                                                          **
  118.  *****************************************************************************/
  120. enum TQ3FileModeMasks {
  121.     kQ3FileModeNormal           = 0,
  122.     kQ3FileModeStream           = 1 << 0,
  123.     kQ3FileModeDatabase         = 1 << 1,
  124.     kQ3FileModeText             = 1 << 2
  125. };
  126. typedef enum TQ3FileModeMasks TQ3FileModeMasks;
  128. typedef unsigned long                   TQ3FileMode;
  129. /******************************************************************************
  130.  **                                                                          **
  131.  **                                 Method Types                             **
  132.  **                                                                          **
  133.  *****************************************************************************/
  134. /*
  135.  *  IO Methods
  136.  *
  137.  *  The IO system treats all objects as groups of typed information.
  138.  *  When you register your element or attribute, the "elementType" is the 
  139.  *  binary type of your object, the "elementName" the ascii type.
  140.  *  
  141.  *  All objects in the metafile are made up of a "root" or parent object which
  142.  *  defines the instantiated object type. You may define the format of your 
  143.  *  data any way you wish as long as you use the primitives types above and the
  144.  *  routines below.
  145.  *
  146.  *  Root Objects are often appended with additional child objects, called 
  147.  *  subobjects. You may append your object with other QuickDraw 3D objects.
  148.  *  
  149.  *  Writing is straightforward: an object traverses itself any other objects 
  150.  *  that make it up, then writes its own data. Writing uses two methods: 
  151.  *  TQ3XObjectTraverseMethod and TQ3XObjectWriteMethod.
  152.  *
  153.  *  The TQ3XObjectTraverseMethod method should:
  154.  *  + First, Determine if the data should be written 
  155.  *      - if you don't want to write out your object after examining your
  156.  *          data, return kQ3Success in your Traverse method without calling
  157.  *          any other submit calls.
  158.  *  + Next, calculate the size of your object on disk
  159.  *  + Gather whatever state from the view you need to preserve
  160.  *      - you may access the view state NOW, as the state of the
  161.  *          view duing your TQ3XObjectWriteMethod will not be valid. You may
  162.  *          pass a temporary buffer to your write method.
  163.  *  + Submit your view write data using Q3View_SubmitWriteData
  164.  *      - note that you MUST call this before any other "_Submit" call.
  165.  *      - you may pass in a "deleteMethod" for your data. This method
  166.  *          will be called whether or not your write method succeeds or fails.
  167.  *  + Submit your subobjects to the view
  168.  *  
  169.  *  The TQ3XObjectWriteMethod method should:
  170.  *  + Write your data format to the file using the primitives routines below.
  171.  *      - If you passed a "deleteMethod" in your Q3View_SubmitWriteData, that
  172.  *          method will be called upon exit of your write method.
  173.  *
  174.  *  Reading is less straightforward because your root object and
  175.  *  any subobjects must be read inside of your TQ3XObjectReadDataMethod. There 
  176.  *  is an implicit state contained in the file while reading, which you must 
  177.  *  be aware of. When you first enter the read method, you must physically 
  178.  *  read in your data format using the primitives routines until
  179.  *  
  180.  *  Q3File_IsEndOfData(file) == kQ3True
  181.  *  
  182.  *  Generally, your data format should be self-descriptive such that you do not
  183.  *  need to call Q3File_IsEndOfData to determine if you are done reading. 
  184.  *  However, this call is useful for determining zero-sized object or 
  185.  *  determining the end of an object's data.
  186.  *  
  187.  *  Once you have read in all the data, you may collect subobjects. A metafile
  188.  *  object ONLY has subobjects if it is in a container. The call
  189.  *  
  190.  *  Q3File_IsEndOfContainer(file)
  191.  *  
  192.  *  returns kQ3False if subobjects exist, and kQ3True if subobjects do not 
  193.  *  exist.
  194.  *  
  195.  *  At this point, you may use
  196.  *  
  197.  *  Q3File_GetNextObjectType
  198.  *  Q3File_IsNextObjectOfType
  199.  *  Q3File_ReadObject
  200.  *  Q3File_SkipObject
  201.  *  
  202.  *  to iterate through the subobjects until Q3File_IsEndOfContainer(file) 
  203.  *  is kQ3True.
  204.  * 
  205.  */
  207. /*
  208.  * IO Methods
  209.  */
  210. enum {
  211.     kQ3XMethodTypeObjectFileVersion = FOUR_CHAR_CODE('vers'),   /* version */
  212.     kQ3XMethodTypeObjectTraverse = FOUR_CHAR_CODE('trvs'),      /* byte count */
  213.     kQ3XMethodTypeObjectTraverseData = FOUR_CHAR_CODE('trvd'),  /* byte count */
  214.     kQ3XMethodTypeObjectWrite   = FOUR_CHAR_CODE('writ'),       /* Dump info to file */
  215.     kQ3XMethodTypeObjectReadData = FOUR_CHAR_CODE('rddt'),      /* Read info from file into buffer or, attach read data to parent */
  216.     kQ3XMethodTypeObjectRead    = FOUR_CHAR_CODE('read'),
  217.     kQ3XMethodTypeObjectAttach  = FOUR_CHAR_CODE('attc')
  218. };
  220. /*
  221.  *  TQ3XObjectTraverseMethod
  222.  *
  223.  *  For "elements" (meaning "attributes, too), you will be passed NULL for 
  224.  *  object. Sorry, custom objects will be available in the next major revision.
  225.  *
  226.  *  The "data" is a pointer to your internal element data.
  227.  *
  228.  *  The view is the current traversal view.
  229.  */
  230. typedef CALLBACK_API_C( TQ3Status , TQ3XObjectTraverseMethod )(TQ3Object object, void *data, TQ3ViewObject view);
  231. /*
  232.  *  TQ3XObjectTraverseDataMethod
  233.  */
  234. typedef CALLBACK_API_C( TQ3Status , TQ3XObjectTraverseDataMethod )(TQ3Object object, void *data, TQ3ViewObject view);
  235. /*
  236.  *  TQ3XObjectWriteMethod
  237.  */
  238. typedef CALLBACK_API_C( TQ3Status , TQ3XObjectWriteMethod )(const void *object, TQ3FileObject theFile);
  239. /*
  240.  *  Custom object writing 
  241.  */
  242. typedef CALLBACK_API_C( void , TQ3XDataDeleteMethod )(void *data);
  243. #if CALL_NOT_IN_CARBON
  244. EXTERN_API_C( TQ3Status )
  245. Q3XView_SubmitWriteData         (TQ3ViewObject          view,
  246.                                  TQ3Size                size,
  247.                                  void *                 data,
  248.                                  TQ3XDataDeleteMethod   deleteData);
  250. EXTERN_API_C( TQ3Status )
  251. Q3XView_SubmitSubObjectData     (TQ3ViewObject          view,
  252.                                  TQ3XObjectClass        objectClass,
  253.                                  unsigned long          size,
  254.                                  void *                 data,
  255.                                  TQ3XDataDeleteMethod   deleteData);
  257. /*
  258.  *  TQ3XObjectReadMethod
  259.  */
  260. #endif  /* CALL_NOT_IN_CARBON */
  262. typedef CALLBACK_API_C( TQ3Object , TQ3XObjectReadMethod )(TQ3FileObject theFile);
  263. /*
  264.  *  TQ3XObjectReadDataMethod
  265.  *
  266.  *  For "elements" (meaning "attributes", too), you must allocate stack space 
  267.  *  and call Q3Set_Add on "parentObject", which is an TQ3SetObject.
  268.  *
  269.  *  Otherwise, parentObject is whatever object your element is a subobject of...
  270.  */
  271. typedef CALLBACK_API_C( TQ3Status , TQ3XObjectReadDataMethod )(TQ3Object parentObject, TQ3FileObject theFile);
  272. /*
  273.  *  TQ3XObjectAttachMethod
  274.  */
  275. typedef CALLBACK_API_C( TQ3Status , TQ3XObjectAttachMethod )(TQ3Object childObject, TQ3Object parentObject);
  278. /******************************************************************************
  279.  **                                                                          **
  280.  **                             Versioning                                   **
  281.  **                                                                          **
  282.  *****************************************************************************/
  284. #define Q3FileVersion(majorVersion, minorVersion)  (TQ3FileVersion) 
  285.  ((((TQ3Uns32) majorVersion & 0xFFFF) << 16) | ((TQ3Uns32) minorVersion & 0xFFFF))
  287. typedef unsigned long                   TQ3FileVersion;
  288. #define kQ3FileVersionCurrent   Q3FileVersion(1,6)
  290. /******************************************************************************
  291.  **                                                                          **
  292.  **                             File Routines                                **
  293.  **                                                                          **
  294.  *****************************************************************************/
  295. /*
  296.  * Creation and accessors
  297.  */
  298. #if CALL_NOT_IN_CARBON
  299. EXTERN_API_C( TQ3FileObject )
  300. Q3File_New                      (void);
  302. EXTERN_API_C( TQ3Status )
  303. Q3File_GetStorage               (TQ3FileObject          theFile,
  304.                                  TQ3StorageObject *     storage);
  306. EXTERN_API_C( TQ3Status )
  307. Q3File_SetStorage               (TQ3FileObject          theFile,
  308.                                  TQ3StorageObject       storage);
  310. /*
  311.  * Opening, and accessing "open" state, closing/cancelling
  312.  */
  313. EXTERN_API_C( TQ3Status )
  314. Q3File_OpenRead                 (TQ3FileObject          theFile,
  315.                                  TQ3FileMode *          mode);
  317. EXTERN_API_C( TQ3Status )
  318. Q3File_OpenWrite                (TQ3FileObject          theFile,
  319.                                  TQ3FileMode            mode);
  321. EXTERN_API_C( TQ3Status )
  322. Q3File_IsOpen                   (TQ3FileObject          theFile,
  323.                                  TQ3Boolean *           isOpen);
  325. EXTERN_API_C( TQ3Status )
  326. Q3File_GetMode                  (TQ3FileObject          theFile,
  327.                                  TQ3FileMode *          mode);
  329. EXTERN_API_C( TQ3Status )
  330. Q3File_GetVersion               (TQ3FileObject          theFile,
  331.                                  TQ3FileVersion *       version);
  333. EXTERN_API_C( TQ3Status )
  334. Q3File_Close                    (TQ3FileObject          theFile);
  336. EXTERN_API_C( TQ3Status )
  337. Q3File_Cancel                   (TQ3FileObject          theFile);
  339. /*
  340.  * Writing (Application)
  341.  */
  342. EXTERN_API_C( TQ3Status )
  343. Q3View_StartWriting             (TQ3ViewObject          view,
  344.                                  TQ3FileObject          theFile);
  346. EXTERN_API_C( TQ3ViewStatus )
  347. Q3View_EndWriting               (TQ3ViewObject          view);
  349. /*
  350.  * Reading (Application)
  351.  */
  352. EXTERN_API_C( TQ3ObjectType )
  353. Q3File_GetNextObjectType        (TQ3FileObject          theFile);
  355. EXTERN_API_C( TQ3Boolean )
  356. Q3File_IsNextObjectOfType       (TQ3FileObject          theFile,
  357.                                  TQ3ObjectType          ofType);
  359. EXTERN_API_C( TQ3Object )
  360. Q3File_ReadObject               (TQ3FileObject          theFile);
  362. EXTERN_API_C( TQ3Status )
  363. Q3File_SkipObject               (TQ3FileObject          theFile);
  365. EXTERN_API_C( TQ3Boolean )
  366. Q3File_IsEndOfData              (TQ3FileObject          theFile);
  368. EXTERN_API_C( TQ3Boolean )
  369. Q3File_IsEndOfContainer         (TQ3FileObject          theFile,
  370.                                  TQ3Object              rootObject);
  372. EXTERN_API_C( TQ3Boolean )
  373. Q3File_IsEndOfFile              (TQ3FileObject          theFile);
  375. /*    
  376.  *  External file references
  377.  */
  378. EXTERN_API_C( TQ3Status )
  379. Q3File_MarkAsExternalReference  (TQ3FileObject          theFile,
  380.                                  TQ3SharedObject        sharedObject);
  382. EXTERN_API_C( TQ3GroupObject )
  383. Q3File_GetExternalReferences    (TQ3FileObject          theFile);
  385. /*    
  386.  *  Tracking editing in read-in objects with custom elements
  387.  */
  388. EXTERN_API_C( TQ3Status )
  389. Q3Shared_ClearEditTracking      (TQ3SharedObject        sharedObject);
  391. EXTERN_API_C( TQ3Boolean )
  392. Q3Shared_GetEditTrackingState   (TQ3SharedObject        sharedObject);
  394. /*    
  395.  *  Reading objects inside a group one-by-one
  396.  */
  397. #endif  /* CALL_NOT_IN_CARBON */
  400. enum TQ3FileReadGroupStateMasks {
  401.     kQ3FileReadWholeGroup       = 0,
  402.     kQ3FileReadObjectsInGroup   = 1 << 0,
  403.     kQ3FileCurrentlyInsideGroup = 1 << 1
  404. };
  405. typedef enum TQ3FileReadGroupStateMasks TQ3FileReadGroupStateMasks;
  407. typedef unsigned long                   TQ3FileReadGroupState;
  408. #if CALL_NOT_IN_CARBON
  409. EXTERN_API_C( TQ3Status )
  410. Q3File_SetReadInGroup           (TQ3FileObject          theFile,
  411.                                  TQ3FileReadGroupState  readGroupState);
  413. EXTERN_API_C( TQ3Status )
  414. Q3File_GetReadInGroup           (TQ3FileObject          theFile,
  415.                                  TQ3FileReadGroupState * readGroupState);
  418. /*
  419.  * Idling
  420.  */
  421. #endif  /* CALL_NOT_IN_CARBON */
  423. typedef CALLBACK_API_C( TQ3Status , TQ3FileIdleMethod )(TQ3FileObject theFile, const void *idlerData);
  424. #if CALL_NOT_IN_CARBON
  425. EXTERN_API_C( TQ3Status )
  426. Q3File_SetIdleMethod            (TQ3FileObject          theFile,
  427.                                  TQ3FileIdleMethod      idle,
  428.                                  const void *           idleData);
  431. /******************************************************************************
  432.  **                                                                          **
  433.  **                             Primitives Routines                          **
  434.  **                                                                          **
  435.  *****************************************************************************/
  436. EXTERN_API_C( TQ3Status )
  437. Q3NewLine_Write                 (TQ3FileObject          theFile);
  439. EXTERN_API_C( TQ3Status )
  440. Q3Uns8_Read                     (TQ3Uns8 *              data,
  441.                                  TQ3FileObject          theFile);
  443. EXTERN_API_C( TQ3Status )
  444. Q3Uns8_Write                    (TQ3Uns8                data,
  445.                                  TQ3FileObject          theFile);
  447. EXTERN_API_C( TQ3Status )
  448. Q3Uns16_Read                    (TQ3Uns16 *             data,
  449.                                  TQ3FileObject          theFile);
  451. EXTERN_API_C( TQ3Status )
  452. Q3Uns16_Write                   (TQ3Uns16               data,
  453.                                  TQ3FileObject          theFile);
  455. EXTERN_API_C( TQ3Status )
  456. Q3Uns32_Read                    (TQ3Uns32 *             data,
  457.                                  TQ3FileObject          theFile);
  459. EXTERN_API_C( TQ3Status )
  460. Q3Uns32_Write                   (TQ3Uns32               data,
  461.                                  TQ3FileObject          theFile);
  463. EXTERN_API_C( TQ3Status )
  464. Q3Int8_Read                     (TQ3Int8 *              data,
  465.                                  TQ3FileObject          theFile);
  467. EXTERN_API_C( TQ3Status )
  468. Q3Int8_Write                    (TQ3Int8                data,
  469.                                  TQ3FileObject          theFile);
  471. EXTERN_API_C( TQ3Status )
  472. Q3Int16_Read                    (TQ3Int16 *             data,
  473.                                  TQ3FileObject          theFile);
  475. EXTERN_API_C( TQ3Status )
  476. Q3Int16_Write                   (TQ3Int16               data,
  477.                                  TQ3FileObject          theFile);
  479. EXTERN_API_C( TQ3Status )
  480. Q3Int32_Read                    (TQ3Int32 *             data,
  481.                                  TQ3FileObject          theFile);
  483. EXTERN_API_C( TQ3Status )
  484. Q3Int32_Write                   (TQ3Int32               data,
  485.                                  TQ3FileObject          theFile);
  487. EXTERN_API_C( TQ3Status )
  488. Q3Uns64_Read                    (TQ3Uns64 *             data,
  489.                                  TQ3FileObject          theFile);
  491. EXTERN_API_C( TQ3Status )
  492. Q3Uns64_Write                   (TQ3Uns64               data,
  493.                                  TQ3FileObject          theFile);
  495. EXTERN_API_C( TQ3Status )
  496. Q3Int64_Read                    (TQ3Int64 *             data,
  497.                                  TQ3FileObject          theFile);
  499. EXTERN_API_C( TQ3Status )
  500. Q3Int64_Write                   (TQ3Int64               data,
  501.                                  TQ3FileObject          theFile);
  503. EXTERN_API_C( TQ3Status )
  504. Q3Float32_Read                  (TQ3Float32 *           data,
  505.                                  TQ3FileObject          theFile);
  507. EXTERN_API_C( TQ3Status )
  508. Q3Float32_Write                 (TQ3Float32             data,
  509.                                  TQ3FileObject          theFile);
  511. EXTERN_API_C( TQ3Status )
  512. Q3Float64_Read                  (TQ3Float64 *           data,
  513.                                  TQ3FileObject          theFile);
  515. EXTERN_API_C( TQ3Status )
  516. Q3Float64_Write                 (TQ3Float64             data,
  517.                                  TQ3FileObject          theFile);
  519. EXTERN_API_C( TQ3Size )
  520. Q3Size_Pad                      (TQ3Size                size);
  522. /*
  523.  * Pass a pointer to a buffer of kQ3StringMaximumLength bytes
  524.  */
  525. EXTERN_API_C( TQ3Status )
  526. Q3String_Read                   (char *                 data,
  527.                                  unsigned long *        length,
  528.                                  TQ3FileObject          theFile);
  530. EXTERN_API_C( TQ3Status )
  531. Q3String_Write                  (const char *           data,
  532.                                  TQ3FileObject          theFile);
  534. /* 
  535.  * This call will read Q3Size_Pad(size) bytes,
  536.  *  but only place size bytes into data.
  537.  */
  538. EXTERN_API_C( TQ3Status )
  539. Q3RawData_Read                  (unsigned char *        data,
  540.                                  unsigned long          size,
  541.                                  TQ3FileObject          theFile);
  543. /* 
  544.  * This call will write Q3Size_Pad(size) bytes,
  545.  *  adding 0's to pad to the nearest 4 byte boundary.
  546.  */
  547. EXTERN_API_C( TQ3Status )
  548. Q3RawData_Write                 (const unsigned char *  data,
  549.                                  unsigned long          size,
  550.                                  TQ3FileObject          theFile);
  552. /******************************************************************************
  553.  **                                                                          **
  554.  **                     Convenient Primitives Routines                       **
  555.  **                                                                          **
  556.  *****************************************************************************/
  557. EXTERN_API_C( TQ3Status )
  558. Q3Point2D_Read                  (TQ3Point2D *           point2D,
  559.                                  TQ3FileObject          theFile);
  561. EXTERN_API_C( TQ3Status )
  562. Q3Point2D_Write                 (const TQ3Point2D *     point2D,
  563.                                  TQ3FileObject          theFile);
  565. EXTERN_API_C( TQ3Status )
  566. Q3Point3D_Read                  (TQ3Point3D *           point3D,
  567.                                  TQ3FileObject          theFile);
  569. EXTERN_API_C( TQ3Status )
  570. Q3Point3D_Write                 (const TQ3Point3D *     point3D,
  571.                                  TQ3FileObject          theFile);
  573. EXTERN_API_C( TQ3Status )
  574. Q3RationalPoint3D_Read          (TQ3RationalPoint3D *   point3D,
  575.                                  TQ3FileObject          theFile);
  577. EXTERN_API_C( TQ3Status )
  578. Q3RationalPoint3D_Write         (const TQ3RationalPoint3D * point3D,
  579.                                  TQ3FileObject          theFile);
  581. EXTERN_API_C( TQ3Status )
  582. Q3RationalPoint4D_Read          (TQ3RationalPoint4D *   point4D,
  583.                                  TQ3FileObject          theFile);
  585. EXTERN_API_C( TQ3Status )
  586. Q3RationalPoint4D_Write         (const TQ3RationalPoint4D * point4D,
  587.                                  TQ3FileObject          theFile);
  589. EXTERN_API_C( TQ3Status )
  590. Q3Vector2D_Read                 (TQ3Vector2D *          vector2D,
  591.                                  TQ3FileObject          theFile);
  593. EXTERN_API_C( TQ3Status )
  594. Q3Vector2D_Write                (const TQ3Vector2D *    vector2D,
  595.                                  TQ3FileObject          theFile);
  597. EXTERN_API_C( TQ3Status )
  598. Q3Vector3D_Read                 (TQ3Vector3D *          vector3D,
  599.                                  TQ3FileObject          theFile);
  601. EXTERN_API_C( TQ3Status )
  602. Q3Vector3D_Write                (const TQ3Vector3D *    vector3D,
  603.                                  TQ3FileObject          theFile);
  605. EXTERN_API_C( TQ3Status )
  606. Q3Matrix4x4_Read                (TQ3Matrix4x4 *         matrix4x4,
  607.                                  TQ3FileObject          theFile);
  609. EXTERN_API_C( TQ3Status )
  610. Q3Matrix4x4_Write               (const TQ3Matrix4x4 *   matrix4x4,
  611.                                  TQ3FileObject          theFile);
  613. EXTERN_API_C( TQ3Status )
  614. Q3Tangent2D_Read                (TQ3Tangent2D *         tangent2D,
  615.                                  TQ3FileObject          theFile);
  617. EXTERN_API_C( TQ3Status )
  618. Q3Tangent2D_Write               (const TQ3Tangent2D *   tangent2D,
  619.                                  TQ3FileObject          theFile);
  621. EXTERN_API_C( TQ3Status )
  622. Q3Tangent3D_Read                (TQ3Tangent3D *         tangent3D,
  623.                                  TQ3FileObject          theFile);
  625. EXTERN_API_C( TQ3Status )
  626. Q3Tangent3D_Write               (const TQ3Tangent3D *   tangent3D,
  627.                                  TQ3FileObject          theFile);
  629. /*  This call affects only text Files - it is a no-op in binary files */
  630. EXTERN_API_C( TQ3Status )
  631. Q3Comment_Write                 (char *                 comment,
  632.                                  TQ3FileObject          theFile);
  634. /******************************************************************************
  635.  **                                                                          **
  636.  **                             Unknown Object                               **
  637.  **                                                                          **
  638.  **     Unknown objects are generated when reading files which contain       **
  639.  **     custom data which has not been registered in the current             **
  640.  **     instantiation of QuickDraw 3D.                                       **
  641.  **                                                                          **
  642.  *****************************************************************************/
  643. EXTERN_API_C( TQ3ObjectType )
  644. Q3Unknown_GetType               (TQ3UnknownObject       unknownObject);
  646. EXTERN_API_C( TQ3Status )
  647. Q3Unknown_GetDirtyState         (TQ3UnknownObject       unknownObject,
  648.                                  TQ3Boolean *           isDirty);
  650. EXTERN_API_C( TQ3Status )
  651. Q3Unknown_SetDirtyState         (TQ3UnknownObject       unknownObject,
  652.                                  TQ3Boolean             isDirty);
  655. /******************************************************************************
  656.  **                                                                          **
  657.  **                         Unknown Text Routines                            **
  658.  **                                                                          **
  659.  *****************************************************************************/
  660. #endif  /* CALL_NOT_IN_CARBON */
  663. struct TQ3UnknownTextData {
  664.     char *                          objectName;                 /* '' terminated */
  665.     char *                          contents;                   /* '' terminated */
  666. };
  667. typedef struct TQ3UnknownTextData       TQ3UnknownTextData;
  668. #if CALL_NOT_IN_CARBON
  669. EXTERN_API_C( TQ3Status )
  670. Q3UnknownText_GetData           (TQ3UnknownObject       unknownObject,
  671.                                  TQ3UnknownTextData *   unknownTextData);
  673. EXTERN_API_C( TQ3Status )
  674. Q3UnknownText_EmptyData         (TQ3UnknownTextData *   unknownTextData);
  677. /******************************************************************************
  678.  **                                                                          **
  679.  **                         Unknown Binary Routines                          **
  680.  **                                                                          **
  681.  *****************************************************************************/
  682. #endif  /* CALL_NOT_IN_CARBON */
  685. struct TQ3UnknownBinaryData {
  686.     TQ3ObjectType                   objectType;
  687.     unsigned long                   size;
  688.     TQ3Endian                       byteOrder;
  689.     char *                          contents;
  690. };
  691. typedef struct TQ3UnknownBinaryData     TQ3UnknownBinaryData;
  692. #if CALL_NOT_IN_CARBON
  693. EXTERN_API_C( TQ3Status )
  694. Q3UnknownBinary_GetData         (TQ3UnknownObject       unknownObject,
  695.                                  TQ3UnknownBinaryData * unknownBinaryData);
  697. EXTERN_API_C( TQ3Status )
  698. Q3UnknownBinary_EmptyData       (TQ3UnknownBinaryData * unknownBinaryData);
  701. #endif  /* CALL_NOT_IN_CARBON */
  703. #if CALL_NOT_IN_CARBON
  704. EXTERN_API_C( TQ3Status )
  705. Q3UnknownBinary_GetTypeString   (TQ3UnknownObject       unknownObject,
  706.                                  char **                typeString);
  708. EXTERN_API_C( TQ3Status )
  709. Q3UnknownBinary_EmptyTypeString (char **                typeString);
  711. #endif  /* CALL_NOT_IN_CARBON */
  713. /******************************************************************************
  714.  **                                                                          **
  715.  **                         ViewHints routines                               **
  716.  **                                                                          **
  717.  **     ViewHints are an object in a metafile to give you some hints on how  **
  718.  **     to render a scene.  You may create a view with any of the objects    **
  719.  **     retrieved from it, or you can just throw it away.                    **
  720.  **                                                                          **
  721.  **     To write a view hints to a file, create a view hints object from a   **
  722.  **     view and write the view hints.                                       **
  723.  **                                                                          **
  724.  *****************************************************************************/
  725. #if CALL_NOT_IN_CARBON
  726. EXTERN_API_C( TQ3ViewHintsObject )
  727. Q3ViewHints_New                 (TQ3ViewObject          view);
  729. EXTERN_API_C( TQ3Status )
  730. Q3ViewHints_SetRenderer         (TQ3ViewHintsObject     viewHints,
  731.                                  TQ3RendererObject      renderer);
  733. EXTERN_API_C( TQ3Status )
  734. Q3ViewHints_GetRenderer         (TQ3ViewHintsObject     viewHints,
  735.                                  TQ3RendererObject *    renderer);
  737. EXTERN_API_C( TQ3Status )
  738. Q3ViewHints_SetCamera           (TQ3ViewHintsObject     viewHints,
  739.                                  TQ3CameraObject        camera);
  741. EXTERN_API_C( TQ3Status )
  742. Q3ViewHints_GetCamera           (TQ3ViewHintsObject     viewHints,
  743.                                  TQ3CameraObject *      camera);
  745. EXTERN_API_C( TQ3Status )
  746. Q3ViewHints_SetLightGroup       (TQ3ViewHintsObject     viewHints,
  747.                                  TQ3GroupObject         lightGroup);
  749. EXTERN_API_C( TQ3Status )
  750. Q3ViewHints_GetLightGroup       (TQ3ViewHintsObject     viewHints,
  751.                                  TQ3GroupObject *       lightGroup);
  753. EXTERN_API_C( TQ3Status )
  754. Q3ViewHints_SetAttributeSet     (TQ3ViewHintsObject     viewHints,
  755.                                  TQ3AttributeSet        attributeSet);
  757. EXTERN_API_C( TQ3Status )
  758. Q3ViewHints_GetAttributeSet     (TQ3ViewHintsObject     viewHints,
  759.                                  TQ3AttributeSet *      attributeSet);
  761. EXTERN_API_C( TQ3Status )
  762. Q3ViewHints_SetDimensionsState  (TQ3ViewHintsObject     viewHints,
  763.                                  TQ3Boolean             isValid);
  765. EXTERN_API_C( TQ3Status )
  766. Q3ViewHints_GetDimensionsState  (TQ3ViewHintsObject     viewHints,
  767.                                  TQ3Boolean *           isValid);
  769. EXTERN_API_C( TQ3Status )
  770. Q3ViewHints_SetDimensions       (TQ3ViewHintsObject     viewHints,
  771.                                  unsigned long          width,
  772.                                  unsigned long          height);
  774. EXTERN_API_C( TQ3Status )
  775. Q3ViewHints_GetDimensions       (TQ3ViewHintsObject     viewHints,
  776.                                  unsigned long *        width,
  777.                                  unsigned long *        height);
  779. EXTERN_API_C( TQ3Status )
  780. Q3ViewHints_SetMaskState        (TQ3ViewHintsObject     viewHints,
  781.                                  TQ3Boolean             isValid);
  783. EXTERN_API_C( TQ3Status )
  784. Q3ViewHints_GetMaskState        (TQ3ViewHintsObject     viewHints,
  785.                                  TQ3Boolean *           isValid);
  787. EXTERN_API_C( TQ3Status )
  788. Q3ViewHints_SetMask             (TQ3ViewHintsObject     viewHints,
  789.                                  const TQ3Bitmap *      mask);
  791. EXTERN_API_C( TQ3Status )
  792. Q3ViewHints_GetMask             (TQ3ViewHintsObject     viewHints,
  793.                                  TQ3Bitmap *            mask);
  795. /* Call Q3Bitmap_Empty when done with the mask  */
  796. EXTERN_API_C( TQ3Status )
  797. Q3ViewHints_SetClearImageMethod (TQ3ViewHintsObject     viewHints,
  798.                                  TQ3DrawContextClearImageMethod  clearMethod);
  800. EXTERN_API_C( TQ3Status )
  801. Q3ViewHints_GetClearImageMethod (TQ3ViewHintsObject     viewHints,
  802.                                  TQ3DrawContextClearImageMethod * clearMethod);
  804. EXTERN_API_C( TQ3Status )
  805. Q3ViewHints_SetClearImageColor  (TQ3ViewHintsObject     viewHints,
  806.                                  const TQ3ColorARGB *   color);
  808. EXTERN_API_C( TQ3Status )
  809. Q3ViewHints_GetClearImageColor  (TQ3ViewHintsObject     viewHints,
  810.                                  TQ3ColorARGB *         color);
  814. #endif  /* CALL_NOT_IN_CARBON */
  817. #if PRAGMA_ENUM_ALWAYSINT
  818.     #pragma enumsalwaysint reset
  819.     #ifdef __QD3DIO__RESTORE_TWOBYTEINTS
  820.         #pragma fourbyteints off
  821.     #endif
  822. #elif PRAGMA_ENUM_OPTIONS
  823.     #pragma option enum=reset
  824. #elif defined(__QD3DIO__RESTORE_PACKED_ENUMS)
  825.     #pragma options(pack_enums)
  826. #endif
  828. #if PRAGMA_STRUCT_ALIGN
  829.     #pragma options align=reset
  830. #elif PRAGMA_STRUCT_PACKPUSH
  831.     #pragma pack(pop)
  832. #elif PRAGMA_STRUCT_PACK
  833.     #pragma pack()
  834. #endif
  836. #ifdef PRAGMA_IMPORT_OFF
  837. #pragma import off
  838. #elif PRAGMA_IMPORT
  839. #pragma import reset
  840. #endif
  842. #ifdef __cplusplus
  843. }
  844. #endif
  846. #endif /* __QD3DIO__ */