Raster rendering rule

Display a raster on a map and apply different rendering rules to that raster.

Use case

Raster images whose individual pixels represent elevation values can be rendered in a number of different ways, including representation of slope, aspect, hillshade, and shaded relief. Applying these different rendering rules to the same raster allows for a powerful visual analysis of the data. For example, a geologist could interrogate the raster image to map subtle geological features on a landscape, which may become apparent only through comparing the raster when rendered using several different rules.

How to use the sample

Run the sample and use the drop-down menu at the top to select a rendering rule.

How it works

1. Create an ImageServiceRaster using a URL to an online image service.
2. After loading the raster, use imageServiceRaster.ServiceInfo.RenderingRuleInfos to get a list of RenderingRuleInfo supported by the service.
3. Choose a rendering rule info to apply and use it to create a RenderingRule.
4. Create a new ImageServiceRaster using the same URL.
5. Apply the rendering rule to the new raster.
6. Create a RasterLayer from the raster for display.

Relevant API

• ImageServiceRaster
• RasterLayer
• RenderingRule

About the data

This raster image service contains 9 LAS files covering Charlotte, North Carolina's downtown area. The lidar data was collected in 2007. Four Raster Rules are available for selection: None, RFTAspectColor, RFTHillshade, and RFTShadedReliefElevationColorRamp.

Additional information

Image service rasters of any type can have rendering rules applied to them; they need not necessarily be elevation rasters. See the list of raster function objects and syntax for rendering rules in the ArcGIS REST API documentation.

Tags

raster, rendering rules, visualization

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<UserControl
    x:Class="ArcGISRuntime.UWP.Samples.RasterRenderingRule.RasterRenderingRule"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:esriUI="using:Esri.ArcGISRuntime.UI.Controls">
    <Grid>
        <esriUI:MapView x:Name="MyMapView" />
        <Border  Style="{StaticResource BorderStyle}">
            <StackPanel>
                <TextBlock Text="Select a rendering rule."
                           Margin="0,0,0,5"
                           TextWrapping="Wrap" TextAlignment="Center" FontWeight="SemiBold" />
                <ComboBox x:Name="RenderingRuleChooser"
                          HorizontalAlignment="Stretch"
                          SelectionChanged="comboBox_RenderingRuleChooser_SelectionChanged" />
            </StackPanel>
        </Border>
    </Grid>
</UserControl>