com.luciad.lucy.map.cameralinking.lightspeed

LuciadLightspeedClass ALcyLspCameraLinker3D

java.lang.Object

com.luciad.lucy.map.cameralinking.ALcyCameraLinker

com.luciad.lucy.map.cameralinking.lightspeed.ALcyLspCameraLinker3D

All Implemented Interfaces:

ILcdPropertyChangeSource

public abstract class ALcyLspCameraLinker3D
extends ALcyCameraLinker

Implementation of ALcyLspCameraLinker, specifically meant to be used in combination with 3D Lightspeed views.

Since:

2012.0

Constructor Summary

Constructors

Constructor and Description
ALcyLspCameraLinker3D(ILcyLspMapComponent aMapComponent, Object[] aObjects, ILcdModel[] aModels) Create a new 3D camera linker, which is used to create and configure new tracking camera's.

Method Summary

Modifier and Type	Method and Description
protected abstract ALspCameraConstraint<TLspViewXYZWorldTransformation3D>	createCameraConstraint(ALspTrackingPointProvider aTrackingPointProvider, ILspView aView) Create a new camera constraint and return it.
protected ALspTrackingPointProvider	createTrackingPointProvider(Object[] aObjectsToTrack, ILcdModel[] aModelsToTrack, ILspView aView) Create a new tracking point provider, based on the given parameters.
ILcdModel[]	getTrackedModels() Return the models to which the objects, which will be tracked by any camera installed by this linker object, belong to.
Object[]	getTrackedObjects() Return the objects which will be tracked by any camera installed by this linker object.
boolean	isLinked() Check if the camera is linked.
protected boolean	isValidViewXYZWorldTransformation(ALspViewXYZWorldTransformation aTransformation) Determines if the linker is still valid for the given transformation.
protected void	linkTrackingCamera(Object[] aObjectsToTrack, ILcdModel[] aModelsToTrack, ILspView aView) Create and install a new tracking camera on the given view.
void	setLinked(boolean aLinked) Link or unlink the camera.
protected void	unlinkTrackingCamera(Object[] aObjectsToTrack, ILcdModel[] aModelsToTrack, ILspView aView) Remove the currently installed tracking camera from the given view.

Methods inherited from class com.luciad.lucy.map.cameralinking.ALcyCameraLinker

addPropertyChangeListener, addPropertyChangeListener, firePropertyChange, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Constructor Detail

ALcyLspCameraLinker3D

public ALcyLspCameraLinker3D(ILcyLspMapComponent aMapComponent,
                             Object[] aObjects,
                             ILcdModel[] aModels)

Create a new 3D camera linker, which is used to create and configure new tracking camera's.

Parameters:

aMapComponent - The map component on which this linker will install tracking cameras.

aObjects - The set of object that should be tracked by this camera linker.

aModels - A set of models, denoting for each object of aObjects to which ILcdModel it belongs.

Method Detail

linkTrackingCamera

protected void linkTrackingCamera(Object[] aObjectsToTrack,
                                  ILcdModel[] aModelsToTrack,
                                  ILspView aView)

Create and install a new tracking camera on the given view.

Parameters:

aObjectsToTrack - The objects the camera should track.

aModelsToTrack - The models of those objects.

aView - The view which contains the currently installed camera.

unlinkTrackingCamera

protected void unlinkTrackingCamera(Object[] aObjectsToTrack,
                                    ILcdModel[] aModelsToTrack,
                                    ILspView aView)

Remove the currently installed tracking camera from the given view.

Parameters:

aObjectsToTrack - The set of objects currently tracked by the tracking camera.

aModelsToTrack - The models of those objects

aView - The view on which the tracking camera is installed.

createTrackingPointProvider

protected ALspTrackingPointProvider createTrackingPointProvider(Object[] aObjectsToTrack,
                                                                ILcdModel[] aModelsToTrack,
                                                                ILspView aView)

Create a new tracking point provider, based on the given parameters.

Parameters:

aObjectsToTrack - The objects which the tracking point provider should track.

aModelsToTrack - The models of the objects which the tracking point provider should track.

aView - The view which will be tracked using the tracking point provider returned by this method.

Returns:

A new tracking point provider.

createCameraConstraint

protected abstract ALspCameraConstraint<TLspViewXYZWorldTransformation3D> createCameraConstraint(ALspTrackingPointProvider aTrackingPointProvider,
                                                                                                 ILspView aView)

Create a new camera constraint and return it. The constraint can be created based on the given parameters.

Note that the constraint should not yet be installed on the given camera. Adding and eventually removing this constraint will be done afterwards.

By default this method is called by linkTrackingCamera(Object[], ILcdModel[], ILspView), after a matching tracking point provider has been created.

Parameters:

aTrackingPointProvider - The tracking point provider that should be used by the camera constraint.

aView - The view which contains the camera on which the constraint shall be installed later on.

Returns:

A camera constraint ready to be installed on the provided view's camera.

isLinked

public boolean isLinked()

Description copied from class: ALcyCameraLinker

Check if the camera is linked.

Specified by:

isLinked in class ALcyCameraLinker

Returns:

Whether or not the camera is linked.

isValidViewXYZWorldTransformation

protected boolean isValidViewXYZWorldTransformation(ALspViewXYZWorldTransformation aTransformation)

Determines if the linker is still valid for the given transformation. If not, the linker is unlinked

Parameters:

aTransformation - transfo to check

Returns:

false if the linker should be unlinked

setLinked

public void setLinked(boolean aLinked)

Description copied from class: ALcyCameraLinker

Link or unlink the camera.

Specified by:

setLinked in class ALcyCameraLinker

Parameters:

aLinked - Whether or not to link the camera.

getTrackedObjects

public Object[] getTrackedObjects()

Return the objects which will be tracked by any camera installed by this linker object.

Returns:

The objects which will be tracked by any camera installed by this linker object.

getTrackedModels

public ILcdModel[] getTrackedModels()

Return the models to which the objects, which will be tracked by any camera installed by this linker object, belong to.

Returns:

The models to which the objects, which will be tracked by any camera installed by this linker object, belong to.