CreateTouchTool3D Class
A touch tool that can be used to create new features interactively in a 3D GlobeView.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class CreateTouchTool3D : TouchToolRemarks
The CreateTouchTool3D allows the user to create new point, line and polygon features using touch interactions in a 3D GlobeView. The tool inserts the new features into a MemoryDataSet specified by the application through the DataSet property and the type of feature to create is specified by the CreateMode property.
The tool by itself does not provide any visual feedback, it is up to the application to add the dataset to a layer with the proper visualizations.
A new feature is created and inserted into the dataset as soon as the user starts a new create operation. The new feature inherits the attributes specified by the Attributes properties.
When the user completes the feature, the tool fires a FeatureCreated event. The application can add a handler for this event and, for example, activate a StandardTouchTool so the user can pan/zoom in the map again.
See MapControl.IsTouchInputSupported for a list of which platforms and API:s support touch input.
Supported Interactions
Instead of placing each individual point with multiple touches, multi-point geometries are placed along a line where you move your finger while pressing. When you release your finger the geometry is created. If you set ControlPoints you can make the tool limit the number of points the geometry gets.
Creating Simple Geometries
Choose which one of these geometries are created by modifying CreateMode.
Point
Press to place the point.
Line
Press to place the first point.
While still pressing, move your finger to outline the line.
Release the finger to finish the line.
LineSegment
Press to place the first point.
While still pressing, move your finger to move the second point.
Release the finger to finish the line.
LineSegmentDrag
Press to place the first point.
While still pressing, move your finger to move the second point.
Release the finger to finish the line.
Polygon
Press to place the first point.
While still pressing, move your finger to outline the polygon.
Release the finger to finish the polygon.
Creating Boxes
If you have a BoxOperator and want to create the meshes, use Polygon to create polygons. Set attributes for the top and bottom elevation in Attributes and set up your BoxOperator to take the elevation values from these attributes. The procedure is the same as for clicking out the points for a polygon. Note that the box will be placed according to the elevation attributes, while the points you place will be placed according to the settings of the tool.
The steps are the same as for creating a polygon. Use StandardTouchTool3D to modify the top and bottom elevation after it has been created.
Creating Ellipses
Set CreateMode to Ellipse. Ellipses are created using EllipseOperator and to be able to create and edit them you need to set it up according to the documentation in Interacting with Ellipses.
To alter the settings you also need to set CreateToolParameters to an instance of EllipseCreateToolParameters. These parameters are used to control how the ellipse is created and to set up the attribute names used to control the EllipseOperator.
Initial Attributes
By setting attributes in the Attributes you can skip manual steps in the creation of the ellipse. This can be useful for example when you want to place a sector representing a field of view. If it represents equipment, the radius and angle width may not change. By setting these as initial attributes, the tool only needs the user to place the center and then a point indicating the direction.
For the following steps, if all of the attributes that a step is setting are already set as initial attributes, that step will be skipped.
Ellipse
Press to place the center.
While still pressing, move your finger to place a point deciding the radius and direction.
Release to finish the ellipse.
The ellipse will be created with a ratio of 0.5 unless the ratio is set as an initial attribute. It can later be edited with the StandardTouchTool3D.
Circle
Press to place the center.
While still pressing, move your finger to place a point deciding the radius and direction.
Release to finish the circle.
If EllipseCreateToolParameters.HasInnerRadius is enabled and is not set by an initial attribute, the inner radius will be set to half of the radius. It can later be edited with the StandardTouchTool3D.
Sector
The sector is placed differently based on the EllipseCreateToolParameters.SectorDefinition. For all sectors, if EllipseCreateToolParameters.HasInnerRadius is enabled and is not set by an initial attribute, the inner radius will be set to half of the radius. It can later be edited with the StandardTouchTool3D. Also, unless specified as an initial attribute, the width of the sector will be 45 degrees. It can also be edited with the StandardTouchTool3D.
Using StartClockwiseToFinish:
Press to place the center.
While still pressing, move your finger to place a point deciding the radius and start angle.
Release to finish the sector.
Using StartClockwiseByWidth:
Press to place the center.
While still pressing, move your finger to place a point deciding the radius and start angle.
Release to finish the sector.
Using MiddleAndWidth:
Press to place the center.
While still pressing, move your finger to place a point deciding the radius and middle angle.
Release to finish the sector.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
TouchTool
CreateTouchTool3D
Platforms
Windows, Linux, Android
CreateTouchTool3D Members
The CreateTouchTool3D type has the following members.
Constructors
| Name | Description |
|---|---|
| CreateTouchTool3D | Initializes a new instance of the CreateTouchTool3D class. |
Properties
| Name | Description |
|---|---|
| Attributes | Gets the set of attributes that will be set in the new Feature. |
| ControlPoints | Gets or sets the maximum number of control points in features created by a CreateTouchTool3D. |
| CreateMode | Gets or sets a value indicating what type of features the user can create with the tool. |
| DataSet | Gets or sets the MemoryDataSet in which the tool inserts new features. |
| ElevationMode | Gets or sets a value specifying how created nodes are elevated. |
| IsDisposed | Gets a value that tells whether the current CreateTouchTool3D has been disposed. Inherited from EngineObject |
| MinPointDistance | Gets or sets the minimum distance, in pixels, between points in line or polygon features. |
| NativeHandle | Gets the native Carmenta Engine kernel object the current CreateTouchTool3D represents. Inherited from EngineObject |
| Offset | Gets or sets the offset that is added to the elevation of the ground when a node is created. |
| Parameters | Gets or sets additional parameters for the CreateTouchTool3D to use when it creates new features. |
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 |
|---|---|
| FeatureCreated | Occurs when user has completed creating a new feature. |