Lingo Dictionary > G-K > hotSpot

 

hotSpot

Syntax

member(whichCursorCastMember).hotspot
the hotspot of member whichCursorCastMember

Description

Cursor cast member property; specifies the horizontal and vertical point location of the pixel that represents the hotspot within the animated color cursor cast member whichCursorCastMember. Director uses this point to track the cursor's position on the screen (for example, when it returns the values for the Lingo functions mouseH and mouseV) and to determine where a rollover (signaled by the Lingo message mouseEnter) occurs.

The upper left corner of a cursor is point(0,0), which is the default hotSpot value. Trying to set a point outside the bounds of the cursor produces an error. For example, setting the hotspot of a 16-by-16-pixel cursor to point(16,16) produces an error (because the starting point is 0,0, not 1,1).

This property can be tested and set.

Example

This handler sets the hotspot of a 32-by-32-pixel cursor (whose cast member number is stored in the variable cursorNum) to the middle of the cursor:

on startMovie
	member(cursorNum).hotSpot = point(16,16)
end