Class RasterLayer
An instance of this class allows you to display raster data (from a raster data source).
Implements
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class RasterLayer : ImageAdjustmentLayer, INotifyPropertyChanged, ILoadable, ILayerContent, IPopupSource, ITimeAwareRemarks
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:
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. |
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
Applies to
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.3 - 100.15 |
| .NET 6.0 | 100.13 - 100.15 |
| .NET 6.0 Windows | 100.13 - 100.15 |
| .NET Framework | 100.0 - 100.15 |
| .NET 5 | 100.10 - 100.12 |
| .NET Core 3.1 | 100.7 - 100.12 |
| Xamarin.Android | 100.0 - 100.15 |
| Xamarin.iOS | 100.0 - 100.15 |
| UWP | 100.0 - 100.15 |