EncCell Class

  • EncCell
  • class Esri::ArcGISRuntime::EncCell

    A single Electronic Navigation Chart (ENC) data source object. More...

    Header: #include <EncCell.h>
    Since: Esri::ArcGISRuntime 100.2
    Inherits: Esri::ArcGISRuntime::Object and Esri::ArcGISRuntime::Loadable

    Public Functions

    EncCell(Esri::ArcGISRuntime::EncDataset *dataset, QObject *parent = nullptr)
    EncCell(const QString &path, QObject *parent = nullptr)
    virtual ~EncCell() override
    Esri::ArcGISRuntime::EncDataset *dataset() const
    QString path() const

    Reimplemented Public Functions

    virtual void cancelLoad() override
    virtual void load() override
    virtual Esri::ArcGISRuntime::Error loadError() const override
    virtual Esri::ArcGISRuntime::LoadStatus loadStatus() const override
    virtual void retryLoad() override

    Signals

    void doneLoading(const Esri::ArcGISRuntime::Error &loadError)
    void loadStatusChanged(Esri::ArcGISRuntime::LoadStatus loadStatus)

    Detailed Description

    An ENC cell can be created using a EncDataset obtained from a EncExchangeSet, or using path to S-57/ENC (*.000) file, and can be visualized using EncLayer.

    Note: It can take some time to load an ENC cell. Preprocessing the cells by loading them ahead of time is recommended, especially when loading from large ENC exchange sets. Subsequent loads of the cell will read from the internal SENC database for improved performance.

    // create ENC Cell using path
    EncCell* encCell = new EncCell(path, parent);
    
    // visualize ENC data in ENC layer.
    EncLayer* encLayer = new EncLayer(encCell, parent);

    See also Loadable and EncLayer.

    Member Function Documentation

    [explicit] EncCell::EncCell(Esri::ArcGISRuntime::EncDataset *dataset, QObject *parent = nullptr)

    Creates an ENC cell using an ENC dataset.

    • dataset - The ENC dataset object previously obtained from an EncExchangeSet.
    • parent - The optional parent QObject.

    Use this method when constructing an ENC cell delivered as part of an exchange set. When an ENC cell is constructed from the path directly, updates (*.001, *.002, etc.) that are part of the associated exchange set (if there is one) will not be applied.

    [explicit] EncCell::EncCell(const QString &path, QObject *parent = nullptr)

    Creates an ENC cell from the specified path.

    • path - The path to the S-57/ENC (extension .000) file.
    • parent - The optional parent QObject.

    EncCell() is the correct method of constructing an ENC cell delivered as part of an exchange set. When an ENC cell is constructed from the path directly, updates (*.001, *.002, etc.) that are part of the associated exchange set (if there is one) will not be applied.

    See also EncCell.

    [override virtual] EncCell::~EncCell()

    Destructor.

    [override virtual] void EncCell::cancelLoad()

    Reimplements: Loadable::cancelLoad().

    Cancels loading metadata for the object.

    Cancels loading the metadata if the object is loading.

    See Loadable.

    Esri::ArcGISRuntime::EncDataset *EncCell::dataset() const

    Returns the ENC data set object associated with the ENC cell.

    The dataset will be nullptr if the ENC cell was loaded from a path.

    See also EncDataset.

    [signal] void EncCell::doneLoading(const Esri::ArcGISRuntime::Error &loadError)

    Signal emitted when this object is done loading.

    • loadError - Details about any error that may have occurred.

    Note: If there is a load error it will also be emitted on the errorOccurred signal.

    See also Loadable and Object.

    [override virtual] void EncCell::load()

    Reimplements: Loadable::load().

    Loads the metadata for the object asynchronously.

    Loads the metadata if the object is not loaded.

    See Loadable.

    [override virtual] Esri::ArcGISRuntime::Error EncCell::loadError() const

    Reimplements: Loadable::loadError() const.

    Returns the load error.

    See Loadable.

    See also Error.

    [override virtual] Esri::ArcGISRuntime::LoadStatus EncCell::loadStatus() const

    Reimplements: Loadable::loadStatus() const.

    Returns the load status.

    See Loadable.

    See also LoadStatus.

    [signal] void EncCell::loadStatusChanged(Esri::ArcGISRuntime::LoadStatus loadStatus)

    Signal emitted when the load status changes for this object.

    See also Loadable.

    QString EncCell::path() const

    Returns the path to the S-57/ENC (*.000) file associated with the ENC cell.

    [override virtual] void EncCell::retryLoad()

    Reimplements: Loadable::retryLoad().

    Loads or retries loading metadata for the object asynchronously.

    Will retry loading the metadata if the object is failed to load. Will load the object if it is not loaded. Will not retry to load the object if the object is loaded. Will always call the done loading if this is called.

    See Loadable.

    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.