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
<UserControl x:Class="ArcGIS.WPF.Samples.RasterHillshade.RasterHillshade"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
<Grid>
<esri:MapView x:Name="MyMapView" />
<Border Style="{StaticResource BorderStyle}">
<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition />
<ColumnDefinition Width="3*" />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition />
<RowDefinition />
<RowDefinition />
<RowDefinition />
</Grid.RowDefinitions>
<TextBlock Grid.Row="0"
Grid.Column="0"
VerticalAlignment="Center"
Text="Slope type:"
TextAlignment="Right" />
<ComboBox x:Name="SlopeTypeCombo"
Grid.Row="0"
Grid.Column="1"
Margin="5" />
<TextBlock Grid.Row="1"
Grid.Column="0"
VerticalAlignment="Center"
Text="Altitude:"
TextAlignment="Right" />
<Slider x:Name="AltitudeSlider"
Grid.Row="1"
Grid.Column="1"
Margin="5"
Maximum="90"
Minimum="0">
<Slider.ToolTip>
<ToolTip Content="{Binding RelativeSource={RelativeSource Self}, Path=PlacementTarget.Value}" ContentStringFormat="{}{0:0}" />
</Slider.ToolTip>
</Slider>
<TextBlock Grid.Row="2"
Grid.Column="0"
VerticalAlignment="Center"
Text="Azimuth:"
TextAlignment="Right" />
<Slider x:Name="AzimuthSlider"
Grid.Row="2"
Grid.Column="1"
Margin="5"
Maximum="360"
Minimum="0">
<Slider.ToolTip>
<ToolTip Content="{Binding RelativeSource={RelativeSource Self}, Path=PlacementTarget.Value}" ContentStringFormat="{}{0:0}" />
</Slider.ToolTip>
</Slider>
<Button x:Name="ApplyHillshadeButton"
Grid.Row="3"
Grid.Column="0"
Grid.ColumnSpan="2"
Margin="5"
Padding="3"
Click="ApplyHillshadeButton_Click"
Content="Apply hillshade"
IsEnabled="False" />
</Grid>
</Border>
</Grid>
</UserControl>