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.
|
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.
|
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