Skip to navigation

holoscan::InputPortConfigurator

Beta
View as Markdown
template <PublishedPayload T>

Configure cold authoring policy for one Graph-owned input port.

A configurator is a non-owning handle. It remains usable only while the originating Graph and exact port declaration remain live. Each successful call atomically updates cold authoring state; a rejected call leaves the port and its incident edges unchanged. Configurators do not make Graph authoring thread-safe, so callers must serialize them with all other reads and mutations of the same Graph.

#include <holoscan/graph.hpp>

Template parameters

T
PublishedPayload

Exact published payload type of the input declaration.


Constructors

InputPortConfigurator

std::weak_ptr<detail::GraphState> state,
std::shared_ptr<const void> handle_identity
) noexcept

Methods

queue_depth

InputPortConfigurator & holoscan::InputPortConfigurator<T>::queue_depth(
std::uint32_t depth
)

Override the finite input history depth.

Returns: This configurator for fluent authoring.

Throws: RuntimeError if depth is zero or the source Graph is unavailable.

Parameters

depth
std::uint32_t

Positive number of samples retained for this logical input.

expects_tensor

InputPortConfigurator & holoscan::InputPortConfigurator<T>::expects_tensor(
const TensorInputSpec &spec
)

Override this input with one common consumer Tensor spec.

Returns: This configurator for fluent authoring.

Parameters

spec
const TensorInputSpec &

Representation, finite bounds, and conversion requirements.

diagnostic_alias

InputPortConfigurator & holoscan::InputPortConfigurator<T>::diagnostic_alias(
std::string_view alias
)

Assign an owned diagnostic alias without changing port identity.

Returns: This configurator for fluent authoring.

Throws: RuntimeError if alias is invalid or the source Graph is unavailable.

Parameters

alias
std::string_view

Nonempty bounded UTF-8 alias copied before return.

state

std::shared_ptr<detail::GraphState> holoscan::InputPortConfigurator<T>::state() const

apply

static void holoscan::InputPortConfigurator<T>::apply(
expected<void, Error> result
)

Types

Typedefs

NameDefinitionDescription
graph_authoring_handle_tagvoidOpt this authoring handle out of replayable Graph captures.

Member variables

NameTypeDescription
state_std::weak_ptr< detail::GraphState >
port_GraphPortId
handle_identity_std::shared_ptr< const void >