PresentationObject Class
Represents a drawing operation that has been generated by a Visualizer for a View.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class PresentationObject : EngineObjectRemarks
PresentationObject instances correspond to drawing operations for elements like symbols, lines and texts. They can be buffered by Carmenta Engine, for example a TileLayer will buffer presentation objects to avoid reading and processing features unnecessarily when a View is updated, and they are also returned by View.WhatsAt and View.WhatsIn to tell what objects a user points at.
A PresentationObject can also represent the visualization of a plot from a PlotLayer.
A PresentationObject contains information about how they are visualized and about the Feature they originate from. In that way the original object that is presented at a specific pixel position in a View can be found and also which specific part of the visualization is located at the position.
PresentationObject instances can only be created by Carmenta Engine, with the View.WhatsIn and View.WhatsAt methods.
For PresentationObject instances that originate from a ScreenLayer, methods using the geometry of the presentation objects are not supported.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
PresentationObject
Platforms
Windows, Linux, Android
PresentationObject Members
The PresentationObject type has the following members.
Properties
| Name | Description |
|---|---|
| ChildPresentationObjects | Gets the presentation objects that are children of the PresentationObject. |
| Feature | Gets the Feature that generated this PresentationObject. |
| HasHoverVisualization | Gets a value that indicates if the visualized feature also has hover visualization. |
| IsDisposed | Gets a value that tells whether the current PresentationObject has been disposed. Inherited from EngineObject |
| IsSelected | Gets a value that tells whether the PresentationObject was generated by a selection visualizer. |
| NativeHandle | Gets the native Carmenta Engine kernel object the current PresentationObject represents. Inherited from EngineObject |
| Node | Gets the index of the node that generated this PresentationObject. |
| PlotId | Gets identity of the plot the PresentationObject was generated from. |
| Points | Gets the Crs coordinates of the PresentationObject. |
| Ring | Gets the index of the polygon ring that generated this PresentationObject. |
| SourceFeature | Gets the source Feature that generated the PresentationObject. |
| SourceId | Gets identity of the Feature the PresentationObject was generated from. |
| SourceType | Gets a value that tells what kind of feature the PresentationObject was generated from. |
| Type | Gets a value that tells what kind of Visualizer generated the PresentationObject. |
| Visualizer | Gets the Visualizer that created the PresentationObject. |
Methods
| Name | Description |
|---|---|
| CalculateBounds | Returns the bounds of the PresentationObject in pixel coordinates in the specified View. |
| 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 |
 GetUniqueSourceFeatures | Overloaded. Returns the source Feature elements of all PresentationObject in a collection. |
| HitTest | Overloaded. Performs a hit test on the PresentationObject in the specified View. |
| NearestPoint | Overloaded. Returns the geographic position that is nearest the specified drawable coordinates. |
| SegmentNearPoint | Overloaded. Returns the index of the segment that is closest to the specified geographic position. |