ImFusion SDK 4.3
CreateGroupedStereoImageStreamAlgorithm Class Reference

#include <ImFusion/Vision/CreateGroupedStereoImageStreamAlgorithm.h>

The algorithm creates a GroupedStereoImageStream from two image streams and takes over their control Before using any stereo-related algorithms (e.g., depth estimation, disparity calculation, or 3D reconstruction), it is recommended to first run this algorithm to convert the two image streams into a stereo image stream. More...

+ Inheritance diagram for CreateGroupedStereoImageStreamAlgorithm:

Detailed Description

The algorithm creates a GroupedStereoImageStream from two image streams and takes over their control Before using any stereo-related algorithms (e.g., depth estimation, disparity calculation, or 3D reconstruction), it is recommended to first run this algorithm to convert the two image streams into a stereo image stream.

The stereo image stream also handles synchronization between the two image streams. There are two ways to set input data: set them in the constructor Or use setOwningStereoData function

Public Member Functions

 CreateGroupedStereoImageStreamAlgorithm (std::unique_ptr< ImageStream > &&leftImageStream, std::unique_ptr< ImageStream > &&rightImageStream)
 
bool setOwningStereoData (std::unique_ptr< ImageStream > &&leftImageStream, std::unique_ptr< ImageStream > &&rightImageStream)
 Set input data if the algorithm is contructed with default constructor.
 
OwningDataList takeOutput () override
 Returns an OwningDataList containing the stream and sets m_isOutputTaken to true.
 
virtual void compute () override
 Execute the algorithm.
 
Streamstream () override
 Helper function to get access to GroupedStereoImageStream.
 
bool survivesDataDeletion (const Data *data) const override
 very important step: in controller if we remove the selected data, the algorithm will also be deleted we have to keep the algorithm alive Therefore this is the opposite of the default implementation
 
- Public Member Functions inherited from StreamAlgorithmBase
bool isOutputTaken () const
 
virtual DataGroupdataGroup ()
 
- Public Member Functions inherited from SignalReceiver
 SignalReceiver ()=default
 Default constructor.
 
 SignalReceiver (const SignalReceiver &other)
 Copy constructor, does not copy any existing signal connections from other.
 
SignalReceiveroperator= (SignalReceiver rhs)
 Assignment operator, disconnects all existing connections, does not copy any existing signal connections from rhs.
 
virtual ~SignalReceiver ()
 Virtual destructor disconnects from all connected signals.
 
- Public Member Functions inherited from Algorithm
 Algorithm ()
 Default constructor will registers a single "compute" action that calls compute() and returns status().
 
virtual void setProgress (Progress *progress)
 Sets a Progress interface the algorithm can use to notify observers about its computing progress.
 
Progressprogress () const
 Returns the progress interface if set.
 
virtual int status () const
 Indicates the status of the last call to compute().
 
const FactoryInfofactoryInfo () const
 Returns the record describing how this Algorithm was instantiated by the AlgorithmFactory.
 
void setFactoryInfo (const FactoryInfo &value)
 Sets the record describing how this Algorithm was instantiated by the AlgorithmFactory.
 
Status runAction (const std::string &id)
 Run the action with name id if it exists.
 
const std::vector< Action > & actions ()
 Get a mapping from Action id to Action as registered in this algorithm.
 
- Public Member Functions inherited from Configurable
virtual void configure (const Properties *p)
 Configure this object instance by de-serializing the given Properties.
 
virtual void configuration (Properties *p) const
 Serialize the current object configuration into the given Properties object.
 
virtual void configureDefaults ()
 Retrieve the properties of this object, replaces values with their defaults and sets it again.
 
void registerParameter (ParameterBase *param)
 Register the given Parameter or SubProperty, so that it will be configured during configure()/configuration().
 
void unregisterParameter (const ParameterBase *param)
 Remove the given Parameter or SubProperty from the list of registered parameters.
 
 Configurable (const Configurable &rhs)
 
 Configurable (Configurable &&rhs) noexcept
 
Configurableoperator= (const Configurable &)
 
Configurableoperator= (Configurable &&) noexcept
 

Static Public Member Functions

static bool createCompatible (const DataList &data, Algorithm **a=nullptr)
 
- Static Public Member Functions inherited from Algorithm
static bool createCompatible (const DataList &data, Algorithm **a=nullptr)
 Factory function to check algorithm compatibility with input data and optionally instantiate it.
 

Protected Member Functions

void resetStream () override
 Deletes the stream if m_isOutputTaken is false. In any case sets the stream to nullptr.
 
- Protected Member Functions inherited from SignalReceiver
void disconnectAll ()
 Disconnects all existing connections.
 
- Protected Member Functions inherited from Algorithm
void loadDefaults ()
 
void registerAction (const std::string &id, const std::string &guiName, const std::function< Algorithm::Status(void)> &action)
 Register an action to be run via runAction.
 
template<typename D>
void registerAction (const std::string &id, const std::string &guiName, Algorithm::Status(D::*action)(void))
 Template version of runAction that can be used with a pointer to a member function.
 
void registerAction (const Action &action)
 Register an action.
 

Additional Inherited Members

- Public Types inherited from Algorithm
enum  Status {
  Unknown = -1 , Success = 0 , Error = 1 , InvalidInput ,
  IncompleteInput , OutOfMemoryHost , OutOfMemoryGPU , UnsupportedGPU ,
  UnknownAction , AbortedByUser , User = 1000
}
 Status codes. More...
 
- Public Attributes inherited from Algorithm
Signal signalOutputChanged
 Signal should be emitted by Algorithms when their output/result has changed.
 
Signal signalParametersChanged
 Signal should be emitted by Algorithms when their parameter configuration has changed.
 
- Public Attributes inherited from Configurable
Signal signalParametersChanged
 Emitted whenever one of the registered Parameters' or SubPropertys' signalValueChanged signal was emitted.
 
- Protected Attributes inherited from StreamAlgorithmBase
bool m_isOutputTaken = false
 
- Protected Attributes inherited from Algorithm
std::string m_name
 Algorithm name.
 
Progressm_progress = nullptr
 Non-owing pointer to a progress interface. May be a nullptr.
 
FactoryInfo m_factoryInfo = {}
 Record describing how this algorithm was instantiated by the AlgorithmFactory.
 
int m_status = Status::Unknown
 Algorithm status after last call to compute()
 
std::vector< Actionm_actions
 Map of key given by the id of the action, of the available actions of this algorithm.
 
- Protected Attributes inherited from Configurable
std::vector< Paramm_params
 List of all registered Parameter and SubProperty instances.
 

Member Function Documentation

◆ takeOutput()

OwningDataList takeOutput ( )
overridevirtual

Returns an OwningDataList containing the stream and sets m_isOutputTaken to true.

If m_isOutputTaken is already true then an empty list is returned.

Reimplemented from StreamAlgorithmBase.

◆ compute()

virtual void compute ( )
overridevirtual

Execute the algorithm.

Implements Algorithm.

◆ stream()

Stream * stream ( )
inlineoverridevirtual

Helper function to get access to GroupedStereoImageStream.

Implements StreamAlgorithmBase.

◆ survivesDataDeletion()

bool survivesDataDeletion ( const Data * data) const
inlineoverridevirtual

very important step: in controller if we remove the selected data, the algorithm will also be deleted we have to keep the algorithm alive Therefore this is the opposite of the default implementation

Reimplemented from Algorithm.

◆ resetStream()

void resetStream ( )
inlineoverrideprotectedvirtual

Deletes the stream if m_isOutputTaken is false. In any case sets the stream to nullptr.

Implements StreamAlgorithmBase.


The documentation for this class was generated from the following file:
Search Tab / S to search, Esc to close