• RasterPyramidInfo
  • class Esri::ArcGISRuntime::RasterPyramidInfo

    Information about a raster pyramid set. More...

    Header: #include <RasterPyramidInfo.h>
    Since: Esri::ArcGISRuntime 300.1
    Inherits: Esri::ArcGISRuntime::Object

    Public Functions

    virtual ~RasterPyramidInfo() override
    Esri::ArcGISRuntime::RasterPyramidCompressionType compressionType() const
    QString filePath() const
    bool isEmbedded() const
    int levelCount() const
    Esri::ArcGISRuntime::RasterResamplingType resamplingType() const

    Detailed Description

    A raster pyramid set is a collection of reduced-resolution copies of a raster. These reduced-resolution levels let the runtime display the raster more efficiently at smaller scales by using data that is already closer to the requested resolution.

    Pyramids for a raster can be embedded within the raster file or in a separate pyramid file (.ovr). When returned from RasterPyramids::pyramidInfo, it describes the pyramid set available for the raster.

    Pyramids stored in a separate pyramid file (.ovr) can be deleted using RasterPyramids::deletePyramids. After the pyramids are deleted, new pyramids can be built using RasterPyramids::buildPyramids(Esri::ArcGISRuntime::BuildRasterPyramidsParameters*).

    Member Function Documentation

    [override virtual noexcept] RasterPyramidInfo::~RasterPyramidInfo()

    Destructor.

    Esri::ArcGISRuntime::RasterPyramidCompressionType RasterPyramidInfo::compressionType() const

    Returns the compression type used by the pyramid set.

    This property is RasterPyramidCompressionType::Default when the compression type cannot be determined from the available metadata. Otherwise, it represents the actual compression used by the pyramid set.

    After the pyramid build operation completes successfully, use RasterPyramids::pyramidInfo to inspect the pyramid set that was built. If the request fell back from an unsupported requested compression to the runtime default pyramid compression, this property reports the compression that was actually written.

    QString RasterPyramidInfo::filePath() const

    Returns the path to the file that stores the pyramid set, if available.

    When the pyramid set is stored in a file, this property identifies that file. The path may refer to an .ovr file or to another file used by the raster format to store pyramid data.

    This property is empty when no file path is available for the pyramid set, such as when the pyramids are stored internally in the source raster.

    bool RasterPyramidInfo::isEmbedded() const

    Returns true if pyramids are part of the source raster dataset, false otherwise.

    Pyramids can be part of the source raster dataset or stored in a separate pyramid file (.ovr). Dataset pyramids may be stored internally by the raster format or in format-managed sidecar files such as .rrd or .aux. In both cases, this property is true.

    This property is false only when the pyramid set is stored in a separate pyramid file (.ovr).

    int RasterPyramidInfo::levelCount() const

    Returns the number of levels in the pyramid set.

    Each level is a reduced-resolution representation of the source raster. This count does not include the full-resolution source raster.

    Esri::ArcGISRuntime::RasterResamplingType RasterPyramidInfo::resamplingType() const

    Returns the resampling method used to create the pyramid set.

    This property is RasterResamplingType::Automatic when the resampling method cannot be determined from the available metadata or is not represented by an exposed RasterResamplingType value.