View in MAUI WPF WinUI View on GitHub

Apply a hillshade renderer to a raster.

Image of hillshade renderer

Use case

An environmental agency may track coastal erosion by comparing images of an area taken over a a longer period of time with hillshade renderers applied.

How to use the sample

Choose and adjust the settings to update the hillshade renderer on the raster layer. The sample allows you to change the Altitude, Azimuth, and Slope Type.

How it works

  1. Create a Raster from a grayscale raster file.
  2. Create a RasterLayer from the raster.
  3. Create a Basemap from the raster layer and set it to the map.
  4. Create a HillshadeRenderer, specifying the slope type and other properties, new HillshadeRenderer(Altitude, Azimuth, ZFactor, SlopeType, PixelSizeFactor, PixelSizePower, OutputBitDepth).
  5. Set the hillshade renderer to be used on the raster layer with rasterLayer.Renderer.

Relevant API

  • Basemap
  • HillshadeRenderer
  • Raster
  • RasterLayer

Offline data

This sample downloads the Hillshade raster portal item from ArcGIS Online automatically.

Tags

altitude, angle, azimuth, raster, slope, visualization

Sample Code

RasterHillshade.xaml RasterHillshade.xaml RasterHillshade.xaml.cs
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage x:Class="ArcGIS.Samples.RasterHillshade.RasterHillshade"
xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Maui;assembly=Esri.ArcGISRuntime.Maui">
<Grid Style="{DynamicResource EsriSampleContainer}">
<esriUI:MapView x:Name="MyMapView" Style="{DynamicResource EsriSampleGeoView}" />
<Border Style="{DynamicResource EsriSampleControlPanel}">
<Grid Padding="5"
ColumnDefinitions="auto,*"
ColumnSpacing="5"
RowDefinitions="auto,auto,auto,auto">
<Label Grid.Row="0"
Grid.Column="0"
Text="Slope type:"
VerticalOptions="Center" />
<Picker x:Name="SlopeTypePicker"
Grid.Row="0"
Grid.Column="1"
MinimumWidthRequest="100" />
<Label Grid.Row="1"
Grid.Column="0"
HorizontalTextAlignment="End"
Text="Altitude:"
VerticalOptions="Center" />
<Slider x:Name="AltitudeSlider"
Grid.Row="1"
Grid.Column="1"
Maximum="90"
Minimum="0" />
<Label Grid.Row="2"
Grid.Column="0"
HorizontalTextAlignment="End"
Text="Azimuth:"
VerticalOptions="Center" />
<Slider x:Name="AzimuthSlider"
Grid.Row="2"
Grid.Column="1"
Maximum="360"
Minimum="0" />
<Button x:Name="ApplyHillshadeButton"
Grid.Row="3"
Grid.ColumnSpan="2"
Margin="20,0"
Clicked="ApplyHillshadeButton_Click"
HorizontalOptions="Center"
Text="Apply hillshade"
VerticalOptions="Center" />
</Grid>
</Border>
</Grid>
</ContentPage>