org.limn.engine
Class TourEngine

java.lang.Object
  |
  +--org.limn.engine.TourEngine

All Implemented Interfaces:

LimnEngine, LimnRenderable

public class TourEngine

extends java.lang.Object

implements LimnEngine, LimnRenderable

Tour engine is the main implementation of the LimnEngine Interface. It delegates basis creation to a BasisFactory object

The tour engine can be used in a recording program to manage tour recording. Or it can be used to create index projections on prerecorded tours for rendinger highlighting and other real time graphics to augment the images.

Constructor Summary

TourEngine(LimnBasisFactory l)
this is type of constructor is used by the viewer class when it needs to create a projection basis for subsetting data

TourEngine(LimnBasisFactory l, LimnRecorder rec, LimnRender r)

Method Summary

void	augment(java.awt.Graphics g, int height, int width, int i) This method is to be called from within the rendering stage.
LimnBasis	generateProjection() generateProjection is used to generate the next projection
LimnBasis	generateProjection(int index) generateProjection is used to generate the projection for the step indicated by the index number.
void	initEngine()
void	initRecorder()
void	printBasis(double[][] d) This is used to seek to a specific projection in the tour process.
void	step() Step allerts the engine that the animation projection process has finished and the resources are available to begin the next iteration of the cycle.

Methods inherited from class java.lang.Object

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

Constructor Detail

TourEngine

public TourEngine(LimnBasisFactory l,
                  LimnRecorder rec,
                  LimnRender r)

TourEngine

public TourEngine(LimnBasisFactory l)

this is type of constructor is used by the viewer class when it needs to create a projection basis for subsetting data

Method Detail

initEngine

public void initEngine()

initRecorder

public void initRecorder()

augment

public void augment(java.awt.Graphics g,
                    int height,
                    int width,
                    int i)

Description copied from interface: LimnRenderable

This method is to be called from within the rendering stage. allowing an object that implements this interface to add some graphics to the main graphic. this graphics may include information about the duration of the animation, axis information or brushing/linking information

Specified by:

augment in interface LimnRenderable

step

public void step()

Description copied from interface: LimnEngine

Step allerts the engine that the animation projection process has finished and the resources are available to begin the next iteration of the cycle.

Specified by:

step in interface LimnEngine

generateProjection

public LimnBasis generateProjection()

Description copied from interface: LimnEngine

generateProjection is used to generate the next projection

Specified by:

generateProjection in interface LimnEngine

printBasis

public void printBasis(double[][] d)

This is used to seek to a specific projection in the tour process. It is an expensive way to do this, but because the target basis doesnt become the endpoint of a tour segment (due to rotation concerns with the projection frames) we need to follow through a sequence from the very begninning.

generateProjection

public LimnBasis generateProjection(int index)

Description copied from interface: LimnEngine

generateProjection is used to generate the projection for the step indicated by the index number.

Specified by:

generateProjection in interface LimnEngine