NVIDIA DeepStream SDK API Reference

8.0 Release
deepstream::DataReceiver Class Reference

Detailed Description

A specific signal handler for consuming data.

Users must implement the IDataConsumer interface to create a data receiver. Data receiver can only be attached to elements that supports "new-sample" signal, typically an "appsink".

Definition at line 37 of file service-maker/includes/data_receiver.hpp.

Inheritance diagram for deepstream::DataReceiver:
Collaboration diagram for deepstream::DataReceiver:

Data Structures

class  IDataConsumer
 required interface for a data receiver More...
 

Public Member Functions

 DataReceiver (const std::string &name, IDataConsumer *consumer, unsigned int retries=0)
 Constructor. More...
 
 DataReceiver (const std::string &name, const char *factory, IDataConsumer *consumer, unsigned int retries=0)
 Constructor. More...
 
virtual ~DataReceiver ()
 Destructor. More...
 
int consume (Buffer buffer)
 Consume a buffer. More...
 
 DataReceiver (const std::string &name, IDataConsumer *consumer, unsigned int retries=0)
 Constructor. More...
 
 DataReceiver (const std::string &name, const char *factory, IDataConsumer *consumer, unsigned int retries=0)
 Constructor. More...
 
virtual ~DataReceiver ()
 Destructor. More...
 
int consume (Buffer buffer)
 Consume a buffer. More...
 
void * getCallbackFn (const std::string &name) const
 Return the callback for a specific signal. More...
 
void * getCallbackFn (const std::string &name) const
 Return the callback for a specific signal. More...
 
const std::string getName () const
 Return the name assigned during the construction. More...
 
const std::string getName () const
 Return the name assigned during the construction. More...
 
 operator bool () const noexcept
 Check if the object is void. More...
 
 operator bool () const noexcept
 Check if the object is void. More...
 
bool operator== (const Object &other) noexcept
 Check if the two objects are the same. More...
 
bool operator== (const Object &other) noexcept
 Check if the two objects are the same. More...
 
GstObjectgive ()
 Give up the ownership and return the opaque pointer. More...
 
GstObjectgive ()
 Give up the ownership and return the opaque pointer. More...
 
GstObjectgetGObject ()
 Return the opaque object pointer. More...
 
GstObjectgetGObject ()
 Return the opaque object pointer. More...
 
Objecttake (GstObject *object)
 Takes the ownership of a object through the opaque pointer. More...
 
Objecttake (GstObject *object)
 Takes the ownership of a object through the opaque pointer. More...
 
Objectseize (GstObject *object)
 Seize a opaque object to prevent it from being destroyed somewhere. More...
 
Objectseize (GstObject *object)
 Seize a opaque object to prevent it from being destroyed somewhere. More...
 
Objectset (const YAML::Node &params)
 Set the properties from key/value pairs in the yaml format. More...
 
Objectset (const std::string &name, const Value &value)
 
template<typename T , typename... Args>
Objectset (const std::string &name, const T &value, const Args &... args)
 
Objectset (const YAML::Node &params)
 Set the properties from key/value pairs in the yaml format. More...
 
Objectset (const std::string &name, const Value &value)
 
template<typename T , typename... Args>
Objectset (const std::string &name, const T &value, const Args &... args)
 
template<typename T , typename... Args>
ObjectgetProperty (const std::string &name, T &value, Args &... args)
 Template for getting multiple properties. More...
 
template<typename T , typename... Args>
ObjectgetProperty (const std::string &name, T &value, Args &... args)
 Template for getting multiple properties. More...
 
std::vector< std::string > listSignals (bool is_action)
 List all the supported signals from the object. More...
 
std::vector< std::string > listSignals (bool is_action)
 List all the supported signals from the object. More...
 
bool connectSignal (const std::string &signal_name, SignalHandler &handler)
 Connect a signal handler to the object. More...
 
bool connectSignal (const std::string &signal_name, SignalHandler &handler)
 Connect a signal handler to the object. More...
 
void emitSignal (const std::string &signal_name, va_list args)
 Emit a signal. More...
 
void emitSignal (const std::string &signal_name, va_list args)
 Emit a signal. More...
 

Static Public Member Functions

static unsigned long type ()
 Return the type id assigned to signal handler. More...
 
static unsigned long type ()
 Return the type id assigned to signal handler. More...
 

Protected Member Functions

virtual void set_ (const std::string &name, const Value &value)
 
virtual void set_ (const std::string &name, const YAML::Node &value)
 
virtual void set_ (const std::string &name, const Value &value)
 
virtual void set_ (const std::string &name, const YAML::Node &value)
 
virtual Value get_ (const std::string &name)
 
virtual Value get_ (const std::string &name)
 

Protected Attributes

std::unique_ptr< IDataConsumerdata_consumer_
 
unsigned int retries_
 
std::unique_ptr< IActionProviderprovider_
 
std::string param_spec_
 property spec in YAML format More...
 
std::map< std::string, Object::Valueproperties_
 property map More...
 
GstObjectobject_
 

Constructor & Destructor Documentation

◆ DataReceiver() [1/4]

deepstream::DataReceiver::DataReceiver ( const std::string &  name,
IDataConsumer consumer,
unsigned int  retries = 0 
)

Constructor.

Create a data reciver with a user implemented data provider interface

Parameters
[in]namename of the instance
[in]handlerimplementation of the IDataConsumer interface

◆ DataReceiver() [2/4]

deepstream::DataReceiver::DataReceiver ( const std::string &  name,
const char *  factory,
IDataConsumer consumer,
unsigned int  retries = 0 
)

Constructor.

Create a data reciver with a user implemented data provider interface

Parameters
[in]namename of the instance
[in]factoryname of the factory to create the instance
[in]handlerimplementation of the IDataConsumer interface

◆ ~DataReceiver() [1/2]

virtual deepstream::DataReceiver::~DataReceiver ( )
virtual

Destructor.

◆ DataReceiver() [3/4]

deepstream::DataReceiver::DataReceiver ( const std::string &  name,
IDataConsumer consumer,
unsigned int  retries = 0 
)

Constructor.

Create a data reciver with a user implemented data provider interface

Parameters
[in]namename of the instance
[in]handlerimplementation of the IDataConsumer interface

◆ DataReceiver() [4/4]

deepstream::DataReceiver::DataReceiver ( const std::string &  name,
const char *  factory,
IDataConsumer consumer,
unsigned int  retries = 0 
)

Constructor.

Create a data reciver with a user implemented data provider interface

Parameters
[in]namename of the instance
[in]factoryname of the factory to create the instance
[in]handlerimplementation of the IDataConsumer interface

◆ ~DataReceiver() [2/2]

virtual deepstream::DataReceiver::~DataReceiver ( )
virtual

Destructor.

Member Function Documentation

◆ connectSignal() [1/2]

bool deepstream::Object::connectSignal ( const std::string &  signal_name,
SignalHandler handler 
)
inherited

Connect a signal handler to the object.

Parameters
[in]signal_namename of the signal to be connected
[in]handlerhandler for the signal

◆ connectSignal() [2/2]

bool deepstream::Object::connectSignal ( const std::string &  signal_name,
SignalHandler handler 
)
inherited

Connect a signal handler to the object.

Parameters
[in]signal_namename of the signal to be connected
[in]handlerhandler for the signal

◆ consume() [1/2]

int deepstream::DataReceiver::consume ( Buffer  buffer)

Consume a buffer.

The method is called from the pipeline and invokes the its own IDataConsumer interface.

◆ consume() [2/2]

int deepstream::DataReceiver::consume ( Buffer  buffer)

Consume a buffer.

The method is called from the pipeline and invokes the its own IDataConsumer interface.

◆ emitSignal() [1/2]

void deepstream::Object::emitSignal ( const std::string &  signal_name,
va_list  args 
)
inherited

Emit a signal.

◆ emitSignal() [2/2]

void deepstream::Object::emitSignal ( const std::string &  signal_name,
va_list  args 
)
inherited

Emit a signal.

◆ get_() [1/2]

virtual Value deepstream::CustomObject::get_ ( const std::string &  name)
protectedvirtualinherited

Reimplemented from deepstream::Object.

◆ get_() [2/2]

virtual Value deepstream::CustomObject::get_ ( const std::string &  name)
protectedvirtualinherited

Reimplemented from deepstream::Object.

◆ getCallbackFn() [1/2]

void* deepstream::SignalHandler::getCallbackFn ( const std::string &  name) const
inherited

Return the callback for a specific signal.

◆ getCallbackFn() [2/2]

void* deepstream::SignalHandler::getCallbackFn ( const std::string &  name) const
inherited

Return the callback for a specific signal.

◆ getGObject() [1/2]

GstObject* deepstream::Object::getGObject ( )
inlineinherited

Return the opaque object pointer.

Definition at line 140 of file service-maker/includes/object.hpp.

References deepstream::Object::object_.

◆ getGObject() [2/2]

GstObject* deepstream::Object::getGObject ( )
inlineinherited

Return the opaque object pointer.

Definition at line 140 of file 9.0/service-maker/includes/object.hpp.

References deepstream::Object::object_.

◆ getName() [1/2]

const std::string deepstream::Object::getName ( ) const
inherited

Return the name assigned during the construction.

◆ getName() [2/2]

const std::string deepstream::Object::getName ( ) const
inherited

Return the name assigned during the construction.

◆ getProperty() [1/2]

template<typename T , typename... Args>
Object& deepstream::Object::getProperty ( const std::string &  name,
T &  value,
Args &...  args 
)
inlineinherited

Template for getting multiple properties.

Definition at line 171 of file 9.0/service-maker/includes/object.hpp.

References deepstream::Object::get_(), and deepstream::Object::getProperty().

◆ getProperty() [2/2]

template<typename T , typename... Args>
Object& deepstream::Object::getProperty ( const std::string &  name,
T &  value,
Args &...  args 
)
inlineinherited

◆ give() [1/2]

GstObject* deepstream::Object::give ( )
inherited

Give up the ownership and return the opaque pointer.

◆ give() [2/2]

GstObject* deepstream::Object::give ( )
inherited

Give up the ownership and return the opaque pointer.

◆ listSignals() [1/2]

std::vector<std::string> deepstream::Object::listSignals ( bool  is_action)
inherited

List all the supported signals from the object.

◆ listSignals() [2/2]

std::vector<std::string> deepstream::Object::listSignals ( bool  is_action)
inherited

List all the supported signals from the object.

◆ operator bool() [1/2]

deepstream::Object::operator bool ( ) const
inlineexplicitnoexceptinherited

Check if the object is void.

Definition at line 131 of file 9.0/service-maker/includes/object.hpp.

References deepstream::Object::object_.

◆ operator bool() [2/2]

deepstream::Object::operator bool ( ) const
inlineexplicitnoexceptinherited

Check if the object is void.

Definition at line 131 of file service-maker/includes/object.hpp.

References deepstream::Object::object_.

◆ operator==() [1/2]

bool deepstream::Object::operator== ( const Object other)
inlinenoexceptinherited

Check if the two objects are the same.

Definition at line 134 of file service-maker/includes/object.hpp.

References deepstream::Object::object_.

◆ operator==() [2/2]

bool deepstream::Object::operator== ( const Object other)
inlinenoexceptinherited

Check if the two objects are the same.

Definition at line 134 of file 9.0/service-maker/includes/object.hpp.

References deepstream::Object::object_.

◆ seize() [1/2]

Object& deepstream::Object::seize ( GstObject object)
inherited

Seize a opaque object to prevent it from being destroyed somewhere.

◆ seize() [2/2]

Object& deepstream::Object::seize ( GstObject object)
inherited

Seize a opaque object to prevent it from being destroyed somewhere.

◆ set() [1/6]

template<typename T , typename... Args>
Object& deepstream::Object::set ( const std::string &  name,
const T &  value,
const Args &...  args 
)
inlineinherited

◆ set() [2/6]

template<typename T , typename... Args>
Object& deepstream::Object::set ( const std::string &  name,
const T &  value,
const Args &...  args 
)
inlineinherited

◆ set() [3/6]

Object& deepstream::Object::set ( const std::string &  name,
const Value value 
)
inlineinherited

Definition at line 154 of file 9.0/service-maker/includes/object.hpp.

References deepstream::Object::set_().

◆ set() [4/6]

Object& deepstream::Object::set ( const std::string &  name,
const Value value 
)
inlineinherited

Definition at line 154 of file service-maker/includes/object.hpp.

References deepstream::Object::set_().

◆ set() [5/6]

Object& deepstream::Object::set ( const YAML::Node &  params)
inherited

Set the properties from key/value pairs in the yaml format.

Referenced by deepstream::Pipeline::add(), and deepstream::Object::set().

◆ set() [6/6]

Object& deepstream::Object::set ( const YAML::Node &  params)
inherited

Set the properties from key/value pairs in the yaml format.

◆ set_() [1/4]

virtual void deepstream::CustomObject::set_ ( const std::string &  name,
const Value value 
)
protectedvirtualinherited

Reimplemented from deepstream::Object.

◆ set_() [2/4]

virtual void deepstream::CustomObject::set_ ( const std::string &  name,
const Value value 
)
protectedvirtualinherited

Reimplemented from deepstream::Object.

◆ set_() [3/4]

virtual void deepstream::CustomObject::set_ ( const std::string &  name,
const YAML::Node &  value 
)
protectedvirtualinherited

Reimplemented from deepstream::Object.

◆ set_() [4/4]

virtual void deepstream::CustomObject::set_ ( const std::string &  name,
const YAML::Node &  value 
)
protectedvirtualinherited

Reimplemented from deepstream::Object.

◆ take() [1/2]

Object& deepstream::Object::take ( GstObject object)
inherited

Takes the ownership of a object through the opaque pointer.

◆ take() [2/2]

Object& deepstream::Object::take ( GstObject object)
inherited

Takes the ownership of a object through the opaque pointer.

◆ type() [1/2]

static unsigned long deepstream::SignalHandler::type ( )
staticinherited

Return the type id assigned to signal handler.

◆ type() [2/2]

static unsigned long deepstream::SignalHandler::type ( )
staticinherited

Return the type id assigned to signal handler.

Field Documentation

◆ data_consumer_

std::unique_ptr< IDataConsumer > deepstream::DataReceiver::data_consumer_
protected

Definition at line 95 of file service-maker/includes/data_receiver.hpp.

◆ object_

GstObject * deepstream::Object::object_
protectedinherited

◆ param_spec_

std::string deepstream::CustomObject::param_spec_
protectedinherited

property spec in YAML format

Definition at line 51 of file service-maker/includes/custom_object.hpp.

◆ properties_

std::map< std::string, Object::Value > deepstream::CustomObject::properties_
protectedinherited

property map

Definition at line 53 of file service-maker/includes/custom_object.hpp.

◆ provider_

std::unique_ptr< IActionProvider > deepstream::SignalHandler::provider_
protectedinherited

Definition at line 91 of file service-maker/includes/signal_handler.hpp.

◆ retries_

unsigned int deepstream::DataReceiver::retries_
protected

Definition at line 96 of file service-maker/includes/data_receiver.hpp.


The documentation for this class was generated from the following file: