Simple renderer

View on GitHubSample viewer app

Display common symbols for all graphics in a graphics overlay with a renderer.

screenshot

Use case

Graphics are often used to display data that changes location regularly because they are held in memory instead of being persisted to the map. When a number of graphics are required to share the same style, a simple renderer can be applied to the graphics overlay containing the graphics. For example, the location of mobile taxis from a same company could be plotted on a map with each taxi marked by a relevant symbol.

How to use the sample

The sample loads with a predefined simple renderer, which displays a red cross simple marker symbol for the graphics in the graphics overlay.

How it works

  1. Create a GraphicsOverlay.
  2. Create a number of Point objects with x, y and spatial reference parameters.
  3. Create a SimpleMarkerSymbol passing in a SimpleMarkerSymbolStyle, color and size as parameters.
  4. Create a simple renderer with SimpleRenderer(simpleMarkerSymbol).
  5. Set the simple renderer to the graphics overlay using graphicsOverlay::setRenderer(simpleRenderer).
  6. Create a number of Graphic objects with the points initiated in step 2.
  7. Add the graphics to the graphics overlay with graphicsOverlay::graphics()::append(graphic).

Relevant API

  • Graphic
  • GraphicsOverlay
  • Point
  • SimpleMarkerSymbol
  • SimpleRenderer

Additional information

Renderers are used to display graphics that don't already have a symbol set. A renderer will not override a graphic's symbol if one has been set.

Tags

graphics, marker, renderer, symbol, symbolize, symbology

Sample Code

Simple_Renderer.cppSimple_Renderer.cppSimple_Renderer.hSimple_Renderer.qml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
// [WriteFile Name=Simple_Renderer, Category=DisplayInformation]
// [Legal]
// Copyright 2016 Esri.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// [Legal]

#ifdef PCH_BUILD
#include "pch.hpp"
#endif // PCH_BUILD

// sample headers
#include "Simple_Renderer.h"

// ArcGIS Maps SDK headers
#include "Envelope.h"
#include "Graphic.h"
#include "GraphicListModel.h"
#include "GraphicsOverlay.h"
#include "GraphicsOverlayListModel.h"
#include "Map.h"
#include "MapQuickView.h"
#include "MapTypes.h"
#include "MapViewTypes.h"
#include "Point.h"
#include "SimpleMarkerSymbol.h"
#include "SimpleRenderer.h"
#include "SpatialReference.h"
#include "SymbolTypes.h"

// Qt headers
#include <QFuture>

using namespace Esri::ArcGISRuntime;

Simple_Renderer::Simple_Renderer(QQuickItem* parent) :
  QQuickItem(parent)
{
}

Simple_Renderer::~Simple_Renderer() = default;

void Simple_Renderer::init()
{
  qmlRegisterType<MapQuickView>("Esri.Samples", 1, 0, "MapView");
  qmlRegisterType<Simple_Renderer>("Esri.Samples", 1, 0, "Simple_RendererSample");
}

void Simple_Renderer::componentComplete()
{
  QQuickItem::componentComplete();

  // find QML MapView component
  m_mapView = findChild<MapQuickView*>("mapView");
  m_mapView->setWrapAroundMode(WrapAroundMode::Disabled);

  // Create a map using the imagery basemap
  m_map = new Map(BasemapStyle::ArcGISImageryStandard, this);

  // create graphics overlay
  m_graphicsOverlay = new GraphicsOverlay(this);

  // create red cross SimpleMarkerSymbol
  SimpleMarkerSymbol* crossSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbolStyle::Cross, QColor("red"), 12, this);

  // create renderer and set symbol to crossSymbol
  SimpleRenderer* simpleRenderer = new SimpleRenderer(crossSymbol, this);
  // set the SimpleRenderer to the GraphicsOverlay
  m_graphicsOverlay->setRenderer(simpleRenderer);

  // create points to render
  Point oldFaithfulPoint(-110.828140, 44.460458, SpatialReference::wgs84());
  Point cascadeGeyserPoint(-110.829004, 44.462438, SpatialReference::wgs84());
  Point plumeGeyserPoint(-110.829381, 44.462735, SpatialReference::wgs84());

  // create graphics using points and add them to GraphicsOverlay
  addPoint(oldFaithfulPoint);
  addPoint(cascadeGeyserPoint);
  addPoint(plumeGeyserPoint);

  // Set map to map view
  m_mapView->setMap(m_map);

  // set viewpoint using the two farthest points as an envelope with padding
  m_mapView->setViewpointGeometryAsync(Envelope(oldFaithfulPoint, plumeGeyserPoint), 50);

  // add GraphicsOverlay to MapView
  m_mapView->graphicsOverlays()->append(m_graphicsOverlay);
}

void Simple_Renderer::addPoint(Point &point)
{
  // create graphic
  Graphic* graphic = new Graphic(point, this);

  // add graphic to Graphic Overlay
  m_graphicsOverlay->graphics()->append(graphic);
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close