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

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

多媒体编程

开发平台：

Visual C++

QuickTimeVR.h：源码内容
  1. /*
  2.      File:       QuickTimeVR.h
  3.  
  4.      Contains:   QuickTime VR interfaces
  5.  
  6.      Version:    Technology: QuickTime VR 5.0
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1997-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 __QUICKTIMEVR__
  18. #define __QUICKTIMEVR__
  20. #ifndef __CONDITIONALMACROS__
  21. #include "ConditionalMacros.h"
  22. #endif
  24. #ifndef __DIALOGS__
  25. #include "Dialogs.h"
  26. #endif
  28. #ifndef __MOVIES__
  29. #include "Movies.h"
  30. #endif
  35. #if PRAGMA_ONCE
  36. #pragma once
  37. #endif
  39. #ifdef __cplusplus
  40. extern "C" {
  41. #endif
  43. #if PRAGMA_IMPORT
  44. #pragma import on
  45. #endif
  47. #if PRAGMA_STRUCT_ALIGN
  48.     #pragma options align=mac68k
  49. #elif PRAGMA_STRUCT_PACKPUSH
  50.     #pragma pack(push, 2)
  51. #elif PRAGMA_STRUCT_PACK
  52.     #pragma pack(2)
  53. #endif
  55. typedef struct OpaqueQTVRInstance*      QTVRInstance;
  57. /* Released API Version numbers */
  58. #define kQTVRAPIMajorVersion05  (0x05)
  59. #define kQTVRAPIMajorVersion02  (0x02)
  60. #define kQTVRAPIMinorVersion00  (0x00)
  61. #define kQTVRAPIMinorVersion01  (0x01)
  62. #define kQTVRAPIMinorVersion10  (0x10)
  63. #define kQTVRAPIMinorVersion20  (0x20)
  65. /* Version numbers for the API described in this header */
  66. #define kQTVRAPIMajorVersion kQTVRAPIMajorVersion05
  67. #define kQTVRAPIMinorVersion kQTVRAPIMinorVersion00
  70. enum {
  71.     kQTVRControllerSubType      = FOUR_CHAR_CODE('ctyp'),
  72.     kQTVRQTVRType               = FOUR_CHAR_CODE('qtvr'),
  73.     kQTVRPanoramaType           = FOUR_CHAR_CODE('pano'),
  74.     kQTVRObjectType             = FOUR_CHAR_CODE('obje'),
  75.     kQTVROldPanoType            = FOUR_CHAR_CODE('STpn'),       /* Used in QTVR 1.0 release*/
  76.     kQTVROldObjectType          = FOUR_CHAR_CODE('stna')        /* Used in QTVR 1.0 release*/
  77. };
  79. #if TARGET_OS_MAC && !TARGET_API_MAC_OSX
  80. #define kQTVRUnknownType '????'     /* Unknown node type */
  81. #else
  82. #define kQTVRUnknownType '????' /* Unknown node type */
  83. #endif  /* TARGET_OS_MAC && !TARGET_API_MAC_OSX */
  85. /* QTVR hot spot types*/
  86. enum {
  87.     kQTVRHotSpotLinkType        = FOUR_CHAR_CODE('link'),
  88.     kQTVRHotSpotURLType         = FOUR_CHAR_CODE('url '),
  89.     kQTVRHotSpotUndefinedType   = FOUR_CHAR_CODE('undf')
  90. };
  92. /* Special Values for nodeID in QTVRGoToNodeID*/
  93. enum {
  94.     kQTVRCurrentNode            = 0,
  95.     kQTVRPreviousNode           = (long)0x80000000,
  96.     kQTVRDefaultNode            = (long)0x80000001
  97. };
  99. /* Panorama correction modes used for the kQTVRImagingCorrection imaging property*/
  100. enum {
  101.     kQTVRNoCorrection           = 0,
  102.     kQTVRPartialCorrection      = 1,
  103.     kQTVRFullCorrection         = 2
  104. };
  106. /* Imaging Modes used by QTVRSetImagingProperty, QTVRGetImagingProperty, QTVRUpdate, QTVRBeginUpdate*/
  108. typedef UInt32 QTVRImagingMode;
  109. enum {
  110.     kQTVRStatic                 = 1,
  111.     kQTVRMotion                 = 2,
  112.     kQTVRCurrentMode            = 0,                            /* Special Value for QTVRUpdate*/
  113.     kQTVRAllModes               = 100                           /* Special value for QTVRSetProperty*/
  114. };
  116. /* Imaging Properties used by QTVRSetImagingProperty, QTVRGetImagingProperty*/
  117. enum {
  118.     kQTVRImagingCorrection      = 1,
  119.     kQTVRImagingQuality         = 2,
  120.     kQTVRImagingDirectDraw      = 3,
  121.     kQTVRImagingCurrentMode     = 100                           /* Get Only*/
  122. };
  124. /* OR the above with kImagingDefaultValue to get/set the default value*/
  125. enum {
  126.     kImagingDefaultValue        = (long)0x80000000
  127. };
  129. /* Transition Types used by QTVRSetTransitionProperty, QTVREnableTransition*/
  130. enum {
  131.     kQTVRTransitionSwing        = 1
  132. };
  134. /* Transition Properties QTVRSetTransitionProperty*/
  135. enum {
  136.     kQTVRTransitionSpeed        = 1,
  137.     kQTVRTransitionDirection    = 2
  138. };
  140. /* Constraint values used to construct value returned by GetConstraintStatus*/
  141. enum {
  142.     kQTVRUnconstrained          = 0L,
  143.     kQTVRCantPanLeft            = 1L << 0,
  144.     kQTVRCantPanRight           = 1L << 1,
  145.     kQTVRCantPanUp              = 1L << 2,
  146.     kQTVRCantPanDown            = 1L << 3,
  147.     kQTVRCantZoomIn             = 1L << 4,
  148.     kQTVRCantZoomOut            = 1L << 5,
  149.     kQTVRCantTranslateLeft      = 1L << 6,
  150.     kQTVRCantTranslateRight     = 1L << 7,
  151.     kQTVRCantTranslateUp        = 1L << 8,
  152.     kQTVRCantTranslateDown      = 1L << 9
  153. };
  155. /* Object-only mouse mode values used to construct value returned by QTVRGetCurrentMouseMode*/
  156. enum {
  157.     kQTVRPanning                = 1L << 0,                      /* standard objects, "object only" controllers*/
  158.     kQTVRTranslating            = 1L << 1,                      /* all objects*/
  159.     kQTVRZooming                = 1L << 2,                      /* all objects*/
  160.     kQTVRScrolling              = 1L << 3,                      /* standard object arrow scrollers and joystick object*/
  161.     kQTVRSelecting              = 1L << 4                       /* object absolute controller*/
  162. };
  164. /* Properties for use with QTVRSetInteractionProperty/GetInteractionProperty*/
  165. enum {
  166.     kQTVRInteractionMouseClickHysteresis = 1,                   /* pixels within which the mouse is considered not to have moved (UInt16)*/
  167.     kQTVRInteractionMouseClickTimeout = 2,                      /* ticks after which a mouse click times out and turns into panning (UInt32)*/
  168.     kQTVRInteractionPanTiltSpeed = 3,                           /* control the relative pan/tilt speed from 1 (slowest) to 10 (fastest). (UInt32) Default is 5;*/
  169.     kQTVRInteractionZoomSpeed   = 4,                            /* control the relative zooming speed from 1 (slowest) to 10 (fastest). (UInt32) Default is 5;*/
  170.     kQTVRInteractionTranslateOnMouseDown = 101,                 /* Holding MouseDown with this setting translates zoomed object movies (Boolean)*/
  171.     kQTVRInteractionMouseMotionScale = 102,                     /* The maximum angle of rotation caused by dragging across the display window. (* float)*/
  172.     kQTVRInteractionNudgeMode   = 103                           /* A QTVRNudgeMode: rotate, translate, or the same as the current mouse mode. Requires QTVR 2.1*/
  173. };
  175. /* OR the above with kQTVRInteractionDefaultValue to get/set the default value*/
  176. enum {
  177.     kQTVRInteractionDefaultValue = (long)0x80000000
  178. };
  181. /* Geometry constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings, QTVRGetBackBufferMemInfo*/
  182. enum {
  183.     kQTVRUseMovieGeometry       = 0,
  184.     kQTVRVerticalCylinder       = FOUR_CHAR_CODE('vcyl'),
  185.     kQTVRHorizontalCylinder     = FOUR_CHAR_CODE('hcyl'),
  186.     kQTVRCube                   = FOUR_CHAR_CODE('cube')
  187. };
  189. /* Resolution constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings, QTVRGetBackBufferMemInfo*/
  190. enum {
  191.     kQTVRDefaultRes             = 0,
  192.     kQTVRFullRes                = 1L << 0,
  193.     kQTVRHalfRes                = 1L << 1,
  194.     kQTVRQuarterRes             = 1L << 2
  195. };
  197. /* QTVR-specific pixelFormat constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings, QTVRGetBackBufferMemInfo*/
  198. enum {
  199.     kQTVRUseMovieDepth          = 0
  200. };
  202. /* Cache Size Pref constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings*/
  203. enum {
  204.     kQTVRMinimumCache           = -1,
  205.     kQTVRSuggestedCache         = 0,
  206.     kQTVRFullCache              = 1
  207. };
  209. /* Angular units used by QTVRSetAngularUnits*/
  211. typedef UInt32 QTVRAngularUnits;
  212. enum {
  213.     kQTVRDegrees                = 0,
  214.     kQTVRRadians                = 1
  215. };
  217. /* Values for enableFlag parameter in QTVREnableHotSpot*/
  218. enum {
  219.     kQTVRHotSpotID              = 0,
  220.     kQTVRHotSpotType            = 1,
  221.     kQTVRAllHotSpots            = 2
  222. };
  224. /* Values for viewParameter for QTVRSet/GetViewParameter*/
  225. enum {
  226.     kQTVRPanAngle               = 0x0100,                       /* default units; &float, &float*/
  227.     kQTVRTiltAngle              = 0x0101,                       /* default units; &float, &float*/
  228.     kQTVRFieldOfViewAngle       = 0x0103,                       /* default units; &float, &float*/
  229.     kQTVRViewCenter             = 0x0104,                       /* pixels (per object movies); &QTVRFloatPoint, &QTVRFloatPoint*/
  230.     kQTVRHotSpotsVisible        = 0x0200                        /* Boolean, &Boolean*/
  231. };
  233. /* Values for flagsIn for QTVRSet/GetViewParameter*/
  234. enum {
  235.     kQTVRValueIsRelative        = 1L << 0,                      /* Is the value absolute or relative to the current value?*/
  236.     kQTVRValueIsRate            = 1L << 1,                      /* Is the value absolute or a rate of change to be applied?*/
  237.     kQTVRValueIsUserPrefRelative = 1L << 2                      /* Is the value a percentage of the user rate pref?*/
  238. };
  240. /* Values for kind parameter in QTVRGet/SetConstraints, QTVRGetViewingLimits*/
  241. enum {
  242.     kQTVRPan                    = 0,
  243.     kQTVRTilt                   = 1,
  244.     kQTVRFieldOfView            = 2,
  245.     kQTVRViewCenterH            = 4,                            /* WrapAndConstrain only*/
  246.     kQTVRViewCenterV            = 5                             /* WrapAndConstrain only*/
  247. };
  249. /* Values for setting parameter in QTVRSetAnimationSetting, QTVRGetAnimationSetting*/
  251. typedef UInt32 QTVRObjectAnimationSetting;
  252. enum {
  253.                                                                 /* View Frame Animation Settings*/
  254.     kQTVRPalindromeViewFrames   = 1,
  255.     kQTVRStartFirstViewFrame    = 2,
  256.     kQTVRDontLoopViewFrames     = 3,
  257.     kQTVRPlayEveryViewFrame     = 4,                            /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  258.                                                                 /* View Animation Settings*/
  259.     kQTVRSyncViewToFrameRate    = 16,
  260.     kQTVRPalindromeViews        = 17,
  261.     kQTVRPlayStreamingViews     = 18                            /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  262. };
  265. typedef UInt32 QTVRControlSetting;
  266. enum {
  267.     kQTVRWrapPan                = 1,
  268.     kQTVRWrapTilt               = 2,
  269.     kQTVRCanZoom                = 3,
  270.     kQTVRReverseHControl        = 4,
  271.     kQTVRReverseVControl        = 5,
  272.     kQTVRSwapHVControl          = 6,
  273.     kQTVRTranslation            = 7
  274. };
  277. typedef UInt32 QTVRViewStateType;
  278. enum {
  279.     kQTVRDefault                = 0,
  280.     kQTVRCurrent                = 2,
  281.     kQTVRMouseDown              = 3
  282. };
  285. typedef UInt32 QTVRNudgeControl;
  286. enum {
  287.     kQTVRRight                  = 0,
  288.     kQTVRUpRight                = 45,
  289.     kQTVRUp                     = 90,
  290.     kQTVRUpLeft                 = 135,
  291.     kQTVRLeft                   = 180,
  292.     kQTVRDownLeft               = 225,
  293.     kQTVRDown                   = 270,
  294.     kQTVRDownRight              = 315
  295. };
  298. typedef UInt32 QTVRNudgeMode;
  299. enum {
  300.     kQTVRNudgeRotate            = 0,
  301.     kQTVRNudgeTranslate         = 1,
  302.     kQTVRNudgeSameAsMouse       = 2
  303. };
  306. /* Flags to control elements of the QTVR control bar (set via mcActionSetFlags) */
  307. enum {
  308.     mcFlagQTVRSuppressBackBtn   = 1L << 16,
  309.     mcFlagQTVRSuppressZoomBtns  = 1L << 17,
  310.     mcFlagQTVRSuppressHotSpotBtn = 1L << 18,
  311.     mcFlagQTVRSuppressTranslateBtn = 1L << 19,
  312.     mcFlagQTVRSuppressHelpText  = 1L << 20,
  313.     mcFlagQTVRSuppressHotSpotNames = 1L << 21,
  314.     mcFlagQTVRExplicitFlagSet   = 1L << 31                      /* bits 0->30 should be interpreted as "explicit on" for the corresponding suppression bits*/
  315. };
  317. /* Cursor types used in type field of QTVRCursorRecord*/
  318. enum {
  319.     kQTVRUseDefaultCursor       = 0,
  320.     kQTVRStdCursorType          = 1,
  321.     kQTVRColorCursorType        = 2
  322. };
  324. /* Values for flags parameter in QTVRMouseOverHotSpot callback*/
  325. enum {
  326.     kQTVRHotSpotEnter           = 0,
  327.     kQTVRHotSpotWithin          = 1,
  328.     kQTVRHotSpotLeave           = 2
  329. };
  331. /* Values for flags parameter in QTVRSetPrescreenImagingCompleteProc*/
  332. enum {
  333.     kQTVRPreScreenEveryIdle     = 1L << 0                       /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  334. };
  336. /* Values for flags field of areasOfInterest in QTVRSetBackBufferImagingProc*/
  337. enum {
  338.     kQTVRBackBufferEveryUpdate  = 1L << 0,
  339.     kQTVRBackBufferEveryIdle    = 1L << 1,
  340.     kQTVRBackBufferAlwaysRefresh = 1L << 2,
  341.     kQTVRBackBufferHorizontal   = 1L << 3                       /* Requires that backbuffer proc be long-rowBytes aware (gestaltQDHasLongRowBytes)*/
  342. };
  344. /* Values for flagsIn parameter in QTVRBackBufferImaging callback*/
  345. enum {
  346.     kQTVRBackBufferRectVisible  = 1L << 0,
  347.     kQTVRBackBufferWasRefreshed = 1L << 1
  348. };
  350. /* Values for flagsOut parameter in QTVRBackBufferImaging callback*/
  351. enum {
  352.     kQTVRBackBufferFlagDidDraw  = 1L << 0,
  353.     kQTVRBackBufferFlagLastFlag = 1L << 31
  354. };
  356. /* QTVRCursorRecord used in QTVRReplaceCursor*/
  358. struct QTVRCursorRecord {
  359.     UInt16                          theType;                    /* field was previously named "type"*/
  360.     SInt16                          rsrcID;
  361.     Handle                          handle;
  362. };
  363. typedef struct QTVRCursorRecord         QTVRCursorRecord;
  365. struct QTVRFloatPoint {
  366.     float                           x;
  367.     float                           y;
  368. };
  369. typedef struct QTVRFloatPoint           QTVRFloatPoint;
  370. /* Struct used for areasOfInterest parameter in QTVRSetBackBufferImagingProc*/
  372. struct QTVRAreaOfInterest {
  373.     float                           panAngle;
  374.     float                           tiltAngle;
  375.     float                           width;
  376.     float                           height;
  377.     UInt32                          flags;
  378. };
  379. typedef struct QTVRAreaOfInterest       QTVRAreaOfInterest;
  380. /*
  381.   =================================================================================================
  382.    Callback routines 
  383.   -------------------------------------------------------------------------------------------------
  384. */
  386. typedef CALLBACK_API( OSErr , QTVRLeavingNodeProcPtr )(QTVRInstance qtvr, UInt32 fromNodeID, UInt32 toNodeID, Boolean *cancel, SInt32 refCon);
  387. typedef CALLBACK_API( OSErr , QTVREnteringNodeProcPtr )(QTVRInstance qtvr, UInt32 nodeID, SInt32 refCon);
  388. typedef CALLBACK_API( OSErr , QTVRMouseOverHotSpotProcPtr )(QTVRInstance qtvr, UInt32 hotSpotID, UInt32 flags, SInt32 refCon);
  389. typedef CALLBACK_API( OSErr , QTVRImagingCompleteProcPtr )(QTVRInstance qtvr, SInt32 refCon);
  390. typedef CALLBACK_API( OSErr , QTVRBackBufferImagingProcPtr )(QTVRInstance qtvr, Rect *drawRect, UInt16 areaIndex, UInt32 flagsIn, UInt32 *flagsOut, SInt32 refCon);
  391. typedef STACK_UPP_TYPE(QTVRLeavingNodeProcPtr)                  QTVRLeavingNodeUPP;
  392. typedef STACK_UPP_TYPE(QTVREnteringNodeProcPtr)                 QTVREnteringNodeUPP;
  393. typedef STACK_UPP_TYPE(QTVRMouseOverHotSpotProcPtr)             QTVRMouseOverHotSpotUPP;
  394. typedef STACK_UPP_TYPE(QTVRImagingCompleteProcPtr)              QTVRImagingCompleteUPP;
  395. typedef STACK_UPP_TYPE(QTVRBackBufferImagingProcPtr)            QTVRBackBufferImagingUPP;
  396. #if OPAQUE_UPP_TYPES
  397.     EXTERN_API(QTVRLeavingNodeUPP)
  398.     NewQTVRLeavingNodeUPP          (QTVRLeavingNodeProcPtr  userRoutine);
  400.     EXTERN_API(QTVREnteringNodeUPP)
  401.     NewQTVREnteringNodeUPP         (QTVREnteringNodeProcPtr userRoutine);
  403.     EXTERN_API(QTVRMouseOverHotSpotUPP)
  404.     NewQTVRMouseOverHotSpotUPP     (QTVRMouseOverHotSpotProcPtr userRoutine);
  406.     EXTERN_API(QTVRImagingCompleteUPP)
  407.     NewQTVRImagingCompleteUPP      (QTVRImagingCompleteProcPtr userRoutine);
  409.     EXTERN_API(QTVRBackBufferImagingUPP)
  410.     NewQTVRBackBufferImagingUPP    (QTVRBackBufferImagingProcPtr userRoutine);
  412.     EXTERN_API(void)
  413.     DisposeQTVRLeavingNodeUPP      (QTVRLeavingNodeUPP      userUPP);
  415.     EXTERN_API(void)
  416.     DisposeQTVREnteringNodeUPP     (QTVREnteringNodeUPP     userUPP);
  418.     EXTERN_API(void)
  419.     DisposeQTVRMouseOverHotSpotUPP    (QTVRMouseOverHotSpotUPP userUPP);
  421.     EXTERN_API(void)
  422.     DisposeQTVRImagingCompleteUPP    (QTVRImagingCompleteUPP userUPP);
  424.     EXTERN_API(void)
  425.     DisposeQTVRBackBufferImagingUPP    (QTVRBackBufferImagingUPP userUPP);
  427.     EXTERN_API(OSErr)
  428.     InvokeQTVRLeavingNodeUPP       (QTVRInstance            qtvr,
  429.                                     UInt32                  fromNodeID,
  430.                                     UInt32                  toNodeID,
  431.                                     Boolean *               cancel,
  432.                                     SInt32                  refCon,
  433.                                     QTVRLeavingNodeUPP      userUPP);
  435.     EXTERN_API(OSErr)
  436.     InvokeQTVREnteringNodeUPP      (QTVRInstance            qtvr,
  437.                                     UInt32                  nodeID,
  438.                                     SInt32                  refCon,
  439.                                     QTVREnteringNodeUPP     userUPP);
  441.     EXTERN_API(OSErr)
  442.     InvokeQTVRMouseOverHotSpotUPP    (QTVRInstance          qtvr,
  443.                                     UInt32                  hotSpotID,
  444.                                     UInt32                  flags,
  445.                                     SInt32                  refCon,
  446.                                     QTVRMouseOverHotSpotUPP userUPP);
  448.     EXTERN_API(OSErr)
  449.     InvokeQTVRImagingCompleteUPP    (QTVRInstance           qtvr,
  450.                                     SInt32                  refCon,
  451.                                     QTVRImagingCompleteUPP  userUPP);
  453.     EXTERN_API(OSErr)
  454.     InvokeQTVRBackBufferImagingUPP    (QTVRInstance         qtvr,
  455.                                     Rect *                  drawRect,
  456.                                     UInt16                  areaIndex,
  457.                                     UInt32                  flagsIn,
  458.                                     UInt32 *                flagsOut,
  459.                                     SInt32                  refCon,
  460.                                     QTVRBackBufferImagingUPP userUPP);
  462. #else
  463.     enum { uppQTVRLeavingNodeProcInfo = 0x0000FFE0 };               /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes) */
  464.     enum { uppQTVREnteringNodeProcInfo = 0x00000FE0 };              /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes) */
  465.     enum { uppQTVRMouseOverHotSpotProcInfo = 0x00003FE0 };          /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */
  466.     enum { uppQTVRImagingCompleteProcInfo = 0x000003E0 };           /* pascal 2_bytes Func(4_bytes, 4_bytes) */
  467.     enum { uppQTVRBackBufferImagingProcInfo = 0x0003FBE0 };         /* pascal 2_bytes Func(4_bytes, 4_bytes, 2_bytes, 4_bytes, 4_bytes, 4_bytes) */
  468.     #define NewQTVRLeavingNodeUPP(userRoutine)                      (QTVRLeavingNodeUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRLeavingNodeProcInfo, GetCurrentArchitecture())
  469.     #define NewQTVREnteringNodeUPP(userRoutine)                     (QTVREnteringNodeUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVREnteringNodeProcInfo, GetCurrentArchitecture())
  470.     #define NewQTVRMouseOverHotSpotUPP(userRoutine)                 (QTVRMouseOverHotSpotUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRMouseOverHotSpotProcInfo, GetCurrentArchitecture())
  471.     #define NewQTVRImagingCompleteUPP(userRoutine)                  (QTVRImagingCompleteUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRImagingCompleteProcInfo, GetCurrentArchitecture())
  472.     #define NewQTVRBackBufferImagingUPP(userRoutine)                (QTVRBackBufferImagingUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRBackBufferImagingProcInfo, GetCurrentArchitecture())
  473.     #define DisposeQTVRLeavingNodeUPP(userUPP)                      DisposeRoutineDescriptor(userUPP)
  474.     #define DisposeQTVREnteringNodeUPP(userUPP)                     DisposeRoutineDescriptor(userUPP)
  475.     #define DisposeQTVRMouseOverHotSpotUPP(userUPP)                 DisposeRoutineDescriptor(userUPP)
  476.     #define DisposeQTVRImagingCompleteUPP(userUPP)                  DisposeRoutineDescriptor(userUPP)
  477.     #define DisposeQTVRBackBufferImagingUPP(userUPP)                DisposeRoutineDescriptor(userUPP)
  478.     #define InvokeQTVRLeavingNodeUPP(qtvr, fromNodeID, toNodeID, cancel, refCon, userUPP)  (OSErr)CALL_FIVE_PARAMETER_UPP((userUPP), uppQTVRLeavingNodeProcInfo, (qtvr), (fromNodeID), (toNodeID), (cancel), (refCon))
  479.     #define InvokeQTVREnteringNodeUPP(qtvr, nodeID, refCon, userUPP)  (OSErr)CALL_THREE_PARAMETER_UPP((userUPP), uppQTVREnteringNodeProcInfo, (qtvr), (nodeID), (refCon))
  480.     #define InvokeQTVRMouseOverHotSpotUPP(qtvr, hotSpotID, flags, refCon, userUPP)  (OSErr)CALL_FOUR_PARAMETER_UPP((userUPP), uppQTVRMouseOverHotSpotProcInfo, (qtvr), (hotSpotID), (flags), (refCon))
  481.     #define InvokeQTVRImagingCompleteUPP(qtvr, refCon, userUPP)     (OSErr)CALL_TWO_PARAMETER_UPP((userUPP), uppQTVRImagingCompleteProcInfo, (qtvr), (refCon))
  482.     #define InvokeQTVRBackBufferImagingUPP(qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon, userUPP)  (OSErr)CALL_SIX_PARAMETER_UPP((userUPP), uppQTVRBackBufferImagingProcInfo, (qtvr), (drawRect), (areaIndex), (flagsIn), (flagsOut), (refCon))
  483. #endif
  484. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  485. #define NewQTVRLeavingNodeProc(userRoutine)                     NewQTVRLeavingNodeUPP(userRoutine)
  486. #define NewQTVREnteringNodeProc(userRoutine)                    NewQTVREnteringNodeUPP(userRoutine)
  487. #define NewQTVRMouseOverHotSpotProc(userRoutine)                NewQTVRMouseOverHotSpotUPP(userRoutine)
  488. #define NewQTVRImagingCompleteProc(userRoutine)                 NewQTVRImagingCompleteUPP(userRoutine)
  489. #define NewQTVRBackBufferImagingProc(userRoutine)               NewQTVRBackBufferImagingUPP(userRoutine)
  490. #define CallQTVRLeavingNodeProc(userRoutine, qtvr, fromNodeID, toNodeID, cancel, refCon) InvokeQTVRLeavingNodeUPP(qtvr, fromNodeID, toNodeID, cancel, refCon, userRoutine)
  491. #define CallQTVREnteringNodeProc(userRoutine, qtvr, nodeID, refCon) InvokeQTVREnteringNodeUPP(qtvr, nodeID, refCon, userRoutine)
  492. #define CallQTVRMouseOverHotSpotProc(userRoutine, qtvr, hotSpotID, flags, refCon) InvokeQTVRMouseOverHotSpotUPP(qtvr, hotSpotID, flags, refCon, userRoutine)
  493. #define CallQTVRImagingCompleteProc(userRoutine, qtvr, refCon)  InvokeQTVRImagingCompleteUPP(qtvr, refCon, userRoutine)
  494. #define CallQTVRBackBufferImagingProc(userRoutine, qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon) InvokeQTVRBackBufferImagingUPP(qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon, userRoutine)
  495. /*
  496.   =================================================================================================
  497.     QTVR Intercept Struct, Callback, Routine Descriptors 
  498.   -------------------------------------------------------------------------------------------------
  499. */
  502. typedef UInt32 QTVRProcSelector;
  503. enum {
  504.     kQTVRSetPanAngleSelector    = 0x2000,
  505.     kQTVRSetTiltAngleSelector   = 0x2001,
  506.     kQTVRSetFieldOfViewSelector = 0x2002,
  507.     kQTVRSetViewCenterSelector  = 0x2003,
  508.     kQTVRMouseEnterSelector     = 0x2004,
  509.     kQTVRMouseWithinSelector    = 0x2005,
  510.     kQTVRMouseLeaveSelector     = 0x2006,
  511.     kQTVRMouseDownSelector      = 0x2007,
  512.     kQTVRMouseStillDownSelector = 0x2008,
  513.     kQTVRMouseUpSelector        = 0x2009,
  514.     kQTVRTriggerHotSpotSelector = 0x200A,
  515.     kQTVRGetHotSpotTypeSelector = 0x200B,                       /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  516.     kQTVRSetViewParameterSelector = 0x200C,                     /* Requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
  517.     kQTVRGetViewParameterSelector = 0x200D                      /* Requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
  518. };
  521. struct QTVRInterceptRecord {
  522.     SInt32                          reserved1;
  523.     SInt32                          selector;
  525.     SInt32                          reserved2;
  526.     SInt32                          reserved3;
  528.     SInt32                          paramCount;
  529.     void *                          parameter[6];
  530. };
  531. typedef struct QTVRInterceptRecord      QTVRInterceptRecord;
  533. typedef QTVRInterceptRecord *           QTVRInterceptPtr;
  534. /* Prototype for Intercept Proc callback*/
  535. typedef CALLBACK_API( void , QTVRInterceptProcPtr )(QTVRInstance qtvr, QTVRInterceptPtr qtvrMsg, SInt32 refCon, Boolean *cancel);
  536. typedef STACK_UPP_TYPE(QTVRInterceptProcPtr)                    QTVRInterceptUPP;
  537. #if OPAQUE_UPP_TYPES
  538.     EXTERN_API(QTVRInterceptUPP)
  539.     NewQTVRInterceptUPP            (QTVRInterceptProcPtr    userRoutine);
  541.     EXTERN_API(void)
  542.     DisposeQTVRInterceptUPP        (QTVRInterceptUPP        userUPP);
  544.     EXTERN_API(void)
  545.     InvokeQTVRInterceptUPP         (QTVRInstance            qtvr,
  546.                                     QTVRInterceptPtr        qtvrMsg,
  547.                                     SInt32                  refCon,
  548.                                     Boolean *               cancel,
  549.                                     QTVRInterceptUPP        userUPP);
  551. #else
  552.     enum { uppQTVRInterceptProcInfo = 0x00003FC0 };                 /* pascal no_return_value Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */
  553.     #define NewQTVRInterceptUPP(userRoutine)                        (QTVRInterceptUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRInterceptProcInfo, GetCurrentArchitecture())
  554.     #define DisposeQTVRInterceptUPP(userUPP)                        DisposeRoutineDescriptor(userUPP)
  555.     #define InvokeQTVRInterceptUPP(qtvr, qtvrMsg, refCon, cancel, userUPP)  CALL_FOUR_PARAMETER_UPP((userUPP), uppQTVRInterceptProcInfo, (qtvr), (qtvrMsg), (refCon), (cancel))
  556. #endif
  557. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  558. #define NewQTVRInterceptProc(userRoutine)                       NewQTVRInterceptUPP(userRoutine)
  559. #define CallQTVRInterceptProc(userRoutine, qtvr, qtvrMsg, refCon, cancel) InvokeQTVRInterceptUPP(qtvr, qtvrMsg, refCon, cancel, userRoutine)
  560. /*
  561.   =================================================================================================
  562.     Initialization QTVR calls 
  563.   -------------------------------------------------------------------------------------------------
  564.    Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10) and only work on Non-Macintosh platforms
  565. */
  566. #if !TARGET_OS_MAC
  567. #if CALL_NOT_IN_CARBON
  568. EXTERN_API_C( OSErr )
  569. InitializeQTVR                  (void);
  571. EXTERN_API_C( OSErr )
  572. TerminateQTVR                   (void);
  574. #endif  /* CALL_NOT_IN_CARBON */
  576. #endif  /* !TARGET_OS_MAC */
  578. /*
  579.   =================================================================================================
  580.     General QTVR calls 
  581.   -------------------------------------------------------------------------------------------------
  582. */
  583. EXTERN_API_C( Track )
  584. QTVRGetQTVRTrack                (Movie                  theMovie,
  585.                                  SInt32                 index);
  587. EXTERN_API_C( OSErr )
  588. QTVRGetQTVRInstance             (QTVRInstance *         qtvr,
  589.                                  Track                  qtvrTrack,
  590.                                  MovieController        mc);
  592. /*
  593.   =================================================================================================
  594.     Viewing Angles and Zooming 
  595.   -------------------------------------------------------------------------------------------------
  596. */
  598. /* QTVRSetViewParameter requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
  599. EXTERN_API_C( OSErr )
  600. QTVRSetViewParameter            (QTVRInstance           qtvr,
  601.                                  UInt32                 viewParameter,
  602.                                  void *                 value,
  603.                                  UInt32                 flagsIn);
  605. /* QTVRGetViewParameter requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
  606. EXTERN_API_C( OSErr )
  607. QTVRGetViewParameter            (QTVRInstance           qtvr,
  608.                                  UInt32                 viewParameter,
  609.                                  void *                 value,
  610.                                  UInt32                 flagsIn,
  611.                                  UInt32 *               flagsOut);
  613. EXTERN_API_C( OSErr )
  614. QTVRSetPanAngle                 (QTVRInstance           qtvr,
  615.                                  float                  panAngle);
  617. EXTERN_API_C( float )
  618. QTVRGetPanAngle                 (QTVRInstance           qtvr);
  620. EXTERN_API_C( OSErr )
  621. QTVRSetTiltAngle                (QTVRInstance           qtvr,
  622.                                  float                  tiltAngle);
  624. EXTERN_API_C( float )
  625. QTVRGetTiltAngle                (QTVRInstance           qtvr);
  627. EXTERN_API_C( OSErr )
  628. QTVRSetFieldOfView              (QTVRInstance           qtvr,
  629.                                  float                  fieldOfView);
  631. EXTERN_API_C( float )
  632. QTVRGetFieldOfView              (QTVRInstance           qtvr);
  634. EXTERN_API_C( OSErr )
  635. QTVRShowDefaultView             (QTVRInstance           qtvr);
  637. /* Object Specific*/
  638. EXTERN_API_C( OSErr )
  639. QTVRSetViewCenter               (QTVRInstance           qtvr,
  640.                                  const QTVRFloatPoint * viewCenter);
  642. EXTERN_API_C( OSErr )
  643. QTVRGetViewCenter               (QTVRInstance           qtvr,
  644.                                  QTVRFloatPoint *       viewCenter);
  646. EXTERN_API_C( OSErr )
  647. QTVRNudge                       (QTVRInstance           qtvr,
  648.                                  QTVRNudgeControl       direction);
  650. /* QTVRInteractionNudge requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  651. EXTERN_API_C( OSErr )
  652. QTVRInteractionNudge            (QTVRInstance           qtvr,
  653.                                  QTVRNudgeControl       direction);
  655. /*
  656.   =================================================================================================
  657.     Scene and Node Location Information 
  658.   -------------------------------------------------------------------------------------------------
  659. */
  661. EXTERN_API_C( OSErr )
  662. QTVRGetVRWorld                  (QTVRInstance           qtvr,
  663.                                  QTAtomContainer *      VRWorld);
  665. EXTERN_API_C( OSErr )
  666. QTVRGetNodeInfo                 (QTVRInstance           qtvr,
  667.                                  UInt32                 nodeID,
  668.                                  QTAtomContainer *      nodeInfo);
  670. EXTERN_API_C( OSErr )
  671. QTVRGoToNodeID                  (QTVRInstance           qtvr,
  672.                                  UInt32                 nodeID);
  674. EXTERN_API_C( UInt32 )
  675. QTVRGetCurrentNodeID            (QTVRInstance           qtvr);
  677. EXTERN_API_C( OSType )
  678. QTVRGetNodeType                 (QTVRInstance           qtvr,
  679.                                  UInt32                 nodeID);
  681. /*
  682.   =================================================================================================
  683.     Hot Spot related calls 
  684.   -------------------------------------------------------------------------------------------------
  685. */
  687. EXTERN_API_C( OSErr )
  688. QTVRPtToHotSpotID               (QTVRInstance           qtvr,
  689.                                  Point                  pt,
  690.                                  UInt32 *               hotSpotID);
  692. /* QTVRGetHotSpotType requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  693. EXTERN_API_C( OSErr )
  694. QTVRGetHotSpotType              (QTVRInstance           qtvr,
  695.                                  UInt32                 hotSpotID,
  696.                                  OSType *               hotSpotType);
  698. EXTERN_API_C( OSErr )
  699. QTVRTriggerHotSpot              (QTVRInstance           qtvr,
  700.                                  UInt32                 hotSpotID,
  701.                                  QTAtomContainer        nodeInfo,
  702.                                  QTAtom                 selectedAtom);
  704. EXTERN_API_C( OSErr )
  705. QTVRSetMouseOverHotSpotProc     (QTVRInstance           qtvr,
  706.                                  QTVRMouseOverHotSpotUPP  mouseOverHotSpotProc,
  707.                                  SInt32                 refCon,
  708.                                  UInt32                 flags);
  710. EXTERN_API_C( OSErr )
  711. QTVREnableHotSpot               (QTVRInstance           qtvr,
  712.                                  UInt32                 enableFlag,
  713.                                  UInt32                 hotSpotValue,
  714.                                  Boolean                enable);
  716. EXTERN_API_C( UInt32 )
  717. QTVRGetVisibleHotSpots          (QTVRInstance           qtvr,
  718.                                  Handle                 hotSpots);
  720. EXTERN_API_C( OSErr )
  721. QTVRGetHotSpotRegion            (QTVRInstance           qtvr,
  722.                                  UInt32                 hotSpotID,
  723.                                  RgnHandle              hotSpotRegion);
  725. /*
  726.   =================================================================================================
  727.     Event & Cursor Handling Calls 
  728.   -------------------------------------------------------------------------------------------------
  729. */
  731. EXTERN_API_C( OSErr )
  732. QTVRSetMouseOverTracking        (QTVRInstance           qtvr,
  733.                                  Boolean                enable);
  735. EXTERN_API_C( Boolean )
  736. QTVRGetMouseOverTracking        (QTVRInstance           qtvr);
  738. EXTERN_API_C( OSErr )
  739. QTVRSetMouseDownTracking        (QTVRInstance           qtvr,
  740.                                  Boolean                enable);
  742. EXTERN_API_C( Boolean )
  743. QTVRGetMouseDownTracking        (QTVRInstance           qtvr);
  745. EXTERN_API_C( OSErr )
  746. QTVRMouseEnter                  (QTVRInstance           qtvr,
  747.                                  Point                  pt,
  748.                                  UInt32 *               hotSpotID,
  749.                                  WindowRef              w);
  751. EXTERN_API_C( OSErr )
  752. QTVRMouseWithin                 (QTVRInstance           qtvr,
  753.                                  Point                  pt,
  754.                                  UInt32 *               hotSpotID,
  755.                                  WindowRef              w);
  757. EXTERN_API_C( OSErr )
  758. QTVRMouseLeave                  (QTVRInstance           qtvr,
  759.                                  Point                  pt,
  760.                                  WindowRef              w);
  762. EXTERN_API_C( OSErr )
  763. QTVRMouseDown                   (QTVRInstance           qtvr,
  764.                                  Point                  pt,
  765.                                  UInt32                 when,
  766.                                  UInt16                 modifiers,
  767.                                  UInt32 *               hotSpotID,
  768.                                  WindowRef              w);
  770. EXTERN_API_C( OSErr )
  771. QTVRMouseStillDown              (QTVRInstance           qtvr,
  772.                                  Point                  pt,
  773.                                  UInt32 *               hotSpotID,
  774.                                  WindowRef              w);
  776. EXTERN_API_C( OSErr )
  777. QTVRMouseUp                     (QTVRInstance           qtvr,
  778.                                  Point                  pt,
  779.                                  UInt32 *               hotSpotID,
  780.                                  WindowRef              w);
  782. /* These require QTVR 2.01 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion01)*/
  783. EXTERN_API_C( OSErr )
  784. QTVRMouseStillDownExtended      (QTVRInstance           qtvr,
  785.                                  Point                  pt,
  786.                                  UInt32 *               hotSpotID,
  787.                                  WindowRef              w,
  788.                                  UInt32                 when,
  789.                                  UInt16                 modifiers);
  791. EXTERN_API_C( OSErr )
  792. QTVRMouseUpExtended             (QTVRInstance           qtvr,
  793.                                  Point                  pt,
  794.                                  UInt32 *               hotSpotID,
  795.                                  WindowRef              w,
  796.                                  UInt32                 when,
  797.                                  UInt16                 modifiers);
  799. /*
  800.   =================================================================================================
  801.     Intercept Routines 
  802.   -------------------------------------------------------------------------------------------------
  803. */
  805. EXTERN_API_C( OSErr )
  806. QTVRInstallInterceptProc        (QTVRInstance           qtvr,
  807.                                  QTVRProcSelector       selector,
  808.                                  QTVRInterceptUPP       interceptProc,
  809.                                  SInt32                 refCon,
  810.                                  UInt32                 flags);
  812. EXTERN_API_C( OSErr )
  813. QTVRCallInterceptedProc         (QTVRInstance           qtvr,
  814.                                  QTVRInterceptRecord *  qtvrMsg);
  816. /*
  817.   =================================================================================================
  818.     Object Movie Specific Calls 
  819.   -------------------------------------------------------------------------------------------------
  820.    QTVRGetCurrentMouseMode requires QTRVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)
  821. */
  822. EXTERN_API_C( UInt32 )
  823. QTVRGetCurrentMouseMode         (QTVRInstance           qtvr);
  825. EXTERN_API_C( OSErr )
  826. QTVRSetFrameRate                (QTVRInstance           qtvr,
  827.                                  float                  rate);
  829. EXTERN_API_C( float )
  830. QTVRGetFrameRate                (QTVRInstance           qtvr);
  832. EXTERN_API_C( OSErr )
  833. QTVRSetViewRate                 (QTVRInstance           qtvr,
  834.                                  float                  rate);
  836. EXTERN_API_C( float )
  837. QTVRGetViewRate                 (QTVRInstance           qtvr);
  839. EXTERN_API_C( OSErr )
  840. QTVRSetViewCurrentTime          (QTVRInstance           qtvr,
  841.                                  TimeValue              time);
  843. EXTERN_API_C( TimeValue )
  844. QTVRGetViewCurrentTime          (QTVRInstance           qtvr);
  846. EXTERN_API_C( TimeValue )
  847. QTVRGetCurrentViewDuration      (QTVRInstance           qtvr);
  849. /*
  850.   =================================================================================================
  851.    View State Calls - QTVR Object Only
  852.   -------------------------------------------------------------------------------------------------
  853. */
  855. EXTERN_API_C( OSErr )
  856. QTVRSetViewState                (QTVRInstance           qtvr,
  857.                                  QTVRViewStateType      viewStateType,
  858.                                  UInt16                 state);
  860. EXTERN_API_C( OSErr )
  861. QTVRGetViewState                (QTVRInstance           qtvr,
  862.                                  QTVRViewStateType      viewStateType,
  863.                                  UInt16 *               state);
  865. EXTERN_API_C( UInt16 )
  866. QTVRGetViewStateCount           (QTVRInstance           qtvr);
  868. EXTERN_API_C( OSErr )
  869. QTVRSetAnimationSetting         (QTVRInstance           qtvr,
  870.                                  QTVRObjectAnimationSetting  setting,
  871.                                  Boolean                enable);
  873. EXTERN_API_C( OSErr )
  874. QTVRGetAnimationSetting         (QTVRInstance           qtvr,
  875.                                  QTVRObjectAnimationSetting  setting,
  876.                                  Boolean *              enable);
  878. EXTERN_API_C( OSErr )
  879. QTVRSetControlSetting           (QTVRInstance           qtvr,
  880.                                  QTVRControlSetting     setting,
  881.                                  Boolean                enable);
  883. EXTERN_API_C( OSErr )
  884. QTVRGetControlSetting           (QTVRInstance           qtvr,
  885.                                  QTVRControlSetting     setting,
  886.                                  Boolean *              enable);
  888. EXTERN_API_C( OSErr )
  889. QTVREnableFrameAnimation        (QTVRInstance           qtvr,
  890.                                  Boolean                enable);
  892. EXTERN_API_C( Boolean )
  893. QTVRGetFrameAnimation           (QTVRInstance           qtvr);
  895. EXTERN_API_C( OSErr )
  896. QTVREnableViewAnimation         (QTVRInstance           qtvr,
  897.                                  Boolean                enable);
  899. EXTERN_API_C( Boolean )
  900. QTVRGetViewAnimation            (QTVRInstance           qtvr);
  903. /*
  904.   =================================================================================================
  905.     Imaging Characteristics 
  906.   -------------------------------------------------------------------------------------------------
  907. */
  909. EXTERN_API_C( OSErr )
  910. QTVRSetVisible                  (QTVRInstance           qtvr,
  911.                                  Boolean                visible);
  913. EXTERN_API_C( Boolean )
  914. QTVRGetVisible                  (QTVRInstance           qtvr);
  916. EXTERN_API_C( OSErr )
  917. QTVRSetImagingProperty          (QTVRInstance           qtvr,
  918.                                  QTVRImagingMode        imagingMode,
  919.                                  UInt32                 imagingProperty,
  920.                                  SInt32                 propertyValue);
  922. EXTERN_API_C( OSErr )
  923. QTVRGetImagingProperty          (QTVRInstance           qtvr,
  924.                                  QTVRImagingMode        imagingMode,
  925.                                  UInt32                 imagingProperty,
  926.                                  SInt32 *               propertyValue);
  928. EXTERN_API_C( OSErr )
  929. QTVRUpdate                      (QTVRInstance           qtvr,
  930.                                  QTVRImagingMode        imagingMode);
  932. EXTERN_API_C( OSErr )
  933. QTVRBeginUpdateStream           (QTVRInstance           qtvr,
  934.                                  QTVRImagingMode        imagingMode);
  936. EXTERN_API_C( OSErr )
  937. QTVREndUpdateStream             (QTVRInstance           qtvr);
  939. EXTERN_API_C( OSErr )
  940. QTVRSetTransitionProperty       (QTVRInstance           qtvr,
  941.                                  UInt32                 transitionType,
  942.                                  UInt32                 transitionProperty,
  943.                                  SInt32                 transitionValue);
  945. EXTERN_API_C( OSErr )
  946. QTVREnableTransition            (QTVRInstance           qtvr,
  947.                                  UInt32                 transitionType,
  948.                                  Boolean                enable);
  950. /*
  951.   =================================================================================================
  952.     Basic Conversion and Math Routines 
  953.   -------------------------------------------------------------------------------------------------
  954. */
  956. EXTERN_API_C( OSErr )
  957. QTVRSetAngularUnits             (QTVRInstance           qtvr,
  958.                                  QTVRAngularUnits       units);
  960. EXTERN_API_C( QTVRAngularUnits )
  961. QTVRGetAngularUnits             (QTVRInstance           qtvr);
  963. /* Pano specific routines*/
  964. EXTERN_API_C( OSErr )
  965. QTVRPtToAngles                  (QTVRInstance           qtvr,
  966.                                  Point                  pt,
  967.                                  float *                panAngle,
  968.                                  float *                tiltAngle);
  970. EXTERN_API_C( OSErr )
  971. QTVRCoordToAngles               (QTVRInstance           qtvr,
  972.                                  QTVRFloatPoint *       coord,
  973.                                  float *                panAngle,
  974.                                  float *                tiltAngle);
  976. EXTERN_API_C( OSErr )
  977. QTVRAnglesToCoord               (QTVRInstance           qtvr,
  978.                                  float                  panAngle,
  979.                                  float                  tiltAngle,
  980.                                  QTVRFloatPoint *       coord);
  982. /* Object specific routines*/
  983. EXTERN_API_C( short )
  984. QTVRPanToColumn                 (QTVRInstance           qtvr,
  985.                                  float                  panAngle);
  987. /* zero based   */
  988. EXTERN_API_C( float )
  989. QTVRColumnToPan                 (QTVRInstance           qtvr,
  990.                                  short                  column);
  992. /* zero based   */
  993. EXTERN_API_C( short )
  994. QTVRTiltToRow                   (QTVRInstance           qtvr,
  995.                                  float                  tiltAngle);
  997. /* zero based   */
  998. EXTERN_API_C( float )
  999. QTVRRowToTilt                   (QTVRInstance           qtvr,
  1000.                                  short                  row);
  1002. /* zero based               */
  1003. EXTERN_API_C( OSErr )
  1004. QTVRWrapAndConstrain            (QTVRInstance           qtvr,
  1005.                                  short                  kind,
  1006.                                  float                  value,
  1007.                                  float *                result);
  1010. /*
  1011.   =================================================================================================
  1012.     Interaction Routines 
  1013.   -------------------------------------------------------------------------------------------------
  1014. */
  1016. EXTERN_API_C( OSErr )
  1017. QTVRSetEnteringNodeProc         (QTVRInstance           qtvr,
  1018.                                  QTVREnteringNodeUPP    enteringNodeProc,
  1019.                                  SInt32                 refCon,
  1020.                                  UInt32                 flags);
  1022. EXTERN_API_C( OSErr )
  1023. QTVRSetLeavingNodeProc          (QTVRInstance           qtvr,
  1024.                                  QTVRLeavingNodeUPP     leavingNodeProc,
  1025.                                  SInt32                 refCon,
  1026.                                  UInt32                 flags);
  1028. EXTERN_API_C( OSErr )
  1029. QTVRSetInteractionProperty      (QTVRInstance           qtvr,
  1030.                                  UInt32                 property,
  1031.                                  void *                 value);
  1033. EXTERN_API_C( OSErr )
  1034. QTVRGetInteractionProperty      (QTVRInstance           qtvr,
  1035.                                  UInt32                 property,
  1036.                                  void *                 value);
  1038. EXTERN_API_C( OSErr )
  1039. QTVRReplaceCursor               (QTVRInstance           qtvr,
  1040.                                  QTVRCursorRecord *     cursRecord);
  1042. /*
  1043.   =================================================================================================
  1044.     Viewing Limits and Constraints 
  1045.   -------------------------------------------------------------------------------------------------
  1046. */
  1048. EXTERN_API_C( OSErr )
  1049. QTVRGetViewingLimits            (QTVRInstance           qtvr,
  1050.                                  UInt16                 kind,
  1051.                                  float *                minValue,
  1052.                                  float *                maxValue);
  1054. EXTERN_API_C( UInt32 )
  1055. QTVRGetConstraintStatus         (QTVRInstance           qtvr);
  1057. EXTERN_API_C( OSErr )
  1058. QTVRGetConstraints              (QTVRInstance           qtvr,
  1059.                                  UInt16                 kind,
  1060.                                  float *                minValue,
  1061.                                  float *                maxValue);
  1063. EXTERN_API_C( OSErr )
  1064. QTVRSetConstraints              (QTVRInstance           qtvr,
  1065.                                  UInt16                 kind,
  1066.                                  float                  minValue,
  1067.                                  float                  maxValue);
  1070. /*
  1071.   =================================================================================================
  1072.     Back Buffer Memory Management 
  1073.   -------------------------------------------------------------------------------------------------
  1074. */
  1076. EXTERN_API_C( OSErr )
  1077. QTVRGetAvailableResolutions     (QTVRInstance           qtvr,
  1078.                                  UInt16 *               resolutionsMask);
  1080. /* These require QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
  1081. EXTERN_API_C( OSErr )
  1082. QTVRGetBackBufferMemInfo        (QTVRInstance           qtvr,
  1083.                                  UInt32                 geometry,
  1084.                                  UInt16                 resolution,
  1085.                                  UInt32                 cachePixelFormat,
  1086.                                  SInt32 *               minCacheBytes,
  1087.                                  SInt32 *               suggestedCacheBytes,
  1088.                                  SInt32 *               fullCacheBytes);
  1090. EXTERN_API_C( OSErr )
  1091. QTVRGetBackBufferSettings       (QTVRInstance           qtvr,
  1092.                                  UInt32 *               geometry,
  1093.                                  UInt16 *               resolution,
  1094.                                  UInt32 *               cachePixelFormat,
  1095.                                  SInt16 *               cacheSize);
  1097. EXTERN_API_C( OSErr )
  1098. QTVRSetBackBufferPrefs          (QTVRInstance           qtvr,
  1099.                                  UInt32                 geometry,
  1100.                                  UInt16                 resolution,
  1101.                                  UInt32                 cachePixelFormat,
  1102.                                  SInt16                 cacheSize);
  1104. /*
  1105.   =================================================================================================
  1106.     Buffer Access 
  1107.   -------------------------------------------------------------------------------------------------
  1108. */
  1110. EXTERN_API_C( OSErr )
  1111. QTVRSetPrescreenImagingCompleteProc (QTVRInstance       qtvr,
  1112.                                  QTVRImagingCompleteUPP  imagingCompleteProc,
  1113.                                  SInt32                 refCon,
  1114.                                  UInt32                 flags);
  1116. EXTERN_API_C( OSErr )
  1117. QTVRSetBackBufferImagingProc    (QTVRInstance           qtvr,
  1118.                                  QTVRBackBufferImagingUPP  backBufferImagingProc,
  1119.                                  UInt16                 numAreas,
  1120.                                  QTVRAreaOfInterest     areasOfInterest[],
  1121.                                  SInt32                 refCon);
  1123. EXTERN_API_C( OSErr )
  1124. QTVRRefreshBackBuffer           (QTVRInstance           qtvr,
  1125.                                  UInt32                 flags);
  1129. /*
  1130.   =================================================================================================
  1131.     Old Names
  1132.   -------------------------------------------------------------------------------------------------
  1133. */
  1134. #if OLDROUTINENAMES
  1135. typedef QTVRCursorRecord                CursorRecord;
  1136. typedef QTVRAreaOfInterest              AreaOfInterest;
  1137. typedef QTVRFloatPoint                  FloatPoint;
  1138. typedef QTVRLeavingNodeProcPtr          LeavingNodeProcPtr;
  1139. typedef QTVRLeavingNodeUPP              LeavingNodeUPP;
  1140. typedef QTVREnteringNodeProcPtr         EnteringNodeProcPtr;
  1141. typedef QTVREnteringNodeUPP             EnteringNodeUPP;
  1142. typedef QTVRMouseOverHotSpotProcPtr     MouseOverHotSpotProcPtr;
  1143. typedef QTVRMouseOverHotSpotUPP         MouseOverHotSpotUPP;
  1144. typedef QTVRImagingCompleteProcPtr      ImagingCompleteProcPtr;
  1145. typedef QTVRImagingCompleteUPP          ImagingCompleteUPP;
  1146. typedef QTVRBackBufferImagingProcPtr    BackBufferImagingProcPtr;
  1147. typedef QTVRBackBufferImagingUPP        BackBufferImagingUPP;
  1148. #endif  /* OLDROUTINENAMES */
  1152. #if PRAGMA_STRUCT_ALIGN
  1153.     #pragma options align=reset
  1154. #elif PRAGMA_STRUCT_PACKPUSH
  1155.     #pragma pack(pop)
  1156. #elif PRAGMA_STRUCT_PACK
  1157.     #pragma pack()
  1158. #endif
  1160. #ifdef PRAGMA_IMPORT_OFF
  1161. #pragma import off
  1162. #elif PRAGMA_IMPORT
  1163. #pragma import reset
  1164. #endif
  1166. #ifdef __cplusplus
  1167. }
  1168. #endif
  1170. #endif /* __QUICKTIMEVR__ */