GeoTiffFactory.h

/*--------------------------------------------------------------------------------------------
Copyright (c) 2020, NDEVR LLC
tyler.parke@ndevr.org
  __    __   ____     _____ __     __  _______
 |  \  |  | |  __ \  |  ___|\ \   / / |   __  \
 |   \ |  | | |  \ \ | |___  \ \ / /  |  |__)  |
 |  . \|  | | |__/ / | |___   \ V /   |   _   /
 |  |\    |_|_____/__|_____|___\_/____|  | \  \
 |__| \__________________________________|  \__\
 
Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants
Licensee a limited, non-exclusive, non-transferable, royalty-free license
(without the right to sublicense) to use the API solely for the purpose of
Licensee's internal development efforts to develop applications for which
the API was provided.
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
 
Library: TIFImageHandler
File: GeoTiffFactory
Included in API: True
Author(s): Tyler Parke
 *-----------------------------------------------------------------------------------------**/
#pragma once
#include "DLLInfo.h"
#include <NDEVR/IOFactory.h>
#include <NDEVR/Matrix.h>
 
struct tiff;
typedef struct tiff TIFF;
 
namespace NDEVR
{
    struct TIF_IMAGE_HANDLER_API GeoTiffInfo
    {
        Vector<3, fltp08> pixel_scale = Constant<Vector<3, fltp08>>::Invalid; 
        bool has_pixel_scale = false; 
 
        Buffer<Vertex<3, fltp08>> raster_tiepoints; 
        Buffer<Vertex<3, fltp08>> model_tiepoints; 
        bool has_tiepoints = false; 
 
        Matrix<fltp08> model_transformation; 
        bool has_transformation = false; 
 
        uint04 projected_cs_type = Constant<uint04>::Invalid; 
        uint04 geographic_type = Constant<uint04>::Invalid; 
        uint04 model_type = Constant<uint04>::Invalid; 
        uint04 raster_type = Constant<uint04>::Invalid; 
 
        uint04 width = 0; 
        uint04 height = 0; 
        uint16_t samples_per_pixel = 0; 
        uint16_t bits_per_sample = 0; 
        uint16_t sample_format = 0; 
        fltp08 invalid_val; 
 
        uint02 elevation_band_index = Constant<uint02>::Invalid; 
        Buffer<String> band_descriptions; 
 
        // Set by readFile when CRS is geographic (degrees) -- holds the UTM projection
        // used for converting degree coordinates to meters
        UUID source_projection = Constant<UUID>::Invalid; 

        bool isOrthophoto() const;
        bool isMultispectral() const;

        Vertex<3, fltp08> pixelToCoord(fltp08 col, fltp08 row, fltp08 z = 0.0) const;
        Vertex<3, fltp08> pixelToMeters(fltp08 col, fltp08 row, fltp08 z = 0.0) const;
    };

    class TIF_IMAGE_HANDLER_API GeoTiffFactory : public IOFactory
    {
    private:
        GeoTiffFactory();
    public:
        void getSupportedFormats(Buffer<FileFormat>& formats, bool is_read) override;
        bool canRead(const File& file) override;
        bool canRead(const FactoryParameters& file) override;
        bool readFile(FactoryParameters& file) override;
        bool writeFile(FactoryParameters& file) override;
        FactoryOptions defaultReadOptions(const FactoryParameters& file) const override;
        FactoryFeatures factoryFeatures(const FactoryParameters& file, bool is_read) const override;
        static GeoTiffFactory* DefaultFactory();
        static constexpr StringView FactoryID() { return "GeoTIFF Factory"; }

        virtual bool isAutoEnabled() const;
        static bool HasGeoTiffTags(TIFF* tif);
        static GeoTiffInfo ParseGeoTiffTags(TIFF* tif);
        static UUID ResolveProjection(const GeoTiffInfo& info);
    private:
        bool readOrthophoto(FactoryParameters& params, TIFF* tif, const GeoTiffInfo& info);
        bool readMultispectral(FactoryParameters& params, TIFF* tif, const GeoTiffInfo& info);

        static constexpr StringView CustomOptionsLabel() { return "geotiff_options"; }
        static constexpr StringView CustomOptionsImportMode() { return "import_mode"; }
        static constexpr StringView CustomOptionsDecimation() { return "decimation_stride"; }
        static constexpr StringView CustomOptionsDrapeMode() { return "drape_mode"; }
        static constexpr StringView CustomOptionsUseProjection() { return "use_projection"; }
    };
}