Michael Bayne
7253a68c7c
to handle scrolling in a much cleaner and happier way. There's now a VirtualMediaPanel which operates in virtual coordinates and can be made to "view" any location in those virtual coordinates. By changing the view, the view can be scrolled and the view can be made to center on a pathable (generally a sprite) which will cause it to scroll around as the pathable moves around in the virtual coordinate space. git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@1475 542714f4-19e9-0310-aa3c-eee0fc999fb1
56 lines
2.0 KiB
Java
56 lines
2.0 KiB
Java
//
|
|
// $Id: Path.java,v 1.8 2002/06/18 22:25:33 mdb Exp $
|
|
|
|
package com.threerings.media.util;
|
|
|
|
import java.awt.Graphics2D;
|
|
|
|
/**
|
|
* A path is used to cause a {@link Pathable} to follow a particular path
|
|
* along the screen. The {@link Pathable} is responsible for calling
|
|
* {@link #tick} on the path with reasonable frequency (generally as a
|
|
* part of the frame tick. The path is responsible for updating the
|
|
* position of the {@link Pathable} based on the time that has elapsed
|
|
* since the {@link Pathable} started down the path.
|
|
*
|
|
* <p> The path should call the appropriate callbacks on the {@link
|
|
* Pathable} when appropriate (e.g. {@link Pathable#pathBeginning}, {@link
|
|
* Pathable#pathCompleted}).
|
|
*/
|
|
public interface Path
|
|
{
|
|
/**
|
|
* Called once to let the path prepare itself for the process of
|
|
* animating the supplied pathable.
|
|
*/
|
|
public void init (Pathable pable, long tickStamp);
|
|
|
|
/**
|
|
* Called to request that this path update the position of the
|
|
* specified pathable based on the supplied timestamp information. A
|
|
* path should record its initial timestamp and determine the progress
|
|
* of the pathable along the path based on the time elapsed since the
|
|
* pathable began down the path.
|
|
*
|
|
* @param pable the pathable whose position should be updated.
|
|
* @param tickStamp the timestamp associated with this frame.
|
|
*
|
|
* @return true if the pathable's position was updated, false if the
|
|
* path determined that the pathable should not move at this time.
|
|
*/
|
|
public boolean tick (Pathable pable, long tickStamp);
|
|
|
|
/**
|
|
* This is called if the pathable is paused for some length of time
|
|
* and then unpaused. Paths should adjust any time stamps they are
|
|
* maintaining internally by the delta so that time maintains the
|
|
* illusion of flowing smoothly forward.
|
|
*/
|
|
public void fastForward (long timeDelta);
|
|
|
|
/**
|
|
* Paint this path on the screen (used for debugging purposes only).
|
|
*/
|
|
public void paint (Graphics2D gfx);
|
|
}
|