DK for Delphi | GisTypesUI.TGIS_GradientMap.RealizeColorMap | Constructors | Methods | Properties
Prepares a colormap as requested.
// Delphi public function RealizeColorMap( const _mode : TGIS_ColorMapMode = TGIS_ColorMapMode.Continuous; const _subClass : Integer = 0; const _reverse : Boolean = False ) : TGIS_ColorMapArray;
// C++ Builder public: TGIS_ColorMapArray* RealizeColorMap( TGIS_ColorMapMode* const _mode, const int _subClass, const bool _reverse );
Name | Type | Description |
---|---|---|
_mode | TGIS_ColorMapMode | colormap mode (continuous by default or discrete) |
_subClass | Integer | if available, gets subclass of a ramp with specified, or the possible nearest to specified, number of colors; if 0, gets default colormap (this is the default parameter); |
_reverse | Boolean | if True, reverses colors from colormap (False is the default parameter); |
Type | Description |
---|---|
TGIS_ColorMapArray | Array of a colormap. |
Color ramps can be prepared in continuous or discrete mode by setting desired TGIS_ColorMapMode to the _mode parameter.
![]() | ![]() |
![]() | ![]() |
Continuous mode (default) | Discrete mode |
Some ramps, besides the default definition, have versions prepared with a specific number of colors. Using _subclass parameter, you can request a colormap with a defined number of colors, if suchcolormap representation exist.
Three different representations of YellowGreenBlue color ramp. | ||
![]() | ![]() | ![]() |
![]() | ![]() | ![]() |
Color ramp with 3 colors (subclass=3) | Default color ramp definition (subclass=0) | Color ramp with 9 colors (subclass=9) |
Colors in a ramps can be reversed by setting the _reverse parameter to True.
![]() | ![]() |
![]() | ![]() |
Default color ramp definition (reverse=False) | Reversed color ramp (reverse=True) |
Below are a few examples of how to apply a specified color ramp to a grid layer.
// pseudocode min_value = grid_layer.MinHeight max_value = grid_layer.MaxHeight // default representation of 'ElevationDark' color ramp color_ramp = TGIS_Utils.GisColorRampList.ByName(TGIS_ColorRampNames.ElevationDark) color_map = color_ramp.RealizeColorMap(TGIS_ColorMapMode.Continuous, 0, false) grid_layer.GenerateRampEx(min_value, max_value, color_map, None) // discrete representation of 'Accent' color ramp with maximum number of colors color_ramp = TGIS_Utils.GisColorRampList.ByName(TGIS_ColorRampNames.Accent) color_map = color_ramp.RealizeColorMap(TGIS_ColorMapMode.Discrete, -1, false) grid_layer.GenerateRampEx(min_value, max_value, color_map, None) // inverted continuous representation of 'Spectral' color ramp, get subclass with 3 colors color_ramp = TGIS_Utils.GisColorRampList.ByName(TGIS_ColorRampNames.Spectral) color_map = color_ramp.RealizeColorMap(TGIS_ColorMapMode.Continuous, 3, true) grid_layer.GenerateRampEx(min_value, max_value, color_map, None)