StandardTouchTool3D Class
An advanced touch tool for interacting with a 3D GlobeView.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class StandardTouchTool3D : TouchToolRemarks
StandardTouchTool3D is a touch tool for interacting with 3D globe view. By using only touch interactions, the user can easily move around the 3D globe, zoom in or out on specific positions in the view, or rotate around interesting positions, controlling the camera position, bearing and pitch. It also supports moving complete objects or parts of objects, and even adding and removing nodes of existing features.
The editing operations only work if the feature is in a layer that is selectable (see Layer.Selectable), the layer's parent layers are selectable and the feature is stored in a dataset that is writable (i.e. it has to be a MemoryDataSet).
The tool will update the original nodes of geometries you edit. If you want to edit individual nodes of the geometries with the tool, the operator chain should not add, delete or move nodes in the geometry between being read from the MemoryDataSet and being visualized by a VisualizationOperator. The features should not reside inside a GlobeTileLayer since this may introduce new nodes on the visualized geometry where the tiles are joined. To improve performance, editable features should instead reside in a OrdinaryLayer using Dynamic.
The StandardTouchTool3D does not let you create new features; use CreateTouchTool3D for that.
See MapControl.IsTouchInputSupported for a list of which platforms and API:s support touch input.
Supported Interactions
The tool has several functions and the way you switch between these depend on what interaction and navigation mode is set. In the default mode, mouse buttons and the keyboard are used to switch between modes. Most of the functions can also be enabled or disabled using bool properties. It is also possible to switch to some of the modes manually by using the InteractionMode and NavigationMode properties.
The default settings do not let you move features and nodes vertically. You need to change the InteractionMode for this.
Navigation
Interaction | Behavior |
|---|---|
Single finger drag action | Moves the terrain relative to the camera, using the selected ground point as a handle. The camera altitude (unless modified by a ViewConstraints) and direction are unchanged |
Single finger double tap | Zooms in a set amount. Keeps the tapped location in the same place on the screen |
Two finger pinch | Zooms towards/from the ground point between the fingers |
Two finger rotation | Rotates the camera around the ground point between the fingers |
Two finger vertical swipe | Changes the camera pitch up or down |
General Editing
Single finger tap on selectable feature | The feature is selected. The selection status is toggled if multi-select is enabled |
|---|---|
Single finger touch down and drag on selectable feature | The feature is selected and moved. All selected features are moved if multi-select is enabled |
Single finger tap on background | Any selected feature is deselected |
Single finger tap on selected line/polygon node | The selection is toggled if multi-select is enabled |
Single finger tap and hold on selected line/polygon node | The node is removed. This operation requires a selection visualizer for the nodes |
Single finger tap and hold on selected line/polygon edge | A new node is added and then moved if you move the finger. This operation requires selection visualizers for both the nodes and the line/polygon |
Ellipse Editing
Ellipse interaction symbols are generated by the InteractionVisualizer. You can find information on setting up the interaction in Interacting with Ellipses.
Interaction | Behavior |
|---|---|
Single finger on center symbol and dragging | Moves the center |
Single finger on circle radius symbol and dragging | Changes the radius and direction |
Single finger on circle inner radius symbol and dragging | Changes the inner radius and direction |
Interaction | Behavior |
|---|---|
Single finger on center symbol and dragging | Moves the center |
Single finger on ellipse primary radius symbol and dragging | Changes the radius and the direction. The ratio is also changed so that the ellipse is only changed in one direction |
Single finger on ellipse secondary radius symbol and dragging | Changes the ratio |
Interaction | Behavior |
|---|---|
Single finger on center symbol and dragging | Moves the center |
Single finger on middle symbol and dragging | Changes the radius and the start and end angle of the sector so that the middle of the sector is where the cursor is |
Single finger on left symbol and dragging | Depending on the EllipseOperator.SectorDefinition, changes the radius and/or start angle and/or width of the sector |
Single finger on right symbol and dragging | Depending on the EllipseOperator.SectorDefinition, changes the inner radius and/or finish angle and/or width of the sector |
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
TouchTool
StandardTouchTool3D
InspectTouchTool3D
Platforms
Windows, Linux, Android
StandardTouchTool3D Members
The StandardTouchTool3D type has the following members.
Constructors
| Name | Description |
|---|---|
| StandardTouchTool3D | Initializes a new instance of the StandardTouchTool3D class. |
Properties
| Name | Description |
|---|---|
| DoubleTapZoomEnabled | Gets or sets a flag indicating if the user may zoom the view by double tapping. |
| EditEnabled | Gets or sets a flag indicating if the user can edit features with touch interactions. |
| InteractionMode | Gets or sets the tool interaction mode. Use this to override the default tool interaction. |
| IsDisposed | Gets a value that tells whether the current StandardTouchTool3D has been disposed. Inherited from EngineObject |
| KineticScrollingEnabled | Gets or sets a flag indicating if kinetic scrolling is enabled. |
| MaximumEllipseRatio | Gets or sets a value indicating the maximum allowed EllipseOperator.Ratio when editing ellipses. The most useful case is when you want the axis that is along the EllipseOperator.Direction to always be longer than the axis that is defined by the EllipseOperator.Direction. You can then set the value of this property to 1.0. A value of 0.0 means that there is no maximum ratio. |
| MultiSelectEnabled | Gets or sets a flag indicating if selecting multiple features by tapping the screen is enabled. |
| NativeHandle | Gets the native Carmenta Engine kernel object the current StandardTouchTool3D represents. Inherited from EngineObject |
| NavigationMode | Gets or sets the navigation mode. Use this to override the default tool navigation. |
| PanEnabled | Gets or sets a flag indicating if the user may pan the view by dragging with one or two fingers. |
| RotateEnabled | Gets or sets a flag indicating if the user may rotate the view by rotating two fingers. |
| SelectEnabled | Gets or sets a flag indicating if selecting features by tapping the screen is enabled. |
| ShowMarker | Gets or sets a flag indicating if the tool draws a marker in the view, showing the zoom or inspect point. |
| TouchRadius | Gets or sets an explicit touch radius that will be used by the StandardTouchTool3D. |
| TouchRadiusScaleFactor | Gets or sets a scale factor that is applied to the touch radius before it is used by the StandardTouchTool3D. |
| ZoomEnabled | Gets or sets a flag indicating if the user may zoom the view by using a pinch gesture. |
Methods
| Name | Description |
|---|---|
| Clone | Creates a copy of an object. Inherited from EngineObject |
| Dispose | Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject |
| Equals | Determines whether this instance is equal to another. Inherited from EngineObject |
| ITouchTool.IsActive | Indicates if the touch tool is currently tracking any touch points. Inherited from ITouchTool |
| ITouchTool.OnConnect | Called when a tool is connected to the map control. Inherited from ITouchTool |
| ITouchTool.OnDisconnect | Called when the tool is disconnected from the map control. Inherited from ITouchTool |
| ITouchTool.OnTouchBegin | Called before the map control forwards any touch down, move or up events. Inherited from ITouchTool |
| ITouchTool.OnTouchDown | Called when a new touch point is detected. Inherited from ITouchTool |
| ITouchTool.OnTouchEnd | Called after the map control has forwarded all touch down, move and up events. Inherited from ITouchTool |
| ITouchTool.OnTouchMove | Called when a touch point is moved. Inherited from ITouchTool |
| ITouchTool.OnTouchUp | Called when a touch point is released. Inherited from ITouchTool |
| SetFilterParameters | Sets parameters on the filter that Carmenta Engine uses to reduce jitter on touch input. Inherited from TouchTool |
Events
| Name | Description |
|---|---|
| Interacted | Occurs when a user completes (or aborts) an interaction. |
| Interacting | Occurs when a user interacts with features in a selectable layer. |
| Selecting | Occurs when user has clicked one ore more features and the tool is about to add them to the selection of the view. |