d4708
/
source-engine
mirror of https://github.com/nillerusr/source-engine.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Modified source engine (2017) developed by valve and leaked in 2020. Not for commercial purporses
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
132 Commits
25 Branches
6 Tags
221 MiB
Tree: 875e52e29e
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '875e52e29e'
${ noResults }
source-engine/common/quicktime_win32/QuickTimeVR.h

2460 lines
73 KiB
Raw Normal View History Unescape

1
5 years ago
/*
File: QuickTimeVR.h
Contains: QuickTime VR interfaces
Version: QuickTime 7.3
Copyright: (c) 2007 (c) 1997-2007 by Apple Inc., all rights reserved.
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
#ifndef __QUICKTIMEVR__
#define __QUICKTIMEVR__
#ifndef __MACTYPES__
#include <MacTypes.h>
#endif
#ifndef __MOVIES__
#include <Movies.h>
#endif
#if PRAGMA_ONCE
#pragma once
#endif
#ifdef __cplusplus
extern "C" {
#endif
#if PRAGMA_IMPORT
#pragma import on
#endif
#if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
#pragma pack(2)
#endif
/* QuickTime is not available to 64-bit clients */
#if !__LP64__
typedef struct OpaqueQTVRInstance* QTVRInstance;
/* Released API Version numbers */
#define kQTVRAPIMajorVersion05 (0x05)
#define kQTVRAPIMajorVersion02 (0x02)
#define kQTVRAPIMinorVersion00 (0x00)
#define kQTVRAPIMinorVersion01 (0x01)
#define kQTVRAPIMinorVersion10 (0x10)
#define kQTVRAPIMinorVersion20 (0x20)
/* Version numbers for the API described in this header */
#define kQTVRAPIMajorVersion kQTVRAPIMajorVersion05
#define kQTVRAPIMinorVersion kQTVRAPIMinorVersion00
enum {
kQTVRControllerSubType = FOUR_CHAR_CODE('ctyp'),
kQTVRQTVRType = FOUR_CHAR_CODE('qtvr'),
kQTVRPanoramaType = FOUR_CHAR_CODE('pano'),
kQTVRObjectType = FOUR_CHAR_CODE('obje'),
kQTVROldPanoType = FOUR_CHAR_CODE('STpn'), /* Used in QTVR 1.0 release*/
kQTVROldObjectType = FOUR_CHAR_CODE('stna') /* Used in QTVR 1.0 release*/
};
#define kQTVRUnknownType '\?\?\?\?' /* Unknown node type */
/* QTVR hot spot types*/
enum {
kQTVRHotSpotLinkType = FOUR_CHAR_CODE('link'),
kQTVRHotSpotURLType = FOUR_CHAR_CODE('url '),
kQTVRHotSpotUndefinedType = FOUR_CHAR_CODE('undf')
};
/* Special Values for nodeID in QTVRGoToNodeID*/
enum {
kQTVRCurrentNode = 0,
kQTVRPreviousNode = (long)0x80000000,
kQTVRDefaultNode = (long)0x80000001
};
/* Panorama correction modes used for the kQTVRImagingCorrection imaging property*/
enum {
kQTVRNoCorrection = 0,
kQTVRPartialCorrection = 1,
kQTVRFullCorrection = 2
};
/* Imaging Modes used by QTVRSetImagingProperty, QTVRGetImagingProperty, QTVRUpdate, QTVRBeginUpdate*/
typedef UInt32 QTVRImagingMode;
enum {
kQTVRStatic = 1,
kQTVRMotion = 2,
kQTVRCurrentMode = 0, /* Special Value for QTVRUpdate*/
kQTVRAllModes = 100 /* Special value for QTVRSetProperty*/
};
/* Imaging Properties used by QTVRSetImagingProperty, QTVRGetImagingProperty*/
enum {
kQTVRImagingCorrection = 1,
kQTVRImagingQuality = 2,
kQTVRImagingDirectDraw = 3,
kQTVRImagingCurrentMode = 100 /* Get Only*/
};
/* OR the above with kImagingDefaultValue to get/set the default value*/
enum {
kImagingDefaultValue = (long)0x80000000
};
/* Transition Types used by QTVRSetTransitionProperty, QTVREnableTransition*/
enum {
kQTVRTransitionSwing = 1
};
/* Transition Properties QTVRSetTransitionProperty*/
enum {
kQTVRTransitionSpeed = 1,
kQTVRTransitionDirection = 2
};
/* Constraint values used to construct value returned by GetConstraintStatus*/
enum {
kQTVRUnconstrained = 0L,
kQTVRCantPanLeft = 1L << 0,
kQTVRCantPanRight = 1L << 1,
kQTVRCantPanUp = 1L << 2,
kQTVRCantPanDown = 1L << 3,
kQTVRCantZoomIn = 1L << 4,
kQTVRCantZoomOut = 1L << 5,
kQTVRCantTranslateLeft = 1L << 6,
kQTVRCantTranslateRight = 1L << 7,
kQTVRCantTranslateUp = 1L << 8,
kQTVRCantTranslateDown = 1L << 9
};
/* Object-only mouse mode values used to construct value returned by QTVRGetCurrentMouseMode*/
enum {
kQTVRPanning = 1L << 0, /* standard objects, "object only" controllers*/
kQTVRTranslating = 1L << 1, /* all objects*/
kQTVRZooming = 1L << 2, /* all objects*/
kQTVRScrolling = 1L << 3, /* standard object arrow scrollers and joystick object*/
kQTVRSelecting = 1L << 4 /* object absolute controller*/
};
/* Properties for use with QTVRSetInteractionProperty/GetInteractionProperty*/
enum {
kQTVRInteractionMouseClickHysteresis = 1, /* pixels within which the mouse is considered not to have moved (UInt16)*/
kQTVRInteractionMouseClickTimeout = 2, /* ticks after which a mouse click times out and turns into panning (UInt32)*/
kQTVRInteractionPanTiltSpeed = 3, /* control the relative pan/tilt speed from 1 (slowest) to 10 (fastest). (UInt32) Default is 5;*/
kQTVRInteractionZoomSpeed = 4, /* control the relative zooming speed from 1 (slowest) to 10 (fastest). (UInt32) Default is 5;*/
kQTVRInteractionTranslateOnMouseDown = 101, /* Holding MouseDown with this setting translates zoomed object movies (Boolean)*/
kQTVRInteractionMouseMotionScale = 102, /* The maximum angle of rotation caused by dragging across the display window. (* float)*/
kQTVRInteractionNudgeMode = 103 /* A QTVRNudgeMode: rotate, translate, or the same as the current mouse mode. Requires QTVR 2.1*/
};
/* OR the above with kQTVRInteractionDefaultValue to get/set the default value*/
enum {
kQTVRInteractionDefaultValue = (long)0x80000000
};
/* Geometry constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings, QTVRGetBackBufferMemInfo*/
enum {
kQTVRUseMovieGeometry = 0,
kQTVRVerticalCylinder = FOUR_CHAR_CODE('vcyl'),
kQTVRHorizontalCylinder = FOUR_CHAR_CODE('hcyl'),
kQTVRCube = FOUR_CHAR_CODE('cube')
};
/* Resolution constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings, QTVRGetBackBufferMemInfo*/
enum {
kQTVRDefaultRes = 0,
kQTVRFullRes = 1L << 0,
kQTVRHalfRes = 1L << 1,
kQTVRQuarterRes = 1L << 2
};
/* QTVR-specific pixelFormat constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings, QTVRGetBackBufferMemInfo*/
enum {
kQTVRUseMovieDepth = 0
};
/* Cache Size Pref constants used in QTVRSetBackBufferPrefs, QTVRGetBackBufferSettings*/
enum {
kQTVRMinimumCache = -1,
kQTVRSuggestedCache = 0,
kQTVRFullCache = 1
};
/* Angular units used by QTVRSetAngularUnits*/
typedef UInt32 QTVRAngularUnits;
enum {
kQTVRDegrees = 0,
kQTVRRadians = 1
};
/* Values for enableFlag parameter in QTVREnableHotSpot*/
enum {
kQTVRHotSpotID = 0,
kQTVRHotSpotType = 1,
kQTVRAllHotSpots = 2
};
/* Values for viewParameter for QTVRSet/GetViewParameter*/
enum {
kQTVRPanAngle = 0x0100, /* default units; &float, &float*/
kQTVRTiltAngle = 0x0101, /* default units; &float, &float*/
kQTVRFieldOfViewAngle = 0x0103, /* default units; &float, &float*/
kQTVRViewCenter = 0x0104, /* pixels (per object movies); &QTVRFloatPoint, &QTVRFloatPoint*/
kQTVRHotSpotsVisible = 0x0200 /* Boolean, &Boolean*/
};
/* Values for flagsIn for QTVRSet/GetViewParameter*/
enum {
kQTVRValueIsRelative = 1L << 0, /* Is the value absolute or relative to the current value?*/
kQTVRValueIsRate = 1L << 1, /* Is the value absolute or a rate of change to be applied?*/
kQTVRValueIsUserPrefRelative = 1L << 2 /* Is the value a percentage of the user rate pref?*/
};
/* Values for kind parameter in QTVRGet/SetConstraints, QTVRGetViewingLimits*/
enum {
kQTVRPan = 0,
kQTVRTilt = 1,
kQTVRFieldOfView = 2,
kQTVRViewCenterH = 4, /* WrapAndConstrain only*/
kQTVRViewCenterV = 5 /* WrapAndConstrain only*/
};
/* Values for setting parameter in QTVRSetAnimationSetting, QTVRGetAnimationSetting*/
typedef UInt32 QTVRObjectAnimationSetting;
enum {
/* View Frame Animation Settings*/
kQTVRPalindromeViewFrames = 1,
kQTVRStartFirstViewFrame = 2,
kQTVRDontLoopViewFrames = 3,
kQTVRPlayEveryViewFrame = 4, /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
/* View Animation Settings*/
kQTVRSyncViewToFrameRate = 16,
kQTVRPalindromeViews = 17,
kQTVRPlayStreamingViews = 18 /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
};
typedef UInt32 QTVRControlSetting;
enum {
kQTVRWrapPan = 1,
kQTVRWrapTilt = 2,
kQTVRCanZoom = 3,
kQTVRReverseHControl = 4,
kQTVRReverseVControl = 5,
kQTVRSwapHVControl = 6,
kQTVRTranslation = 7
};
typedef UInt32 QTVRViewStateType;
enum {
kQTVRDefault = 0,
kQTVRCurrent = 2,
kQTVRMouseDown = 3
};
typedef UInt32 QTVRNudgeControl;
enum {
kQTVRRight = 0,
kQTVRUpRight = 45,
kQTVRUp = 90,
kQTVRUpLeft = 135,
kQTVRLeft = 180,
kQTVRDownLeft = 225,
kQTVRDown = 270,
kQTVRDownRight = 315
};
typedef UInt32 QTVRNudgeMode;
enum {
kQTVRNudgeRotate = 0,
kQTVRNudgeTranslate = 1,
kQTVRNudgeSameAsMouse = 2
};
/* Flags to control elements of the QTVR control bar (set via mcActionSetFlags) */
enum {
mcFlagQTVRSuppressBackBtn = 1L << 16,
mcFlagQTVRSuppressZoomBtns = 1L << 17,
mcFlagQTVRSuppressHotSpotBtn = 1L << 18,
mcFlagQTVRSuppressTranslateBtn = 1L << 19,
mcFlagQTVRSuppressHelpText = 1L << 20,
mcFlagQTVRSuppressHotSpotNames = 1L << 21,
mcFlagQTVRExplicitFlagSet = 1L << 31 /* bits 0->30 should be interpreted as "explicit on" for the corresponding suppression bits*/
};
/* Cursor types used in type field of QTVRCursorRecord*/
enum {
kQTVRUseDefaultCursor = 0,
kQTVRStdCursorType = 1,
kQTVRColorCursorType = 2
};
/* Values for flags parameter in QTVRMouseOverHotSpot callback*/
enum {
kQTVRHotSpotEnter = 0,
kQTVRHotSpotWithin = 1,
kQTVRHotSpotLeave = 2
};
/* Values for flags parameter in QTVRSetPrescreenImagingCompleteProc*/
enum {
kQTVRPreScreenEveryIdle = 1L << 0 /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
};
/* Values for flags field of areasOfInterest in QTVRSetBackBufferImagingProc*/
enum {
kQTVRBackBufferEveryUpdate = 1L << 0,
kQTVRBackBufferEveryIdle = 1L << 1,
kQTVRBackBufferAlwaysRefresh = 1L << 2,
kQTVRBackBufferHorizontal = 1L << 3 /* Requires that backbuffer proc be long-rowBytes aware (gestaltQDHasLongRowBytes)*/
};
/* Values for flagsIn parameter in QTVRBackBufferImaging callback*/
enum {
kQTVRBackBufferRectVisible = 1L << 0,
kQTVRBackBufferWasRefreshed = 1L << 1
};
/* Values for flagsOut parameter in QTVRBackBufferImaging callback*/
enum {
kQTVRBackBufferFlagDidDraw = 1L << 0,
kQTVRBackBufferFlagLastFlag = 1L << 31
};
/* QTVRCursorRecord used in QTVRReplaceCursor*/
struct QTVRCursorRecord {
UInt16 theType; /* field was previously named "type"*/
SInt16 rsrcID;
Handle handle;
};
typedef struct QTVRCursorRecord QTVRCursorRecord;
struct QTVRFloatPoint {
float x;
float y;
};
typedef struct QTVRFloatPoint QTVRFloatPoint;
/* Struct used for areasOfInterest parameter in QTVRSetBackBufferImagingProc*/
struct QTVRAreaOfInterest {
float panAngle;
float tiltAngle;
float width;
float height;
UInt32 flags;
};
typedef struct QTVRAreaOfInterest QTVRAreaOfInterest;
/*
=================================================================================================
Callback routines
-------------------------------------------------------------------------------------------------
*/
typedef CALLBACK_API( OSErr , QTVRLeavingNodeProcPtr )(QTVRInstance qtvr, UInt32 fromNodeID, UInt32 toNodeID, Boolean *cancel, SInt32 refCon);
typedef CALLBACK_API( OSErr , QTVREnteringNodeProcPtr )(QTVRInstance qtvr, UInt32 nodeID, SInt32 refCon);
typedef CALLBACK_API( OSErr , QTVRMouseOverHotSpotProcPtr )(QTVRInstance qtvr, UInt32 hotSpotID, UInt32 flags, SInt32 refCon);
typedef CALLBACK_API( OSErr , QTVRImagingCompleteProcPtr )(QTVRInstance qtvr, SInt32 refCon);
typedef CALLBACK_API( OSErr , QTVRBackBufferImagingProcPtr )(QTVRInstance qtvr, Rect *drawRect, UInt16 areaIndex, UInt32 flagsIn, UInt32 *flagsOut, SInt32 refCon);
typedef STACK_UPP_TYPE(QTVRLeavingNodeProcPtr) QTVRLeavingNodeUPP;
typedef STACK_UPP_TYPE(QTVREnteringNodeProcPtr) QTVREnteringNodeUPP;
typedef STACK_UPP_TYPE(QTVRMouseOverHotSpotProcPtr) QTVRMouseOverHotSpotUPP;
typedef STACK_UPP_TYPE(QTVRImagingCompleteProcPtr) QTVRImagingCompleteUPP;
typedef STACK_UPP_TYPE(QTVRBackBufferImagingProcPtr) QTVRBackBufferImagingUPP;
/*
* NewQTVRLeavingNodeUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( QTVRLeavingNodeUPP )
NewQTVRLeavingNodeUPP(QTVRLeavingNodeProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum { uppQTVRLeavingNodeProcInfo = 0x0000FFE0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes) */
#ifdef __cplusplus
inline DEFINE_API_C(QTVRLeavingNodeUPP) NewQTVRLeavingNodeUPP(QTVRLeavingNodeProcPtr userRoutine) { return (QTVRLeavingNodeUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRLeavingNodeProcInfo, GetCurrentArchitecture()); }
#else
#define NewQTVRLeavingNodeUPP(userRoutine) (QTVRLeavingNodeUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRLeavingNodeProcInfo, GetCurrentArchitecture())
#endif
#endif
/*
* NewQTVREnteringNodeUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( QTVREnteringNodeUPP )
NewQTVREnteringNodeUPP(QTVREnteringNodeProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum { uppQTVREnteringNodeProcInfo = 0x00000FE0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes) */
#ifdef __cplusplus
inline DEFINE_API_C(QTVREnteringNodeUPP) NewQTVREnteringNodeUPP(QTVREnteringNodeProcPtr userRoutine) { return (QTVREnteringNodeUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVREnteringNodeProcInfo, GetCurrentArchitecture()); }
#else
#define NewQTVREnteringNodeUPP(userRoutine) (QTVREnteringNodeUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVREnteringNodeProcInfo, GetCurrentArchitecture())
#endif
#endif
/*
* NewQTVRMouseOverHotSpotUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( QTVRMouseOverHotSpotUPP )
NewQTVRMouseOverHotSpotUPP(QTVRMouseOverHotSpotProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum { uppQTVRMouseOverHotSpotProcInfo = 0x00003FE0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */
#ifdef __cplusplus
inline DEFINE_API_C(QTVRMouseOverHotSpotUPP) NewQTVRMouseOverHotSpotUPP(QTVRMouseOverHotSpotProcPtr userRoutine) { return (QTVRMouseOverHotSpotUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRMouseOverHotSpotProcInfo, GetCurrentArchitecture()); }
#else
#define NewQTVRMouseOverHotSpotUPP(userRoutine) (QTVRMouseOverHotSpotUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRMouseOverHotSpotProcInfo, GetCurrentArchitecture())
#endif
#endif
/*
* NewQTVRImagingCompleteUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( QTVRImagingCompleteUPP )
NewQTVRImagingCompleteUPP(QTVRImagingCompleteProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum { uppQTVRImagingCompleteProcInfo = 0x000003E0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes) */
#ifdef __cplusplus
inline DEFINE_API_C(QTVRImagingCompleteUPP) NewQTVRImagingCompleteUPP(QTVRImagingCompleteProcPtr userRoutine) { return (QTVRImagingCompleteUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRImagingCompleteProcInfo, GetCurrentArchitecture()); }
#else
#define NewQTVRImagingCompleteUPP(userRoutine) (QTVRImagingCompleteUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRImagingCompleteProcInfo, GetCurrentArchitecture())
#endif
#endif
/*
* NewQTVRBackBufferImagingUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( QTVRBackBufferImagingUPP )
NewQTVRBackBufferImagingUPP(QTVRBackBufferImagingProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum { uppQTVRBackBufferImagingProcInfo = 0x0003FBE0 }; /* pascal 2_bytes Func(4_bytes, 4_bytes, 2_bytes, 4_bytes, 4_bytes, 4_bytes) */
#ifdef __cplusplus
inline DEFINE_API_C(QTVRBackBufferImagingUPP) NewQTVRBackBufferImagingUPP(QTVRBackBufferImagingProcPtr userRoutine) { return (QTVRBackBufferImagingUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRBackBufferImagingProcInfo, GetCurrentArchitecture()); }
#else
#define NewQTVRBackBufferImagingUPP(userRoutine) (QTVRBackBufferImagingUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRBackBufferImagingProcInfo, GetCurrentArchitecture())
#endif
#endif
/*
* DisposeQTVRLeavingNodeUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
DisposeQTVRLeavingNodeUPP(QTVRLeavingNodeUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) DisposeQTVRLeavingNodeUPP(QTVRLeavingNodeUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
#else
#define DisposeQTVRLeavingNodeUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
/*
* DisposeQTVREnteringNodeUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
DisposeQTVREnteringNodeUPP(QTVREnteringNodeUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) DisposeQTVREnteringNodeUPP(QTVREnteringNodeUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
#else
#define DisposeQTVREnteringNodeUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
/*
* DisposeQTVRMouseOverHotSpotUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
DisposeQTVRMouseOverHotSpotUPP(QTVRMouseOverHotSpotUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) DisposeQTVRMouseOverHotSpotUPP(QTVRMouseOverHotSpotUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
#else
#define DisposeQTVRMouseOverHotSpotUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
/*
* DisposeQTVRImagingCompleteUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
DisposeQTVRImagingCompleteUPP(QTVRImagingCompleteUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) DisposeQTVRImagingCompleteUPP(QTVRImagingCompleteUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
#else
#define DisposeQTVRImagingCompleteUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
/*
* DisposeQTVRBackBufferImagingUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
DisposeQTVRBackBufferImagingUPP(QTVRBackBufferImagingUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) DisposeQTVRBackBufferImagingUPP(QTVRBackBufferImagingUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
#else
#define DisposeQTVRBackBufferImagingUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
/*
* InvokeQTVRLeavingNodeUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( OSErr )
InvokeQTVRLeavingNodeUPP(
QTVRInstance qtvr,
UInt32 fromNodeID,
UInt32 toNodeID,
Boolean * cancel,
SInt32 refCon,
QTVRLeavingNodeUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(OSErr) InvokeQTVRLeavingNodeUPP(QTVRInstance qtvr, UInt32 fromNodeID, UInt32 toNodeID, Boolean * cancel, SInt32 refCon, QTVRLeavingNodeUPP userUPP) { return (OSErr)CALL_FIVE_PARAMETER_UPP(userUPP, uppQTVRLeavingNodeProcInfo, qtvr, fromNodeID, toNodeID, cancel, refCon); }
#else
#define InvokeQTVRLeavingNodeUPP(qtvr, fromNodeID, toNodeID, cancel, refCon, userUPP) (OSErr)CALL_FIVE_PARAMETER_UPP((userUPP), uppQTVRLeavingNodeProcInfo, (qtvr), (fromNodeID), (toNodeID), (cancel), (refCon))
#endif
#endif
/*
* InvokeQTVREnteringNodeUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( OSErr )
InvokeQTVREnteringNodeUPP(
QTVRInstance qtvr,
UInt32 nodeID,
SInt32 refCon,
QTVREnteringNodeUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(OSErr) InvokeQTVREnteringNodeUPP(QTVRInstance qtvr, UInt32 nodeID, SInt32 refCon, QTVREnteringNodeUPP userUPP) { return (OSErr)CALL_THREE_PARAMETER_UPP(userUPP, uppQTVREnteringNodeProcInfo, qtvr, nodeID, refCon); }
#else
#define InvokeQTVREnteringNodeUPP(qtvr, nodeID, refCon, userUPP) (OSErr)CALL_THREE_PARAMETER_UPP((userUPP), uppQTVREnteringNodeProcInfo, (qtvr), (nodeID), (refCon))
#endif
#endif
/*
* InvokeQTVRMouseOverHotSpotUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( OSErr )
InvokeQTVRMouseOverHotSpotUPP(
QTVRInstance qtvr,
UInt32 hotSpotID,
UInt32 flags,
SInt32 refCon,
QTVRMouseOverHotSpotUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(OSErr) InvokeQTVRMouseOverHotSpotUPP(QTVRInstance qtvr, UInt32 hotSpotID, UInt32 flags, SInt32 refCon, QTVRMouseOverHotSpotUPP userUPP) { return (OSErr)CALL_FOUR_PARAMETER_UPP(userUPP, uppQTVRMouseOverHotSpotProcInfo, qtvr, hotSpotID, flags, refCon); }
#else
#define InvokeQTVRMouseOverHotSpotUPP(qtvr, hotSpotID, flags, refCon, userUPP) (OSErr)CALL_FOUR_PARAMETER_UPP((userUPP), uppQTVRMouseOverHotSpotProcInfo, (qtvr), (hotSpotID), (flags), (refCon))
#endif
#endif
/*
* InvokeQTVRImagingCompleteUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( OSErr )
InvokeQTVRImagingCompleteUPP(
QTVRInstance qtvr,
SInt32 refCon,
QTVRImagingCompleteUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(OSErr) InvokeQTVRImagingCompleteUPP(QTVRInstance qtvr, SInt32 refCon, QTVRImagingCompleteUPP userUPP) { return (OSErr)CALL_TWO_PARAMETER_UPP(userUPP, uppQTVRImagingCompleteProcInfo, qtvr, refCon); }
#else
#define InvokeQTVRImagingCompleteUPP(qtvr, refCon, userUPP) (OSErr)CALL_TWO_PARAMETER_UPP((userUPP), uppQTVRImagingCompleteProcInfo, (qtvr), (refCon))
#endif
#endif
/*
* InvokeQTVRBackBufferImagingUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( OSErr )
InvokeQTVRBackBufferImagingUPP(
QTVRInstance qtvr,
Rect * drawRect,
UInt16 areaIndex,
UInt32 flagsIn,
UInt32 * flagsOut,
SInt32 refCon,
QTVRBackBufferImagingUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(OSErr) InvokeQTVRBackBufferImagingUPP(QTVRInstance qtvr, Rect * drawRect, UInt16 areaIndex, UInt32 flagsIn, UInt32 * flagsOut, SInt32 refCon, QTVRBackBufferImagingUPP userUPP) { return (OSErr)CALL_SIX_PARAMETER_UPP(userUPP, uppQTVRBackBufferImagingProcInfo, qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon); }
#else
#define InvokeQTVRBackBufferImagingUPP(qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon, userUPP) (OSErr)CALL_SIX_PARAMETER_UPP((userUPP), uppQTVRBackBufferImagingProcInfo, (qtvr), (drawRect), (areaIndex), (flagsIn), (flagsOut), (refCon))
#endif
#endif
#if CALL_NOT_IN_CARBON || OLDROUTINENAMES
/* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
#define NewQTVRLeavingNodeProc(userRoutine) NewQTVRLeavingNodeUPP(userRoutine)
#define NewQTVREnteringNodeProc(userRoutine) NewQTVREnteringNodeUPP(userRoutine)
#define NewQTVRMouseOverHotSpotProc(userRoutine) NewQTVRMouseOverHotSpotUPP(userRoutine)
#define NewQTVRImagingCompleteProc(userRoutine) NewQTVRImagingCompleteUPP(userRoutine)
#define NewQTVRBackBufferImagingProc(userRoutine) NewQTVRBackBufferImagingUPP(userRoutine)
#define CallQTVRLeavingNodeProc(userRoutine, qtvr, fromNodeID, toNodeID, cancel, refCon) InvokeQTVRLeavingNodeUPP(qtvr, fromNodeID, toNodeID, cancel, refCon, userRoutine)
#define CallQTVREnteringNodeProc(userRoutine, qtvr, nodeID, refCon) InvokeQTVREnteringNodeUPP(qtvr, nodeID, refCon, userRoutine)
#define CallQTVRMouseOverHotSpotProc(userRoutine, qtvr, hotSpotID, flags, refCon) InvokeQTVRMouseOverHotSpotUPP(qtvr, hotSpotID, flags, refCon, userRoutine)
#define CallQTVRImagingCompleteProc(userRoutine, qtvr, refCon) InvokeQTVRImagingCompleteUPP(qtvr, refCon, userRoutine)
#define CallQTVRBackBufferImagingProc(userRoutine, qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon) InvokeQTVRBackBufferImagingUPP(qtvr, drawRect, areaIndex, flagsIn, flagsOut, refCon, userRoutine)
#endif /* CALL_NOT_IN_CARBON */
/*
=================================================================================================
QTVR Intercept Struct, Callback, Routine Descriptors
-------------------------------------------------------------------------------------------------
*/
typedef UInt32 QTVRProcSelector;
enum {
kQTVRSetPanAngleSelector = 0x2000,
kQTVRSetTiltAngleSelector = 0x2001,
kQTVRSetFieldOfViewSelector = 0x2002,
kQTVRSetViewCenterSelector = 0x2003,
kQTVRMouseEnterSelector = 0x2004,
kQTVRMouseWithinSelector = 0x2005,
kQTVRMouseLeaveSelector = 0x2006,
kQTVRMouseDownSelector = 0x2007,
kQTVRMouseStillDownSelector = 0x2008,
kQTVRMouseUpSelector = 0x2009,
kQTVRTriggerHotSpotSelector = 0x200A,
kQTVRGetHotSpotTypeSelector = 0x200B, /* Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
kQTVRSetViewParameterSelector = 0x200C, /* Requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
kQTVRGetViewParameterSelector = 0x200D /* Requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
};
struct QTVRInterceptRecord {
SInt32 reserved1;
SInt32 selector;
SInt32 reserved2;
SInt32 reserved3;
SInt32 paramCount;
void * parameter[6];
};
typedef struct QTVRInterceptRecord QTVRInterceptRecord;
typedef QTVRInterceptRecord * QTVRInterceptPtr;
/* Prototype for Intercept Proc callback*/
typedef CALLBACK_API( void , QTVRInterceptProcPtr )(QTVRInstance qtvr, QTVRInterceptPtr qtvrMsg, SInt32 refCon, Boolean *cancel);
typedef STACK_UPP_TYPE(QTVRInterceptProcPtr) QTVRInterceptUPP;
/*
* NewQTVRInterceptUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( QTVRInterceptUPP )
NewQTVRInterceptUPP(QTVRInterceptProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum { uppQTVRInterceptProcInfo = 0x00003FC0 }; /* pascal no_return_value Func(4_bytes, 4_bytes, 4_bytes, 4_bytes) */
#ifdef __cplusplus
inline DEFINE_API_C(QTVRInterceptUPP) NewQTVRInterceptUPP(QTVRInterceptProcPtr userRoutine) { return (QTVRInterceptUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRInterceptProcInfo, GetCurrentArchitecture()); }
#else
#define NewQTVRInterceptUPP(userRoutine) (QTVRInterceptUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppQTVRInterceptProcInfo, GetCurrentArchitecture())
#endif
#endif
/*
* DisposeQTVRInterceptUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
DisposeQTVRInterceptUPP(QTVRInterceptUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) DisposeQTVRInterceptUPP(QTVRInterceptUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
#else
#define DisposeQTVRInterceptUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
/*
* InvokeQTVRInterceptUPP()
*
* Availability:
* Non-Carbon CFM: available as macro/inline
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
InvokeQTVRInterceptUPP(
QTVRInstance qtvr,
QTVRInterceptPtr qtvrMsg,
SInt32 refCon,
Boolean * cancel,
QTVRInterceptUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline DEFINE_API_C(void) InvokeQTVRInterceptUPP(QTVRInstance qtvr, QTVRInterceptPtr qtvrMsg, SInt32 refCon, Boolean * cancel, QTVRInterceptUPP userUPP) { CALL_FOUR_PARAMETER_UPP(userUPP, uppQTVRInterceptProcInfo, qtvr, qtvrMsg, refCon, cancel); }
#else
#define InvokeQTVRInterceptUPP(qtvr, qtvrMsg, refCon, cancel, userUPP) CALL_FOUR_PARAMETER_UPP((userUPP), uppQTVRInterceptProcInfo, (qtvr), (qtvrMsg), (refCon), (cancel))
#endif
#endif
#if CALL_NOT_IN_CARBON || OLDROUTINENAMES
/* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
#define NewQTVRInterceptProc(userRoutine) NewQTVRInterceptUPP(userRoutine)
#define CallQTVRInterceptProc(userRoutine, qtvr, qtvrMsg, refCon, cancel) InvokeQTVRInterceptUPP(qtvr, qtvrMsg, refCon, cancel, userRoutine)
#endif /* CALL_NOT_IN_CARBON */
/*
=================================================================================================
Initialization QTVR calls
-------------------------------------------------------------------------------------------------
Requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10) and only work on Non-Macintosh platforms
*/
#if !TARGET_OS_MAC
#if CALL_NOT_IN_CARBON
/*
* InitializeQTVR()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: not available
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
InitializeQTVR(void);
/*
* TerminateQTVR()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: not available
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
TerminateQTVR(void);
#endif /* CALL_NOT_IN_CARBON */
#endif /* !TARGET_OS_MAC */
/*
=================================================================================================
General QTVR calls
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRGetQTVRTrack()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( Track )
QTVRGetQTVRTrack(
Movie theMovie,
SInt32 index);
/*
* QTVRGetQTVRInstance()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetQTVRInstance(
QTVRInstance * qtvr,
Track qtvrTrack,
MovieController mc);
/*
=================================================================================================
Viewing Angles and Zooming
-------------------------------------------------------------------------------------------------
*/
/* QTVRSetViewParameter requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
/*
* QTVRSetViewParameter()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 5.0 and later
* CarbonLib: in CarbonLib 1.3 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 5.0 and later
*/
EXTERN_API_C( OSErr )
QTVRSetViewParameter(
QTVRInstance qtvr,
UInt32 viewParameter,
void * value,
UInt32 flagsIn);
/* QTVRGetViewParameter requires QTVR 5.0 (kQTVRAPIMajorVersion05 + kQTVRAPIMinorVersion00)*/
/*
* QTVRGetViewParameter()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 5.0 and later
* CarbonLib: in CarbonLib 1.3 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 5.0 and later
*/
EXTERN_API_C( OSErr )
QTVRGetViewParameter(
QTVRInstance qtvr,
UInt32 viewParameter,
void * value,
UInt32 flagsIn,
UInt32 * flagsOut);
/*
* QTVRSetPanAngle()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetPanAngle(
QTVRInstance qtvr,
float panAngle);
/*
* QTVRGetPanAngle()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRGetPanAngle(QTVRInstance qtvr);
/*
* QTVRSetTiltAngle()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetTiltAngle(
QTVRInstance qtvr,
float tiltAngle);
/*
* QTVRGetTiltAngle()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRGetTiltAngle(QTVRInstance qtvr);
/*
* QTVRSetFieldOfView()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetFieldOfView(
QTVRInstance qtvr,
float fieldOfView);
/*
* QTVRGetFieldOfView()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRGetFieldOfView(QTVRInstance qtvr);
/*
* QTVRShowDefaultView()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRShowDefaultView(QTVRInstance qtvr);
/* Object Specific*/
/*
* QTVRSetViewCenter()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetViewCenter(
QTVRInstance qtvr,
const QTVRFloatPoint * viewCenter);
/*
* QTVRGetViewCenter()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetViewCenter(
QTVRInstance qtvr,
QTVRFloatPoint * viewCenter);
/*
* QTVRNudge()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRNudge(
QTVRInstance qtvr,
QTVRNudgeControl direction);
/* QTVRInteractionNudge requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
/*
* QTVRInteractionNudge()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRInteractionNudge(
QTVRInstance qtvr,
QTVRNudgeControl direction);
/*
=================================================================================================
Scene and Node Location Information
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRGetVRWorld()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetVRWorld(
QTVRInstance qtvr,
QTAtomContainer * VRWorld);
/*
* QTVRGetNodeInfo()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetNodeInfo(
QTVRInstance qtvr,
UInt32 nodeID,
QTAtomContainer * nodeInfo);
/*
* QTVRGoToNodeID()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGoToNodeID(
QTVRInstance qtvr,
UInt32 nodeID);
/*
* QTVRGetCurrentNodeID()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( UInt32 )
QTVRGetCurrentNodeID(QTVRInstance qtvr);
/*
* QTVRGetNodeType()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSType )
QTVRGetNodeType(
QTVRInstance qtvr,
UInt32 nodeID);
/*
=================================================================================================
Hot Spot related calls
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRPtToHotSpotID()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRPtToHotSpotID(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID);
/* QTVRGetHotSpotType requires QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
/*
* QTVRGetHotSpotType()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetHotSpotType(
QTVRInstance qtvr,
UInt32 hotSpotID,
OSType * hotSpotType);
/*
* QTVRTriggerHotSpot()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRTriggerHotSpot(
QTVRInstance qtvr,
UInt32 hotSpotID,
QTAtomContainer nodeInfo,
QTAtom selectedAtom);
/*
* QTVRSetMouseOverHotSpotProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetMouseOverHotSpotProc(
QTVRInstance qtvr,
QTVRMouseOverHotSpotUPP mouseOverHotSpotProc,
SInt32 refCon,
UInt32 flags);
/*
* QTVREnableHotSpot()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVREnableHotSpot(
QTVRInstance qtvr,
UInt32 enableFlag,
UInt32 hotSpotValue,
Boolean enable);
/*
* QTVRGetVisibleHotSpots()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( UInt32 )
QTVRGetVisibleHotSpots(
QTVRInstance qtvr,
Handle hotSpots);
/*
* QTVRGetHotSpotRegion()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetHotSpotRegion(
QTVRInstance qtvr,
UInt32 hotSpotID,
RgnHandle hotSpotRegion);
/*
=================================================================================================
Event & Cursor Handling Calls
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRSetMouseOverTracking()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetMouseOverTracking(
QTVRInstance qtvr,
Boolean enable);
/*
* QTVRGetMouseOverTracking()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( Boolean )
QTVRGetMouseOverTracking(QTVRInstance qtvr);
/*
* QTVRSetMouseDownTracking()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetMouseDownTracking(
QTVRInstance qtvr,
Boolean enable);
/*
* QTVRGetMouseDownTracking()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( Boolean )
QTVRGetMouseDownTracking(QTVRInstance qtvr);
/*
* QTVRMouseEnter()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseEnter(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID,
WindowRef w);
/*
* QTVRMouseWithin()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseWithin(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID,
WindowRef w);
/*
* QTVRMouseLeave()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseLeave(
QTVRInstance qtvr,
Point pt,
WindowRef w);
/*
* QTVRMouseDown()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseDown(
QTVRInstance qtvr,
Point pt,
UInt32 when,
UInt16 modifiers,
UInt32 * hotSpotID,
WindowRef w);
/*
* QTVRMouseStillDown()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseStillDown(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID,
WindowRef w);
/*
* QTVRMouseUp()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseUp(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID,
WindowRef w);
/* These require QTVR 2.01 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion01)*/
/*
* QTVRMouseStillDownExtended()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseStillDownExtended(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID,
WindowRef w,
UInt32 when,
UInt16 modifiers);
/*
* QTVRMouseUpExtended()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRMouseUpExtended(
QTVRInstance qtvr,
Point pt,
UInt32 * hotSpotID,
WindowRef w,
UInt32 when,
UInt16 modifiers);
/*
=================================================================================================
Intercept Routines
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRInstallInterceptProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRInstallInterceptProc(
QTVRInstance qtvr,
QTVRProcSelector selector,
QTVRInterceptUPP interceptProc,
SInt32 refCon,
UInt32 flags);
/*
* QTVRCallInterceptedProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRCallInterceptedProc(
QTVRInstance qtvr,
QTVRInterceptRecord * qtvrMsg);
/*
=================================================================================================
Object Movie Specific Calls
-------------------------------------------------------------------------------------------------
QTVRGetCurrentMouseMode requires QTRVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)
*/
/*
* QTVRGetCurrentMouseMode()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( UInt32 )
QTVRGetCurrentMouseMode(QTVRInstance qtvr);
/*
* QTVRSetFrameRate()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetFrameRate(
QTVRInstance qtvr,
float rate);
/*
* QTVRGetFrameRate()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRGetFrameRate(QTVRInstance qtvr);
/*
* QTVRSetViewRate()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetViewRate(
QTVRInstance qtvr,
float rate);
/*
* QTVRGetViewRate()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRGetViewRate(QTVRInstance qtvr);
/*
* QTVRSetViewCurrentTime()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetViewCurrentTime(
QTVRInstance qtvr,
TimeValue time);
/*
* QTVRGetViewCurrentTime()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( TimeValue )
QTVRGetViewCurrentTime(QTVRInstance qtvr);
/*
* QTVRGetCurrentViewDuration()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( TimeValue )
QTVRGetCurrentViewDuration(QTVRInstance qtvr);
/*
=================================================================================================
View State Calls - QTVR Object Only
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRSetViewState()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetViewState(
QTVRInstance qtvr,
QTVRViewStateType viewStateType,
UInt16 state);
/*
* QTVRGetViewState()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetViewState(
QTVRInstance qtvr,
QTVRViewStateType viewStateType,
UInt16 * state);
/*
* QTVRGetViewStateCount()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( UInt16 )
QTVRGetViewStateCount(QTVRInstance qtvr);
/*
* QTVRSetAnimationSetting()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetAnimationSetting(
QTVRInstance qtvr,
QTVRObjectAnimationSetting setting,
Boolean enable);
/*
* QTVRGetAnimationSetting()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetAnimationSetting(
QTVRInstance qtvr,
QTVRObjectAnimationSetting setting,
Boolean * enable);
/*
* QTVRSetControlSetting()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetControlSetting(
QTVRInstance qtvr,
QTVRControlSetting setting,
Boolean enable);
/*
* QTVRGetControlSetting()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetControlSetting(
QTVRInstance qtvr,
QTVRControlSetting setting,
Boolean * enable);
/*
* QTVREnableFrameAnimation()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVREnableFrameAnimation(
QTVRInstance qtvr,
Boolean enable);
/*
* QTVRGetFrameAnimation()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( Boolean )
QTVRGetFrameAnimation(QTVRInstance qtvr);
/*
* QTVREnableViewAnimation()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVREnableViewAnimation(
QTVRInstance qtvr,
Boolean enable);
/*
* QTVRGetViewAnimation()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( Boolean )
QTVRGetViewAnimation(QTVRInstance qtvr);
/*
=================================================================================================
Imaging Characteristics
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRSetVisible()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetVisible(
QTVRInstance qtvr,
Boolean visible);
/*
* QTVRGetVisible()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( Boolean )
QTVRGetVisible(QTVRInstance qtvr);
/*
* QTVRSetImagingProperty()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetImagingProperty(
QTVRInstance qtvr,
QTVRImagingMode imagingMode,
UInt32 imagingProperty,
SInt32 propertyValue);
/*
* QTVRGetImagingProperty()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetImagingProperty(
QTVRInstance qtvr,
QTVRImagingMode imagingMode,
UInt32 imagingProperty,
SInt32 * propertyValue);
/*
* QTVRUpdate()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRUpdate(
QTVRInstance qtvr,
QTVRImagingMode imagingMode);
/*
* QTVRBeginUpdateStream()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRBeginUpdateStream(
QTVRInstance qtvr,
QTVRImagingMode imagingMode);
/*
* QTVREndUpdateStream()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVREndUpdateStream(QTVRInstance qtvr);
/*
* QTVRSetTransitionProperty()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetTransitionProperty(
QTVRInstance qtvr,
UInt32 transitionType,
UInt32 transitionProperty,
SInt32 transitionValue);
/*
* QTVREnableTransition()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVREnableTransition(
QTVRInstance qtvr,
UInt32 transitionType,
Boolean enable);
/*
=================================================================================================
Basic Conversion and Math Routines
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRSetAngularUnits()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetAngularUnits(
QTVRInstance qtvr,
QTVRAngularUnits units);
/*
* QTVRGetAngularUnits()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( QTVRAngularUnits )
QTVRGetAngularUnits(QTVRInstance qtvr);
/* Pano specific routines*/
/*
* QTVRPtToAngles()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRPtToAngles(
QTVRInstance qtvr,
Point pt,
float * panAngle,
float * tiltAngle);
/*
* QTVRCoordToAngles()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRCoordToAngles(
QTVRInstance qtvr,
QTVRFloatPoint * coord,
float * panAngle,
float * tiltAngle);
/*
* QTVRAnglesToCoord()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRAnglesToCoord(
QTVRInstance qtvr,
float panAngle,
float tiltAngle,
QTVRFloatPoint * coord);
/* Object specific routines*/
/*
* QTVRPanToColumn()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( short )
QTVRPanToColumn(
QTVRInstance qtvr,
float panAngle);
/* zero based */
/*
* QTVRColumnToPan()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRColumnToPan(
QTVRInstance qtvr,
short column);
/* zero based */
/*
* QTVRTiltToRow()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( short )
QTVRTiltToRow(
QTVRInstance qtvr,
float tiltAngle);
/* zero based */
/*
* QTVRRowToTilt()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( float )
QTVRRowToTilt(
QTVRInstance qtvr,
short row);
/* zero based */
/*
* QTVRWrapAndConstrain()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRWrapAndConstrain(
QTVRInstance qtvr,
short kind,
float value,
float * result);
/*
=================================================================================================
Interaction Routines
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRSetEnteringNodeProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetEnteringNodeProc(
QTVRInstance qtvr,
QTVREnteringNodeUPP enteringNodeProc,
SInt32 refCon,
UInt32 flags);
/*
* QTVRSetLeavingNodeProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetLeavingNodeProc(
QTVRInstance qtvr,
QTVRLeavingNodeUPP leavingNodeProc,
SInt32 refCon,
UInt32 flags);
/*
* QTVRSetInteractionProperty()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetInteractionProperty(
QTVRInstance qtvr,
UInt32 property,
void * value);
/*
* QTVRGetInteractionProperty()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetInteractionProperty(
QTVRInstance qtvr,
UInt32 property,
void * value);
/*
* QTVRReplaceCursor()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRReplaceCursor(
QTVRInstance qtvr,
QTVRCursorRecord * cursRecord);
/*
=================================================================================================
Viewing Limits and Constraints
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRGetViewingLimits()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetViewingLimits(
QTVRInstance qtvr,
UInt16 kind,
float * minValue,
float * maxValue);
/*
* QTVRGetConstraintStatus()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( UInt32 )
QTVRGetConstraintStatus(QTVRInstance qtvr);
/*
* QTVRGetConstraints()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetConstraints(
QTVRInstance qtvr,
UInt16 kind,
float * minValue,
float * maxValue);
/*
* QTVRSetConstraints()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetConstraints(
QTVRInstance qtvr,
UInt16 kind,
float minValue,
float maxValue);
/*
=================================================================================================
Back Buffer Memory Management
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRGetAvailableResolutions()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetAvailableResolutions(
QTVRInstance qtvr,
UInt16 * resolutionsMask);
/* These require QTVR 2.1 (kQTVRAPIMajorVersion02 + kQTVRAPIMinorVersion10)*/
/*
* QTVRGetBackBufferMemInfo()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetBackBufferMemInfo(
QTVRInstance qtvr,
UInt32 geometry,
UInt16 resolution,
UInt32 cachePixelFormat,
SInt32 * minCacheBytes,
SInt32 * suggestedCacheBytes,
SInt32 * fullCacheBytes);
/*
* QTVRGetBackBufferSettings()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRGetBackBufferSettings(
QTVRInstance qtvr,
UInt32 * geometry,
UInt16 * resolution,
UInt32 * cachePixelFormat,
SInt16 * cacheSize);
/*
* QTVRSetBackBufferPrefs()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.1 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetBackBufferPrefs(
QTVRInstance qtvr,
UInt32 geometry,
UInt16 resolution,
UInt32 cachePixelFormat,
SInt16 cacheSize);
/*
=================================================================================================
Buffer Access
-------------------------------------------------------------------------------------------------
*/
/*
* QTVRSetPrescreenImagingCompleteProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetPrescreenImagingCompleteProc(
QTVRInstance qtvr,
QTVRImagingCompleteUPP imagingCompleteProc,
SInt32 refCon,
UInt32 flags);
/*
* QTVRSetBackBufferImagingProc()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRSetBackBufferImagingProc(
QTVRInstance qtvr,
QTVRBackBufferImagingUPP backBufferImagingProc,
UInt16 numAreas,
QTVRAreaOfInterest areasOfInterest[],
SInt32 refCon);
/*
* QTVRRefreshBackBuffer()
*
* Availability:
* Non-Carbon CFM: in QuickTimeVRLib 2.0 and later
* CarbonLib: in CarbonLib 1.1 and later
* Mac OS X: in version 10.0 and later
* Windows: in QTVR.lib 2.1 and later
*/
EXTERN_API_C( OSErr )
QTVRRefreshBackBuffer(
QTVRInstance qtvr,
UInt32 flags);
/*
=================================================================================================
Old Names
-------------------------------------------------------------------------------------------------
*/
#if OLDROUTINENAMES
typedef QTVRCursorRecord CursorRecord;
typedef QTVRAreaOfInterest AreaOfInterest;
typedef QTVRFloatPoint FloatPoint;
typedef QTVRLeavingNodeProcPtr LeavingNodeProcPtr;
typedef QTVRLeavingNodeUPP LeavingNodeUPP;
typedef QTVREnteringNodeProcPtr EnteringNodeProcPtr;
typedef QTVREnteringNodeUPP EnteringNodeUPP;
typedef QTVRMouseOverHotSpotProcPtr MouseOverHotSpotProcPtr;
typedef QTVRMouseOverHotSpotUPP MouseOverHotSpotUPP;
typedef QTVRImagingCompleteProcPtr ImagingCompleteProcPtr;
typedef QTVRImagingCompleteUPP ImagingCompleteUPP;
typedef QTVRBackBufferImagingProcPtr BackBufferImagingProcPtr;
typedef QTVRBackBufferImagingUPP BackBufferImagingUPP;
#endif /* OLDROUTINENAMES */
#endif // !__LP64__
#if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
#pragma pack()
#endif
#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif
#ifdef __cplusplus
}
#endif
#endif /* __QUICKTIMEVR__ */