RGB renderer

View on GitHubSample viewer app

Apply an RGB renderer to a raster layer to enhance feature visibility.

Image of RGB renderer

Use case

An RGB renderer is used to adjust the color bands of a multispectral image. Remote sensing images acquired from satellites often contain values representing the reflection of multiple spectrums of light. Changing the RGB renderer of such rasters can be used to differentiate and highlight particular features that reflect light differently, such as different vegetation types, or turbidity in water.

How to use the sample

Choose one of the stretch parameter types. The other options will adjust based on the chosen type. Add your inputs and click the 'Update' button to update the renderer.

How it works

  1. Create a Raster from a multispectral raster file.
  2. Create a RasterLayer from the raster.
  3. Create a Basemap from the raster layer and instantiate an ArcGISMap with it.
  4. Create a RGBRenderer, specifying the StretchParameters and other properties.
  5. Set the renderer on the raster layer with rasterLayer.setRasterRenderer(renderer).

Relevant API

  • Basemap
  • Raster
  • RasterLayer
  • RGBRenderer
  • StretchParameters

About the data

The raster used in this sample shows an area in the south of the Shasta-Trinity National Forest, California.

Tags

analysis, color, composite, imagery, multiband, multispectral, pan-sharpen, photograph, raster, spectrum, stretch, visualization

Sample Code

RgbRendererController.javaRgbRendererController.javaRgbRendererSample.java
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
/*
 * Copyright 2017 Esri.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.esri.samples.rgb_renderer;

import java.io.File;
import java.util.Arrays;
import java.util.List;

import javafx.fxml.FXML;
import javafx.scene.control.ComboBox;
import javafx.scene.control.Spinner;
import javafx.scene.layout.GridPane;
import javafx.scene.layout.HBox;
import javafx.scene.layout.VBox;

import com.esri.arcgisruntime.layers.RasterLayer;
import com.esri.arcgisruntime.mapping.ArcGISMap;
import com.esri.arcgisruntime.mapping.Basemap;
import com.esri.arcgisruntime.mapping.view.MapView;
import com.esri.arcgisruntime.raster.MinMaxStretchParameters;
import com.esri.arcgisruntime.raster.PercentClipStretchParameters;
import com.esri.arcgisruntime.raster.RGBRenderer;
import com.esri.arcgisruntime.raster.Raster;
import com.esri.arcgisruntime.raster.StandardDeviationStretchParameters;
import com.esri.arcgisruntime.raster.StretchParameters;

public class RgbRendererController {

  @FXML private HBox stdDeviationGroup;
  @FXML private GridPane minMaxGroup;
  @FXML private VBox percentClipGroup;
  @FXML private MapView mapView;
  @FXML private ComboBox<String> stretchTypeComboBox;
  @FXML private Spinner<Integer> factorSpinner;
  @FXML private Spinner<Integer> minPercentSpinner;
  @FXML private Spinner<Integer> maxPercentSpinner;
  @FXML private Spinner<Integer> minRedSpinner;
  @FXML private Spinner<Integer> minGreenSpinner;
  @FXML private Spinner<Integer> minBlueSpinner;
  @FXML private Spinner<Integer> maxRedSpinner;
  @FXML private Spinner<Integer> maxGreenSpinner;
  @FXML private Spinner<Integer> maxBlueSpinner;

  private RasterLayer rasterLayer;

  public void initialize() {

    // create raster
    Raster raster = new Raster(new File(System.getProperty("data.dir"), "./samples-data/raster/Shasta.tif").getAbsolutePath());

    // create a raster layer
    rasterLayer = new RasterLayer(raster);

    // create a basemap from the raster layer
    Basemap basemap = new Basemap(rasterLayer);
    ArcGISMap map = new ArcGISMap(basemap);

    // set the map to the map view
    mapView.setMap(map);

    // set stretch types
    stretchTypeComboBox.getItems().addAll("Min Max", "Percent Clip", "Std Deviation");

    // hide options based on selected stretch type
    stretchTypeComboBox.getSelectionModel().selectedItemProperty().addListener(e -> {
      String type = stretchTypeComboBox.getSelectionModel().getSelectedItem();
      minMaxGroup.setVisible("Min Max".equals(type));
      percentClipGroup.setVisible("Percent Clip".equals(type));
      stdDeviationGroup.setVisible("Std Deviation".equals(type));
    });

    // set up sliders to match constraint min + max <= 100
    minPercentSpinner.valueProperty().addListener(e -> {
      if (minPercentSpinner.getValue() + maxPercentSpinner.getValue() > 100) {
        maxPercentSpinner.getValueFactory().setValue(100 - minPercentSpinner.getValue());
      }
    });
    maxPercentSpinner.valueProperty().addListener(e -> {
      if (minPercentSpinner.getValue() + maxPercentSpinner.getValue() > 100) {
        minPercentSpinner.getValueFactory().setValue(100 - maxPercentSpinner.getValue());
      }
    });

    stretchTypeComboBox.getSelectionModel().select(0);

    updateRenderer();
  }

  /**
   * Updates the raster layer renderer according to the chosen property values.
   */
  public void updateRenderer() {

    StretchParameters stretchParameters;
    switch (stretchTypeComboBox.getSelectionModel().getSelectedItem()) {
      case "Min Max":
        List<Double> minValues = Arrays.asList(minRedSpinner.getValue().doubleValue(), minGreenSpinner.getValue()
                .doubleValue(), minBlueSpinner.getValue().doubleValue());
        List<Double> maxValues = Arrays.asList(maxRedSpinner.getValue().doubleValue(), maxGreenSpinner.getValue()
                .doubleValue(), maxBlueSpinner.getValue().doubleValue());
        stretchParameters = new MinMaxStretchParameters(minValues, maxValues);
        break;
      case "Percent Clip":
        stretchParameters = new PercentClipStretchParameters(minPercentSpinner.getValue(), maxPercentSpinner.getValue());
        break;
      default:
        stretchParameters = new StandardDeviationStretchParameters(factorSpinner.getValue());
    }

    // create rgb renderer
    RGBRenderer rgbRenderer = new RGBRenderer(stretchParameters, Arrays.asList(0, 1, 2), null, true);

    rasterLayer.setRasterRenderer(rgbRenderer);
  }

  /**
   * Stops and releases all resources used in application.
   */
  void terminate() {

    if (mapView != null) {
      mapView.dispose();
    }
  }

}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.