Multiple Images Converter
Use the Multiple Images converter to convert multiple images, with or without terrain data, into a format that can be displayed in a 3D Graphics window. The images are converted to .pdttx, .jp2, .bmp, or .ppm files (image inlays) and the terrain data is converted to pdtt files (terrain inlays).
The Multiple Images converter is available from the Utilities menu-->Imagery and Terrain Converter.
To display an image inlay or terrain inlay on the central body, use the Globe Manager.
Caution: The image converter creates temporary files during the image conversion process and puts them in the output directory or a directory specified by an environment variable. If the drive that holds the temporary files becomes full, the image conversion process fails and returns an error message indicating that STK was unable to create the output file at the desired location. If the image converter fails you can:
- Check the temporary directory drive for sufficient disk space.
- Update your TMP or TEMP environment variable to point to a location with more disk space. STK checks the TMP environment variable first to determine the location to use. If the variable does not exist or is not set, then STK checks the TEMP variable. If that does not exist or is not set, then STK uses the C:\ directory.
Valid Image File Formats
See Valid Imagery Formats for image files that can be converted using the Multiple Images converter.
Image Source
Directory. Select the directory in which the images of interest reside. All images in that directory display in the Images table, along with any position information that may be available.
The results in the Images table are sorted alphabetically by image name. To sort the results by a different column, double-click the column heading.
If you select a directory with CADRG or CIB header files (A.TOC) images, all of the image files contained in the A.TOC directory display in the Image table.
Image. Select one or more images to be converted. Use the blue right arrow button to copy selections to the Images to Convert list.
To select multiple images, click one file, and then hold down the Ctrl key and click each additional file. To select a list of files, click the first file, and then hold down the Shift key and click the last file. To enable Terrain for all the selected files, hold down the Shift key, select all the files, and enable Terrain for one of the selected files.
Terrain. If checked, creates corresponding terrain data (.pdtt). The specified terrain source is used for all images with Terrain enabled.
South Lat/West Lon/North Lat/East Lon. To convert an image, you must enter the valid position unless the image has a position file (*.pos) or is a georeferenced image (such as GeoTIFF) that displays its position.
For *.ntf files, the data in the position fields provides an approximate geographic location and is not intended for analytical purposes (for example, targeting or distance calculation).
Terrain Source. Specifies the source file used to create a corresponding terrain file (.pdtt) for all images that have Terrain enabled. A Terrain sources can be:
Raw terrain. Any terrain data set specified at the scenario level can be used.
The terrain source used must overlap some region of the image to be converted. Altitudes of zero are inserted wherever the terrain region does not overlap the image.
Processed Intermediate Terrain Files (.datt). The intermediate processed terrain file (.datt) is created whenever a raw terrain source is converted to a terrain file (.pdtt). This intermediate file is deleted in the conversion process unless the Delete Intermediate Terrain File button is disabled. The image converted must fall completely within the selected .datt file.
Use one of the following to select the terrain source:
Automatic Selection. Selects an appropriate terrain source based on the position of the image and available terrain sources. The raw terrain sources are searched first, then any available .datt or .pdtt files.
Use to add a new terrain source file (.datt). For convenience, all available .datt files in the directory with the selected terrain source files are also added as available sources. Raw terrain sources may be added via the scenario's Terrain properties page.
Remove All button. Remove all selected images from the list of images to be converted.
RGB Transparent Color
Use. Uses the selected RGB color as the transparent color for the image file. All pixels in the image of that color are not displayed.
Output Format
Select either a JPEG 2000 image (jp2) or an AGI image (pdttx).
JPEG 2000 Compression
Profile. Select a compression profile and whether the profile will use Lossless or Compression Ratio x.
Central Body
Associates the images with the central body specified here.
Central body applies only to .pdttx files.
Output
Directory. Use the button to choose the directory in which converted images should be stored. Once you choose the directory, all images created during the conversion will be placed in that directory.
2D Map Options
When you select an image from the 2D Graphics window, the image is outlined on the globe in the 3D Graphics window.
Show Extents. Displays image outlines in the 2D Graphics window so that you can more easily select images using the mouse and the Map. Enable if you are using the 2D Map to select image files.
Show Names. Displays image names in the 2D Graphics window for easy identification. Enable if you are using the 2D Map to select image files.
Select on Map. If checked, you can select image files using your mouse in the 2D Graphics window, even when a number of images are overlaid in one area of the 2D Graphics window. This option is especially useful when converting CADRG and CIB files.
To select an image or images:
- Use the left mouse button to select an extent. When you click once an extent in the Map, the image file is highlighted in the Images table in the Image Converter window. To select multiple images at once, you can click the map and drag a bounding rectangle around the group of images you wish to select.
- Click the right mouse button once on the same extent to copy the image or images to the Images to Convert list or use the right arrow in the Image Converter window to copy it to the Images to Convert list.
Any other interaction with the 2D Graphics window, such as zooming, will disable mouse interaction with the images. To re-enable selecting images on the 2D map, disable and then enable the Select on Map button.
When converting a file and using the Select on Map option, it is best to complete the task without interruption. It is best to zoom in or out to the view you want to use in the Map before turning on Select on Map. If you zoom in after you've turned on this option, you must reset the Select on Map option.
Clicking a selected image on the 2D Graphics window clears it. Clicking the same image again selects any image behind that image. This way, you can select overlapping images on the 2D Graphics window by cycling through selected images in the same location.
If not checked, use the selections in the Images Table to choose images to be converted.
Convert button. When you click Convert, STK creates an image file named <OriginalFileName>_<Size>.<Extension>
To add the converted files to the 3D Graphics window, use the Globe Manager or drag and drop the file from the file browser to the 3D Graphics window.
To add the converted files (to the 2D Graphics window, use the Images properties page or drag and drop the file from the file browser to the 2D Graphics window.