IDS peak genericC++  v1.4.3
peak_system_descriptor.hpp
Go to the documentation of this file.
1 
11 #pragma once
12 
13 
17 #include <peak/dll_interface/peak_dll_interface_util.hpp>
20 
21 #include <cstdint>
22 #include <functional>
23 #include <memory>
24 #include <string>
25 #include <vector>
26 
27 
28 namespace peak
29 {
30 namespace core
31 {
32 
33 class ProducerLibrary;
34 
43 {
44 public:
45  SystemDescriptor() = delete;
46  ~SystemDescriptor() override = default;
47  SystemDescriptor(const SystemDescriptor& other) = delete;
48  SystemDescriptor& operator=(const SystemDescriptor& other) = delete;
49  SystemDescriptor(SystemDescriptor&& other) = delete;
50  SystemDescriptor& operator=(SystemDescriptor&& other) = delete;
51 
53  std::string Key() const;
54 
88  RawInformation Info(int32_t infoCommand) const;
98  std::string DisplayName() const;
108  std::string VendorName() const;
118  std::string ModelName() const;
128  std::string Version() const;
138  std::string TLType() const;
148  std::string CTIFileName() const;
158  std::string CTIFullPath() const;
168  uint32_t GenTLVersionMajor() const;
178  uint32_t GenTLVersionMinor() const;
198  std::shared_ptr<ProducerLibrary> ParentLibrary() const;
209  std::shared_ptr<System> OpenSystem();
219  std::shared_ptr<System> OpenedSystem() const;
220 
221 private:
222  PEAK_MODULE_DESCRIPTOR_HANDLE ModuleDescriptorHandle() const override;
223 
224  friend ClassCreator<SystemDescriptor>;
226  PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, const std::weak_ptr<ProducerLibrary>& parentLibrary);
227  PEAK_SYSTEM_DESCRIPTOR_HANDLE m_backendHandle;
228 
229  std::weak_ptr<ProducerLibrary> m_parentLibrary;
230  std::weak_ptr<System> m_openedSystem;
231 
232  std::string m_key;
233 };
234 
235 } /* namespace core */
236 } /* namespace peak */
237 
238 /* Implementation */
239 namespace peak
240 {
241 namespace core
242 {
243 
245  PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, const std::weak_ptr<ProducerLibrary>& parentLibrary)
246  : m_backendHandle(systemDescriptorHandle)
247  , m_parentLibrary(parentLibrary)
248  , m_key(QueryStringFromCInterfaceFunction([&](char* key, size_t* keySize) {
249  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetKey(systemDescriptorHandle, key, keySize);
250  }))
251 {}
252 
253 inline std::string SystemDescriptor::Key() const
254 {
255  return m_key;
256 }
257 
258 inline RawInformation SystemDescriptor::Info(int32_t infoCommand) const
259 {
260  return QueryRawInformationFromCInterfaceFunction([&](int32_t* dataType, uint8_t* buffer, size_t* bufferSize) {
262  m_backendHandle, infoCommand, dataType, buffer, bufferSize);
263  });
264 }
265 
266 inline std::string SystemDescriptor::DisplayName() const
267 {
268  return QueryStringFromCInterfaceFunction([&](char* displayName, size_t* displayNameSize) {
270  m_backendHandle, displayName, displayNameSize);
271  });
272 }
273 
274 inline std::string SystemDescriptor::VendorName() const
275 {
276  return QueryStringFromCInterfaceFunction([&](char* vendorName, size_t* vendorNameSize) {
277  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetVendorName(m_backendHandle, vendorName, vendorNameSize);
278  });
279 }
280 
281 inline std::string SystemDescriptor::ModelName() const
282 {
283  return QueryStringFromCInterfaceFunction([&](char* modelName, size_t* modelNameSize) {
284  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetModelName(m_backendHandle, modelName, modelNameSize);
285  });
286 }
287 
288 inline std::string SystemDescriptor::Version() const
289 {
290  return QueryStringFromCInterfaceFunction([&](char* version, size_t* versionSize) {
291  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetVersion(m_backendHandle, version, versionSize);
292  });
293 }
294 
295 inline std::string SystemDescriptor::TLType() const
296 {
297  return QueryStringFromCInterfaceFunction([&](char* tlType, size_t* tlTypeSize) {
298  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetTLType(m_backendHandle, tlType, tlTypeSize);
299  });
300 }
301 
302 inline std::string SystemDescriptor::CTIFileName() const
303 {
304  return QueryStringFromCInterfaceFunction([&](char* ctiFileName, size_t* ctiFileNameSize) {
306  m_backendHandle, ctiFileName, ctiFileNameSize);
307  });
308 }
309 
310 inline std::string SystemDescriptor::CTIFullPath() const
311 {
312  return QueryStringFromCInterfaceFunction([&](char* ctiFullPath, size_t* ctiFullPathSize) {
314  m_backendHandle, ctiFullPath, ctiFullPathSize);
315  });
316 }
317 
318 inline uint32_t SystemDescriptor::GenTLVersionMajor() const
319 {
320  return QueryNumericFromCInterfaceFunction<uint32_t>([&](uint32_t* gentlVersionMajor) {
321  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetGenTLVersionMajor(m_backendHandle, gentlVersionMajor);
322  });
323 }
324 
325 inline uint32_t SystemDescriptor::GenTLVersionMinor() const
326 {
327  return QueryNumericFromCInterfaceFunction<uint32_t>([&](uint32_t* gentlVersionMinor) {
328  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_GetGenTLVersionMinor(m_backendHandle, gentlVersionMinor);
329  });
330 }
331 
333 {
334  return static_cast<peak::core::CharacterEncoding>(
335  QueryNumericFromCInterfaceFunction<PEAK_CHARACTER_ENCODING>(
336  [&](PEAK_CHARACTER_ENCODING* characterEncoding) {
338  m_backendHandle, characterEncoding);
339  }));
340 }
341 
342 inline std::shared_ptr<ProducerLibrary> SystemDescriptor::ParentLibrary() const
343 {
344  return LockOrThrow(m_parentLibrary);
345 }
346 
347 inline std::shared_ptr<System> SystemDescriptor::OpenSystem()
348 {
349  auto systemHandle = QueryNumericFromCInterfaceFunction<PEAK_SYSTEM_HANDLE>(
350  [&](PEAK_SYSTEM_HANDLE* _systemHandle) {
351  return PEAK_C_ABI_PREFIX PEAK_SystemDescriptor_OpenSystem(m_backendHandle, _systemHandle);
352  });
353 
354  auto system = std::make_shared<ClassCreator<System>>(systemHandle, m_parentLibrary);
355  m_openedSystem = system;
356  return system;
357 }
358 
359 inline std::shared_ptr<System> SystemDescriptor::OpenedSystem() const
360 {
361  return LockOrThrowOpenedModule(m_openedSystem);
362 }
363 
364 inline PEAK_MODULE_DESCRIPTOR_HANDLE SystemDescriptor::ModuleDescriptorHandle() const
365 {
366  auto moduleDescriptorHandle = QueryNumericFromCInterfaceFunction<PEAK_MODULE_DESCRIPTOR_HANDLE>(
367  [&](PEAK_MODULE_DESCRIPTOR_HANDLE* _moduleDescriptorHandle) {
369  m_backendHandle, _moduleDescriptorHandle);
370  });
371 
372  return moduleDescriptorHandle;
373 }
374 
375 } /* namespace core */
376 } /* namespace peak */
std::shared_ptr< System > OpenedSystem() const
Returns the System that was opened with this SystemDescriptor.
Definition: peak_system_descriptor.hpp:359
std::string Key() const
Returns the unique key.
Definition: peak_system_descriptor.hpp:253
PEAK_C_API PEAK_SystemDescriptor_GetCTIFullPath(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *ctiFullPath, size_t *ctiFullPathSize)
Asks the given system descriptor for its parent CTI&#39;s full path.
PEAK_C_API PEAK_SystemDescriptor_GetGenTLVersionMinor(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, uint32_t *gentlVersionMinor)
Asks the given system descriptor for the minor component of its GenTL version.
PEAK_C_API PEAK_SystemDescriptor_GetTLType(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *tlType, size_t *tlTypeSize)
Asks the given system descriptor for its TL type.
PEAK_C_API PEAK_SystemDescriptor_GetCharacterEncoding(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, PEAK_CHARACTER_ENCODING *characterEncoding)
Asks the given system descriptor for its character encoding.
The "peak" namespace directly contains convenience functionality like the DeviceManager as well as th...
Definition: peak_dynamic_loader.h:32
PEAK_C_API PEAK_SystemDescriptor_GetCTIFileName(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *ctiFileName, size_t *ctiFileNameSize)
Asks the given system descriptor for its parent CTI&#39;s file name.
~SystemDescriptor() override=default
PEAK_C_API PEAK_SystemDescriptor_GetInfo(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, int32_t infoCommand, int32_t *infoDataType, uint8_t *info, size_t *infoSize)
Asks the given system descriptor for an information based on a specific command.
PEAK_C_API PEAK_SystemDescriptor_GetVersion(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *version, size_t *versionSize)
Asks the given system descriptor for its version.
Encapsulates the GenTL functions associated with the GenTL System module&#39;s ID.
Definition: peak_system_descriptor.hpp:42
PEAK_C_API PEAK_SystemDescriptor_ToModuleDescriptor(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, PEAK_MODULE_DESCRIPTOR_HANDLE *moduleDescriptorHandle)
Casts the given system descriptor to a module descriptor.
std::shared_ptr< ProducerLibrary > ParentLibrary() const
Returns the parent library.
Definition: peak_system_descriptor.hpp:342
int32_t PEAK_CHARACTER_ENCODING
Definition: peak_backend.h:90
uint32_t GenTLVersionMajor() const
Returns the GenTL major version of the GenTL producer library this system belongs to...
Definition: peak_system_descriptor.hpp:318
std::shared_ptr< System > OpenSystem()
Opens the system.
Definition: peak_system_descriptor.hpp:347
PEAK_C_API PEAK_SystemDescriptor_OpenSystem(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, PEAK_SYSTEM_HANDLE *systemHandle)
Opens the system being associated with the given system descriptor.
struct PEAK_MODULE_DESCRIPTOR * PEAK_MODULE_DESCRIPTOR_HANDLE
Definition: peak_backend.h:397
std::string CTIFileName() const
Returns the file name of the GenTL producer library this system belongs to.
Definition: peak_system_descriptor.hpp:302
PEAK_C_API PEAK_SystemDescriptor_GetVendorName(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *vendorName, size_t *vendorNameSize)
Asks the given system descriptor for its vendor name.
PEAK_C_API PEAK_SystemDescriptor_GetKey(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *key, size_t *keySize)
Asks the given system descriptor for its key.
std::string VendorName() const
Returns the vendor name.
Definition: peak_system_descriptor.hpp:274
SystemDescriptor & operator=(const SystemDescriptor &other)=delete
PEAK_C_API PEAK_SystemDescriptor_GetGenTLVersionMajor(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, uint32_t *gentlVersionMajor)
Asks the given system descriptor for the major component of its GenTL version.
std::string TLType() const
Returns the TL (transport layer) type.
Definition: peak_system_descriptor.hpp:295
The base class for all openable modules.
Definition: peak_module_descriptor.hpp:30
struct PEAK_SYSTEM * PEAK_SYSTEM_HANDLE
Definition: peak_backend.h:353
struct PEAK_SYSTEM_DESCRIPTOR * PEAK_SYSTEM_DESCRIPTOR_HANDLE
Definition: peak_backend.h:349
RawInformation Info(int32_t infoCommand) const
Delivers information based on the given GenTL info command.
Definition: peak_system_descriptor.hpp:258
PEAK_C_API PEAK_SystemDescriptor_GetDisplayName(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *displayName, size_t *displayNameSize)
Asks the given system descriptor for its display name.
std::string CTIFullPath() const
Returns the full path of the GenTL producer library this system belongs to.
Definition: peak_system_descriptor.hpp:310
CharacterEncoding
Possible character encodings.
Definition: peak_common_system_enums.hpp:24
#define PEAK_C_ABI_PREFIX
Definition: peak_dll_defines.h:16
uint32_t GenTLVersionMinor() const
Returns the GenTL minor version of the GenTL producer library this system belongs to...
Definition: peak_system_descriptor.hpp:325
peak::core::CharacterEncoding CharacterEncoding() const
Returns the character encoding of the GenTL producer library this system belongs to.
Definition: peak_system_descriptor.hpp:332
The struct returned by all raw information functions.
Definition: peak_common_structs.hpp:24
PEAK_C_API PEAK_SystemDescriptor_GetModelName(PEAK_SYSTEM_DESCRIPTOR_HANDLE systemDescriptorHandle, char *modelName, size_t *modelNameSize)
Asks the given system descriptor for its model name.
std::string Version() const
Returns the version.
Definition: peak_system_descriptor.hpp:288
std::string DisplayName() const
Returns the display name.
Definition: peak_system_descriptor.hpp:266
std::string ModelName() const
Returns the model name.
Definition: peak_system_descriptor.hpp:281