gdal_utils_priv.h

/******************************************************************************
 * $Id$
 *
 * Project:  GDAL Utilities
 * Purpose:  GDAL Utilities Private Declarations.
 * Author:   Even Rouault <even.rouault at spatialys.com>
 *
 * ****************************************************************************
 * Copyright (c) 2015, Even Rouault <even.rouault at spatialys.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * 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.
 ****************************************************************************/
 
#ifndef GDAL_UTILS_PRIV_H_INCLUDED
#define GDAL_UTILS_PRIV_H_INCLUDED
 
#ifndef DOXYGEN_SKIP
 
#include "cpl_port.h"
#include "cpl_string.h"
#include "gdal_utils.h"
 
/* This file is only meant at being used by the XXXX_bin.cpp and XXXX_lib.cpp
 * files */
 
CPL_C_START
 
struct GDALInfoOptionsForBinary
{
    /* Filename to open. */
    std::string osFilename{};
 
    /* Open options. */
    CPLStringList aosOpenOptions{};
 
    /* For reporting on a particular subdataset */
    int nSubdataset = 0;
 
    /* Allowed input drivers. */
    CPLStringList aosAllowedInputDrivers{};
};
 
struct GDALDEMProcessingOptionsForBinary
{
    std::string osProcessing;
    std::string osSrcFilename;
    std::string osColorFilename;
    std::string osDstFilename;
    bool bQuiet = false;
};
 
CPL_C_END
 
/* Access modes */
typedef enum
{
    ACCESS_CREATION,
    ACCESS_UPDATE, /* open existing output datasource in update mode rather than
                      trying to create a new one */
    ACCESS_APPEND, /* append to existing layer instead of creating new */
    ACCESS_OVERWRITE /*  delete the output layer and recreate it empty */
} GDALVectorTranslateAccessMode;
 
struct GDALVectorTranslateOptionsForBinary
{
    std::string osDataSource{};
    std::string osDestDataSource{};
    bool bQuiet = false;
    CPLStringList aosOpenOptions{};
    std::string osFormat;
    GDALVectorTranslateAccessMode eAccessMode = ACCESS_CREATION;
    bool bShowUsageIfError = false;
 
    /* Allowed input drivers. */
    CPLStringList aosAllowInputDrivers{};
};
 
struct GDALMultiDimInfoOptionsForBinary
{
    /* Filename to open. */
    std::string osFilename{};
 
    /* Allowed input drivers. */
    CPLStringList aosAllowInputDrivers{};
 
    /* Open options. */
    CPLStringList aosOpenOptions{};
};
 
struct GDALMultiDimTranslateOptionsForBinary
{
    std::string osSource{};
    std::string osDest{};
    std::string osFormat{};
    bool bQuiet = false;
    bool bUpdate = false;
 
    /* Allowed input drivers. */
    CPLStringList aosAllowInputDrivers{};
 
    /* Open options. */
    CPLStringList aosOpenOptions{};
};
 
struct GDALVectorInfoOptionsForBinary
{
    /* Filename to open. */
    std::string osFilename{};
 
    bool bVerbose = true;
 
    bool bReadOnly = false;
 
    bool bUpdate = false;
 
    std::string osSQLStatement{};
 
    /* Open options. */
    CPLStringList aosOpenOptions{};
 
    /* Allowed input drivers. */
    CPLStringList aosAllowInputDrivers{};
};
 
struct GDALGridOptionsForBinary
{
    std::string osSource{};
    std::string osDest{};
    bool bQuiet = false;
    CPLStringList aosOpenOptions{};
};
 
struct GDALRasterizeOptionsForBinary
{
    std::string osSource{};
    bool bDestSpecified = false;
    std::string osDest{};
    bool bQuiet = false;
    CPLStringList aosOpenOptions{};
    bool bCreateOutput = false;
    std::string osFormat{};
};
 
struct GDALFootprintOptionsForBinary
{
    std::string osSource{};
    bool bDestSpecified = false;
    std::string osDest{};
    bool bQuiet = false;
    CPLStringList aosOpenOptions{};
    bool bCreateOutput = false;
    std::string osFormat{};
 
    bool bOverwrite = false;
 
    std::string osDestLayerName{};
};
 
struct GDALTileIndexOptionsForBinary
{
    CPLStringList aosSrcFiles{};
    bool bDestSpecified = false;
    std::string osDest{};
    bool bQuiet = false;
};
 
struct GDALNearblackOptionsForBinary
{
    std::string osInFile{};
    std::string osOutFile{};
    bool bQuiet = false;
};
 
struct GDALTranslateOptionsForBinary
{
    std::string osSource{};
    std::string osDest{};
    bool bQuiet = false;
    bool bCopySubDatasets = false;
    CPLStringList aosOpenOptions{};
    std::string osFormat{};
 
    /* Allowed input drivers. */
    CPLStringList aosAllowedInputDrivers{};
};
 
struct GDALWarpAppOptionsForBinary
{
    CPLStringList aosSrcFiles{};
    std::string osDstFilename{};
    bool bQuiet = false;
    CPLStringList aosOpenOptions{};
 
    CPLStringList aosDestOpenOptions{};
 
    CPLStringList aosCreateOptions{};
 
    bool bOverwrite = false;
    bool bCreateOutput = false;
 
    /* Allowed input drivers. */
    CPLStringList aosAllowedInputDrivers{};
};
 
struct GDALBuildVRTOptionsForBinary
{
    CPLStringList aosSrcFiles{};
    std::string osDstFilename{};
    bool bQuiet = false;
    bool bOverwrite = false;
};
 
std::string CPL_DLL GDALNearblackGetParserUsage();
 
std::string CPL_DLL GDALVectorInfoGetParserUsage();
 
std::string CPL_DLL GDALTranslateGetParserUsage();
 
std::string CPL_DLL GDALMultiDimTranslateAppGetParserUsage();
 
std::string CPL_DLL GDALVectorTranslateGetParserUsage();
 
std::string CPL_DLL GDALWarpAppGetParserUsage();
 
std::string CPL_DLL GDALInfoAppGetParserUsage();
 
std::string CPL_DLL GDALMultiDimInfoAppGetParserUsage();
 
std::string CPL_DLL GDALGridGetParserUsage();
 
std::string CPL_DLL GDALBuildVRTGetParserUsage();
 
std::string CPL_DLL GDALTileIndexAppGetParserUsage();
 
std::string CPL_DLL GDALFootprintAppGetParserUsage();
 
std::string CPL_DLL
GDALDEMAppGetParserUsage(const std::string &osProcessingMode);
 
#endif /* #ifndef DOXYGEN_SKIP */
 
#endif /* GDAL_UTILS_PRIV_H_INCLUDED */