QM_GetHotSpotInfo

QM_GetHotSpotInfo(movieRef; nodeID; hotSpotID; hotSpotType; hotSpotName; hotSpotComment):error
	movieRef	Longint	Movie reference
	nodeID	Longint	Node ID
	hotSpotID	Longint	Hot spot ID
	hotSpotType	String4	Hot spot type
	hotSpotName	Text	Hot spot name
	hotSpotComment	Text	Hot spot comment
	error	Longint	Error result

Returns information about a hot spot in a VR movie node.

Parameter movieRef is the reference to the movie instance. The movie reference must have been previously obtained with a call to QM_NewMovieFromFile or QM_NewMovieFromURL. The movie must be currently assigned to a movie plug-in area.

Parameter nodeID specifies the node in the movie.

Parameter hotSpotID specifies the hotSpot in the VR movie node.

Parameter hotSpotType receives the type of the specified hot spot. The hot spot's type can be one of the following, or any application-defined value:

qm_LinkHotSpot	"link"	The hot spot is a link in the movie
qm_URLHotSpot	"url "	The hot spot is a URL link
qm_UndefinedHotSpot	"undf"	The hot spot type is undefined

Parameters hotSpotName and hotSpotComment receive the hot spot's name and comment respectively.

Example

`Get info on hotspot ID $hotSpotID of node ID $nodeID of VR movie $movie

C_STRING(4;$hotSpotType)
C_TEXT($hotSpotName;$hotSpotComment)
$err:=QM_GetHotSpotInfo ($movie;$nodeID;$hotSpotID;$hotSpotType;$hotSpotName;$hotSpotComment)

Related commands

QM_GetHotSpots	Returns the IDs of all hot spots in a node.
QM_GetLinkHotSpotTarget	Returns the target node ID a link hot spot.
QM_GetURLHotSpotTarget	Returns the target URL of a URL hot spot.