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

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

多媒体编程

开发平台：

Visual C++

QD3DViewer.h：源码内容
  1. /*
  2.      File:       QD3DViewer.h
  3.  
  4.      Contains:   MacOS Viewer Controller Interface File.
  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 __QD3DVIEWER__
  18. #define __QD3DVIEWER__
  20. #ifndef __QD3D__
  21. #include "QD3D.h"
  22. #endif
  24. #ifndef __QD3DGROUP__
  25. #include "QD3DGroup.h"
  26. #endif
  29. #if TARGET_OS_MAC
  30. #ifndef __EVENTS__
  31. #include "Events.h"
  32. #endif
  34. #ifndef __MACTYPES__
  35. #include "MacTypes.h"
  36. #endif
  38. #ifndef __QUICKDRAW__
  39. #include "Quickdraw.h"
  40. #endif
  42. #endif  /* TARGET_OS_MAC */
  46. #if PRAGMA_ONCE
  47. #pragma once
  48. #endif
  50. #ifdef __cplusplus
  51. extern "C" {
  52. #endif
  54. #if PRAGMA_IMPORT
  55. #pragma import on
  56. #endif
  58. #if PRAGMA_STRUCT_ALIGN
  59.     #pragma options align=power
  60. #elif PRAGMA_STRUCT_PACKPUSH
  61.     #pragma pack(push, 2)
  62. #elif PRAGMA_STRUCT_PACK
  63.     #pragma pack(2)
  64. #endif
  66. #if PRAGMA_ENUM_ALWAYSINT
  67.     #if defined(__fourbyteints__) && !__fourbyteints__ 
  68.         #define __QD3DVIEWER__RESTORE_TWOBYTEINTS
  69.         #pragma fourbyteints on
  70.     #endif
  71.     #pragma enumsalwaysint on
  72. #elif PRAGMA_ENUM_OPTIONS
  73.     #pragma option enum=int
  74. #elif PRAGMA_ENUM_PACK
  75.     #if __option(pack_enums)
  76.         #define __QD3DVIEWER__RESTORE_PACKED_ENUMS
  77.         #pragma options(!pack_enums)
  78.     #endif
  79. #endif
  81. typedef void *                          TQ3ViewerObject;
  83. typedef CALLBACK_API_C( TQ3Status , TQ3ViewerWindowResizeCallbackMethod )(TQ3ViewerObject theViewer, const void *data);
  84. typedef CALLBACK_API_C( TQ3Status , TQ3ViewerPaneResizeNotifyCallbackMethod )(TQ3ViewerObject theViewer, const void *data);
  86. #if TARGET_OS_MAC
  87. typedef CALLBACK_API_C( OSErr , TQ3ViewerDrawingCallbackMethod )(TQ3ViewerObject theViewer, const void *data);
  89. enum {
  90.     kQ3ViewerShowBadge          = 1 << 0,
  91.     kQ3ViewerActive             = 1 << 1,
  92.     kQ3ViewerControllerVisible  = 1 << 2,
  93.     kQ3ViewerDrawFrame          = 1 << 3,
  94.     kQ3ViewerDraggingOff        = 1 << 4,
  95.     kQ3ViewerButtonCamera       = 1 << 5,
  96.     kQ3ViewerButtonTruck        = 1 << 6,
  97.     kQ3ViewerButtonOrbit        = 1 << 7,
  98.     kQ3ViewerButtonZoom         = 1 << 8,
  99.     kQ3ViewerButtonDolly        = 1 << 9,
  100.     kQ3ViewerButtonReset        = 1 << 10,
  101.     kQ3ViewerOutputTextMode     = 1 << 11,
  102.     kQ3ViewerDragMode           = 1 << 12,
  103.     kQ3ViewerDrawGrowBox        = 1 << 13,
  104.     kQ3ViewerDrawDragBorder     = 1 << 14,
  105.     kQ3ViewerDraggingInOff      = 1 << 15,
  106.     kQ3ViewerDraggingOutOff     = 1 << 16,
  107.     kQ3ViewerButtonOptions      = 1 << 17,
  108.     kQ3ViewerPaneGrowBox        = 1 << 18,
  109.     kQ3ViewerDefault            = 1 << 31
  110. };
  112. enum {
  113.     kQ3ViewerEmpty              = 0,
  114.     kQ3ViewerHasModel           = 1 << 0,
  115.     kQ3ViewerHasUndo            = 1 << 1
  116. };
  119. enum TQ3ViewerCameraView {
  120.     kQ3ViewerCameraRestore      = 0,
  121.     kQ3ViewerCameraFit          = 1,
  122.     kQ3ViewerCameraFront        = 2,
  123.     kQ3ViewerCameraBack         = 3,
  124.     kQ3ViewerCameraLeft         = 4,
  125.     kQ3ViewerCameraRight        = 5,
  126.     kQ3ViewerCameraTop          = 6,
  127.     kQ3ViewerCameraBottom       = 7
  128. };
  129. typedef enum TQ3ViewerCameraView TQ3ViewerCameraView;
  134. /******************************************************************************
  135.  **                                                                          **
  136.  **     Return viewer version number                                         **
  137.  **                                                                          **
  138.  *****************************************************************************/
  139. #if CALL_NOT_IN_CARBON
  140. EXTERN_API_C( OSErr )
  141. Q3ViewerGetVersion              (unsigned long *        majorRevision,
  142.                                  unsigned long *        minorRevision);
  145. /******************************************************************************
  146.  **                                                                          **
  147.  **     Return viewer release version number                                 **
  148.  **     (in 'vers' format - e.g. 0x01518000 ==> 1.5.1 release)               **
  149.  **                                                                          **
  150.  *****************************************************************************/
  151. EXTERN_API_C( OSErr )
  152. Q3ViewerGetReleaseVersion       (unsigned long *        releaseRevision);
  155. /******************************************************************************
  156.  **                                                                          **
  157.  **                     Creation and destruction                             **
  158.  **             Note that this is not a QuickDraw 3D object                  **
  159.  **                                                                          **
  160.  *****************************************************************************/
  161. EXTERN_API_C( TQ3ViewerObject )
  162. Q3ViewerNew                     (CGrafPtr               port,
  163.                                  Rect *                 rect,
  164.                                  unsigned long          flags);
  166. EXTERN_API_C( OSErr )
  167. Q3ViewerDispose                 (TQ3ViewerObject        theViewer);
  170. /******************************************************************************
  171.  **                                                                          **
  172.  **                 Functions to attach data to a viewer                     **
  173.  **                                                                          **
  174.  *****************************************************************************/
  175. EXTERN_API_C( OSErr )
  176. Q3ViewerUseFile                 (TQ3ViewerObject        theViewer,
  177.                                  long                   refNum);
  179. EXTERN_API_C( OSErr )
  180. Q3ViewerUseData                 (TQ3ViewerObject        theViewer,
  181.                                  void *                 data,
  182.                                  long                   size);
  185. /******************************************************************************
  186.  **                                                                          **
  187.  **     Functions to write data out from the Viewer                          **
  188.  **                                                                          **
  189.  *****************************************************************************/
  190. EXTERN_API_C( OSErr )
  191. Q3ViewerWriteFile               (TQ3ViewerObject        theViewer,
  192.                                  long                   refNum);
  194. EXTERN_API_C( unsigned long )
  195. Q3ViewerWriteData               (TQ3ViewerObject        theViewer,
  196.                                  Handle                 data);
  199. /******************************************************************************
  200.  **                                                                          **
  201.  **     Use this function to force the Viewer to re-draw                     **
  202.  **                                                                          **
  203.  *****************************************************************************/
  204. EXTERN_API_C( OSErr )
  205. Q3ViewerDraw                    (TQ3ViewerObject        theViewer);
  207. EXTERN_API_C( OSErr )
  208. Q3ViewerDrawContent             (TQ3ViewerObject        theViewer);
  210. EXTERN_API_C( OSErr )
  211. Q3ViewerDrawControlStrip        (TQ3ViewerObject        theViewer);
  214. /******************************************************************************
  215.  **                                                                          **
  216.  **     Function used by the Viewer to filter and handle events              **
  217.  **                                                                          **
  218.  *****************************************************************************/
  219. EXTERN_API_C( Boolean )
  220. Q3ViewerEvent                   (TQ3ViewerObject        theViewer,
  221.                                  EventRecord *          evt);
  224. /******************************************************************************
  225.  **                                                                          **
  226.  **     This function returns a PICT of the contents of the                  **
  227.  **     Viewer's window.  The application should dispose the PICT.           **
  228.  **                                                                          **
  229.  *****************************************************************************/
  230. EXTERN_API_C( PicHandle )
  231. Q3ViewerGetPict                 (TQ3ViewerObject        theViewer);
  234. /******************************************************************************
  235.  **                                                                          **
  236.  **                     Calls for dealing with Buttons                       **
  237.  **                                                                          **
  238.  *****************************************************************************/
  239. EXTERN_API_C( OSErr )
  240. Q3ViewerGetButtonRect           (TQ3ViewerObject        theViewer,
  241.                                  unsigned long          button,
  242.                                  Rect *                 rect);
  244. EXTERN_API_C( unsigned long )
  245. Q3ViewerGetCurrentButton        (TQ3ViewerObject        theViewer);
  247. EXTERN_API_C( OSErr )
  248. Q3ViewerSetCurrentButton        (TQ3ViewerObject        theViewer,
  249.                                  unsigned long          button);
  252. /******************************************************************************
  253.  **                                                                          **
  254.  **     Functions to set/get the group to be displayed by the Viewer.        **
  255.  **                                                                          **
  256.  *****************************************************************************/
  257. EXTERN_API_C( OSErr )
  258. Q3ViewerUseGroup                (TQ3ViewerObject        theViewer,
  259.                                  TQ3GroupObject         group);
  261. EXTERN_API_C( TQ3GroupObject )
  262. Q3ViewerGetGroup                (TQ3ViewerObject        theViewer);
  265. /******************************************************************************
  266.  **                                                                          **
  267.  **     Functions to set/get the color used to clear the window              **
  268.  **                                                                          **
  269.  *****************************************************************************/
  270. EXTERN_API_C( OSErr )
  271. Q3ViewerSetBackgroundColor      (TQ3ViewerObject        theViewer,
  272.                                  TQ3ColorARGB *         color);
  274. EXTERN_API_C( OSErr )
  275. Q3ViewerGetBackgroundColor      (TQ3ViewerObject        theViewer,
  276.                                  TQ3ColorARGB *         color);
  279. /******************************************************************************
  280.  **                                                                          **
  281.  **     Getting/Setting a Viewer's View object.                              **
  282.  **                                                                          **
  283.  *****************************************************************************/
  284. EXTERN_API_C( TQ3ViewObject )
  285. Q3ViewerGetView                 (TQ3ViewerObject        theViewer);
  287. EXTERN_API_C( OSErr )
  288. Q3ViewerRestoreView             (TQ3ViewerObject        theViewer);
  291. /******************************************************************************
  292.  **                                                                          **
  293.  **     Calls for setting/getting viewer flags                               **
  294.  **                                                                          **
  295.  *****************************************************************************/
  296. EXTERN_API_C( OSErr )
  297. Q3ViewerSetFlags                (TQ3ViewerObject        theViewer,
  298.                                  unsigned long          flags);
  300. EXTERN_API_C( unsigned long )
  301. Q3ViewerGetFlags                (TQ3ViewerObject        theViewer);
  304. /******************************************************************************
  305.  **                                                                          **
  306.  **     Calls related to bounds/dimensions.  Bounds is the size of           **
  307.  **     the window.  Dimensions can either be the Rect from the ViewHints    **
  308.  **     or the current dimensions of the window (if you do a Set).           **
  309.  **                                                                          **
  310.  *****************************************************************************/
  311. EXTERN_API_C( OSErr )
  312. Q3ViewerSetBounds               (TQ3ViewerObject        theViewer,
  313.                                  Rect *                 bounds);
  315. EXTERN_API_C( OSErr )
  316. Q3ViewerGetBounds               (TQ3ViewerObject        theViewer,
  317.                                  Rect *                 bounds);
  319. EXTERN_API_C( OSErr )
  320. Q3ViewerSetDimension            (TQ3ViewerObject        theViewer,
  321.                                  unsigned long          width,
  322.                                  unsigned long          height);
  324. EXTERN_API_C( OSErr )
  325. Q3ViewerGetDimension            (TQ3ViewerObject        theViewer,
  326.                                  unsigned long *        width,
  327.                                  unsigned long *        height);
  329. EXTERN_API_C( OSErr )
  330. Q3ViewerGetMinimumDimension     (TQ3ViewerObject        theViewer,
  331.                                  unsigned long *        width,
  332.                                  unsigned long *        height);
  335. /******************************************************************************
  336.  **                                                                          **
  337.  **                         Port related calls                               **
  338.  **                                                                          **
  339.  *****************************************************************************/
  340. EXTERN_API_C( OSErr )
  341. Q3ViewerSetPort                 (TQ3ViewerObject        theViewer,
  342.                                  CGrafPtr               port);
  344. EXTERN_API_C( CGrafPtr )
  345. Q3ViewerGetPort                 (TQ3ViewerObject        theViewer);
  348. /******************************************************************************
  349.  **                                                                          **
  350.  **     Adjust Cursor should be called from idle loop to allow the Viewer    **
  351.  **     to change the cursor according to the cursor position/object under   **
  352.  **     the cursor.                                                          **
  353.  **                                                                          **
  354.  *****************************************************************************/
  355. EXTERN_API_C( Boolean )
  356. Q3ViewerAdjustCursor            (TQ3ViewerObject        theViewer,
  357.                                  Point *                pt);
  359. EXTERN_API_C( OSErr )
  360. Q3ViewerCursorChanged           (TQ3ViewerObject        theViewer);
  363. /******************************************************************************
  364.  **                                                                          **
  365.  **     Returns the state of the viewer.  See the constant defined at the    **
  366.  **     top of this file.                                                    **
  367.  **                                                                          **
  368.  *****************************************************************************/
  369. EXTERN_API_C( unsigned long )
  370. Q3ViewerGetState                (TQ3ViewerObject        theViewer);
  373. /******************************************************************************
  374.  **                                                                          **
  375.  **                         Clipboard utilities                              **
  376.  **                                                                          **
  377.  *****************************************************************************/
  378. EXTERN_API_C( OSErr )
  379. Q3ViewerClear                   (TQ3ViewerObject        theViewer);
  381. EXTERN_API_C( OSErr )
  382. Q3ViewerCut                     (TQ3ViewerObject        theViewer);
  384. EXTERN_API_C( OSErr )
  385. Q3ViewerCopy                    (TQ3ViewerObject        theViewer);
  387. EXTERN_API_C( OSErr )
  388. Q3ViewerPaste                   (TQ3ViewerObject        theViewer);
  391. /******************************************************************************
  392.  **                                                                          **
  393.  **                         New Event Model                                  **
  394.  **                                                                          **
  395.  *****************************************************************************/
  396. EXTERN_API_C( Boolean )
  397. Q3ViewerMouseDown               (TQ3ViewerObject        theViewer,
  398.                                  long                   x,
  399.                                  long                   y);
  401. EXTERN_API_C( Boolean )
  402. Q3ViewerContinueTracking        (TQ3ViewerObject        theViewer,
  403.                                  long                   x,
  404.                                  long                   y);
  406. EXTERN_API_C( Boolean )
  407. Q3ViewerMouseUp                 (TQ3ViewerObject        theViewer,
  408.                                  long                   x,
  409.                                  long                   y);
  411. EXTERN_API_C( Boolean )
  412. Q3ViewerHandleKeyEvent          (TQ3ViewerObject        theViewer,
  413.                                  EventRecord *          evt);
  416. /******************************************************************************
  417.  **                                                                          **
  418.  **                                 CallBacks                                **
  419.  **                                                                          **
  420.  *****************************************************************************/
  421. EXTERN_API_C( OSErr )
  422. Q3ViewerSetDrawingCallbackMethod (TQ3ViewerObject       theViewer,
  423.                                  TQ3ViewerDrawingCallbackMethod  callbackMethod,
  424.                                  const void *           data);
  426. EXTERN_API_C( OSErr )
  427. Q3ViewerSetWindowResizeCallback (TQ3ViewerObject        theViewer,
  428.                                  TQ3ViewerWindowResizeCallbackMethod  windowResizeCallbackMethod,
  429.                                  const void *           data);
  431. EXTERN_API_C( OSErr )
  432. Q3ViewerSetPaneResizeNotifyCallback (TQ3ViewerObject    theViewer,
  433.                                  TQ3ViewerPaneResizeNotifyCallbackMethod  paneResizeNotifyCallbackMethod,
  434.                                  const void *           data);
  437. /******************************************************************************
  438.  **                                                                          **
  439.  **                                 Undo                                     **
  440.  **                                                                          **
  441.  *****************************************************************************/
  442. EXTERN_API_C( OSErr )
  443. Q3ViewerUndo                    (TQ3ViewerObject        theViewer);
  445. EXTERN_API_C( Boolean )
  446. Q3ViewerGetUndoString           (TQ3ViewerObject        theViewer,
  447.                                  char *                 str,
  448.                                  unsigned long *        cnt);
  451. /******************************************************************************
  452.  **                                                                          **
  453.  **                             Camera Support                               **
  454.  **                                                                          **
  455.  *****************************************************************************/
  456. EXTERN_API_C( OSErr )
  457. Q3ViewerGetCameraCount          (TQ3ViewerObject        theViewer,
  458.                                  unsigned long *        cnt);
  460. EXTERN_API_C( OSErr )
  461. Q3ViewerSetCameraByNumber       (TQ3ViewerObject        theViewer,
  462.                                  unsigned long          cameraNo);
  464. EXTERN_API_C( OSErr )
  465. Q3ViewerSetCameraByView         (TQ3ViewerObject        theViewer,
  466.                                  TQ3ViewerCameraView    viewType);
  469. /******************************************************************************
  470.  **                                                                          **
  471.  **                         Pop-up Button Options                            **
  472.  **                                                                          **
  473.  *****************************************************************************/
  474. EXTERN_API_C( OSErr )
  475. Q3ViewerSetRendererType         (TQ3ViewerObject        theViewer,
  476.                                  TQ3ObjectType          rendererType);
  478. EXTERN_API_C( OSErr )
  479. Q3ViewerGetRendererType         (TQ3ViewerObject        theViewer,
  480.                                  TQ3ObjectType *        rendererType);
  482. EXTERN_API_C( OSErr )
  483. Q3ViewerChangeBrightness        (TQ3ViewerObject        theViewer,
  484.                                  float                  brightness);
  486. EXTERN_API_C( OSErr )
  487. Q3ViewerSetRemoveBackfaces      (TQ3ViewerObject        theViewer,
  488.                                  TQ3Boolean             remove);
  490. EXTERN_API_C( OSErr )
  491. Q3ViewerGetRemoveBackfaces      (TQ3ViewerObject        theViewer,
  492.                                  TQ3Boolean *           remove);
  494. EXTERN_API_C( OSErr )
  495. Q3ViewerSetPhongShading         (TQ3ViewerObject        theViewer,
  496.                                  TQ3Boolean             phong);
  498. EXTERN_API_C( OSErr )
  499. Q3ViewerGetPhongShading         (TQ3ViewerObject        theViewer,
  500.                                  TQ3Boolean *           phong);
  503. #endif  /* CALL_NOT_IN_CARBON */
  505. #endif  /* TARGET_OS_MAC */
  511. #if PRAGMA_ENUM_ALWAYSINT
  512.     #pragma enumsalwaysint reset
  513.     #ifdef __QD3DVIEWER__RESTORE_TWOBYTEINTS
  514.         #pragma fourbyteints off
  515.     #endif
  516. #elif PRAGMA_ENUM_OPTIONS
  517.     #pragma option enum=reset
  518. #elif defined(__QD3DVIEWER__RESTORE_PACKED_ENUMS)
  519.     #pragma options(pack_enums)
  520. #endif
  522. #if PRAGMA_STRUCT_ALIGN
  523.     #pragma options align=reset
  524. #elif PRAGMA_STRUCT_PACKPUSH
  525.     #pragma pack(pop)
  526. #elif PRAGMA_STRUCT_PACK
  527.     #pragma pack()
  528. #endif
  530. #ifdef PRAGMA_IMPORT_OFF
  531. #pragma import off
  532. #elif PRAGMA_IMPORT
  533. #pragma import reset
  534. #endif
  536. #ifdef __cplusplus
  537. }
  538. #endif
  540. #endif /* __QD3DVIEWER__ */