|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--quicktime.QTObject | +--quicktime.vr.QTVRInstance
The QTVRInstance is used for making QTVR calls
If an application installs any of the QTVR callbacks, then it must remove these callbacks when it has finished with them (or with the QTVRInstance itself) to allow the native structures used to be properly disposed.
Fields inherited from interface quicktime.jdirect.QuickTimeLib |
JDirect_MacOSX, libraryInstance, name |
Fields inherited from interface quicktime.jdirect.QuickTimeVRLib |
JDirect_MacOSX, libraryInstance |
Constructor Summary | |
QTVRInstance(Track qtvrTrack,
MovieController mc)
You can use the QTVRGetQTVRInstance function to get an instance of a QuickTime VR movie. |
Method Summary | |
void |
callInterceptedProc(QTVRInterceptRecord qtvrMsg)
This method is used by the QTVRInterceptor execute method to call the QTVR default proc for the selector that was intercepted. |
float |
columnToPan(int column)
You can use QTVRColumnToPan to get the pan angle that corresponds to a column number in the object image array. |
void |
enableHotSpot(int enableFlag,
int hotSpotValue,
boolean enable)
You can use the QTVREnableHotSpot function to enable or disable one or more hot spots. |
int |
getAngularUnits()
You can use QTVRGetAngularUnits to get the type of unit currently used when specifying angles. |
float |
getConstraints_max(int kind)
You can use the QTVRGetConstraints function to get the current constraints of a movie. |
float |
getConstraints_min(int kind)
You can use the QTVRGetConstraints function to get the current constraints of a movie. |
int |
getCurrentNodeID()
You can use the QTVRGetCurrentNodeID function to get the current node of a movie. |
float |
getFieldOfView()
You can use the QTVRGetFieldOfView function to get the vertical field of view of a QuickTime VR movie. |
Region |
getHotSpotRegion(int hotSpotID)
The QTVRGetHotSpotRegion function returns, in the hotSpotRegion parameter, a handle to the region occupied by the hot spot, in the QuickTimeÊVR movie specified by the qtvr parameter, whose ID is specified by the hotSpotID parameter. |
int |
getHotSpotType(int hotSpotID)
This method gets the type of a hot spot whose ID you specify. |
int |
getImagingProperty(int imagingMode,
int imagingProperty)
You can use the QTVRGetImagingProperty function to get the current value of an imaging property of a movie. |
int |
getInteractionMouseClickHysteresis()
Gets the Mouse Click Hysteresis property of the Interaction property defined as the distance, in pixels, from the location of a mouse-down event to the limit within which the cursor is considered not to have moved. |
int |
getInteractionMouseClickTimeout()
Gets the Mouse Click Timeout Interaction property defined as the number of ticks after which a mouse click times out and is automatically switched from a hot spot selection into a pan. |
float |
getInteractionMouseMotionScale()
Sets the mouse motion scale interaction property |
int |
getInteractionNudgeMode()
Gets the nudge mode interaction property |
int |
getInteractionPanTiltSpeed()
Gets the panning and tilting speed interaction property |
boolean |
getInteractionTranslateOnMouseDown()
Sets the translation interaction property |
int |
getInteractionZoomSpeed()
Gets the zoom speed interaction property |
boolean |
getMouseDownTracking()
Returns, as its function result, a Boolean value that indicates whether QuickTimeÊVR is currently handling mouse-down tracking for the QuickTimeÊVR movie specified by the parameter ( true ) or not ( false ). |
boolean |
getMouseOverTracking()
Returns a Boolean value that indicates whether QuickTimeÊVR is currently handling mouse-over tracking for the QuickTimeÊVR movie specified by the QTVRInstance ( true ) or not ( false ). |
AtomContainer |
getNodeInfo(int nodeID)
You can use the QTVRGetNodeInfo function to get the node information atom container that describes a node and all the hot spots in the node. |
int |
getNodeType(int nodeID)
You can use the QTVRGetNodeType function to get the OSType of a movie node. |
float |
getPanAngle()
You can use the QTVRGetPanAngle function to get the pan angle of a QuickTime VR movie. |
float |
getTiltAngle()
You can use the QTVRGetTiltAngle function to get the tilt angle of a QuickTime VR movie. |
QDPoint |
getViewCenter()
The getViewCenter method returns, in the QDPoint class, the x and y coordinates of the current view center of the QuickTimeÊVR movie specified by the QTVRInstance you call this on. |
int[] |
getVisibleHotSpots()
Returns a list of IDs of all the hot spots in the QuickTimeÊVR instance that are currently visible. |
AtomContainer |
getVRWorld()
The QTVRGetVRWorld function returns an atom container that contains general scene information about the QuickTime VR movie specified, as well as a list of all the nodes in that movie. |
void |
goToNodeID(int nodeID)
You can use the QTVRGoToNodeID function to set the current node of a movie. |
void |
installInterceptProc(int selector,
QTVRInterceptor interceptProc,
int flags)
You can use the QTVRInstallInterceptProc function to install or remove an intercept procedure for a QuickTime VR Manager function QuickTime::QTVRInstallInterceptProc |
void |
nudge(int direction)
You can use the QTVRNudge function to turn one step in a particular direction and display the new view. |
int |
panToColumn(float panAngle)
You can use QTVRPanToColumn to get the column number in the object image array that corresponds to a pan angle. |
int |
ptToHotSpotID(QDPoint pt)
Returns the ID of the hot spot in the QuickTimeÊVR instance that lies directly under the point specified by the pt parameter. |
float |
ptToPanAngle(QDPoint pt)
You can use QTVRPtToAngles to get the pan angle of a point. |
float |
ptToTiltAngle(QDPoint pt)
You can use QTVRPtToAngles to get the tilt angle of a point. |
void |
removeEnteringNodeProc()
You can use the QTVRSetEnteringNodeProc function to remove a node-entering procedure. |
void |
removeInterceptProc(int selector)
You can use the QTVRInstallInterceptProc function to install or remove an intercept procedure for a QuickTime VR Manager function QuickTime::QTVRInstallInterceptProc |
void |
removeLeavingNodeProc()
You can use the QTVRSetLeavingNodeProc function to remove a node-leaving procedure. |
void |
removeMouseOverHotSpotProc()
You can use the QTVRSetMouseOverHotSpotProc function to remove a mouse over hot spot procedure. |
void |
removePrescreenImagingCompleteProc()
You can use the QTVRSetPrescreenImagingCompleteProc function to remove a prescreen imaging complete proc. |
float |
rowToTilt(int row)
You can use QTVRRowToTilt to get the tilt angle that corresponds to a row number in the object image array. |
void |
setAngularUnits(int units)
You can use QTVRSetAngularUnits to set the type of unit used when specifying angles. |
void |
setConstraints(int kind,
float minValue,
float maxValue)
You can use the QTVRSetConstraints function to set the constraints of a movie. |
void |
setEnteringNodeProc(QTVREnteringNode enteringNodeProc,
int flags)
You can use the QTVRSetEnteringNodeProc function to install or remove a node-entering procedure. |
void |
setFieldOfView(float fieldOfView)
You can use the QTVRSetFieldOfView function to set the vertical field of view of a QuickTime VR movie. |
void |
setImagingProperty(int imagingMode,
int imagingProperty,
int propertyValue)
You can use the QTVRSetImagingProperty function to set the current value of an imaging property of a movie. |
void |
setInteractionMouseClickHysteresis(int hysteresis)
Sets the Mouse Click Hysteresis property of the Interaction property defined as the distance, in pixels, from the location of a mouse-down event to the limit within which the cursor is considered not to have moved. |
void |
setInteractionMouseClickTimeout(int timeout)
Sets the Mouse Click Timeout Interaction property. |
void |
setInteractionMouseMotionScale(float scale)
Sets the Mouse Motion Scale interaction property. |
void |
setInteractionNudgeMode(int mode)
Sets the nudge mode interaction property. |
void |
setInteractionPanTiltSpeed(int speed)
Sets the panning and tilting speed interaction property. |
void |
setInteractionTranslateOnMouseDown(boolean translate)
Sets the mouseDown translation flag interaction property. |
void |
setInteractionZoomSpeed(int speed)
Sets the Zoom Speed Interaction Parameter. |
void |
setLeavingNodeProc(QTVRLeavingNode leavingNodeProc,
int flags)
You can use the QTVRSetLeavingNodeProc function to install or remove a node-leaving procedure. |
void |
setMouseDownTracking(boolean enable)
Sets the mouse-down tracking state of the QuickTimeÊVR movie specified by the QTVRInstance to the state specified by the enable parameter. |
void |
setMouseOverHotSpotProc(QTVRMouseOverHotSpot mouseOverHotSpotProc,
int flags)
You can use the QTVRSetMouseOverHotSpotProc function to install or remove a mouse over hot spot procedure QuickTime::QTVRSetMouseOverHotSpotProc |
void |
setMouseOverTracking(boolean enable)
Sets the mouse-over tracking state of the QuickTimeÊVR movie specified by the QTVRInstance object the method is called from. |
void |
setPanAngle(float panAngle)
You can use the QTVRSetPanAngle function to set the pan angle of a QuickTime VR movie. |
void |
setPrescreenImagingCompleteProc(QTVRImagingComplete imageCompleteProc,
int flags)
This method installs a callback that is invoked every time a QTVRInstance is drawn. |
void |
setTiltAngle(float tiltAngle)
You can use the QTVRSetTiltAngle function to set the tilt angle of a QuickTime VR movie. |
void |
setViewCenter(QDPoint viewCenter)
The setViewCenter method sets the view center of the QuickTimeÊVR movie specified by the qtvr parameter to the fixed point specified by the viewCenter parameter. |
void |
showDefaultView()
The showDefaultView method sets the default values of the pan angle, tilt angle, field of view, view center (for object nodes), default state, mouse-down state, and all applicable animation and control settings for the node specified by the QTVRInstance you call this on. |
int |
tiltToRow(float tiltAngle)
You can use QTVRTiltToRow to get the row number in the object image array that corresponds to a tilt angle. |
void |
triggerHotSpot(int hotSpotID,
AtomContainer nodeInfo,
Atom selectedAtom)
You can use the QTVRTriggerHotSpot function to trigger a hot spot. |
void |
update(int imagingMode)
You can use the QTVRUpdate function to force an immediate update of a QuickTime VR movie image. |
float |
wrapAndConstrain(int kind,
float value)
You can use QTVRWrapAndConstrain to preflight a change in the viewing or control characteristics of an object or panoramic node. |
Methods inherited from class quicktime.QTObject |
disposeQTObject, equals, ID, toString |
Methods inherited from class java.lang.Object |
getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public QTVRInstance(Track qtvrTrack, MovieController mc) throws QTException
qtvrTrack
- A QTVR track contained in a QuickTime movie. You can obtain a reference to this track by
calling QTVRGetQTVRTrackmc
- A movie controller that is associated with the new QuickTime VR movieMethod Detail |
public AtomContainer getVRWorld() throws QTVRException
public AtomContainer getNodeInfo(int nodeID) throws QTVRException
nodeID
- Set this parameter to kQTVRCurrentNode to receive information
about the current nodepublic int getCurrentNodeID()
public int getNodeType(int nodeID)
nodeID
- A node ID. Pass kQTVRCurrentNode for the current node.public void triggerHotSpot(int hotSpotID, AtomContainer nodeInfo, Atom selectedAtom) throws QTVRException
hotSpotID
- A hot spot ID.nodeInfo
- A node information atom container (obtained from a previous
call to QTVRGetNodeInfo). You can pass the value 0 in this
parameter to have the QuickTime VR Manager determine the
appropriate node information atom container.selectedAtom
- The atom of the hot spot to trigger. You can pass the value 0 in
this parameter to have the QuickTime VR Manager determine
the appropriate hot spot atom.public void enableHotSpot(int enableFlag, int hotSpotValue, boolean enable) throws QTVRException
enableFlag
- The kind of hot spot or hot spots to enable or disable.hotSpotValue
- The desired hot spot or spots, relative to the specified enabled flag.enable
- A Boolean value that indicates whether the specified hot spots are to be enabled (true) or disabled (false).public void update(int imagingMode) throws QTVRException
imagingMode
- An imaging mode. You can specify
the kQTVRCurrentMode imaging mode to use the current
imaging mode.public void goToNodeID(int nodeID) throws QTVRException
nodeID
- The ID of the node you want to be the current node.public void nudge(int direction) throws QTVRException
direction
- The direction of the nudge.public float getPanAngle()
public void setPanAngle(float panAngle) throws QTVRException
panAngle
- The desired pan angle of the specified movie.public float getTiltAngle()
public void setTiltAngle(float tiltAngle) throws QTVRException
tiltAngle
- The desired tilt angle of the specified movie.public float getFieldOfView()
public void setFieldOfView(float fieldOfView) throws QTVRException
fieldOfView
- The desired vertical field of view for the specified movie.public float getConstraints_min(int kind) throws QTVRException
kind
- The type of constraints to be returned.public float getConstraints_max(int kind) throws QTVRException
kind
- The type of constraints to be returned.public void setConstraints(int kind, float minValue, float maxValue) throws QTVRException
kind
- The type of constraint to set..minValue
- A floating-point value that contains the desired minimum constraint of the specified type.maxValue
- A floating-point value that contains the desired maximum constraint of the specified type.public void setImagingProperty(int imagingMode, int imagingProperty, int propertyValue) throws QTVRException
imagingMode
- an imaging mode.imagingProperty
- an imaging property.propertyValue
- sets the current value of the specified imaging property for the specified mode.public int getImagingProperty(int imagingMode, int imagingProperty) throws QTVRException
imagingMode
- an imaging mode.imagingProperty
- an imaging property.public int getAngularUnits()
public void setAngularUnits(int units) throws QTVRException
units
- A constant that indicates the type of angular units to use.public float ptToPanAngle(QDPoint pt) throws QTVRException
pt
- A point, in the local coordinates of the graphics world of the specified movie.public float ptToTiltAngle(QDPoint pt) throws QTVRException
pt
- A point, in the local coordinates of the graphics world of the specified movie.public int panToColumn(float panAngle)
panAngle
- a pan angle.public float columnToPan(int column)
column
- A column number.public int tiltToRow(float tiltAngle)
tiltAngle
- a tilt angle.public float rowToTilt(int row)
row
- a row number.public float wrapAndConstrain(int kind, float value) throws QTVRException
kind
- a constraint type. See "Constraint Types" for a description of the available constraint types.value
- the desired value of the specified viewing characteristic.public void setEnteringNodeProc(QTVREnteringNode enteringNodeProc, int flags) throws QTVRException
enteringNodeProc
- an instance of the QTVREnteringNode object that will be called or null to remove the callback.flags
- the flagsQTCallBack
public void removeEnteringNodeProc()
public void setLeavingNodeProc(QTVRLeavingNode leavingNodeProc, int flags) throws QTVRException
leavingNodeProc
- an instance of the QTVRLeavingNode object that will be called or null to remove the callback.flags
- the flagsQTCallBack
public void removeLeavingNodeProc()
public void setMouseOverHotSpotProc(QTVRMouseOverHotSpot mouseOverHotSpotProc, int flags) throws QTVRException
mouseOverHotSpotProc
- an instance of the QTVRMouseOverHotSpot object that will be called or null to remove the callback.flags
- the flagsQTCallBack
public void removeMouseOverHotSpotProc()
public void installInterceptProc(int selector, QTVRInterceptor interceptProc, int flags) throws QTVRException
selector
- only the non-mouse selectors are supportedinterceptProc
- the interceptor or null to remove a previously specified callback for the specified selector.flags
- the flagsQTCallBack
public void removeInterceptProc(int selector) throws QTVRException
selector
- only the non-mouse selectors are supportedinterceptProc
- the interceptor or null to remove a previously specified callback for the specified selector.flags
- the flagsQTCallBack
public void callInterceptedProc(QTVRInterceptRecord qtvrMsg) throws QTVRException
qtvrMessage
- the message as passed to the execute functionQTCallBack
public void showDefaultView() throws QTVRException
public void setViewCenter(QDPoint viewCenter) throws QTVRException
viewCenter
- A QDPoint structure that contains the desired view center of the specified movie.public QDPoint getViewCenter() throws QTVRException
public int getHotSpotType(int hotSpotID) throws QTVRException
hotSpotID
- a hot spot IDpublic void setPrescreenImagingCompleteProc(QTVRImagingComplete imageCompleteProc, int flags) throws QTVRException
imagingComplete
- the callback objectflags
- effect the conditions under which QTVR will invoke the callbackQTCallBack
public void removePrescreenImagingCompleteProc()
QTCallBack
public Region getHotSpotRegion(int hotSpotID) throws QTException
hotSpotID
- A hot spot IDpublic int[] getVisibleHotSpots()
public int ptToHotSpotID(QDPoint pt) throws QTVRException
pt
- A point, in the local coordinates of the graphics world of the specified moviepublic void setMouseOverTracking(boolean enable) throws QTVRException
enable
- a boolean specified whether tracking should be disabled (false) or enabled (true)public boolean getMouseOverTracking() throws QTVRException
public void setMouseDownTracking(boolean enable) throws QTVRException
enable
- a boolean specified whether tracking should be disabled (false) or enabled (true)public boolean getMouseDownTracking() throws QTVRException
public void setInteractionMouseClickHysteresis(int hysteresis) throws QTVRException
hysteresis
- the mouse-click hysteresispublic int getInteractionMouseClickHysteresis() throws QTVRException
public void setInteractionMouseClickTimeout(int timeout) throws QTVRException
timeout
- the mouse-click timeoutpublic int getInteractionMouseClickTimeout() throws QTVRException
public void setInteractionPanTiltSpeed(int speed) throws QTVRException
speed
- the pan and tilt speedpublic int getInteractionPanTiltSpeed() throws QTVRException
public void setInteractionZoomSpeed(int speed) throws QTVRException
speed
- the zoom speedpublic int getInteractionZoomSpeed() throws QTVRException
public void setInteractionTranslateOnMouseDown(boolean translate) throws QTVRException
translate
- sets the mouseDown translation propertypublic boolean getInteractionTranslateOnMouseDown() throws QTVRException
public void setInteractionMouseMotionScale(float scale) throws QTVRException
scale
- sets the mouse motion scale propertypublic float getInteractionMouseMotionScale() throws QTVRException
public void setInteractionNudgeMode(int mode) throws QTVRException
mode
- sets the nudge mode property (use kQTVRNudgeRotate, kQTVRNudgeTranslate, or kQTVRNudgeSameAsMouse)public int getInteractionNudgeMode() throws QTVRException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |