Constructs a new BoundsResizeHandle.
The bounds being edited by this handle
The initial identifier of the bound's corner.
Optional handleIconStyle: null | IconStyleThe icon style of the point handle
Protected activeIndicates whether the handle is active.
Protected eventedThe EventedSupport used to emit events.
Typically, handles use emitEditShapeEvent to emit "EditShape" events. This is only used in advanced cases, for example when compositing multiple handles.
The identifier of this handle.
It indicates what corner of the bounds this handle belongs to.
The point to snap to.
This is used to paint a snap icon.
Typically, this is set by subclasses, for example in PointDragHandle.drag.
Called when handle goes from inactive to active state.
The event that triggered the activation
The edit context
Called whenever the point is dragged to a new location.
By default, this delegates to the drag function that was passed into the constructor.
The new location of the point, in model coordinates.
The gesture event that caused the drag.
The edit context
Protected emitEmits an "EditShape" event.
Typically, a handle emits this right after changing the shape.
The shape to emit an edit event for
The status of the edit. Typically, this is IN_PROGRESS while the handle is being dragged / changed, and EditShapeStatus.FINISHED when the drag ends.
Called whenever the handle should flip its identifier.
For example, if a horizontal flip occurred, and this handle was LOWER_LEFT, it should change its identifier to UPPER_LEFT.
indicates whether it was a horizontal flip
indicates whether it was a vertical flip
Returns the cursor for this point handle.
Returns the default handle icon style.
This is the handle icon style that is used if no handleIconStyle was passed into the constructor.
The edit context
The context's handle icon style.
Returns the drape target for this point handle.
This will make sure point handles with z=0 are correctly draped or not, and on the correct DrapeTarget (terrain or a 3D Tiles mesh). Icons for handles at an altitude are never draped.
In detail, this uses the following heuristics to determine a DrapeTarget: By default, this uses the drapeTarget of getHandleIconStyle. If that is not defined, this looks at the DrapeTarget.NOT_DRAPED. If it is zero, this looks for a 3D Tiles mesh layer on the map that has isDrapeTarget set. If a 3D tiles mesh layer is found, this returns DrapeTarget.ALL so the handles are draped on the mesh (and terrain, in case the data lies outside the mesh). If no mesh layer is found, this returns DrapeTarget.NOT_DRAPED.
The edit context
Returns the handle icon style, to be used for visualizing point handles in onDraw.
This returns the handle icon style that was passed into the constructor. If no handle icon style was passed into the constructor, this returns the context's handle icon style.
The edit context
Checks whether the given input event interacts with the point handle.
By default, this returns true if the mouse or finger is within a
certain distance of the point. A larger distance is used for touch events than for mouse events.
Populates a context menu with entries.
For example, a handle for a point in a polyline might add a "Delete point" context menu entry.
the input event that triggered opening the context menu.
the edit context
the context menu to add entries to.
a callback that needs to be called when a menu action is performed. Call this at the end of the ContextMenuItem.action implementation.
Called when this handle should draw shapes on the map.
By default, the implementation draws:
nullnullThis method allows the handle to draw labels on the map.
For example, you can use this to show coordinates of points, or the current radius of a circle on top of an edit handle.
The default implementation draws nothing.
The label canvas to draw labels on
The editing context.
Handles the given context.
The editing handle can modify the feature (or its shape) based on the type and state of the input event. For example, a drag event that moves a circle.
The default implementation ignores the event.
the gesture event.
the edit context.
Processes an event.
It checks if a there's a point to snap to, and sets snapPoint accordingly. After that, it calls drag with the model point under the mouse or finger.
Returns true for DOWN events that interacts with
the point handle.
Returns true on DRAG_END or
CONTEXT_MENU events.
Returns true for GestureEventType.DRAG events.
Called when (another) handle changes the feature or shape, as indicated by the "EditShape" event.
This handle can update its own state, based on the changed shape.
For example, a PointListInsertHandle just inserted a point in a polyline. The PointListTranslateHandle uses the update to recalculate new sub-handles, based on the new polyline (with the extra point).
The default implementation does nothing.
Transform a view point to model coordinates.
The default implementation transforms the view point to a model coordinate on terrain. It also moves the point's Z to 0.
The view point to transform to model coordinates
The edit context
2023.1
An event that is fired whenever this handle has flipped while dragging. Flipped
An event that is emitted whenever this handle changes the shape of a feature. EditShape
Handle that resizes a Bounds bounds shape.
This handle is linked to 1 corner of the bounds, based on its identifier.
The corner handles created by the BoundsEditor can flip, which changes their identifier. For example, if the one of the top corners is dragged below the bottom corners, the top and bottom handles flip their identifier.
See
BoundsEditor
Since
2022.1