True Color Output

Feature Description

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

The results of true color output can display surface features in a way that closely resembles the true colors of objects. Therefore, it plays an important role in fields such as urban planning, land use classification, agricultural monitoring, map production, and updates.

SuperMap iDesktopX11i(2023) version begins to support this feature.

Function Entry

Satellite Image Processing tab->DOM Data Production group->True Color Output.

Parameter Description

Parameter Name Parameter Interpretation Parameter Type
Data Type

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

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

Image Files

This parameter is available only when the function is started from the Satellite Image Processing 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 Satellite Image Processing tab->DOM Data Production group->True Color Output.

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

Datasource
Image Data After selecting Mosaic Dataset in Data Type, specify the image dataset. If it is for 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 (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 calculates the truncation percentage based on the brightness in the image and performs percent clip according to the calculation result.
  • Not Checked: 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. The value range is [0,100], and the 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. The value range is [0,100], and the 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 highlighted white spots in the image is greater 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, and the 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 image data display quality.

If this checkbox is checked, a 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 for the red, green, and blue bands based on the image.
  • Custom: Requires setting the Gamma values for the red, green, and blue bands separately. The default value for each is 1.5, with a value range of (0,10].
    • When the Gamma value equals 1, no gamma correction is applied to the image.

    • When the Gamma value is greater than 1, the contrast in the dark areas of the image increases, details become more prominent, but details in bright areas may be somewhat lost, and the overall image becomes brighter.
    • When the Gamma value is less than 1, the contrast in the bright areas of the image increases, details become more prominent, but details in dark areas may be somewhat 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. Vegetation enhancement is triggered when the NDVI threshold is greater than the image's NDVI value. The default value is 0.0. NDVI = (NIR - Red) / (NIR + Red).

Double
Green Band Weight

Available after checking Vegetation Enhancement.

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

Double
Contrast Enhancement It is recommended to use contrast enhancement when the image contrast is low or when automatically calculating the truncation percentage to improve the image's display effects. This checkbox is checked by default. Boolean
Contrast Limit

Available after checking Contrast Enhancement.

Indicates the degree of contrast enhancement; a larger value means greater enhancement. The 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 mask data can be obtained via Existing data or Cloud detection methods. Default is Existing data. CloudMaskDataSourceType
Data Source Available after selecting Existing data in Source of Data. Specify the datasource where the mask dataset is located. DataSource
Dataset Available after selecting Existing data in Source of Data. Specify the mask dataset. The dataset must contain an ImageName field, and the name must correspond to the image currently to be processed. DatasetVector
Mask Pixel Threshold

Available after selecting Cloud detection in Source of Data.

The minimum number of pixels to be retained for masking; areas with more pixels than this threshold are judged as cloud regions; if less, they are judged as non-cloud regions and mask data is not retained. The 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 image is output using its original storage type.

If executing a production workflow, the Output format parameter from Set the Image Pathor Add Orthophotois used, and this field is not editable.

FileType
Compression Method

Set the compression method for the output image. Available only when the output format is Tiff/GeoTIFF. Default is NONE.

If executing a production workflow, the Compression method parameter from Set the Image Path or Add Orthophotois used, and this field is not editable.

CompressMethod
Export Directory

Set the storage path for the result image.

If executing a production workflow, the Processing path parameter from Set the Image Pathor Add Orthophotois used, and this field is not editable.

File
Add Results to Map Window

This parameter is available only when the function is started from the Satellite Image Processing 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 successful execution.

Boolean
Create an 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.

If executing a production workflow, the Create an Image Pyramid parameter from Set the Image Pathor Add Orthophotois used, and this parameter is not displayed.

Boolean
Resampling Method

Available after checking Create an Image Pyramid. Default is Average. For more method introductions, please refer to Resampling Method.

If executing a production workflow, the Resampling Method parameter from Set the Image Pathor Add Orthophotois used, and this parameter is not displayed.

PyramidResampleType
Asynchronously Create Statistics

When browsing the image, the layer will be stretched based on the 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.

If executing a production workflow, the Asynchronously create statistics parameter from Set the Image Pathor Add Orthophotois used, and this parameter is not displayed.

Boolean

Output Result

  • Outputs the stretched and image-enhanced image data to the local folder.
  • Automatically creates a true color image mosaic dataset in the OrthoData datasource based on the output image data.

Related Topics

Image Fusion

Image Uniform Color

Image Mosaic