ts::InputSwitcher Class Reference

Implementation of the input plugin switcher. More...

#include <tsInputSwitcher.h>

Inheritance diagram for ts::InputSwitcher:

Collaboration diagram for ts::InputSwitcher:

Public Member Functions
	InputSwitcher (const InputSwitcherArgs &args, Report &report)
	Full session constructor.
	InputSwitcher (Report &report)
	Constructor.
	~InputSwitcher ()
	Destructor.
size_t	currentInput ()
	Get the index of the current input plugin.
bool	isStarted () const
	Check if the input switcher is started.
void	nextInput ()
	Switch to the next input plugin.
void	previousInput ()
	Switch to the previous input plugin.
Report &	report () const
	Get a reference to the report object for the input switcher.
void	setInput (size_t pluginIndex)
	Switch to another input plugin.
bool	start (const InputSwitcherArgs &args)
	Start the input switcher session.
void	stop ()
	Stop the input switcher.
bool	success () const
	Check if the session, when completely run in the constructor, was successful.
void	waitForTermination ()
	Suspend the calling thread until input switcher is completed.

Detailed Description

Implementation of the input plugin switcher.

This class is used by the tsswitch utility. It can also be used in other applications to switch between input plugins.

Constructor & Destructor Documentation

InputSwitcher() [1/2]

ts::InputSwitcher::InputSwitcher

(

Report &

report

)

Constructor.

This constructor does not start the session.

Parameters

[in,out]

report

Where to report errors, logs, etc. This object will be used concurrently by all plugin execution threads. Consequently, it must be thread-safe. For performance reasons, it should be asynchronous (see for instance class AsyncReport).

~InputSwitcher()

ts::InputSwitcher::~InputSwitcher

(

)

Destructor.

It waits for termination of the session if it is running.

InputSwitcher() [2/2]

ts::InputSwitcher::InputSwitcher	(	const InputSwitcherArgs &	args,
		Report &	report
	)

Full session constructor.

The complete input switching session is performed in this constructor. The constructor returns only when the input switcher session terminates or fails tp start.

Parameters

[in]	args	Arguments and options.
[in,out]	report	Where to report errors, logs, etc. This object will be used concurrently by all plugin execution threads. Consequently, it must be thread-safe. For performance reasons, it should be asynchronous (see for instance class AsyncReport).

Member Function Documentation

report()

Report & ts::InputSwitcher::report ( ) const

inline

Get a reference to the report object for the input switcher.

Returns

A reference to the report object for the input switcher.

start()

bool ts::InputSwitcher::start

(

const InputSwitcherArgs &

args

)

Start the input switcher session.

Parameters

[in]

args

Arguments and options.

Returns

True on success, false on failure to start.

isStarted()

bool ts::InputSwitcher::isStarted ( ) const

inline

Check if the input switcher is started.

Returns

True if the input switcher is in progress, false otherwise.

setInput()

void ts::InputSwitcher::setInput

(

size_t

pluginIndex

)

Switch to another input plugin.

Parameters

[in]

pluginIndex

Index of the new input plugin.

currentInput()

size_t ts::InputSwitcher::currentInput

(

)

Get the index of the current input plugin.

Returns

The index of the current input plugin.

success()

bool ts::InputSwitcher::success ( ) const

inline

Check if the session, when completely run in the constructor, was successful.

Returns

True on success, false on failure to start.

---

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

• tsInputSwitcher.h