PtInTrack
The PtInTrack function allows your application to determine whether a specified point lies in the region defined by a track's display boundary region after it has been clipped by the movie's final display clipping region. This function is accurate at the current movie time.
pascal Boolean PtInTrack (Track theTrack, Point pt);
theTrack
- Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as
NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).
pt
- Specifies the point to be checked. This point must be expressed in the local display coordinate system of the movie that contains the track.
DESCRIPTION
The PtInTrack function returns a Boolean value. The function sets this value to true if the point lies in the track's display space.
SPECIAL CONSIDERATIONS
The region that PtInTrack checks for is different from the movie box.
ERROR CODES
| invalidMovie | -2010 | This movie is corrupted or invalid |
SEE ALSO
To find out if a point lies within the region defined by a movie's final display boundary region after it has been clipped by the movie's display clipping region, you can use the PtInMovie function, which is described in the previous section.
