Merge pull request #79 from kdl222/m01667

<application name="isis2std" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://isis.astrogeology.usgs.gov/Schemas/Application/application.xsd">

  <brief>

    Exports a cube to a PNG, BMP, GIF, TIFF, JPEG, or JPEG 2000

    Exports a cube to PNG, BMP, TIFF, JPEG, or JPEG 2000

  </brief>

  <description>

    <p>

      This program exports an ISIS cube to one of several popular standard image

      formats.  The current supported formats are BMP,  GIF, JPEG, JP2, PNG, and TIFF.  

      formats.  The current supported formats are BMP, JPEG, JP2, PNG, and TIFF.

    </p>

    <p>

      This program uses TrollTech's version of the Qt Library to export BMP, 

      GIF and JPEG formatted output images. For these format types, due to limitations of Qt, the

      input file size must not exceed 2 gigabytes and the only valid output bit type is 8BIT. 

      This program uses TrollTech's version of the Qt Library to export BMP

      and JPEG formatted output images. For these format types, due to limitations of Qt, the

      input file size must not exceed 2 gigabytes and the only valid output bit type is 8-bit.

    </p>

    <p>

      The JPEG2000 (JP2) and TIFF formats do not depend on the Qt library.  These formats do not

      have the 2 GB limitation for input files and the output bit type may be 8BIT, U16BIT or S16BIT.

      have the 2 GB limitation for input files and the output bit type may be 8-bit, U16-bit or S16-bit.

      For these formats, the writing routines output are streamed lines from the cube, and little

      of the image is held in memory at any one time, therefore increasing the processing speed to

      convert the file.  It is recommended that large images are exported to JP2  or TIFF format.

    <p>

      In addition, if the cube has Mapping labels, the program will produce a world file for use

      in Arc and/or other GIS packages.  The file will have an extension that uses the first and

      last letters for the image extention and a "w". For example, .tif produces a world file 

      last letters for the image extension and a "w". For example, .tif produces a world file

      extension of .tfw.

    </p>

    <p>

    <change name="Jeffrey Covington" date="2015-02-12">

      Changed default compression of TIFF format images to no compression. Added COMPRESSION parameter to

      choose the compression algorithm for TIFF format images. Fixes #1745

    </change>

    <change name="Kaitlyn Lee" date="2018-02-08">

      Removed the option to export as a GIF because Qt does not support GIF

      exports. Fixes #1667.

    </change>

  </history>

  <category>

        </brief>

        <description>

          Use this parameter to select the filename and band to export. For

          example, file.cub+5 will select band 5

          example, file.cub+5 will select band 5.

        </description>

        <filter>

          *.cub

        </brief>

        <description>

          Use this parameter to select the filename and band to export. For

          example, file.cub+5 will select band 5

          example, file.cub+5 will select band 5.

        </description>

        <filter>

          *.cub

        </brief>

        <description>

          Use this parameter to select the filename and band to export. For

          example, file.cub+5 will select band 5

          example, file.cub+5 will select band 5.

        </description>

        <filter>

          *.cub

        </brief>

        <description>

          Use this parameter to select the filename and band to export. For

          example, file.cub+5 will select band 5

          example, file.cub+5 will select band 5.

        </description>

        <filter>

          *.cub

        </brief>

        <description>

          Use this parameter to select the filename and band to export. For

          example, file.cub+5 will select band 5

          example, file.cub+5 will select band 5.

        </description>

        <filter>

          *.cub

        <brief>Format of output image</brief>

        <description>

          This parameter is used to select the output format.  It can be one of

          PNG, BMP, JPEG, TIF, GIF, or JP2.  Note that not all formats may be

          PNG, BMP, JPEG, TIF, or JP2.  Note that not all formats may be

          available.  It will depend on your installation of the Qt libraries.

          <p>

          In addition, if the cube has Mapping labels, the program will produce

          a world file for use in Arc and/or other GIS packages. The file will

          have an extension that uses the first and last letters for the image

          extention and a "w". For example, .tif produces a world file extension of .tfw.

          extension and a "w". For example, .tif produces a world file extension of .tfw.

          </p>

        </description>

              <item>COMPRESSION</item>

            </exclusions>

          </option>

          <option value="GIF">

            <brief>Output image will be GIF</brief>

            <description>

              The output image is in GIF (Graphics Interchange Format) format. The default 

              extension for this format is "gif."

            </description>

            <exclusions>

              <item>BITTYPE</item>

              <item>COMPRESSION</item>

            </exclusions>

          </option>

          <option value="TIFF">

            <brief>Output image will be TIFF</brief>

            <description>

        <brief>Bit type of output file</brief>

        <description>

          This parameter allows the userPackBits is also known as Macintosh RLE. to set the bit type of the output image.

          Some FORMAT values will only allow 8BIT outputs.

          Some FORMAT values will only allow 8-bit outputs.

          16 bit signed (-32767=black, 32768=white)

        </description>

        <list>

      </brief>

      <description>

        This example creates an output TIFF format file from 3 bands of an ISIS cube, designated

        red, green, and blue using a linear stretch and 8 bit output type. A histogram is created 

        red, green, and blue using a linear stretch and 8-bit output type. A histogram is created

        from the input values.  Using this histogram, we determine the minimum value to be any DN

        in the bottom 0.2% of the data. These DNs will be set to black in the output. Similarly,

        the maximum value is any DN in the top 99.8% of the data and these DNs will be set to white.

            <description>

              This image show the graphical user interface for this program.

            </description>

            <thumbnail height="200" width="142" src="assets/thumbs/isis2stdGUI.jpg" caption="isis2std with RGB input and 8BIT output"/>

            <thumbnail height="200" width="142" src="assets/thumbs/isis2stdGUI.jpg" caption="isis2std with RGB input and 8-bit output"/>

          </image>

        </guiInterface>

      </guiInterfaces>

            Output image.

          </brief>

          <description>

            The 8 bit output image, in TIFF format, created using the input red, green, and blue channels.

            The 8-bit output image, in TIFF format, created using the input red, green, and blue channels.

          </description>

          <thumbnail height="150" width="200" src="assets/thumbs/rgbTIFFoutput.jpg" caption="The color output image."/>

          <parameterName>TO</parameterName>