/// Compressed textures are now a standard part of many real-time 3D applications.
/// The improvements in performance obtained by reducing the memory size and bandwidth requirements of texture maps,
/// and the wide availability of hardware support have resulted in extensive adoption of the industry-standard BCn (DXTn) compression formats.
/// This document describes AMD's comprehensively-featured tool for generating these compressed texture maps and also gives information on how to use it
/// to get the best possible quality results when using texture compression in your application.
///
/// \page Info Info
///
/// AMDCompressCLI.exe is a command line tool that uses AMD Compress library and image IO\n
/// plug-ins for compressing textures and creating mip-map levels.
/// For support or more infomation you can send a request using the \subpage Contact page
/// Commadline options are set using the following syntax: <b>codec_options [value]</b>
///
/// For example to run BC7 compression on a bit mapped image file called input.bmp and save the result to a DirectDraw Surface file called Result.dds type at the command prompt
/// In the example the first codec_option instructs the application to set the destination format -fd to that of BC7\n
///
/// Next codec_option -NumThreads instructs the application to use 16 threads during compression, each of which will continually compress asynchronously 4x4 pixel image blocks at any given time until the entire image is compressed.\n
///
/// Finally the application is given the location of the source image to use and the destination file used to save the resulting compression.\n
///
///
/// All codec_options starts with a hyphen sign character followed by an option key word that is case sensative, most key words are followed by a value that specifies a setting for the codec to use.\n
/// For additional details on selecting the compression formats see the help section on \ref compression_formats\n
/// Make sure you have first read \ref CLIOptions "Using Command Line Options".
///
///
/// The following codec options are defined and are all case sensitive:
///
/// \section codec1 -UseChannelWeighting [value]
///
/// Use channel weightings. With swizzled formats the weighting applies to the data within the specified channel not the channel itself; Value of 1 turns the option 0n, 0 turns the option off
///
/// <b>Colour Weighting</b>\n
/// These Weight controls allow the user to specify what weighting the compressor will give to the various colour components when it is considering how to compress a block. The default weightings that are supplied are set up to match the relative importance of the colour channels with respect to their contribution to the output colour's luminance, so green has the highest weighting followed by red and blue. Although this generally gives the highest quality of output overall there may be cases where you will want he encoder to have different priorities - for example, if the image you are trying to compress does not contain colour data, and therefore the weightings should not be luminance-biased.
///
/// \section codecWeightR -WeightR [value]
///
/// The weighting of the Red or X Channel; value can be in the range of 0.1 to 1.0
///
/// \section codecWeightG -WeightG [value]
///
/// The weighting of the Green or Y Channel; value can be in the range of 0.1 to 1.0
///
/// \section codecWeightB -WeightB [value]
///
/// The weighting of the Blue or Z Channel; value can be in the range of 0.1 to 1.0
/// Adapt weighting on a per-block basis, Value sets the alpha threshold to use when compressing to BC1 with DXT1UseAlpha. Texels with an alpha value less than the threshold are treated as transparent.
/// Value can be from 0.0 to 1.0
///
/// \section codecBlockRate -BlockRate [value]
///
/// ASTC 2D only - sets block size or bit rate\n
/// value can be a bit per pixel rate from 0.0 to 9.9 or can be a combination of x and y axes with paired values of 4, 5, 6, 8, 10 or 12 from 4x4 to 12x12\n
/// The trade-off between compression speed & quality, default is set to fast; this value is ignored for BC6H and BC7 (for BC7 the compression speed depends on Quaility and Performance settings)
/// Value of 0 (default) sets Highest quality mode, value of 1 sets slightly lower quality but much faster compression mode, value of 2 sets slightly lower quality but much, much faster compression mode
///
/// \section codecNumThreads -NumThreads [value]
///
/// Number of threads to initialize for BC6H or BC7 encoding. Value can be from 1 to 128, default set to 8;
///
/// \section codecQuality -Quality [value]
///
/// Quality of encoding for BC7. This value ranges between 0.0 and 1.0
/// setting quality above 0.00 gives the fastest, lowest quality encoding, 1.0 is the slowest, highest quality encoding.\n
/// Performance of encoding for BC7. Setting performance at 1.0 gives the fastest encoding for a given quality level, lower values will improve quality but increase encoding time.\n
/// This setting is a quality tuning setting for BC7 which may be necessary for convenience in some applications; Value of 1 turns the option 0n, 0 turns the option off.\n
/// This setting is a quality tuning setting for BC7 which may be necessary for some textures;
/// if set and the block does not need alpha it instructs the code not to use modes that have combined colour + alpha - this
/// avoids the possibility that the encoder might choose an alpha other than 1.0 (due to parity) and cause something to
/// become accidentally slightly transparent (it's possible that when encoding 3-component texture applications will assume that
/// the 4th component can safely be assumed to be 1.0 all the time;
/// Value of 1 turns the option 0n, 0 turns the option off\n
/// default is set to 0
///
/// \section codecModeMask -ModeMask [value]
///
/// Mode to set BC7 to encode blocks using any of 8 different block modes in order to obtain the highest quality. Default set to 0xCF,
/// You can combine the bits to test for which modes produce the best image quality.\n
///
/// \section codecSigned -Signed [value]
///
/// Used for BC6H only, Default BC6H format disables use of a sign bit in the 16-bit floating point channels, with a value set to 1 BC6H format will use a sign bit; Value of 1 turns the option 0n, 0 turns the option off
///
/// \section codecnomipmap -nomipmap
///
/// Disables use of mip map generation, if input image is mip mapped it will read the file as normal.
///
/// \section codecmiplevels -miplevels [value]
///
/// Sets the minimum mip levels to generate on the output file, default is 1. if the level is set greater than 1 and lower than an input files mip levels, the
/// output images will be converted to a mipmap set by miplevels. (mipsize overides this option)
///
/// \section codecmipsize -mipsize [value]
/// The size in pixels used to determine how many mip levels to generate on the output file
///
/// \section codecsilent -silent
///
/// Disables the printing of command line messages
///
/// \section codecperformance -performance
/// Shows various performance statistics
///
/// \section codecnoprogress -noprogress
///
/// Disables the printing of command line progress information during compression and decompression
/// (Most formats are supported directly by AMD Compress CLI application, additional support is provided by DLL plugins)
///
/// \section plugins1 BMP
///
/// Bitmap Image File formats of arbitrary width, height, and resolution. Input images can be formatted as ARGB (8:8:8:8 bits per channel), RGB (8:8:8 bits per channel), 4 bit per single channel or 1 bit per channel.
/// The output file is always saved as ARGB (8:8:8:8 bits per channel), format.
///
/// \section plugins2 DDS
///
/// Direct Draw Surface files
///
/// \section plugins3 EXR
/// High Dynamic Range Imaging format
/// Supports only RGBA scan line based input files, output files can be RGBA or 16 bit tiled RGB
///
/// \section plugins4 KTX
///
/// Khronos Texture formats for OpenGL ES 2 and up
///
/// \section plugins5 PNG
///
/// Portable Network Graphics files.
///
/// \section plugins6 TGA
///
/// Plugin (QTGA.DLL) for TrueVision (TARGA) graphics file format (located in folder plugins - imageformats)
///
/// \section plugins7 TIFF
///
/// Plugin (QTIFF.DLL) for Tagged Image File Format(located in folder plugins - imageformats)
///
/// \section plugins8 UserDefined
///
/// Users can now add new image format DLL to the folder: plugins - imageformats
/// for use with AMD Compress CLI. These DLL's can be obtained from Qt web site by searching for "Qt image plugins"
/// Stores three-component colour data using a 5:6:5 colour (5 bits red, 6 bits green, 5 bits blue).
/// Used for compressing opaque RGB and ARGB textures with 1-bit alpha. As it's alpha support is 1-bit (i.e. fully opaque or fully translucent) it is not suitable for compressing textures with more complex alpha channels. It is the must suitable DXTC format for compressing textures without an alpha channel.
///
/// \section format7 BC2
/// Stores RGB data as a 5:6:5 colour and alpha as a separate 4-bit value.
/// Used for compressing ARGB textures with 4 bits per pixel for colour data & 4 bits per pixel explicit alpha data. It's use of explicit alpha makes it particularly suitable for textures where the alpha values within a block vary greatly. BC2 is identical to BC3 except for it's use of pre-multiplied alpha and can be ignored.
///
/// \section format8 BC3
/// Stores colour data using 5:6:5 colour and alpha data using one byte.
/// Uses of interpolated alpha makes it most suitable for use with majority of textures with an alpha channel.
///
/// \section format9 BC4
/// Stores one-component colour data using 8 bits for each colour.
/// It is suitable for compressing most single channel textures.
///
/// \section format10 BC5
/// A eight bit per pixel DXTC format compressing two channels of data in an identical form to the alpha channel of BC4 texture. It is suitable for compressing most two channel textures and particularly suited for compressing object space normal maps as the third channel of object space normals can be derived from the first two.
///
/// \section format11 BC6H
/// Stores three component data using 16 bits for each colour.
/// It is a high-dynamic range compression format but has no support for an alpha channel. AMDCompressCLI.exe support formats that uses a sign or unsigned bit in the 16-bit floating point colour channel values, which can be set with the command line codec_option Signed.
///
/// \section format12 BC7
/// Is a high-quality compression format of RGB and RGBA data
/// An opaque (or 1-bit alpha) DXTC compressed texture format. Four bits per pixel
///
/// \section format14 DXT3
/// A DXTC compressed texture format with explicit alpha. Eight bits per pixel
///
/// \section format15 DXT5
/// A DXTC compressed texture format with interpolated alpha. Eight bits per pixel
///
/// \section format16 DXT5_xGBR
/// A DXT5 with the red component swizzled into the alpha channel. Eight bits per pixel
///
/// \section format17 DXT5_RxBG
/// A swizzled DXT5 format with the green component swizzled into the alpha channel. Eight bits per pixel
///
/// \section format18 DXT5_RBxG
/// A swizzled DXT5 format with the green component swizzled into the alpha channel & the blue component swizzled into the green channel. Eight bits per pixel
///
/// \section format19 DXT5_xRBG
/// A swizzled DXT5 format with the green component swizzled into the alpha channel & the red component swizzled into the green channel. Eight bits per pixel
///
/// \section format20 DXT5_RGxB
/// A swizzled DXT5 format with the blue component swizzled into the alpha channel. Eight bits per pixel
///
/// \section format21 DXT5_xGxR
/// A two-component swizzled DXT5 format with the red component swizzled into the alpha channel & the green component in the green channel. Eight bits per pixel
