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