PS: This appears to be FS SDK
ImageTool "more detailed" Help output, showing otherwise undocumented ImageTool functions !
[
EDITED]
(
Click on the colored quote area below to see entire excerpt of my original post at AVSIM -re-formatted here for legibility)
NOTE: I've decided that it might be better to re-post this info in a standard forum text format which will be less likely to be overlooked or missed when folks scan this thread and may not "go the full distance" of clicking on the compressed "quote" roll-out message box; so here's the
full content:
Originally Posted by: GaryGB at AVSIM MSFS Forums - Scenery Design Sub-Forum
Posted On: 21 October 2008 - 11:06 AM <- Note: Original post has been 'mutilated' by AVSIM forum archiving ->
Original Post URL:
http://forum.avsim.net/topic/82158-image-tool-guide/#entry560541
I have thus far been unsuccessful getting FSX-SP2 SDK ImageTool.exe to respond to the normal CMD Mode methods to display help info.
So I opened it in
"Quick View" (remember that file viewer program from the install options in Windows 95 & 98 ?) ...in '
Hexadecimal' Viewer Mode.
Here's what I saw when "viewing" (read-only!) the
FSX-SP2 SDK ImageTool.exe in my legally purchased copy of FSX Acceleration).
------------------------------------------------------------------------------------------------
-batch ...Force batch processing.
Batch processing is activated when any legal batch option is supplied on then command line; however, if the conversion is to be done purely using the defaults this option must be used.
-o [string] ...Specifies output file path and name
-verbose ...Turns on verbose output during the batch process.
-brief ...Turns off verbose output during the batch process.
-nogui ...Turns off output during the batch process.
-tga ...The output is in the targa format (.tga).
Note: Not all formats can be expressed as a targa file. Notably, the DXT1 and DXT3 compressed image formats are not supported; furthermore, a lot of programs can not read all targa formats.
Mipmap information is not saved with this format (use the bmp format instead)
-bmp ...The output is in the bitmap format (bmp).
Note: A lot of programs can not read all bmp formats. The most widely supported formats are 8-bit and 24-bit.
Mipmap information is saved with this format; however, this is specific to the files generated with this program. That means that if the file is opened with another program (paint, Photoshop) and saved again the mipmap information is lost.
-dds ...The output is in the DirectX format (dds).
Mipmap information is saved with this format.
-auto ...The output format is automatically picked.
The image format used is picked depending on whether the image contains any alpha information, or not.
The formats chosen are as follows:
16-bit (565) - No alpha information present in source image.
16-bit (1555) - Single bit alpha information (chromakey) present in source image.
16-bit (4444) - Arbitrary alpha information present in source image.
-DXT ...The output format used is DXT1.
This is one of the compressed texture formats supported by DirectX. It supports 1-bit alpha (i.e.
colorkey) information. The resulting image uses only 4-bits per pixel; however, this comes at the cost of potential banding in the resulting picture.
Note: This image format can only be written out in the bmp file format; furthermore, most programs can not read the bitmap files generated with this image format.
-DXT3 ...The output format used is DXT3.
This is one of the compressed texture formats supported by DirectX. It supports 4-bit alpha information. The resulting image uses only 8-bits per pixel; however, this comes at the cost of potential banding in the resulting picture.
Note: This image format can only be written out in the bmp file format; furthermore, most programs can not read the bitmap files generated with this image format.
-DXT5 ...The output format used is DXT5.
This is one of the compressed texture formats supported by DirectX. It supports interpolated alpha information. The resulting image uses only 8-bits per pixel; however, this comes at the cost of potential banding in the resulting picture.
Note: This image format can only be written out in the bmp file format; furthermore, most programs can not read the bitmap files generated with this image format.
-PTC [quality,[alpha quality]] ...The output format used is PTC.
PTC is a Microsoft proprietary lossy compression format. Very high compression ratios are possible at the expense of some loss of image quality. The desired image quality can be specified by the optional quality parameter, where
%g is the best quality and
%g is the lowest quality. The quality of any alpha channel can be specified separately. The default quality is %g and the default alpha channel quality is %g.
-32 ...The output format used is 32-bit (8-bits for the red, green, blue, and alpha channels).
Note: Most programs can not read the files generated with this image format.
-24 ...The output format used is 24-bit (8-bits for the red, green, and blue channels).
Note: This format does not contain an alpha channel; however, it is highly compatible with many other programs (paint, photoshop).
-4444 ...The output format used is 16-bit (4-bits for the red, green, blue, and alpha channels).
Note: Most programs can not read the files generated with this image format.
-444 ...The output format used is 16-bit (4-bits for the red, green, blue, and alpha channels).
Note: Most programs can not read the files generated with this image format.
-565 ...The output format used is 16-bit (5-bits for the red, 6-bits for the green, and 5-bits for the blue channel).
Note: Most programs can not read the files generated with this image format.
-1555 ...The output format used is 16-bit (5-bits for the red, green, and blue channels, and 1-bit for the alpha channel).
Note: Most programs will ignore the alpha channel in this format; furthermore, they have the potential of corrupting the alpha channel when the image is opened and saved.
-555 ...The output format used is 16-bit (5-bits for the red, green, and blue channels, and 1-bit for the alpha channel).
Note: Most programs will ignore the alpha channel in this format; furthermore, they have the potential of corrupting the alpha channel when the image is opened and saved.
-1 ...The output format used is 1-bit monochrome.
-8 ...The output format used is 8-bit
This format uses a 256 entry color table. Each entry in the color table is 32-bits (8-bitsfor the red, green, and blue channels).
Note: Most programs will ignore the alpha channel in the color table; furthermore, they have the potential of corrupting the alpha channel when the image is opened and saved.
-invert ...The alpha channel is inverted
If the image format contains alpha information the inverse of the original alpha channel is written out.
-createalpha ...The alpha channel is created using the RGB value of the upper left pixel of the image
Only available with the -32 option.
-mip ...Generates mipmaps.
The resulting image will contain mipmap information (pre-filtered smaller versions of the source image).
Note: Mipmaps can only be written out in the bitmap (
bmp) format; furthermore, the resulting files are non-standard. That means when the file is opened in another program the mipmap information will not show up.
If the image format is one of the compressed texture formats (DXT1, DXT3) a shorter mip chain will be generated, since these formats have a minimum size of 4x4 pixels.
-addmip ...Load mips from the specified file.
Note: The file name can be a wildcard to allow the addition of several mips at once.
-vflip ...Vertical Flip.
Flips the input image vertically
-nomip ...Removes any mipmap information.
The resulting image will be stripped of any mipmap information that may be present in the image.
border ...Create a 1 pixel border around the image
-hasborder ...
Need Description.
-lm ...
Need Description.
-tile ...
Need Description.
-fold ...Fold the Edge colors for clamped textures
-nofold ...
Need Description.
-warning ...Enables warnings.
Generates warnings when a format that is incompatible with Flight Simulator (tm) is encountered during the batch process.
-nowarning ...Suppresses warnings.
No warning messages are generated during the batch process. Only use this if the resulting images are not to be used with Flight Simulator (tm) directly.
alpha ...Allow images with alpha information
This option only has meaning in conjunction with the -verify option. It means that no warnings or errors will be generated when images with alpha information are encountered during the verification process.
-noalpha ...Disallows images with alpha information
This option only has meaning in conjunction with the -verify option. It means that an error will be generated when 8-bit images with alpha information are encountered during the verification process.
-stop ...Show a warning dialog
This option only has meaning in conjunction with the -verify option. It means that an error dialog will be displayed when a warning or error is encountered during processing. Further processing is paused until the error dialog is dismissed.
-nostop ...Suppress the warning dialog
This option only has meaning in conjunction with the -verify option. It means that no error dialog will be displayed when a warning or error is encountered during processing. The error will still be noted in the status window.
-verify ...Verifies the images for compatibility with Flight Simulator (tm)
Instead of performing conversion the images are checked for validity. That means that each image is checked for valid dimensions (width and height must be a power of two, 2, 4, 8, 16, 32 ... ), for valid image format (8-bit, 16-bit, DXT1, DXT3, or PTC), for existence of mipmap information (suppress with -nomip), and for existence of alpha information in 8-bit images (suppress with -alpha).
-r ...Recursively traverse sub directories
This option allows the processing of entire directory trees. All directories in the tree are traversed. If no directory is specified as part of the input path the recursion starts at the current directory.
-e [string] ...Specify the file extension
This option allows the user to override the file extension to use with the output file. If this option is omitted a default file extension is used.
The defaults used are:
.tga is used with the
-tga option.
.bmp is used with the
-bmp option if no mipmaps are present.
.mip is used with the
-bmp option if mipmaps are present.
-? [string] ...Brings up the help topics.
-? by itself ...Brings up the index of help options.
-? followed by the option (
i.e. -? tga) ...Brings up specific information about that topic.
-gauge ...Output a bitmap to be used as a bitmap in a flight sim gauge (.gau) file.
This option does special processing to preserve the (0,0,0) and (1,1,1) values.
-terrain ...Output a bitmap to be used as a terrain texture file.
This is the same as using the following switches:
-border ...to create a 1 pixel border around the image
-tile ...to indicate this image self tiles
-mip ...to create mip maps
-DXT1 ...to change the format to DXT1
-terrainphoto ...Output a bitmap to be used as a terrain photo texture file.
This is the same as using the following switches:
-hasborder ...the image already has a 1 pixel border
-mip ...to create mip maps
-DXT1 ...to change the format to DXT1
-imgui ...The output format is a bitmap to be used by IMGUI
-redCorrection ...The red component of each pixel in each mip is modified by this value.
-greenCorrection ...The green component of each pixel in each mip is modified by this value.
-blueCorrection ...The blue component of each pixel in each mip is modified by this value.
-RedInAlpha ...Put the red component in the alpha channel and zero out the red component.
Used in conjunction with DXT5 to give good compressed normal maps.
------------------------------------------------------------------------------------------------
ImageTool Usage:
------------------------------------------------------------------------------------------------
imagetool [flags] ...Where flags are:
-o [string] ...Specify output file name
-batch ...Force batch processing
-verbose ...Verbose output [DEFAULT]
-brief ...Brief output
-nogui ...No GUI
-nobeep ...Turns off batch file beeping
-tga ...Output files are in targa (tga) format
-dds ...Output files are in DirectX (dds) format
-bmp ...Output files are in bitmap (bmp) format [DEFAULT]
-imgui ...Output format is to be used by IMGUI
-auto ...Output format is picked automatically
-DXT1 ...Output format is compressed DXT1
-DXT3 ...Output format is compressed DXT3
-DXT5 ...Output format is compressed DXT5
-PTC [Q,[Qa]] ...Output format is compressed PTC
-32 ...Output format is 32-bit
-24 ...Output format is 24-bit
-4444 ...Output format is 16-bit (4444)
-1555 ...Output format is 16-bit (1555)
-565 ...Output format is 16-bit (565)
-8 ...Output format is 8-bit palletized [DEFAULT]
-1 ...Output format is 1-bit monochrome
-detail ...Output format is to be used as a detail texture
-gauge ...Output format is to be used in a flight sim gauge
-terrain ...Output format is to be used as a generic terrain tile
-terrainphoto ...Output format is to be used as terrain photo scenery
-border ...Create a 1 pixel border around the image
-hasborder ...The image already contains a 1 pixel border
-lm ...The image is a light map
-tile ...The image self tiles
-fold ...Fold the Edge colors for clamped textures
-vflip ...Vertical flip
-mip ...Generate mip maps [DEFAULT]
-addmip [file] ...Add custom mip maps
-nomip ...Do not generate mip maps
-dither ...Use Floyd-Steinberg dithering when reducing color depth
-nodither ...Do not use any dithering when reducing color depth
-invert ...Invert the alpha channel
-createalpha ...Create the alpha channel using the RGB value of the (0,0) pixel
-warning ...Enable warnings (FS specific) [DEFAULT]
-nowarning ...Disable warnings
-verify ...Verify that the image matches the given settings
-stop ...Show a warning dialog (only used with -verify) [DEFAULT]
-nostop ...Do not show a warning dialog (only used with -verify) [DEFAULT]
-alpha ...Allow alpha in the bitmap (only used with -verify)
-noalpha ...Do not allow alpha in the bitmap (only used with -verify)
-e [string] ...File extension to use given by [string]
-r ...Recursively traverse the sub directories
-? [string] ...Help on the topic given by [string]
-fallback ...Builds a fallback texture that can be loaded much faster than the base image.
-redCorrection ...Modifies the red component of colors in the mip chain
-blueCorrection ...Modifies the blue component of colors in the mip chain
-greenCorrection ...Modifies the green component of colors in the mip chain
-RedInAlpha ...Put the red channel in the alpha channel and zero out
-redBatch ...Processing only occurs if one of the command line options is supplied; otherwise,the images are opened in imagetool for manual processing.
------------------------------------------------------------------------------------------------
ASCII text from the bottom of the ImageTool file (possibly used to display
a ImageTool 'graphical' help image, help on specific Flags given the appropriate CMD mode switch, error and status messages, etc. ? )

"
Code:
Imagetoold:bt1202privatecoretoolsimagetoolbatch.cpp
-batch-verbose-brief-nogui-nobeep-tga-bmp-dds-auto-DXT1-DXT3-DXT5-RedInAlpha-PTC-32-24-4444-444-565-1555-555-8-1-detail-gauge-gaugealpha-imgui-dither-nodither-invert-createalpha-mip-addmip-vflip-nomip-terrain-terrainphoto-border-hasborder-lm-tile-fold-nofold-warning-nowarning-alpha-noalpha-stop-nostop-verify-r-o-e-?-fallback-redCorrection-blueCorrection-greenCorrection
Image: %s
Format: %s
(ILLEGAL FORMAT)
Width: %d (NOT POWER OF TWO)
Height: %d
Warning (MISMATCH) (NOT A POWER OF TWO)
Yes
No
Mip: %s
None
Colorkey Alpha
Alpha: %s, colorkey, alpha, mip "%s" %dx %d, %s %s %s %s
---> FAILED Processing File: "%s"*.*_def.%s.%s.mip.bmp.tga_def.dds.dds
d:bt1202privatecoretoolsimagetoolbitmap.cpprb
Corrupted image dimensions.
Could not read bitmap image data.wb
Could not write bitmap file header.
Could not write bitmap info header.
Could not write FS info header.
Could not write bitmap image data.d:bt1202privatecoretoolsimagetoolbuildborder.cpp
Adding Border
Copying Image
Dithering Image
Quantizing Image
Inverting Alpha Channel
Creating Alpha Channel
Calculating Alpha Mode
destination source Copy function not supported for %s
image format.Dither function not supported for %s image format.
Quantize function not supported for this image format.
Invert function not supported for this image format.
Alpha mode function not supported for %s images.
Filtering image from %dx%d to %dx%d.p?
FSX.BGL.STN.MOD.R8.R81.R82.0.1.PAL.HAZ.PCX.BMP.PIX.VIS.AIR.GAU.ICN.BIN.WAV.MDL.DLL
.FS6.BND.NDL.PNL.ADV.SIM.LOG.VID.TMP.TXR.LES.CHL.DRV.SC1.CFG.MIS.QCB.FLT.CMG.TXT.PLN.
DP.CDP.DYN.WX.FX.GSL.ABL.FSR.XML.CAB.ZIP.DAT.MIP.PDF.BRF.HTM.WT.WTB.CLD.ANIM.XMLX.RWD.DDS.
FSSAVE.SPB.JPG.PNG
FyFS?Zy;b?:Eo@O@@`?`@H @mRSDS&hHU"
PS: Extra info that 'may' assist in deciphering use of "
%g " in ImageTool help "
-PTC " command switches:
http://www.gnu.org/software/libc/manual/html_node/Floating_002dPoint-Conversions.html
http://www.fsdeveloper.com/forum/threads/cvxextractor-exporting-vector-data.432918/page-3
[
END_EDIT]
GaryGB