org.tinfour.demo.viewer.backplane

Class BackplaneManager

java.lang.Object

org.tinfour.demo.viewer.backplane.BackplaneManager

public class BackplaneManager
extends Object

Constructor Summary

Constructors

Constructor and Description
BackplaneManager(DataViewingPanel viewingPanel, StatusPanel statusPanel)

Method Summary

Modifier and Type	Method and Description
void	clear() Cancel all running tasks and clear all current status posts.
IModel	loadModel(File file, String option) Instantiate a file-based model and queue a loading task.
void	loadModel(IModel model) Initiate a load task for an instance of a model and, ultimately, queue rendering tasks.
void	postImageUpdate(org.tinfour.demo.viewer.backplane.IModelViewTask task, RenderProduct product) Post an image update to the user interface
void	postStatusMessage(int index, String message)
MvComposite	queueConstraintLoadingTask(IModel model, File file, CompositeImageScale ccs, String optionString)
MvComposite	queueHeavyweightRenderTask(IModel model, ViewOptions view, CompositeImageScale ccs) Queues a render task; typically invoked from the UI when the user changes view options that require that a new model-view composite be created.
MvComposite	queueLightweightRenderTask(MvComposite oldComposite, ViewOptions view) Queues a new rendering task; typically invoked from the UI when the user makes changes to the view options that do not require reconstructing the TINs associated with the image.
MvComposite	queueReloadTask(IModel model, ViewOptions vOpt, CompositeImageScale ccs)
void	setViewOptions(ViewOptions view) Set the current view options to be used when loading any new models.

Methods inherited from class java.lang.Object

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

Constructor Detail

BackplaneManager

public BackplaneManager(DataViewingPanel viewingPanel,
                        StatusPanel statusPanel)

Method Detail

postStatusMessage

public void postStatusMessage(int index,
                              String message)

postImageUpdate

public void postImageUpdate(org.tinfour.demo.viewer.backplane.IModelViewTask task,
                            RenderProduct product)

Post an image update to the user interface

Parameters:

task - the task associated with the update

product - a valid render product

clear

public void clear()

Cancel all running tasks and clear all current status posts.

loadModel

public void loadModel(IModel model)

Initiate a load task for an instance of a model and, ultimately, queue rendering tasks.

Parameters:

model - a valid model

loadModel

public IModel loadModel(File file,
                        String option)

Instantiate a file-based model and queue a loading task. Ultimately the loading task will queue rendering tasks.

Parameters:

file - a valid reference to a readable file in a supported format.

option - an optional data element based on the file-type

Returns:

if the model was successfully initialized, a valid instance; otherwise a null.

queueConstraintLoadingTask

public MvComposite queueConstraintLoadingTask(IModel model,
                                              File file,
                                              CompositeImageScale ccs,
                                              String optionString)

queueReloadTask

public MvComposite queueReloadTask(IModel model,
                                   ViewOptions vOpt,
                                   CompositeImageScale ccs)

queueHeavyweightRenderTask

public MvComposite queueHeavyweightRenderTask(IModel model,
                                              ViewOptions view,
                                              CompositeImageScale ccs)

Queues a render task; typically invoked from the UI when the user changes view options that require that a new model-view composite be created. Typically, this is due to a change in the visible map-area (a pan or zoom) or in view options that alter the point-selection and require that any existing TINs be rebuilt.

Parameters:

model - a fully loaded model

view - a valid instance

ccs - specifications for model position and scale for imaging

Returns:

a valid instance

queueLightweightRenderTask

public MvComposite queueLightweightRenderTask(MvComposite oldComposite,
                                              ViewOptions view)

Queues a new rendering task; typically invoked from the UI when the user makes changes to the view options that do not require reconstructing the TINs associated with the image.

Parameters:

oldComposite - an existing, model-view composite that contains elements that can be transferred intact for reuse in a new composite (TINs, grids, etc.).

view - view-related options for rendering

Returns:

a valid model-view composite instance.

setViewOptions

public void setViewOptions(ViewOptions view)

Set the current view options to be used when loading any new models. This method is synchronized to permit communication with background processes.

Parameters:

view - a valid instance