NAVTOR SDK  v.3.0
Software Development Kit for fast and efficient development of ECDIS, ECS and generic marine applications
portrayal_manager_interface.h
Go to the documentation of this file.
1 
9 #ifndef SDK_VISMAN_PORTRAYAL_MANAGER_INTERFACE_H_
10 #define SDK_VISMAN_PORTRAYAL_MANAGER_INTERFACE_H_
11 
12 #include <base/inc/base_types.h>
15 
17 
19 
20 namespace sdk {
21 namespace vis {
22 FWD_DECL_INTERFACE(IPortrayalManager);
23 FWD_DECL_INTERFACE(IPortrayalParameters);
24 FWD_DECL_INTERFACE(IPortrayalsEnumerator);
25 FWD_DECL_INTERFACE(IPortrayalLayer);
26 
30 {
35 };
36 
39 static const wchar_t* kMainChartPortrayalLayerName = L"main-chart";
40 
44 {
45 public:
47  virtual SDKResult SDK_CALLTYPE GetPortrayalParameters(
48  sdk::vis::IPortrayalParametersSP& portrayal_parameters) const throw() = 0;
50  virtual SDKResult SDK_CALLTYPE SetPortrayalParameters(
51  const sdk::vis::IPortrayalParametersSP& portrayal_parameters) throw() = 0;
52 
54  virtual SDKResult SDK_CALLTYPE CreatePortrayalLayer(
55  const SDKString& portrayal_layer_name, IPortrayalLayerSP& portrayal_layer) throw() = 0;
57  virtual SDKResult SDK_CALLTYPE GetPortrayalLayer(
58  const SDKString& portrayal_layer_name, IPortrayalLayerSP& portrayal_layer) const throw() = 0;
60  virtual SDKResult SDK_CALLTYPE RemovePortrayalLayer(
61  const SDKString& portrayal_layer_name) throw() = 0;
62 
64  virtual SDKResult SDK_CALLTYPE EnumPossiblePortrayalNames(const sdk::gdb::PRSP& prsp,
65  EnumSDKStringSP& portrayal_names) const throw() = 0;
67  virtual SDKResult SDK_CALLTYPE SetCurrentPortrayal(const sdk::gdb::PRSP& prsp,
68  const SDKString& portrayal_name) throw() = 0;
70  virtual SDKResult SDK_CALLTYPE GetCurrentPortrayal(const sdk::gdb::PRSP& prsp,
71  SDKString& portrayal_name) const throw() = 0;
72 
74  virtual SDKResult SDK_CALLTYPE EnumAvailablePortrayals(
75  IPortrayalsEnumeratorSP& portrayals) const throw() = 0;
76 
78  virtual SDKResult SDK_CALLTYPE InstallPortrayal(const SDKString& portrayal_path,
79  SDKString* installed_path) throw() = 0;
81  virtual SDKResult SDK_CALLTYPE RemovePortrayal(const SDKString& portrayal_name,
82  double version) throw() = 0;
83 
85  virtual SDKResult SDK_CALLTYPE SetCurrentPortrayalVersion(const SDKString& portrayal_name,
86  double version) throw() = 0;
87 
89  virtual SDKResult SDK_CALLTYPE GetPortrayalInfoFromPath(const SDKString& portrayal_path,
90  SDKString& portrayal_name, double& version, ISDKPropertiesSP& portrayal_props) const throw() = 0;
91 
93  virtual SDKResult SDK_CALLTYPE RegisterUserSymbolSet(
94  const SDKString& portrayal_name, const SDKString& symbolset_path) throw() = 0;
95 
96  SDK_IMPLEMENT_IID(IPortrayalManager)
97  SDK_END_INTERFACE(IPortrayalManager)
98 };
99 SDK_DECLARE_IID(IPortrayalManager)
100 
104 {
107 };
108 
112 {
113 public:
115  virtual SDKResult SDK_CALLTYPE AddDataSourceView(
116  const DataSourceViewID& id) throw() = 0;
117 
119  virtual SDKResult SDK_CALLTYPE DeleteDataSourceView(
120  const DataSourceViewID& id) throw() = 0;
121 
123  virtual SDKResult SDK_CALLTYPE Clear() throw() = 0;
124 
125  // ISDKProperties
126  //virtual SDKResult SDK_CALLTYPE SetProperty(const SDKPropertyID& id,
127  // const SDKAny& value) throw() = 0;
128  //virtual SDKResult SDK_CALLTYPE GetProperty(const SDKPropertyID& id,
129  // SDKAny& value) const throw() = 0;
130 
131  SDK_IMPLEMENT_IID(IPortrayalLayer)
132  SDK_END_INTERFACE(IPortrayalLayer)
133 };
134 SDK_DECLARE_IID(IPortrayalLayer)
135 
139 {
140 public:
142  virtual SDKResult SDK_CALLTYPE Next(SDKString& name, double& version,
143  ISDKPropertiesSP& portrayal_props) const throw() = 0;
145  virtual SDKResult SDK_CALLTYPE Reset() throw() = 0;
146 
147  SDK_IMPLEMENT_IID(IPortrayalsEnumerator)
148  SDK_END_INTERFACE(IPortrayalsEnumerator)
149 };
150 SDK_DECLARE_IID(IPortrayalsEnumerator)
151 
152 } // namespace vis
153 } // namespace sdk
154 
155 #endif // SDK_VISMAN_PORTRAYAL_MANAGER_INTERFACE_H_
sdk::vis::PortrayalLayerProperties
PortrayalLayerProperties
List of portrayal layer properties.
Definition: portrayal_manager_interface.h:103
sdk::vis::IPortrayalManager::SetCurrentPortrayal
virtual SDKResult SDK_CALLTYPE SetCurrentPortrayal(const sdk::gdb::PRSP &prsp, const SDKString &portrayal_name)=0
Sets current portrayal for the data with specified PRSP.
sdk::vis::IPortrayalManager::GetPortrayalInfoFromPath
virtual SDKResult SDK_CALLTYPE GetPortrayalInfoFromPath(const SDKString &portrayal_path, SDKString &portrayal_name, double &version, ISDKPropertiesSP &portrayal_props) const =0
Reads and returned description of portrayal by path.
base_types.h
SDK base types.
sdk::vis::IPortrayalManager::RemovePortrayal
virtual SDKResult SDK_CALLTYPE RemovePortrayal(const SDKString &portrayal_name, double version)=0
Removes installed portrayal.
sdk::vis::kPortrayalProperty_RootPath
@ kPortrayalProperty_RootPath
Path to the portrayal root folder.
Definition: portrayal_manager_interface.h:32
sdk::vis::IPortrayalLayer::DeleteDataSourceView
virtual SDKResult SDK_CALLTYPE DeleteDataSourceView(const DataSourceViewID &id)=0
Removes reference to data source view from portrayal line.
sdk::vis::IPortrayalManager::EnumPossiblePortrayalNames
virtual SDKResult SDK_CALLTYPE EnumPossiblePortrayalNames(const sdk::gdb::PRSP &prsp, EnumSDKStringSP &portrayal_names) const =0
Returns all available portrayals for the data with specified PRSP.
sdk::vis::IPortrayalManager::EnumAvailablePortrayals
virtual SDKResult SDK_CALLTYPE EnumAvailablePortrayals(IPortrayalsEnumeratorSP &portrayals) const =0
Returns enumerator of all known to the sdk portrayals.
sdk::vis::IPortrayalManager::GetPortrayalParameters
virtual SDKResult SDK_CALLTYPE GetPortrayalParameters(sdk::vis::IPortrayalParametersSP &portrayal_parameters) const =0
Returns the interface that manages the portrayal parameters.
sdk::vis::IPortrayalManager::SetPortrayalParameters
virtual SDKResult SDK_CALLTYPE SetPortrayalParameters(const sdk::vis::IPortrayalParametersSP &portrayal_parameters)=0
Sets a new portrayal parameters.
properties_interface.h
Object generic properties interface.
sdk::vis::IPortrayalManager::GetPortrayalLayer
virtual SDKResult SDK_CALLTYPE GetPortrayalLayer(const SDKString &portrayal_layer_name, IPortrayalLayerSP &portrayal_layer) const =0
Returns existing portrayal process pipeline.
sdk::vis::IPortrayalManager::CreatePortrayalLayer
virtual SDKResult SDK_CALLTYPE CreatePortrayalLayer(const SDKString &portrayal_layer_name, IPortrayalLayerSP &portrayal_layer)=0
Creates a new portrayal process pipeline.
sdk::vis::IPortrayalLayer
Allows to setup portrayal process pipeline.
Definition: portrayal_manager_interface.h:111
sdk::vis::kPortrayalLayerProperty_ThreadIndex
@ kPortrayalLayerProperty_ThreadIndex
Allows to set a thread for portrayal.
Definition: portrayal_manager_interface.h:105
sdk::vis::kPortrayalProperty_SymbolSetCatalogPath
@ kPortrayalProperty_SymbolSetCatalogPath
Path to the symbol set catalog file.
Definition: portrayal_manager_interface.h:33
sdk::vis::IPortrayalManager::RemovePortrayalLayer
virtual SDKResult SDK_CALLTYPE RemovePortrayalLayer(const SDKString &portrayal_layer_name)=0
Deletes specified portrayal process pipeline.
PRSP
SDKUInt32 PRSP
Product specification.
Definition: gdb_const.h:250
SDKResult
SDKInt32 SDKResult
Type of all error or return codes which SDK functions can end with.
Definition: sdk_results.h:17
gdb_const.h
Geo database constants and structures.
sdk::ISDKProperties
Provides access to members that control the properties.
Definition: properties_interface.h:32
sdk::vis::kPortrayalProperty_IsDefault
@ kPortrayalProperty_IsDefault
Portrayal installed with sdk is default one.
Definition: portrayal_manager_interface.h:31
SDKRefPtr
A smart pointer class for managing SDK components interface pointers.
Definition: sdk_ref_ptr.h:23
sdk::vis::kPortrayalProperty_FunctionSetRootPath
@ kPortrayalProperty_FunctionSetRootPath
Path to the main function set file.
Definition: portrayal_manager_interface.h:34
sdk::vis::DataSourceViewID
SDKUInt32 DataSourceViewID
Auto-generated Data source view identifier.
Definition: data_source_view_interface.h:33
sdk_component_interface.h
Common base SDK interfaces.
sdk::vis::IPortrayalsEnumerator::Reset
virtual SDKResult SDK_CALLTYPE Reset()=0
Resets enumeration.
sdk::vis::IPortrayalLayer::AddDataSourceView
virtual SDKResult SDK_CALLTYPE AddDataSourceView(const DataSourceViewID &id)=0
Adds reference to data source view to portrayal line.
sdk::vis::IPortrayalManager::SetCurrentPortrayalVersion
virtual SDKResult SDK_CALLTYPE SetCurrentPortrayalVersion(const SDKString &portrayal_name, double version)=0
Sets current portrayal.
ISDKComponent
Base interface for all SDK interfaces.
Definition: sdk_component_interface.h:41
sdk::vis::IPortrayalManager
Manages portrayal process and resources.
Definition: portrayal_manager_interface.h:43
sdk::vis::IPortrayalManager::InstallPortrayal
virtual SDKResult SDK_CALLTYPE InstallPortrayal(const SDKString &portrayal_path, SDKString *installed_path)=0
Install new portrayal from the specified location.
sdk::vis::PortrayalProperties
PortrayalProperties
Properties of portrayal resource.
Definition: portrayal_manager_interface.h:29
sdk::vis::IPortrayalManager::RegisterUserSymbolSet
virtual SDKResult SDK_CALLTYPE RegisterUserSymbolSet(const SDKString &portrayal_name, const SDKString &symbolset_path)=0
Sets additional symbols set which is registered after main one.
sdk::vis::IPortrayalsEnumerator
Allows to enumerate all available in the system portrayals.
Definition: portrayal_manager_interface.h:138
sdk::vis::IPortrayalsEnumerator::Next
virtual SDKResult SDK_CALLTYPE Next(SDKString &name, double &version, ISDKPropertiesSP &portrayal_props) const =0
Returns next portrayal info.
FWD_DECL_INTERFACE
FWD_DECL_INTERFACE(ILWEParserWrapper)
Provides a wrapper around the message parser to get, add or remove the.
sdk::vis::kMainChartPortrayalLayerName
static const wchar_t * kMainChartPortrayalLayerName
Chart layer name.
Definition: portrayal_manager_interface.h:39
sdk::vis::IPortrayalLayer::Clear
virtual SDKResult SDK_CALLTYPE Clear()=0
Removes reference to all data source views from portrayal line.
sdk::vis::IPortrayalManager::GetCurrentPortrayal
virtual SDKResult SDK_CALLTYPE GetCurrentPortrayal(const sdk::gdb::PRSP &prsp, SDKString &portrayal_name) const =0
Returns current portrayal for the data with specified PRSP.
sdk::vis::kPortrayalLayerProperty_IgnoreLUTDisplayScales
@ kPortrayalLayerProperty_IgnoreLUTDisplayScales
Do not use lookup entry display scale parameters.
Definition: portrayal_manager_interface.h:106
data_source_view_interface.h
Describes data-source view interface.