StormByte-Multimedia 3.3.2
C++26 multimedia processing module of the StormByte suite
Loading...
Searching...
No Matches
StormByte::Multimedia::Registry Class Reference

Process-wide catalog of codecs and containers. More...

#include <StormByte/multimedia/registry.hxx>

Public Member Functions

 Registry (const Registry &other)=delete
 Copy is disabled.
 Registry (Registry &&other)=delete
 Move is disabled.
 ~Registry () noexcept
 Destroys provider-owned storage in the multimedia library.
Registry & operator= (const Registry &other)=delete
 Copy assignment is disabled.
Registry & operator= (Registry &&other)=delete
 Move assignment is disabled.
CodecRefs CodecList (Type type) const
 Codecs of one Type.
ContainerRefs ContainerList () const
 All loaded containers.
ExpectedCodec FindCodec (std::string_view name) const
 Looks up by StormByte name or FFmpeg codec id.
ExpectedContainer FindContainer (std::string_view name) const
 Looks up by StormByte name or FFmpeg format id.

Static Public Member Functions

static Registry & Instance ()
 Process-wide instance.

Detailed Description

Process-wide catalog of codecs and containers.

First Instance() loads the private tables and probes FFmpeg. Initialization, lookup and list snapshots may allocate and propagate allocation failures. A failed initialization can be retried.

Note
Conditional DLL safety requires compatible compiler, standard-library ABI and provider layout. The singleton and its borrowed identities must not be destroyed by callers; the multimedia provider must remain loaded during use.

Constructor & Destructor Documentation

◆ Registry() [1/2]

StormByte::Multimedia::Registry::Registry ( const Registry & other)
delete

Copy is disabled.

Parameters
otherSource registry.

◆ Registry() [2/2]

StormByte::Multimedia::Registry::Registry ( Registry && other)
delete

Move is disabled.

Parameters
otherSource registry.

◆ ~Registry()

StormByte::Multimedia::Registry::~Registry ( )
noexcept

Destroys provider-owned storage in the multimedia library.

Member Function Documentation

◆ CodecList()

CodecRefs StormByte::Multimedia::Registry::CodecList ( Type type) const

Codecs of one Type.

Parameters
typeKind to list.
Returns
Safe-owned list of nonempty handles into registry storage.
Note
Handles do not own codecs and expire at registry teardown or unload.

◆ ContainerList()

ContainerRefs StormByte::Multimedia::Registry::ContainerList ( ) const

All loaded containers.

Returns
Safe-owned list of nonempty handles into registry storage.
Note
Handles do not own containers and expire at registry teardown or unload.

◆ FindCodec()

ExpectedCodec StormByte::Multimedia::Registry::FindCodec ( std::string_view name) const

Looks up by StormByte name or FFmpeg codec id.

Parameters
nameKey (H.265 or hevc).
Returns
Nonempty borrowed CodecRef or CodecNotFoundException.
Note
The codec remains registry-owned and expires at registry teardown or unload.

◆ FindContainer()

ExpectedContainer StormByte::Multimedia::Registry::FindContainer ( std::string_view name) const

Looks up by StormByte name or FFmpeg format id.

Parameters
nameKey (Matroska or matroska).
Returns
Nonempty borrowed ContainerRef or ContainerNotFoundException.
Note
The container remains registry-owned and expires at registry teardown or unload.

◆ Instance()

Registry & StormByte::Multimedia::Registry::Instance ( )
static

Process-wide instance.

Returns
The singleton.

◆ operator=() [1/2]

Registry & StormByte::Multimedia::Registry::operator= ( const Registry & other)
delete

Copy assignment is disabled.

Parameters
otherSource registry.
Returns
*this.

◆ operator=() [2/2]

Registry & StormByte::Multimedia::Registry::operator= ( Registry && other)
delete

Move assignment is disabled.

Parameters
otherSource registry.
Returns
*this.

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