.. _image-export-image-label:

Export image
~~~~~~~~~~~~

The *Export image* step saves the converted ``BitmapImage`` with additional metadata information into a standard file format.

After the *Convert* pipeline (see :ref:`image-convert-pipeline-label`) produced a ``BitmapImage`` data, one might want to store the result on the file system as part of a delivery, or to further process the image with another application. This step is meant for this use case.

The current version supports the following output formats:

* Tag Image File Format (TIFF) with GeoTIFF extension

Exporting into Tag Image File Format (TIFF)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

To export into TIFF format one must obtain both the original ``RawImage`` and the produced ``BitmapImage`` along with the ``TiffConfig`` configuring the output file.

.. code-tabs::
    .. code-tab:: cpp
        :title: C++

        P1::ImageSdk::RawImage rawImage;
        P1::ImageSdk::BitmapImage bitmap;
        P1::ImageSdk::TiffConfig config;
        std::string filename;

        P1::ImageSdk::TiffWriter tiffWriter(filename, bitmap, rawImage, config);

    .. code-tab:: csharp
        :title: C#

        P1.ImageSdk.RawImage rawImage;
        P1.ImageSdk.BitmapImage bitmap;
        P1.ImageSdk.TiffConfig config;
        System.String filename;

        rawImage.WriteAsTiff(filename, bitmap, config);

Adding GeoTIFF fields to the metadata
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To output a valid GeoTIFF file, the ImageSdk requires a couple of fields to be defined in the TiffConfig structure.
A minimum set of required parameters are currently supported.

* GTRasterTypeGeoKey
* GTModelTypeGeoKey
* ModelTiepointTag
* ModelPixelScaleTag
* ModelTransformationTag
* GTCitationGeoKey

See an example of how to add the fields to the configuration.

.. code-tabs::
    .. include-tab:: ../../labels/cppSetGeoTiff
        :language: cpp
        :title: C++

    .. include-tab:: ../../labels/csSetGeoTiff
        :language: csharp
        :title: C#