Change sublayer renderer

View inC++QMLView on GitHubSample viewer app

Apply a renderer to a sublayer.

screenshot

Use case

A layer showing animal populations contains sublayers for different species. A renderer could be applied which gives each sublayer a different color, so that populations of each species can be compared visually.

How to use the sample

Wait for the map image layer to load. Press the Apply Renderer button to apply a unique value renderer to see different population ranges in the counties sub-layer data. Press the Reset button to go back to the original renderer.

How it works

  1. Create an ArcGISMapImageLayer from its URL.
  2. After it is done loading, get its SublayerList with imageLayer.mapImageSublayers.
  3. Create a ClassBreaksRenderer with a collection of ClassBreaks for different population ranges.
  4. Set the renderer of the sublayer with sublayer.renderer.

Relevant API

  • ArcGISMapImageLayer
  • ArcGISMapImageSubLayer
  • ClassBreaksRenderer
  • ClassBreaksRenderer.classBreak

About the data

This application displays census data from an ArcGIS Server map service. It contains various population statistics, including total population for each county in 2007.

Additional information

The service hosting the layer must support dynamic layers to be able to change the rendering of sublayers.

Tags

class breaks, dynamic layer, dynamic rendering, renderer, sublayer, symbology, visualization

Sample Code

ChangeSublayerRenderer.qml
Use dark colors for code blocksCopy
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
// [WriteFile Name=ChangeSublayerRenderer, Category=Layers]
// [Legal]
// Copyright 2018 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]

import QtQuick
import QtQuick.Controls
import Esri.ArcGISRuntime

Rectangle {
    id: rootRectangle
    clip: true
    width: 800
    height: 600

    property var sublayer: null
    property var originalRenderer: null

    MapView {
        id: mapView
        anchors.fill: parent

        Component.onCompleted: {
            // Set the focus on MapView to initially enable keyboard navigation
            forceActiveFocus();
        }

        Map {
            Basemap {
                initStyle: Enums.BasemapStyleArcGISStreets
            }

            ArcGISMapImageLayer {
                url: "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer"

                onLoadStatusChanged: {
                    if (loadStatus !== Enums.LoadStatusLoaded)
                        return;

                    // get the counties sublayer
                    sublayer = mapImageSublayers.get(2);

                    // get the original renderer once loaded
                    sublayer.loadStatusChanged.connect(()=> {
                        if (sublayer.loadStatus !== Enums.LoadStatusLoaded)
                            return;

                        originalRenderer = sublayer.renderer;
                    });

                    // load the sublayer
                    sublayer.load();
                }
            }

            ViewpointExtent {
                Envelope {
                    xMin: -13834661.666904
                    yMin: 331181.323482
                    xMax: -8255704.998713
                    yMax: 9118038.075882
                    spatialReference: SpatialReference { wkid: 3857 }
                }
            }
        }
    }

    // create class breaks renderer for the sublayer
    ClassBreaksRenderer {
        id: classBreaksRenderer
        fieldName: "POP2007"

        // declare the class breaks that make up the renderer, along with
        // a symbol for each class break
        ClassBreak {
            minValue: -99
            maxValue: 8560
            description: "-99 to 8560"
            label: description
            SimpleFillSymbol {
                color: Qt.rgba(0.89, 0.92, 0.81, 1)
                outline: SimpleLineSymbol {
                    id: outlineSymbol
                    color: Qt.rgba(0.6, 0.6, 0.6, 1)
                    width: 1
                }
                style: Enums.SimpleFillSymbolStyleSolid
            }
        }

        ClassBreak {
            minValue: 8560
            maxValue: 18109
            description: "> 8,560 to 18,109"
            label: description
            SimpleFillSymbol {
                color: Qt.rgba(0.59, 0.76, 0.75, 1)
                outline: outlineSymbol
                style: Enums.SimpleFillSymbolStyleSolid
            }
        }

        ClassBreak {
            minValue: 18109
            maxValue: 35501
            description: "> 18,109 to 35,501"
            label: description
            SimpleFillSymbol {
                color: Qt.rgba(0.38, 0.65, 0.71, 1)
                outline: outlineSymbol
                style: Enums.SimpleFillSymbolStyleSolid
            }
        }

        ClassBreak {
            minValue: 35501
            maxValue: 86100
            description: "> 35,501 to 86,100"
            label: description
            SimpleFillSymbol {
                color: Qt.rgba(0.27, 0.49, 0.59, 1)
                outline: outlineSymbol
                style: Enums.SimpleFillSymbolStyleSolid
            }
        }

        ClassBreak {
            minValue: 86100
            maxValue: 10110975
            description: "> 86,100 to 10,110,975"
            label: description
            SimpleFillSymbol {
                color: Qt.rgba(0.16, 0.33, 0.47, 1)
                outline: outlineSymbol
                style: Enums.SimpleFillSymbolStyleSolid
            }
        }
    }

    Column {
        anchors {
            left: parent.left
            top: parent.top
            margins: 5
        }
        spacing: 5

        Button {
            width: 200
            text: "Apply Renderer"
            enabled: sublayer ? sublayer.loadStatus === Enums.LoadStatusLoaded : false
            onClicked: sublayer.renderer = classBreaksRenderer;
        }

        Button {
            width: 200
            text: "Reset"
            enabled: sublayer ? sublayer.loadStatus === Enums.LoadStatusLoaded : false
            onClicked: sublayer.renderer = originalRenderer;
        }
    }
}

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