ENCX::S57Manager Class Reference
An S-57 SENC. More...
import "_encxcom_encx.idl";
Public Member Functions | |
| HRESULT | OpenSenc ([in] ILibrary *EncXLibrary,[in] BSTR sSencFolder) |
| Associate this manager with a specified folder. | |
| HRESULT | CloseSenc (void) |
| Dissociate from the current folder. | |
| HRESULT | Cells ([in] IS57ProductAndUsages *ProductAndUsages,[in] IGeoRect *cr,[out, retval] IS57CellIdentifiers **pVal) |
| Obtain the collection of all the cells in this SENC. | |
| HRESULT | CellInfo ([in] IS57CellIdentifier *piCellID,[out, retval] IS57CellInfo **pVal) |
| Obtain the details for a specified S-57 cell. | |
| HRESULT | ObjectClass ([in] IS57FeatureIdentifier *fid,[out, retval] IS57ObjectClass **pVal) |
| Obtain the type (ObjectClass in S-57 language) of a specified S-57 feature. | |
| HRESULT | Geometry ([in] IS57FeatureIdentifier *pifid,[out, retval] enum S57FeatureGeometry *pVal) |
| Obtain the geometry of a specified S-57 feature. | |
| HRESULT | FeatureInfo ([in] IS57FeatureIdentifier *pifid,[out, retval] IS57FeatureInfo **pVal) |
| Obtain the general details for a specified S-57 feature. | |
| HRESULT | FeatureInfoPoint ([in] IS57FeatureIdentifier *pifid,[out, retval] IS57FeaturePoint **pVal) |
| Obtain the general details and spatial details (a single geographical position) for a specified S-57 Point feature. | |
| HRESULT | FeatureInfoLine ([in] IS57FeatureIdentifier *pifid,[out, retval] IS57FeatureLine **pVal) |
| Obtain the general details and spatial details (a chain of geographical positions) for a specified S-57 Line feature. | |
| HRESULT | FeatureInfoArea ([in] IS57FeatureIdentifier *pifid,[out, retval] IS57FeatureArea **pVal) |
| Obtain the general details and spatial details (one or more rings of geographical positions) for a specified S-57 Area feature. | |
| HRESULT | FeatureInfoSounding ([in] IS57FeatureIdentifier *pifid,[out, retval] IS57FeatureSounding **pVal) |
| Obtain the general details and spatial details (one or more point geographical positions) for a specified S-57 Sounding feature. | |
| HRESULT | RunInstallApplication ([in] BSTR pathToApplication) |
| Invoke the CherSoft Windows application that installs and updates ENC cells in the SENC. | |
| HRESULT | OpenSenc2 ([in] ILibrary *EncXLibrary,[in] IS57ManagerInitialisationData *p) |
| Associate this manager with a specified folder. | |
| HRESULT | UserPermit ([out, retval] BSTR *pUserPermit) |
| The ENC user permit needed to buy commercial ENC chart data. | |
| HRESULT | IsValidSencFolder ([in] BSTR sPath,[out, retval] VARIANT_BOOL *bRes) |
| Is the path pointing to a valid SENC. A SENC is the folder structure in which ENC chart data is installed. | |
| HRESULT | CreateSencFolder ([in] BSTR sPath) |
| Create a SENC. A SENC is the folder structure in which ENC chart data is installed. | |
Properties | |
| IS57CellIdentifiers ** | UnusedCells [get] |
| Obtain a collection of the cells in the Senc that cannot be used. These cells need to be re-installed. | |
| IS57ProductAndUsages ** | InstalledProducts [get] |
| Obtain the collection of S-57 products currently present in this SENC. | |
Detailed Description
An S-57 SENC.An S-57 Manager provides access to a System Electronic Navigational Chart (SENC), which comprises a collection of S-57 cells.
Each cell contains the chart information for a bounded area for a particular navigational purpose. Cells are limited in size, so large numbers of cells are required to cover a large area at a detailed scale.
Cells are added to the SENC and updated using ManageENC.exe which is invoked via InstallCells_ENC(). This does everything necessary to install and update all the cells from an S-57 data provider's CD into the SENC.
The SENC can be used to draw S-57 data onto a window or bitmap drawing surface using S57Draw.
Properties and methods via IS57Manager.
Definition at line 3520 of file _encxcom_encx.idl.
Member Function Documentation
| HRESULT IS57Manager::OpenSenc | ( | [in] ILibrary * | EncXLibrary, | |
| [in] BSTR | sSencFolder | |||
| ) | [inherited] |
Associate this manager with a specified folder.
| HRESULT IS57Manager::CloseSenc | ( | void | ) | [inherited] |
Dissociate from the current folder.
| HRESULT IS57Manager::Cells | ( | [in] IS57ProductAndUsages * | ProductAndUsages, | |
| [in] IGeoRect * | cr, | |||
| [out, retval] IS57CellIdentifiers ** | pVal | |||
| ) | [inherited] |
Obtain the collection of all the cells in this SENC.
A snapshot of the installed cells at the time when this property is requested. It will not stay up to date as new cells are installed. To keep up to date you should observe the OnBusy(..) events.
| HRESULT IS57Manager::CellInfo | ( | [in] IS57CellIdentifier * | piCellID, | |
| [out, retval] IS57CellInfo ** | pVal | |||
| ) | [inherited] |
Obtain the details for a specified S-57 cell.
| HRESULT IS57Manager::ObjectClass | ( | [in] IS57FeatureIdentifier * | fid, | |
| [out, retval] IS57ObjectClass ** | pVal | |||
| ) | [inherited] |
Obtain the type (ObjectClass in S-57 language) of a specified S-57 feature.
| HRESULT IS57Manager::Geometry | ( | [in] IS57FeatureIdentifier * | pifid, | |
| [out, retval] enum S57FeatureGeometry * | pVal | |||
| ) | [inherited] |
Obtain the geometry of a specified S-57 feature.
| HRESULT IS57Manager::FeatureInfo | ( | [in] IS57FeatureIdentifier * | pifid, | |
| [out, retval] IS57FeatureInfo ** | pVal | |||
| ) | [inherited] |
Obtain the general details for a specified S-57 feature.
This method can be used with a feature of any Geometry.
| HRESULT IS57Manager::FeatureInfoPoint | ( | [in] IS57FeatureIdentifier * | pifid, | |
| [out, retval] IS57FeaturePoint ** | pVal | |||
| ) | [inherited] |
Obtain the general details and spatial details (a single geographical position) for a specified S-57 Point feature.
This method will only succeed for a feature of ENCX::FG_Point Geometry.
| HRESULT IS57Manager::FeatureInfoLine | ( | [in] IS57FeatureIdentifier * | pifid, | |
| [out, retval] IS57FeatureLine ** | pVal | |||
| ) | [inherited] |
Obtain the general details and spatial details (a chain of geographical positions) for a specified S-57 Line feature.
This method will only succeed for a feature of ENCX::FG_Line Geometry.
| HRESULT IS57Manager::FeatureInfoArea | ( | [in] IS57FeatureIdentifier * | pifid, | |
| [out, retval] IS57FeatureArea ** | pVal | |||
| ) | [inherited] |
Obtain the general details and spatial details (one or more rings of geographical positions) for a specified S-57 Area feature.
This method will only succeed for a feature of ENCX::FG_Area Geometry.
| HRESULT IS57Manager::FeatureInfoSounding | ( | [in] IS57FeatureIdentifier * | pifid, | |
| [out, retval] IS57FeatureSounding ** | pVal | |||
| ) | [inherited] |
Obtain the general details and spatial details (one or more point geographical positions) for a specified S-57 Sounding feature.
This method will only succeed for a feature of ENCX::FG_Sounding Geometry.
ENCX::FG_Sounding is used as a more efficient way of encoding large numbers of soundings. It is very similar to a correspondingly larger number Point features all with identical attributes and attribute values.
| HRESULT IS57Manager::RunInstallApplication | ( | [in] BSTR | pathToApplication | ) | [inherited] |
Invoke the CherSoft Windows application that installs and updates ENC cells in the SENC.
| HRESULT IS57Manager::OpenSenc2 | ( | [in] ILibrary * | EncXLibrary, | |
| [in] IS57ManagerInitialisationData * | p | |||
| ) | [inherited] |
Associate this manager with a specified folder.
| HRESULT IS57Manager::UserPermit | ( | [out, retval] BSTR * | pUserPermit | ) | [inherited] |
The ENC user permit needed to buy commercial ENC chart data.
| HRESULT IS57Manager::IsValidSencFolder | ( | [in] BSTR | sPath, | |
| [out, retval] VARIANT_BOOL * | bRes | |||
| ) | [inherited] |
Is the path pointing to a valid SENC. A SENC is the folder structure in which ENC chart data is installed.
| HRESULT IS57Manager::CreateSencFolder | ( | [in] BSTR | sPath | ) | [inherited] |
Create a SENC. A SENC is the folder structure in which ENC chart data is installed.
Property Documentation
IS57CellIdentifiers ** IS57Manager::UnusedCells [get, inherited] |
Obtain a collection of the cells in the Senc that cannot be used. These cells need to be re-installed.
The result returned is a snapshot of the unused cells at the time when the property is requested. It will not stay up to date.
IS57ProductAndUsages ** IS57Manager::InstalledProducts [get, inherited] |
Obtain the collection of S-57 products currently present in this SENC.
A snapshot of the products at the time when this property is requested. It will not stay up to date.