True Color Output

Instructions for Use

True color output refers to the process of using image stretching and image enhancement techniques to improve the display effects of imagery, making its colors closer to the actual colors of ground objects. At the same time, this process also converts the imagery into a three-band 8-bit unsigned pixel format for output, facilitating subsequent imagery and visualization display.

The result of true color output can display surface features in a way that closely resembles their real colors, thus playing an important role in fields such as urban planning, land use classification, agricultural monitoring, map production, and updating.

SuperMap iDesktopX11i(2023) version starts to support.

Parameter Description

Parameter Name Parameter Interpretation Parameter Type
Data Type

This parameter is available only when the function is started from the Imagery tab -> DOM Data Production group -> True Color Output.

Select the source of the input image data, providing two options: Image Files and Mosaic Dataset. The default selection is Image Files.

Image Files

This parameter is available only when the function is started from the Imagery tab -> DOM Data Production group -> True Color Output.

After selecting Image Files in Data Type, you can directly input the local path information, and all images under that path will be automatically retrieved.

File
Image Data Source

This parameter is available only when the function is started from the Imagery tab -> DOM Data Production group -> True Color Output.

After selecting Mosaic Dataset in Data Type, specify the data source where the image dataset is located.

Datasource
Image Data After selecting Mosaic Dataset in Data Type, specify the image dataset. If it is a workflow production, only the dataset is displayed and cannot be edited. DatasetMosaic
Red Band Index Set the red band, default is 2. Integer
Green Band Index Set the green band, default is 1. Integer
Blue Band Index Set the blue band, default is 0. Integer
Near-Infrared Spectroscopy (NIR) Index Set the near-infrared band, not set by default. This parameter is required when vegetation enhancement is needed. Integer
Automatically Calculate Truncation Percentage

Specify whether to use the Percent Clip method to perform image stretching, not checked by default.

  • Checked: Automatically calculate the truncation percentage based on the brightness in the image and perform percent clip according to the calculation result.
  • Unchecked: The image stretching result will be calculated based on the maximum/minimum truncation percentage.
Boolean
Minimum Truncation Percentage

Available after unchecking Automatically Calculate Truncation Percentage.

Set the minimum truncation percentage value used for image linear extrusion, range is [0,100], default value is 0.2.

Double
Maximum Truncation Percentage

Available after unchecking Automatically Calculate Truncation Percentage.

Set the maximum truncation percentage value used for image linear extrusion, range is [0,100], default value is 99.8.

Double
Highlighted White Spot Threshold

Available after checking Automatically Calculate Truncation Percentage.

When performing image stretching, if the area of the highlighted white spot region in the image is larger than the specified area threshold, the truncation percentage is considered too large. Otherwise, it is considered that the truncation percentage can be further increased.

The default value is 20000, unit is m\u00B2. If there are relatively few highlighted areas in the image, it is recommended to increase this parameter to obtain higher contrast.

Double
Use Gamma Correction

Use gamma correction to achieve non-linear brightness and contrast adjustment of the image, thereby enhancing image display details and improving the display quality of image data.

Not checked by default, meaning gamma correction is not used to improve the display quality of image data.

If this checkbox is checked, then the gamma correction method needs to be selected.

Boolean
Gamma Correction

Available after checking Use Gamma Correction. Provides two methods: Adaptive and Custom, default is Adaptive.

  • Adaptive: The system will automatically adjust the Gamma values of the red, green, and blue bands based on the image.
  • Custom: Need to set the Gamma values for the red, green, and blue bands separately. The default value for each is 1.5, range is (0-10].
    • When the Gamma value equals 1, the image has not undergone gamma correction.

    • When the Gamma value is greater than 1, the contrast of the dark areas of the image increases, details become more prominent, but the details in the bright areas may be lost, and the overall image becomes brighter.
    • When the Gamma value is less than 1, the contrast of the bright areas of the image increases, details become more prominent, but the details in the dark areas may be lost, and the overall image becomes darker.
GammaCorrectMethod
Vegetation Enhancement

Available after the red, green, blue, and near-infrared band indices are all not empty.

Used to enhance the display effects of vegetation areas, not checked by default, meaning vegetation enhancement is not used.

Boolean
NDVI Threshold

Available after checking Vegetation Enhancement.

Used to determine the vegetation range. When the NDVI threshold is greater than the NDVI value of the image, vegetation enhancement is activated. Default value is 0.0. NDVI = (Near-Infrared - Red) / (Near-Infrared + Red).

Double
Green Band Weight

Available after checking Vegetation Enhancement.

Set the weight of the green band during vegetation enhancement, range is [0,1], default value is 0.7. The sum of the green band weight and the near-infrared weight must be 1.

Double
Near-Infrared Weight

Available after checking Vegetation Enhancement.

Set the weight of the near-infrared band during vegetation enhancement, range is [0,1], default value is 0.3. The sum of the green band weight and the near-infrared weight must be 1.

Double
Contrast Enhancement When the image contrast is low or when using automatically calculated truncation percentage, it is recommended to use contrast enhancement to improve the display effects of the image. This checkbox is checked by default. Boolean
Contrast Limit

Available after checking Contrast Enhancement.

Represents the degree of contrast enhancement; the larger the value, the greater the enhancement. Default value is 1.5.

Double
Mask Data

Not checked by default. If checked and mask data is set, the system will exclude that area before outputting the true color image.

Boolean
Source of Data Available after checking Mask Data. Cloud amount data can be obtained through Existing data or Cloud detection methods, default is Existing data. CloudMaskDataSourceType
Data Source Available after selecting Existing data in Source of data. Specify the data source where the mask dataset is located. DataSource
Dataset Available after selecting Existing data in Source of data. Specify the mask dataset. DatasetVector
Mask Pixel Threshold

Available after selecting Cloud detection in Source of data.

The minimum number of pixels retained for masking; only areas larger than this threshold will be judged as cloud regions. If smaller than this threshold, they are judged as non-cloud regions and mask data is not retained. Default value is 4096.

Integer
Output Format

Set the storage type of the result image. Provides four options: Not Set, Tiff/GeoTIFF, Erdas Image, and PCIDSK. Default is Tiff/GeoTIFF, meaning the original storage type of the image is used for output.

If executing a production workflow, use the Output format parameter in Set Image Path or Add orthophoto, and this field is not editable.

FileType
Compression Method

Set the compression method of the output image, available only when the output format is Tiff/GeoTIFF, default is NONE.

If executing a production workflow, use the Compression method parameter in Set Image Path or Add orthophoto, and this field is not editable.

CompressMethod
Export Directory

Set the storage path of the result image.

If executing a production workflow, use the Processing path parameter in Set Image Path or Add orthophoto, and this field is not editable.

File
Add Results to Map Window

This parameter is available only when the function is started from the Imagery tab -> DOM Data Production group -> True Color Output.

Checked by default, meaning the result data will be added to the map window for display after the function is successfully executed.

Boolean
Create Image Pyramid Checked by default. Build pyramids for the image data according to the specified resampling method, thereby improving image zoom display rendering and performance. Boolean
Resampling Method Available after checking Create Image Pyramid. Default is Average. For more method introductions, please refer to Resampling Method. PyramidResampleType
Asynchronously Create Statistics During image browsing, the layer will be stretched based on statistics information. If the image does not have statistics information, it will be displayed according to the default stretch method, and 8-bit data will not be stretched for display. Checked by default, meaning statistics will be created for the image in the background without affecting the workflow execution. If unchecked, statistics will be created while executing this tool, which may consume time. Boolean

Output Result

  • Output the stretched and image-enhanced image data to the local folder.
  • Automatically create a true color image mosaic dataset in the OrthoData data source based on the output image data.

Related Topics

Image Fusion

Image Color Balancing

Image Mosaic