Generic CVB physical device. More...

#include <cvb/device.hpp>

Inherits enable_shared_from_this< Device >.

Inherited by EmuDevice, GenICamDevice, , and VideoDevice.

Public Member Functions
void *	Handle () const noexcept
	Classic API device handle.

String	ResourceLocator () const noexcept
	Gets the access token or path of the file name including its extension.

DeviceControlPtr	DeviceControl () const
	Gets the DeviceControl interface if present.

DigitalIOPtr	DigitalIO () const
	Gets the DigitalIO interface if present.

SoftwareTriggerPtr	SoftwareTrigger () const
	Gets the SoftwareTrigger interface if present.

ImageRectPtr	ImageRect () const
	Gets the ImageRect interface if present.

virtual StreamPtr	Stream () const
	Get the stream for this device.

int	StreamCount () const noexcept
	Get the number of streams.

template<class T>
std::shared_ptr< T >	DeviceImage () const
	Gets, if available, the device image pointing to the last synchronized image.

DeviceImagePtr	DeviceImage () const
	Gets, if available, the device image pointing to the latest synchronized image.

NodeMapPtr	NodeMap (const String &name) const
	Gets the NodeMap with the given name.

std::map< String, NodeMapPtr >	NodeMaps () const
	Gets the dictionary holding all available NodeMaps.

NotifyObservablePtr	NotifyObservable (int id) const
	Get the observable for a given id.

Cvb::ConnectionState	ConnectionState () const noexcept
	brief Gets the current Cvb::ConnectionState of this Device object.

EventCookie	RegisterConnectionStateChangedEvent (std::function< void()> handler)
	Register a listener to the OnDisconnect event.

void	UnregisterConnectionStateChangedEvent (EventCookie eventCookie) noexcept
	Manually unregister a listener to the OnDisconnect event.

Detailed Description

Generic CVB physical device.

A device may provide an image stream or just expose a configuration interface.

See DeviceFactory for creating instances of this object.

Member Function Documentation

◆ DeviceControl()

Driver::DeviceControlPtr DeviceControl ( ) const

inline

Gets the DeviceControl interface if present.

Returns: Pointer object for accessing the interface; empty pointer if not available.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ DeviceImage() [1/2]

template<class T>

std::shared_ptr< T > DeviceImage ( ) const

inline

Gets, if available, the device image pointing to the last synchronized image.

Returns: Pointer to the device image (casted to the provided type).

Exceptions

Any	exception derived from std::exception including CvbException.

◆ DeviceImage() [2/2]

DeviceImagePtr DeviceImage ( ) const

inline

Gets, if available, the device image pointing to the latest synchronized image.

Returns: Pointer to the device image.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ DigitalIO()

Driver::DigitalIOPtr DigitalIO ( ) const

inline

Gets the DigitalIO interface if present.

Returns: Pointer object for accessing the interface; empty pointer if not available.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ Handle()

void * Handle ( ) const

inlinenoexcept

Classic API device handle.

Returns: Classic API handle.

Exceptions

Does	not throw any exception.

It is normally not necessary to work with this handle.

◆ ImageRect()

Driver::ImageRectPtr ImageRect ( ) const

inline

Gets the ImageRect interface if present.

Returns: Pointer object for accessing the interface; empty pointer if not available.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ NodeMap()

NodeMapPtr NodeMap ( const String & name ) const

inline

Gets the NodeMap with the given name.

Parameters

[in] name The NodeMap name (String or Cvb::NodeMapID).

Returns: A pointer to the NodeMap

Exceptions

Any	exception derived from std::exception including CvbException.

Example:: auto devices = Cvb::DeviceFactory::Discover(Cvb::DiscoverFlags::IgnoreVins);

auto device = Cvb::DeviceFactory::Open<Cvb::GenICamDevice>(devices.at(0).AccessToken(),

Cvb::AcquisitionStack::GenTL); auto deviceNodeMap = device->NodeMap(Cvb::NodeMapID::Device);

Cvb::DeviceFactory::Discover
static std::vector< DiscoveryInformation > Discover()
Discovers available devices (not vins) with a default time span of 300ms.
Definition decl_device_factory.hpp:209

Cvb::DeviceFactory::Open
static std::shared_ptr< T > Open(const String &provider, AcquisitionStack acquisitionStack=AcquisitionStack::PreferVin)
Opens a device with the given provider with its default board and port (if applicable).
Definition decl_device_factory.hpp:48

Cvb::Driver::NodeMapID::Device
static const Cvb::String Device
The name of the node map that represents the remote device, i.e. camera.
Definition driver.hpp:559

◆ NodeMaps()

std::map< String, NodeMapPtr > NodeMaps ( ) const

inline

Gets the dictionary holding all available NodeMaps.

Returns: Dictionary containing all available node maps. Empty if no node map interface is available on this device.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ NotifyObservable()

Driver::NotifyObservablePtr NotifyObservable ( int id ) const

inline

Get the observable for a given id.

Parameters

[in] id The observable id, which is device specific.

Returns: Pointer to the observabel object; empty pointer if not available.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ RegisterConnectionStateChangedEvent()

EventCookie RegisterConnectionStateChangedEvent ( std::function< void()> handler )

inline

Register a listener to the OnDisconnect event.

Parameters

[in] handler Listener, to the OnDisconnect event.

Returns: Event cookie, to manually unregister the listener.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ ResourceLocator()

String ResourceLocator ( ) const

inlinenoexcept

Gets the access token or path of the file name including its extension.

Returns: String containing the access token or rooted path for a file name.

Exceptions

Does	not throw any exception.

◆ SoftwareTrigger()

Driver::SoftwareTriggerPtr SoftwareTrigger ( ) const

inline

Gets the SoftwareTrigger interface if present.

Returns: Pointer object for accessing the interface; empty pointer if not available.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ Stream()

CVB_BEGIN_INLINE_NS Driver::StreamPtr Stream ( ) const

inlinevirtual

Get the stream for this device.

Note: This method is not supported by GenICamDevice.

Deprecated: This method is deprecated for all technologies providing a GenTL. Use the template version with ImageStream, PointCloudStream or CompositeStream instead.

Returns: Pointer to the stream object.

Exceptions

Any	exception derived from std::exception including CvbException.

Reimplemented in GenICamDevice, GenICamDevice, GenICamDevice, and GenICamDevice.

◆ StreamCount()

int StreamCount ( ) const

inlinenoexcept

Get the number of streams.

Note: Only a GenICamDevice can have more than one stream A NonStreamingDevice does not have a stream!

Returns: Number of streams.

Exceptions

Does	not throw any exception.

◆ UnregisterConnectionStateChangedEvent()

void UnregisterConnectionStateChangedEvent ( EventCookie eventCookie )

inlinenoexcept

Manually unregister a listener to the OnDisconnect event.

Parameters

[in] eventCookie Event cookie, obtained from registering the listener.

Exceptions

Does	not throw any exception.

Public Member Functions

Detailed Description

Member Function Documentation

◆ DeviceControl()

◆ DeviceImage() [1/2]

◆ DeviceImage() [2/2]

◆ DigitalIO()

◆ Handle()

◆ ImageRect()

◆ NodeMap()

◆ NodeMaps()

◆ NotifyObservable()

◆ RegisterConnectionStateChangedEvent()

◆ ResourceLocator()

◆ SoftwareTrigger()

◆ Stream()

◆ StreamCount()

◆ UnregisterConnectionStateChangedEvent()