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