S52Visualizer Class
Represents a Visualizer that displays features according to the S-52 symbology standard.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class S52Visualizer : VisualizerRemarks
The S52Visualizer is used to render nautical charts on the S-57 format according to the S-52 symbology standards.
For S-57 ENC data (Electronic Navigational Chart), the visualization follows the S-52 Presentation Library version 4.0(.3) from http://www.iho.int.
For S-57 AML data (Additional Military Layers), the visualization follows the AML portrayal specification; see www.ukho.gov.uk/Defence/AML.
 |
The visualizer works together with an S57DataSet reading S-57 data, to create a visualization that follows the standard as closely as possible. The visualizer has a lot of properties to control how the chart is rendered, and to turn certain features on or off, see the members of this class. You should normally not use any other visualizers, or try to filter the features from the dataset. A typical configuration looks something like this in Carmenta Studio:
 |
Most parts of the standard are supported by the visualizer, but there are a few exceptions:
Mariners objects, like own ship, predicted route etc are not supported.
No special handling of date-dependent information is supported.
Overscale and chart boundary indication is not supported.
Update review indication is not supported.
SYMINS attributes, specifying visualization instructions for S-57 objects not yet covered by the current S-52 version, are not supported.
If used under a LabelOrganizingLayer, the visualizer has some rudimentary support to avoid overlapping text labels, see OrganizeLabels. Note that using this feature may not be compliant with the S-52 standard.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
ResourceObject
Visualizer
S52Visualizer
Platforms
Windows, Linux, Android
S52Visualizer Members
The S52Visualizer type has the following members.
Constructors
| Name | Description |
|---|---|
| S52Visualizer | Initializes a new instance of the S52Visualizer class. |
Properties
| Name | Description |
|---|---|
| AreaStyle | Gets or sets a value that specifies how ENC area boundaries are rendered. |
| Condition | Gets or sets a condition that must evaluate to true if the visualizer shall be applied to a feature. Inherited from Visualizer |
| DeepContour | Gets or sets a value that specifies the depth of the deep depth contour. |
| DisplayCategory | Gets or sets a value that specifies the amount of information shown in the chart. |
| HighlightDocument | Gets or sets a value that specifies if objects with an associated text of image document will be highlighted. |
| HighlightInfo | Gets or sets a value that specifies if objects with additional information is highlighted. |
| IsDisposed | Gets a value that tells whether the current S52Visualizer has been disposed. Inherited from EngineObject |
| Name | Gets or sets the name of the S52Visualizer. Inherited from ResourceObject |
| NativeHandle | Gets the native Carmenta Engine kernel object the current S52Visualizer represents. Inherited from EngineObject |
| OptimizeForBitmapTiling | Gets or sets a value indicating if rendering should be adjusted to look better when generating raster tiles. |
| OrganizeLabels | Gets or sets a value that specifies if the visualizer should try to avoid generating overlapping text labels. |
| Palette | Gets or sets a value that specifies which palette to use. |
| PickingSupport | Gets or sets a value specifying how much information is maintained when the visualizer creates a PresentationObject for a feature. Inherited from Visualizer |
| PointStyle | Gets or sets a value that specifies how ENC point features are rendered. |
| RadarSuppression | Gets or sets a value that controls the display of objects that should be displayed on top of, or suppressed by, a radar overlay. |
| SafetyContour | Gets or sets a value that specifies the safety depth contour. |
| SafetyDepth | Gets or sets a value that specifies the safety depth. |
| ShallowContour | Gets or sets a value that specifies the depth of the shallow depth contour. |
| ShowAccuracy | Gets or sets a value that specifies if the accuracy fill pattern is displayed or not. |
| ShowContourLabels | Gets or sets a value that specifies if sounding values are displayed for depth contours. |
| ShowFullLightLines | Gets or sets a value that specifies how light sector legs are displayed. |
| ShowImportantText | Gets or sets a value that controls the display of important text. |
| ShowNationalLanguage | Gets or sets a value that specifies if text labels are displayed in the national language. |
| ShowNoDataPattern | Gets or sets a value that specifies if the nodata fill pattern is displayed or not. |
| ShowOtherText | Gets or sets a value that controls the display of non-important text. |
| ShowShallowPattern | Gets or sets a value that specifies if the shallow fill pattern is displayed or not. |
| ShowShallowWaterDangers | Gets or sets a value that specifies if isolated dangers in shallow waters are displayed or not. |
| ShowUnknown | Gets or sets a value that specifies if unknown features should be displayed or not. |
| UseFourColorDepths | Gets or sets a value that specifies how depth areas are rendered. |
| UseMinScale | Gets or sets a value that specifies if the S-57 SCAMIN attribute should be used or ignored. |
| IUserProperties.UserProperties | Gets the AttributeSet that contains the user properties. Inherited from IUserProperties |
| ViewingGroupFilter | Gets or sets an object that can control whether particular viewing group layers are displayed or not. |
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 |
| Draw | Draws a feature on a drawable. Inherited from Visualizer |
| Equals | Determines whether this instance is equal to another. Inherited from EngineObject |
| FindChildObject | Overloaded. Finds the child object with the specified name. Inherited from Visualizer |
| GetChildObjects | Overloaded. Gets the child objects of the current object. Inherited from Visualizer |