1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160
|
// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
/**
* @class vtkGDALRasterReader
* @brief Read raster file formats using GDAL.
*
* vtkGDALRasterReader is a source object that reads raster files and
* uses GDAL as the underlying library for the task. GDAL library is
* required for this reader. The output of the reader is a
* vtkUniformGrid (vtkImageData with blanking) with cell data.
* The reader currently supports only north up images. Flips along
* X or Y direction are also supported. Arbitrary affine geotransforms or
* GCPs are not supported. See GDAL Data Model for more information
* https://www.gdal.org/gdal_datamodel.html
*
*
*
* @sa
* vtkUniformGrid, vtkImageData
*/
#ifndef vtkGDALRasterReader_h
#define vtkGDALRasterReader_h
#include <vtkIOGDALModule.h> // For export macro
#include <vtkImageReader2.h>
// C++ includes
#include <string> // string is required
#include <vector> // vector is required
VTK_ABI_NAMESPACE_BEGIN
class VTKIOGDAL_EXPORT vtkGDALRasterReader : public vtkImageReader2
{
public:
static vtkGDALRasterReader* New();
vtkTypeMacro(vtkGDALRasterReader, vtkImageReader2);
void PrintSelf(ostream& os, vtkIndent indent) override;
vtkGDALRasterReader();
~vtkGDALRasterReader() override;
/**
* Is this file supported
*/
int CanReadFile(VTK_FILEPATH const char* fname) override;
/**
* Return proj4 spatial reference
*/
const char* GetProjectionString() const;
/**
* Returns WKT spatial reference.
*/
const char* GetProjectionWKT() const { return this->ProjectionWKT.c_str(); }
/**
* Return geo-referenced corner points (Upper left,
* lower left, lower right, upper right)
*/
const double* GetGeoCornerPoints();
/**
* Get/Set if bands are collated in one scalar array.
* Currently we collate RGB, RGBA, gray alpha and palette.
* The default is true.
*/
vtkSetMacro(CollateBands, bool);
vtkGetMacro(CollateBands, bool);
vtkBooleanMacro(CollateBands, bool);
///@{
/**
* Set desired width and height of the image
*/
vtkSetVector2Macro(TargetDimensions, int);
vtkGetVector2Macro(TargetDimensions, int);
///@}
///@{
/**
* Get raster width and height in number of pixels (cells)
*/
int* GetRasterDimensions();
///@}
/**
* Return metadata as reported by GDAL
*/
const std::vector<std::string>& GetMetaData();
/**
* Return the invalid value for a pixel (for blanking purposes) in
* a specified raster band. Note bandIndex is a 0 based index while
* GDAL bands are 1 based indexes. hasNoData indicates if there is a NoData
* value associated with this band.
*/
double GetInvalidValue(size_t bandIndex = 0, int* hasNoData = nullptr);
/**
* Return domain metadata
*/
std::vector<std::string> GetDomainMetaData(const std::string& domain);
///@{
/**
* Return driver name which was used to read the current data
*/
const std::string& GetDriverShortName();
const std::string& GetDriverLongName();
///@}
/**
* Return the number of cells that are not set to GDAL NODATA
*/
vtkIdType GetNumberOfCells();
///@{
/**
* The following methods allow selective reading of bands.
* By default, ALL bands are read.
*/
int GetNumberOfCellArrays();
const char* GetCellArrayName(int index);
int GetCellArrayStatus(const char* name);
void SetCellArrayStatus(const char* name, int status);
void DisableAllCellArrays();
void EnableAllCellArrays();
///@}
protected:
int RequestData(vtkInformation* request, vtkInformationVector** inputVector,
vtkInformationVector* outputVector) override;
int RequestInformation(vtkInformation* request, vtkInformationVector** inputVector,
vtkInformationVector* outputVector) override;
int FillOutputPortInformation(int port, vtkInformation* info) override;
int TargetDimensions[2];
std::string Projection;
std::string ProjectionWKT;
std::string DomainMetaData;
std::string DriverShortName;
std::string DriverLongName;
std::vector<std::string> Domains;
std::vector<std::string> MetaData;
bool CollateBands;
class vtkGDALRasterReaderInternal;
vtkGDALRasterReaderInternal* Impl;
private:
vtkGDALRasterReader(const vtkGDALRasterReader&) = delete;
void operator=(const vtkGDALRasterReader&) = delete;
};
VTK_ABI_NAMESPACE_END
#endif // vtkGDALRasterReader_h
|