MapDotNet UX Help

Add, Edit or Export

Right-click on a map name to add layers, edit map properties, or export or delete maps.

Editing Map Properties

If you right-click the map you can edit map properties.  Some of the properties available on the edit screen are not exposed during the process of initially creating a new map.

Title
The title of the map.  This is read-only.

Map Units
The distance units used by the projection the map displays data in.  This is read-only.

Projection
The Well Known Text (WKT) representation of the projection the map displays data in.  This is read-only.

Background Color
The background color used by the map.

Initial Extents
The recommended starting area for viewing this map.  It is in the coordinate system of the map projection, and listed as minimum X, minimum Y, maximum X, maximum Y.  This can also be set from the Map Settings Display Pane by clicking "Update Map Extents."

Minimum Bleed Ratio
Sets the minimum amount of tile overfetching allowed for this map.  This is used to prevent labels and point symbols from being clipped at the edge of tiles.  The recommended value is 1.0 + ([largest dimension of largest point symbol] / 128.0).  Maps with labeling will need even larger values.

Metadata
Use this to attach arbitrary key-value pairs to the map for use in your applications.  The Identify and Drilldown examples in our interactive SDK demonstrate this.  Note that after adding or editing a metadata item, you must always click the check mark icon for the edit to be recognized.

New to 8.0.2000

There are two properties in the map model that provide rendering options for performance tuning.

 

Map.RenderWithFullIntersectionTests, available in Studio as the "No Render Shortcuts" checkbox in the "Edit Map Properties" dialog, forces full intersection tests during render queries.  By default, the renderer queries for spatial index hits with no further testing.  This is usually faster, but if the spatial index is imprecise and returns large numbers of false positives, setting this option will improve performance.  This typically happens where datasets span very large areas.

 

Layer.RenderWithBoundsClipping, available in Studio as the "Clip To Render Bounds" option in the "Modify Layer" dialog, causes lines or polygons to be clipped to the render window during querying, before being passed to the renderer.  This requires use of a bleed ratio.  This improves performance when zoomed in and viewing small parts of large, complex geometries.

 

Both of these options should only be used when rendering is observed to be unusually slow.  Neither has any effect with Shapefile, SDE, or KML connectors for which they are not implemented.