com.luciad.view.lightspeed.editor

LuciadFusionClass TLspDomeEditor

java.lang.Object

com.luciad.view.lightspeed.editor.ALspEditor

com.luciad.view.lightspeed.editor.TLspDomeEditor

All Implemented Interfaces:

ILspEditor

public class TLspDomeEditor
extends ALspEditor

Enables visual editing of ILcd3DEditableDome objects in an ILspView.

Handles

The dome editor defines the following edit handles for a dome object:

• Radius handle: allows the user to edit the radius of the dome. The user can change the radius by dragging the outline of the dome. This handle generates PROPERTY_CHANGE operations, with ""radius"" as property and a Double as value.
• Center point handle: allows the user to translate the center of the arc. The user can change the position of the center point by dragging the handle. This handle generates MOVE operations, with a HANDLE_IDENTIFIER property with CENTER_POINT as value.
• Object translation handle: allows the user to translate the dome object. This handle generates MOVE operations, without any additional properties.
• Height translation handle: only for domes in a 3D view, allows the user to edit the height of the dome. The user can change the height by translating this handle. This handle generates MOVE operations, with a Z constraint, and a HANDLE_IDENTIFIER property with HEIGHT_POINT as value.

The following figure illustrates all the handles: the red dots represent the radius- and center handles, the circle shape represents the projected shape handle and the dome object represents the height translation handle.

Editing

Based on the TLspEditOperation, generated by an edit handle (see description of handles above), this editor performs different edit operations on the associated dome object. The images below illustrate the effect of the different handles. In each image the gray color represents the previous state of the object and the red color represents the edited object:

• Radius handle: the editor modifies the radius of the dome. The figure below illustrates this behavior.
  
  
  
• Center point handle: the editor translates the entire dome. The figure below illustrates this behaviour.
  
  
  
• Object translation handle: the editor translates the entire dome. Note that the behaviour for this handle is identical to the behaviour of the center point handle, with the exception of how the handle is activated (see the Handles section above).
• Height translation handle: 3D only, the editor modifies the height of the dome. The figure below illustrates this behavior.
  
  
  

Creation

The creation process of a dome consists of two distinct steps:

1. the first step initializes the XY position of the dome's center point, putting it at ground level
2. the second step initializes the radius of the dome

In a 3D view, and extra step is added:

3. the third step initializes the height of the dome's center point above the terrain

The figures below illustrate the creation process. Relevant changes that are new in each step are marked in red:

Setting the center point.		Initializing the radius.		(3D only) Initializing the height.

Since:

2012.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TLspDomeEditor.HandleIdentifier Describes the type of an edit handle created by the enclosing editor implementation.
static class	TLspDomeEditor.PropertyKeys Defines keys used by the enclosing editor implementation to store properties in its edit handles.

Constructor Summary

Constructors

Constructor and Description
TLspDomeEditor() Creates a new TLspDomeEditor.

Method Summary

Modifier and Type	Method and Description
boolean	canEdit(TLspEditContext aContext) Returns true if super returns true and the given object is an instance of ILcd3DEditableDome.
protected ALspEditHandle	createCenterHandle(ILcd3DEditableDome aDome, TLspEditContext aContext) Creates an edit handle that allows the user to translate the given dome in 2D by dragging it.
protected ALspEditHandle	createHeightTranslationHandle(ILcd3DEditableDome aDome, TLspEditContext aContext) Creates an edit handle that allows the user to alter the height above the terrain of the given dome by dragging it up/down.
protected ALspEditHandle	createObjectTranslationHandle(ILcd3DEditableDome aDome, TLspEditContext aContext) Creates an edit handle that allows the user to translate the given shape.
protected ALspEditHandle	createRadiusHandle(ILcd3DEditableDome aDome, TLspEditContext aContext) Creates an edit handle that allows the user to edit the radius of the given dome by dragging it.
protected TLspEditOperationResult	editImpl(TLspEditOperation aOperation, ELspInteractionStatus aInteractionStatus, TLspEditContext aContext) Called by the edit method to edit the given object based on the given edit operation.
ALspEditHandle	getCreateHandle(TLspEditContext aContext) Returns a handle that is used to create the given object.
List<ALspEditHandle>	getEditHandles(TLspEditContext aContext) Returns a set of handles for editing the given object.

Methods inherited from class com.luciad.view.lightspeed.editor.ALspEditor

canCopyGeometry, canPerformOperation, copyGeometrySFCT, edit, fireUndoableHappened

Methods inherited from class java.lang.Object

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

Constructor Detail

TLspDomeEditor

public TLspDomeEditor()

Creates a new TLspDomeEditor. This constructor does not initialize any state.

Method Detail

canEdit

public boolean canEdit(TLspEditContext aContext)

Returns true if super returns true and the given object is an instance of ILcd3DEditableDome.

Specified by:

canEdit in interface ILspEditor

Overrides:

canEdit in class ALspEditor

Parameters:

aContext - provides context information to the editor

Returns:

true if the above conditions are met, false otherwise.

editImpl

protected TLspEditOperationResult editImpl(TLspEditOperation aOperation,
                                           ELspInteractionStatus aInteractionStatus,
                                           TLspEditContext aContext)

Called by the edit method to edit the given object based on the given edit operation.

Note that this method does not need to lock the model of the object, this already happens in the edit method.

By default, this editor can handle the following operations:

• TLspEditOperationType.MOVE
• TLspEditOperationType.PROPERTY_CHANGE

If any of the operations contains the HANDLE_IDENTIFIER property, with a HandleIdentifier as property, and this identifier is RADIUS, then the radius of the dome will be modified.

Specified by:

editImpl in class ALspEditor

Parameters:

aOperation - the event that contains the information on how to edit the object

aInteractionStatus - the interaction status

aContext - the edit context

Returns:

The result of the operation: Whether or not there was success, and whether or not the current handles of the object should be invalidated.

getCreateHandle

public ALspEditHandle getCreateHandle(TLspEditContext aContext)

Returns a handle that is used to create the given object. The returned handle is used by the controller to initialize the other of the object.

Typically the returned handle is an instance of ALspCreateHandle which is a specialized handle implementation used for creating an object.

By default, this method returns an ALspCreateHandle capable of creating an ILcd3DEditableDome, as described in the class javadoc.

Parameters:

aContext - provides context information such as the layer for which the object is being created

Returns:

an edit handle, or null if creation should not be allowed.

See Also:

ALspCreateHandle, TLspCreateController

getEditHandles

public List<ALspEditHandle> getEditHandles(TLspEditContext aContext)

Returns a set of handles for editing the given object.

These handles will be able to generate edit operations, that are passed to the edit method. As a way to communicate with this method, handles will copy their properties to the edit operation properties. By default this method delegates to the following methods:

• createCenterHandle
• createRadiusHandle
• createHeightTranslationHandle
• createObjectTranslationHandle

It returns a list containing the handles returned by those methods. These methods are added for convenience, so they can easily be overridden.

Parameters:

aContext - provides context information such as the layer for which the object is being edited

Returns:

the edit handles to edit the given object, or an empty list if it should not be possible to edit the given object.

See Also:

TLspEditController

createRadiusHandle

protected ALspEditHandle createRadiusHandle(ILcd3DEditableDome aDome,
                                            TLspEditContext aContext)

Creates an edit handle that allows the user to edit the radius of the given dome by dragging it.

By default this method returns a handle with a HANDLE_IDENTIFIER property with HEIGHT_POINT as value.

Parameters:

aDome - the dome for which the handle is created

aContext - the current context

Returns:

an edit handle or null if no handle is needed

createCenterHandle

protected ALspEditHandle createCenterHandle(ILcd3DEditableDome aDome,
                                            TLspEditContext aContext)

Creates an edit handle that allows the user to translate the given dome in 2D by dragging it. By default this method returns a TLspPointTranslationHandle with a HANDLE_IDENTIFIER property with CENTER_POINT as value.

Parameters:

aDome - the dome for which the handle is created

aContext - the current context

Returns:

an edit handle or null if no handle is needed

createHeightTranslationHandle

protected ALspEditHandle createHeightTranslationHandle(ILcd3DEditableDome aDome,
                                                       TLspEditContext aContext)

Creates an edit handle that allows the user to alter the height above the terrain of the given dome by dragging it up/down.

By default this method returns a TLspObjectHeightTranslationHandle with a HANDLE_IDENTIFIER property with HEIGHT_POINT as value.

Note that by default this method only returns a height translation handle when the current view is a 3D view. If this is not the case, this method returns null since in a 2D view, the height translation handle is not useful.

Parameters:

aDome - the dome for which the handle is created

aContext - the current context

Returns:

an edit handle or null if no handle is needed

createObjectTranslationHandle

protected ALspEditHandle createObjectTranslationHandle(ILcd3DEditableDome aDome,
                                                       TLspEditContext aContext)

Creates an edit handle that allows the user to translate the given shape.

By default, in a 3D view, this handle is visualized as a circle (i.e. a projected version of the dome) on the terrain. The returned handle is a TLspProjectedObjectTranslationHandle.

By default, in a 2D view, the handle becomes a regular object translation handle. The returned handle is a TLspObjectTranslationHandle.

Parameters:

aDome - the shape for which the handle is created

aContext - the current context

Returns:

an edit handle or null if no handle is needed