AGSGraphicsOverlay.h File Reference

Go to the source code of this file.

Enumerations
enum	AGSGraphicsRenderingMode { AGSGraphicsRenderingModeDynamic = 0 , AGSGraphicsRenderingModeStatic = 1 }
	Contains a collection of graphics for display in a map or scene view. More...

Enumeration Type Documentation

AGSGraphicsRenderingMode

enum AGSGraphicsRenderingMode

Contains a collection of graphics for display in a map or scene view.

Specifies how the AGSGraphicsOverlay renders its content. Dynamic mode is better suited for a small number of graphics that are constantly changing or moving and need to be redrawn frequently. If your content is more static then use static mode. Static mode does not provide the same level of interactiveness or user experience as dynamic mode, but it allows the overlay to render a larger number of graphics.

Graphics overlays display on top of all other data in a map or scene view. A graphics overlay can contain graphics of various geometry types and can define symbology for the graphics it contains using its AGSGraphicsOverlay::renderer property.

A graphic's Z-index can be used to define its draw order in the collection and is mostly relevant for display in a two dimensional map. For dynamic 3D rendering (in a scene), graphic display order is determined by the distance to the camera rather than by Z-index. Z-index is considered, however, when using static rendering in a scene (draping graphics on the surface, in other words).

If Z-index for graphics is not set, they will usually render in the order in which they were added to the graphics overlay, the first added is rendered first and subsequent ones on top. In rare cases, the rendering algorithm may change the display order to provide more efficient rendering. If ordering is important, set the AGSGraphic::zIndex property explicitly on graphics. You can also place graphics of the same geometry type in their own graphics overlay and manage the order of the overlays in the view.

Since

100.0

Enumerator
AGSGraphicsRenderingModeDynamic	Dynamic rendering mode - the default. Update graphics as the map zooms and pans in an immediate mode.
AGSGraphicsRenderingModeStatic	Static rendering mode. Only update graphics between zoom and pan operations in a retained mode. Use this mode to handle large amount of graphics.