Show / Hide Table of Contents

Class RasterLayer

An instance of this class allows you to display raster data (from a raster data source).

Inheritance
System.Object
Layer
ImageAdjustmentLayer
RasterLayer
Implements
System.ComponentModel.INotifyPropertyChanged
ILoadable
ILayerContent
IPopupSource
ITimeAware
ImageAdjustmentLayer.Brightness
ImageAdjustmentLayer.Contrast
ImageAdjustmentLayer.Gamma
Layer.LoadAsync()
Layer.CancelLoad()
Layer.RetryLoadAsync()
Layer.LoadStatus
Layer.LoadError
Layer.Item
Layer.Attribution
Layer.Description
Layer.MaxScale
Layer.MinScale
Layer.SpatialReference
Layer.Opacity
Layer.Id
Layer.FullExtent
Layer.Clone()
Layer.CanChangeVisibility
Layer.IsVisible
Layer.IsIdentifyEnabled
Layer.Name
Layer.ShowInLegend
Layer.SublayerContents
Layer.GetLegendInfosAsync()
Layer.IsVisibleAtScale(Double)
Layer.PropertyChanged
Layer.OnPropertyChanged(String)
Layer.Loaded
Layer.LoadStatusChanged
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class RasterLayer : ImageAdjustmentLayer, INotifyPropertyChanged, ILoadable, ILayerContent, IPopupSource, ITimeAware
Remarks

In its simplest form, raster data consists of a matrix of cells (or pixels) organized into rows and columns (or a grid) where each cell contains a value representing information. Raster layer can support these main types of raster data sources:

  • Raster files - path to a file on the device.
  • Remote ArcGIS Image services, see ImageServiceRaster.
  • Raster files within GeoPackages, see GeoPackageRaster.
  • Mosaic datasets, see MosaicDatasetRaster.

You can change how a raster layer is visualized by creating a RasterRenderer and applying it to the layer. Each raster layer supports identify on its individual cells when it is displayed in a MapView or SceneView. The raster layer adopts the loadable pattern; many of its properties are initialized asynchronously. See ILoadable for more information.

If a raster dataset has just one value associated with each cell it is called a single-band raster. For example, in a digital elevation model (DEM) each cell contains one value representing the elevation at that location.

A satellite image, however, commonly has multiple bands representing different wavelengths of the electromagnetic spectrum. Landsat imagery, for example, contains seven bands that represent data from the visible and infrared parts of the spectrum. Rasters are particularly useful for remote sensing tasks, such as monitoring vegetation and seeing through smoke to analyze an active fire.

Raster datasets can be quite large. The size of the dataset depends on the following:

  • The geographic extent of the data.
  • The size of the cells used (resolution).
  • The number of bands.

As with any data consumed locally, file size can be an issue for storage as well as for transferring datasets over the network.

Sample Code:

  • Raster layer (GeoPackage)
  • Raster layer (file)
  • Raster hillshade renderer
  • Raster layer (service)
  • Apply raster function to raster from service

Constructors

Name Description
RasterLayer(Item)

Initializes a new instance of the RasterLayer class with the given image service portal item.

RasterLayer(Raster)

Initializes a new instance of the RasterLayer class from a raster.

RasterLayer(String)

Initializes a new instance of the RasterLayer class from the specified raster data source.

Properties

Name Description
FullTimeExtent

Gets the temporal window that encapsulates the instance's complete set of data

IsPopupEnabled

Gets or sets a value indicating whether the PopupDefinition defined on the RasterLayer is enabled.

IsTimeFilteringEnabled

Gets or sets a value indicating whether the instance respects any temporal filters that are applied to it.

PopupDefinition

Gets or sets the pop-up definition for the RasterLayer.

Raster

Gets or sets the raster object on the layer.

Renderer

Gets or sets the raster renderer used for this layer.

SupportsTimeFiltering

Gets a value indicating whether the instance supports filtering its data based on time.

TimeInterval

Gets a temporal value that represents the suggested temporal interval to use when sequentially stepping through the instance's data by time

TimeOffset

Gets or sets the amount of time by which to offset the temporal values of data points in this instance when displaying the data in a GeoView.

Events

Name Description
FullTimeExtentChanged

Raised when the FullTimeExtent of the instance's data changes

See Also

Layer
ImageAdjustmentLayer
Raster
ImageServiceRaster
GeoPackageRaster
MosaicDatasetRaster

Applies to

TargetVersions
.NET Standard 2.0100.3 - 200.7
.NET100.13 - 200.7
.NET Windows100.13 - 200.7
.NET Android200.0 - 200.7
.NET iOS200.0 - 200.7
.NET Framework100.0 - 200.7
Xamarin.Android100.0 - 100.15
Xamarin.iOS100.0 - 100.15
UWP100.0 - 200.7

Relevant samples

Raster layer (file): Create and use a raster layer made from a local raster file.
In This Article
Back to top Copyright © 2022 Esri.