net.cscott.sdr
Class ChoreoEngine

java.lang.Object
  net.cscott.sdr.ChoreoEngine

public class ChoreoEngine
extends Object

ChoreoEngine specifies the interface through which the choreography engine communicates with the rest of the SDR application.

Version:

$Id: ChoreoEngine.java,v 1.2 2006-11-10 00:56:07 cananian Exp $

Author:

C. Scott Ananian

Constructor Summary

ChoreoEngine(DanceState ds)

Method Summary

List<TimedFormation>

execute(TimedFormation start, Apply call, ScoreAccumulator score) Given a TimedFormation representing the "current" dancer formation, perform the given call.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChoreoEngine

public ChoreoEngine(DanceState ds)

Method Detail

execute

public List<TimedFormation> execute(TimedFormation start,
                                    Apply call,
                                    ScoreAccumulator score)
                             throws BadCallException

Given a TimedFormation representing the "current" dancer formation, perform the given call. The result will be a list of future formations, sorted by the time at which they occur (with the earliest first). No dancer will turn more than 1 wall (90 degrees) between formations. All times in the TimedFormations will be absolute.

Parameters:

start - The starting formation and time.

call - The (sequence of) call(s) to perform.

Returns:

a time-stamped list of result formations, with absolute times.

Throws:

BadCallException - if (some part of) the given call is impossible from the given start formation.