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

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

多媒体编程

开发平台：

Visual C++

QD3DGroup.h：源码内容
  1. /*
  2.      File:       QD3DGroup.h
  3.  
  4.      Contains:   Q3Group methods
  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 __QD3DGROUP__
  18. #define __QD3DGROUP__
  20. #ifndef __QD3D__
  21. #include "QD3D.h"
  22. #endif
  27. #if PRAGMA_ONCE
  28. #pragma once
  29. #endif
  31. #ifdef __cplusplus
  32. extern "C" {
  33. #endif
  35. #if PRAGMA_IMPORT
  36. #pragma import on
  37. #endif
  39. #if PRAGMA_STRUCT_ALIGN
  40.     #pragma options align=power
  41. #elif PRAGMA_STRUCT_PACKPUSH
  42.     #pragma pack(push, 2)
  43. #elif PRAGMA_STRUCT_PACK
  44.     #pragma pack(2)
  45. #endif
  47. #if PRAGMA_ENUM_ALWAYSINT
  48.     #if defined(__fourbyteints__) && !__fourbyteints__ 
  49.         #define __QD3DGROUP__RESTORE_TWOBYTEINTS
  50.         #pragma fourbyteints on
  51.     #endif
  52.     #pragma enumsalwaysint on
  53. #elif PRAGMA_ENUM_OPTIONS
  54.     #pragma option enum=int
  55. #elif PRAGMA_ENUM_PACK
  56.     #if __option(pack_enums)
  57.         #define __QD3DGROUP__RESTORE_PACKED_ENUMS
  58.         #pragma options(!pack_enums)
  59.     #endif
  60. #endif
  62. /******************************************************************************
  63.  **                                                                          **
  64.  **                         Group Typedefs                                   **
  65.  **                                                                          **
  66.  *****************************************************************************/
  67. /*
  68.  * These flags affect how a group is traversed
  69.  * They apply to when a group is "drawn", "picked", "bounded", "written"
  70.  */
  72. enum TQ3DisplayGroupStateMasks {
  73.     kQ3DisplayGroupStateNone    = 0,
  74.     kQ3DisplayGroupStateMaskIsDrawn = 1 << 0,
  75.     kQ3DisplayGroupStateMaskIsInline = 1 << 1,
  76.     kQ3DisplayGroupStateMaskUseBoundingBox = 1 << 2,
  77.     kQ3DisplayGroupStateMaskUseBoundingSphere = 1 << 3,
  78.     kQ3DisplayGroupStateMaskIsPicked = 1 << 4,
  79.     kQ3DisplayGroupStateMaskIsWritten = 1 << 5
  80. };
  81. typedef enum TQ3DisplayGroupStateMasks TQ3DisplayGroupStateMasks;
  83. typedef unsigned long                   TQ3DisplayGroupState;
  84.  
  86. /******************************************************************************
  87.  **                                                                          **
  88.  **                 Group Routines (apply to all groups)                     **
  89.  **                                                                          **
  90.  *****************************************************************************/
  91. /* May contain any shared object */
  92. #if CALL_NOT_IN_CARBON
  93. EXTERN_API_C( TQ3GroupObject )
  94. Q3Group_New                     (void);
  96. EXTERN_API_C( TQ3ObjectType )
  97. Q3Group_GetType                 (TQ3GroupObject         group);
  99. EXTERN_API_C( TQ3GroupPosition )
  100. Q3Group_AddObject               (TQ3GroupObject         group,
  101.                                  TQ3Object              object);
  103. EXTERN_API_C( TQ3GroupPosition )
  104. Q3Group_AddObjectBefore         (TQ3GroupObject         group,
  105.                                  TQ3GroupPosition       position,
  106.                                  TQ3Object              object);
  108. EXTERN_API_C( TQ3GroupPosition )
  109. Q3Group_AddObjectAfter          (TQ3GroupObject         group,
  110.                                  TQ3GroupPosition       position,
  111.                                  TQ3Object              object);
  113. EXTERN_API_C( TQ3Status )
  114. Q3Group_GetPositionObject       (TQ3GroupObject         group,
  115.                                  TQ3GroupPosition       position,
  116.                                  TQ3Object *            object);
  118. EXTERN_API_C( TQ3Status )
  119. Q3Group_SetPositionObject       (TQ3GroupObject         group,
  120.                                  TQ3GroupPosition       position,
  121.                                  TQ3Object              object);
  123. EXTERN_API_C( TQ3Object )
  124. Q3Group_RemovePosition          (TQ3GroupObject         group,
  125.                                  TQ3GroupPosition       position);
  127. EXTERN_API_C( TQ3Status )
  128. Q3Group_GetFirstPosition        (TQ3GroupObject         group,
  129.                                  TQ3GroupPosition *     position);
  131. EXTERN_API_C( TQ3Status )
  132. Q3Group_GetLastPosition         (TQ3GroupObject         group,
  133.                                  TQ3GroupPosition *     position);
  135. EXTERN_API_C( TQ3Status )
  136. Q3Group_GetNextPosition         (TQ3GroupObject         group,
  137.                                  TQ3GroupPosition *     position);
  139. EXTERN_API_C( TQ3Status )
  140. Q3Group_GetPreviousPosition     (TQ3GroupObject         group,
  141.                                  TQ3GroupPosition *     position);
  143. EXTERN_API_C( TQ3Status )
  144. Q3Group_CountObjects            (TQ3GroupObject         group,
  145.                                  unsigned long *        nObjects);
  147. EXTERN_API_C( TQ3Status )
  148. Q3Group_EmptyObjects            (TQ3GroupObject         group);
  150. /*
  151.  *  Typed Access
  152.  */
  153. EXTERN_API_C( TQ3Status )
  154. Q3Group_GetFirstPositionOfType  (TQ3GroupObject         group,
  155.                                  TQ3ObjectType          isType,
  156.                                  TQ3GroupPosition *     position);
  158. EXTERN_API_C( TQ3Status )
  159. Q3Group_GetLastPositionOfType   (TQ3GroupObject         group,
  160.                                  TQ3ObjectType          isType,
  161.                                  TQ3GroupPosition *     position);
  163. EXTERN_API_C( TQ3Status )
  164. Q3Group_GetNextPositionOfType   (TQ3GroupObject         group,
  165.                                  TQ3ObjectType          isType,
  166.                                  TQ3GroupPosition *     position);
  168. EXTERN_API_C( TQ3Status )
  169. Q3Group_GetPreviousPositionOfType (TQ3GroupObject       group,
  170.                                  TQ3ObjectType          isType,
  171.                                  TQ3GroupPosition *     position);
  173. EXTERN_API_C( TQ3Status )
  174. Q3Group_CountObjectsOfType      (TQ3GroupObject         group,
  175.                                  TQ3ObjectType          isType,
  176.                                  unsigned long *        nObjects);
  178. EXTERN_API_C( TQ3Status )
  179. Q3Group_EmptyObjectsOfType      (TQ3GroupObject         group,
  180.                                  TQ3ObjectType          isType);
  182. /*
  183.  *  Determine position of objects in a group
  184.  */
  185. EXTERN_API_C( TQ3Status )
  186. Q3Group_GetFirstObjectPosition  (TQ3GroupObject         group,
  187.                                  TQ3Object              object,
  188.                                  TQ3GroupPosition *     position);
  190. EXTERN_API_C( TQ3Status )
  191. Q3Group_GetLastObjectPosition   (TQ3GroupObject         group,
  192.                                  TQ3Object              object,
  193.                                  TQ3GroupPosition *     position);
  195. EXTERN_API_C( TQ3Status )
  196. Q3Group_GetNextObjectPosition   (TQ3GroupObject         group,
  197.                                  TQ3Object              object,
  198.                                  TQ3GroupPosition *     position);
  200. EXTERN_API_C( TQ3Status )
  201. Q3Group_GetPreviousObjectPosition (TQ3GroupObject       group,
  202.                                  TQ3Object              object,
  203.                                  TQ3GroupPosition *     position);
  206. /******************************************************************************
  207.  **                                                                          **
  208.  **                         Group Subclasses                                 **
  209.  **                                                                          **
  210.  *****************************************************************************/
  211. /* Must contain only lights */
  212. EXTERN_API_C( TQ3GroupObject )
  213. Q3LightGroup_New                (void);
  215. /* Must contain only strings */
  216. EXTERN_API_C( TQ3GroupObject )
  217. Q3InfoGroup_New                 (void);
  219. /******************************************************************************
  220.  **                                                                          **
  221.  **                     Display Group Routines                               **
  222.  **                                                                          **
  223.  *****************************************************************************/
  224. /* May contain only drawables */
  225. EXTERN_API_C( TQ3GroupObject )
  226. Q3DisplayGroup_New              (void);
  228. EXTERN_API_C( TQ3ObjectType )
  229. Q3DisplayGroup_GetType          (TQ3GroupObject         group);
  231. EXTERN_API_C( TQ3Status )
  232. Q3DisplayGroup_GetState         (TQ3GroupObject         group,
  233.                                  TQ3DisplayGroupState * state);
  235. EXTERN_API_C( TQ3Status )
  236. Q3DisplayGroup_SetState         (TQ3GroupObject         group,
  237.                                  TQ3DisplayGroupState   state);
  239. EXTERN_API_C( TQ3Status )
  240. Q3DisplayGroup_Submit           (TQ3GroupObject         group,
  241.                                  TQ3ViewObject          view);
  243. EXTERN_API_C( TQ3Status )
  244. Q3DisplayGroup_SetAndUseBoundingBox (TQ3GroupObject     group,
  245.                                  TQ3BoundingBox *       bBox);
  247. EXTERN_API_C( TQ3Status )
  248. Q3DisplayGroup_GetBoundingBox   (TQ3GroupObject         group,
  249.                                  TQ3BoundingBox *       bBox);
  251. EXTERN_API_C( TQ3Status )
  252. Q3DisplayGroup_RemoveBoundingBox (TQ3GroupObject        group);
  254. EXTERN_API_C( TQ3Status )
  255. Q3DisplayGroup_CalcAndUseBoundingBox (TQ3GroupObject    group,
  256.                                  TQ3ComputeBounds       computeBounds,
  257.                                  TQ3ViewObject          view);
  260. /******************************************************************************
  261.  **                                                                          **
  262.  **     Ordered Display Group                                                **
  263.  **                                                                          **
  264.  **     Ordered display groups keep objects in order by the type of object:  **
  265.  **                                                                          **
  266.  **     1   kQ3ShapeTypeTransform                                            **
  267.  **     2   kQ3ShapeTypeStyle                                                **
  268.  **     3   kQ3SetTypeAttribute                                              **
  269.  **     4   kQ3ShapeTypeShader                                               **
  270.  **     5   kQ3ShapeTypeCamera                                               **
  271.  **     6   kQ3ShapeTypeLight                                                **
  272.  **     7   kQ3ShapeTypeGeometry                                             **
  273.  **     8   kQ3ShapeTypeGroup                                                **         
  274.  **     9   kQ3ShapeTypeUnknown                                              **
  275.  **                                                                          **
  276.  **     Within a type, you are responsible for keeping things in order.      **
  277.  **                                                                          **
  278.  **     You may access and/or manipulate the group using the above types     **
  279.  **     (fast), or you may use any parent or leaf class types (slower).      **
  280.  **                                                                          **
  281.  **     Additional types will be added as functionality grows.               **
  282.  **                                                                          **
  283.  **     The group calls which access by type are much faster for ordered     ** 
  284.  **     display group for the types above.                                   **
  285.  **                                                                          **
  286.  **     N.B. Lights and Cameras in groups are a no-op when drawn and will    **
  287.  **          post an error with the debug libraries.                         **
  288.  **                                                                          **
  289.  *****************************************************************************/
  290. EXTERN_API_C( TQ3GroupObject )
  291. Q3OrderedDisplayGroup_New       (void);
  293. /******************************************************************************
  294.  **                                                                          **
  295.  **     IO Proxy Display Group                                               **
  296.  **                                                                          **
  297.  **     IO Proxy display groups are used to place more than one              **
  298.  **     representation of an object in a metafile. For example, if you know  **
  299.  **     another program does not understand NURBPatches but does understand  **
  300.  **     Meshes, you may place a mesh and a NURB Patch in an IO Proxy Group,  **
  301.  **     and the reading program will select the desired representation.      **
  302.  **                                                                          **
  303.  **     Objects in an IO Proxy Display Group are placed in their preferencial**
  304.  **     order, with the FIRST object being the MOST preferred, the LAST      **
  305.  **     object the least preferred.                                          **
  306.  **                                                                          **
  307.  **     The behavior of an IO Proxy Display Group is that when drawn/picked/ **
  308.  **     bounded, the first object in the group that is not "Unknown" is used,**
  309.  **     and the other objects ignored.                                       **
  310.  **                                                                          **
  311.  *****************************************************************************/
  312. EXTERN_API_C( TQ3GroupObject )
  313. Q3IOProxyDisplayGroup_New       (void);
  315. /******************************************************************************
  316.  **                                                                          **
  317.  **                     Group Extension Definitions                          **
  318.  **                                                                          **
  319.  *****************************************************************************/
  320. /*
  321.  *  Searching methods - OPTIONAL
  322.  */
  323. #endif  /* CALL_NOT_IN_CARBON */
  325. enum {
  326.     kQ3XMethodType_GroupAcceptObject = FOUR_CHAR_CODE('gaco')
  327. };
  329. typedef CALLBACK_API_C( TQ3Boolean , TQ3XGroupAcceptObjectMethod )(TQ3GroupObject group, TQ3Object object);
  330. enum {
  331.     kQ3XMethodType_GroupAddObject = FOUR_CHAR_CODE('gado')
  332. };
  334. typedef CALLBACK_API_C( TQ3GroupPosition , TQ3XGroupAddObjectMethod )(TQ3GroupObject group, TQ3Object object);
  335. enum {
  336.     kQ3XMethodType_GroupAddObjectBefore = FOUR_CHAR_CODE('gaob')
  337. };
  339. typedef CALLBACK_API_C( TQ3GroupPosition , TQ3XGroupAddObjectBeforeMethod )(TQ3GroupObject group, TQ3GroupPosition position, TQ3Object object);
  340. enum {
  341.     kQ3XMethodType_GroupAddObjectAfter = FOUR_CHAR_CODE('gaoa')
  342. };
  344. typedef CALLBACK_API_C( TQ3GroupPosition , TQ3XGroupAddObjectAfterMethod )(TQ3GroupObject group, TQ3GroupPosition position, TQ3Object object);
  345. enum {
  346.     kQ3XMethodType_GroupSetPositionObject = FOUR_CHAR_CODE('gspo')
  347. };
  349. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupSetPositionObjectMethod )(TQ3GroupObject group, TQ3GroupPosition gPos, TQ3Object obj);
  350. enum {
  351.     kQ3XMethodType_GroupRemovePosition = FOUR_CHAR_CODE('grmp')
  352. };
  354. typedef CALLBACK_API_C( TQ3Object , TQ3XGroupRemovePositionMethod )(TQ3GroupObject group, TQ3GroupPosition position);
  355.  
  357. /*
  358.  *  Searching methods - OPTIONAL - default uses above methods
  359.  */
  360. enum {
  361.     kQ3XMethodType_GroupGetFirstPositionOfType = FOUR_CHAR_CODE('gfrt')
  362. };
  364. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetFirstPositionOfTypeMethod )(TQ3GroupObject group, TQ3ObjectType isType, TQ3GroupPosition *gPos);
  365. enum {
  366.     kQ3XMethodType_GroupGetLastPositionOfType = FOUR_CHAR_CODE('glst')
  367. };
  369. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetLastPositionOfTypeMethod )(TQ3GroupObject group, TQ3ObjectType isType, TQ3GroupPosition *gPos);
  370. enum {
  371.     kQ3XMethodType_GroupGetNextPositionOfType = FOUR_CHAR_CODE('gnxt')
  372. };
  374. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetNextPositionOfTypeMethod )(TQ3GroupObject group, TQ3ObjectType isType, TQ3GroupPosition *gPos);
  375. enum {
  376.     kQ3XMethodType_GroupGetPrevPositionOfType = FOUR_CHAR_CODE('gpvt')
  377. };
  379. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetPrevPositionOfTypeMethod )(TQ3GroupObject group, TQ3ObjectType isType, TQ3GroupPosition *gPos);
  380. enum {
  381.     kQ3XMethodType_GroupCountObjectsOfType = FOUR_CHAR_CODE('gcnt')
  382. };
  384. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupCountObjectsOfTypeMethod )(TQ3GroupObject group, TQ3ObjectType isType, unsigned long *nObjects);
  385. enum {
  386.     kQ3XMethodType_GroupEmptyObjectsOfType = FOUR_CHAR_CODE('geot')
  387. };
  389. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupEmptyObjectsOfTypeMethod )(TQ3GroupObject group, TQ3ObjectType isType);
  390. enum {
  391.     kQ3XMethodType_GroupGetFirstObjectPosition = FOUR_CHAR_CODE('gfop')
  392. };
  394. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetFirstObjectPositionMethod )(TQ3GroupObject group, TQ3Object object, TQ3GroupPosition *gPos);
  395. enum {
  396.     kQ3XMethodType_GroupGetLastObjectPosition = FOUR_CHAR_CODE('glop')
  397. };
  399. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetLastObjectPositionMethod )(TQ3GroupObject group, TQ3Object object, TQ3GroupPosition *gPos);
  400. enum {
  401.     kQ3XMethodType_GroupGetNextObjectPosition = FOUR_CHAR_CODE('gnop')
  402. };
  404. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetNextObjectPositionMethod )(TQ3GroupObject group, TQ3Object object, TQ3GroupPosition *gPos);
  405. enum {
  406.     kQ3XMethodType_GroupGetPrevObjectPosition = FOUR_CHAR_CODE('gpop')
  407. };
  409. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupGetPrevObjectPositionMethod )(TQ3GroupObject group, TQ3Object object, TQ3GroupPosition *gPos);
  410.  
  412. /*
  413.  *  Group Position Methods
  414.  */
  415. enum {
  416.     kQ3XMethodType_GroupPositionSize = FOUR_CHAR_CODE('ggpz')
  417. };
  419. typedef unsigned long                   TQ3XMethodTypeGroupPositionSize;
  420. enum {
  421.     kQ3XMethodType_GroupPositionNew = FOUR_CHAR_CODE('ggpn')
  422. };
  424. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupPositionNewMethod )(void *gPos, TQ3Object object, const void *initData);
  425. enum {
  426.     kQ3XMethodType_GroupPositionCopy = FOUR_CHAR_CODE('ggpc')
  427. };
  429. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupPositionCopyMethod )(void *srcGPos, void *dstGPos);
  430. enum {
  431.     kQ3XMethodType_GroupPositionDelete = FOUR_CHAR_CODE('ggpd')
  432. };
  434. typedef CALLBACK_API_C( void , TQ3XGroupPositionDeleteMethod )(void *gPos);
  435.  
  437. /*
  438.  *  View Drawing Helpers
  439.  *  
  440.  *  TQ3XGroupStartIterateMethod
  441.  *
  442.  *      Pass back *object = NULL to NOT call EndIterate iterate
  443.  *      Pass back *object != NULL to draw object
  444.  *       (other side will pass it to EndIterate for deletion!)
  445.  *
  446.  *      *iterator is uninitialized, use for iteration state. Caller should 
  447.  *       ignore it.
  448.  *  
  449.  *  TQ3XGroupEndIterateMethod
  450.  *  
  451.  *      *object is previous object, dispose it or play with it.
  452.  *      Pass back NULL when last iteration has occurred
  453.  *      *iterator is previous value, use for iteration state Caller should 
  454.  *      ignore it.
  455.  */
  456. enum {
  457.     kQ3XMethodType_GroupStartIterate = FOUR_CHAR_CODE('gstd')
  458. };
  460. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupStartIterateMethod )(TQ3GroupObject group, TQ3GroupPosition *iterator, TQ3Object *object, TQ3ViewObject view);
  461. enum {
  462.     kQ3XMethodType_GroupEndIterate = FOUR_CHAR_CODE('gitd')
  463. };
  465. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupEndIterateMethod )(TQ3GroupObject group, TQ3GroupPosition *iterator, TQ3Object *object, TQ3ViewObject view);
  466.  
  468. /*
  469.  *  IO  Helpers
  470.  *  
  471.  *  TQ3XGroupEndReadMethod
  472.  *      Called when a group has been completely read. Group should perform
  473.  *      validation and clean up any reading caches.
  474.  */
  475. enum {
  476.     kQ3XMethodType_GroupEndRead = FOUR_CHAR_CODE('gerd')
  477. };
  479. typedef CALLBACK_API_C( TQ3Status , TQ3XGroupEndReadMethod )(TQ3GroupObject group);
  480. #if CALL_NOT_IN_CARBON
  481. EXTERN_API_C( void *)
  482. Q3XGroup_GetPositionPrivate     (TQ3GroupObject         group,
  483.                                  TQ3GroupPosition       position);
  487. #endif  /* CALL_NOT_IN_CARBON */
  490. #if PRAGMA_ENUM_ALWAYSINT
  491.     #pragma enumsalwaysint reset
  492.     #ifdef __QD3DGROUP__RESTORE_TWOBYTEINTS
  493.         #pragma fourbyteints off
  494.     #endif
  495. #elif PRAGMA_ENUM_OPTIONS
  496.     #pragma option enum=reset
  497. #elif defined(__QD3DGROUP__RESTORE_PACKED_ENUMS)
  498.     #pragma options(pack_enums)
  499. #endif
  501. #if PRAGMA_STRUCT_ALIGN
  502.     #pragma options align=reset
  503. #elif PRAGMA_STRUCT_PACKPUSH
  504.     #pragma pack(pop)
  505. #elif PRAGMA_STRUCT_PACK
  506.     #pragma pack()
  507. #endif
  509. #ifdef PRAGMA_IMPORT_OFF
  510. #pragma import off
  511. #elif PRAGMA_IMPORT
  512. #pragma import reset
  513. #endif
  515. #ifdef __cplusplus
  516. }
  517. #endif
  519. #endif /* __QD3DGROUP__ */