StormByte-Multimedia 3.3.2
C++26 multimedia processing module of the StormByte suite
Loading...
Searching...
No Matches
registry.hxx
Go to the documentation of this file.
1/*
2 * Copyright (C) 2024-2026 David C. Manuelda (StormBytePP)
3 *
4 * This file is part of StormByte-Multimedia.
5 *
6 * StormByte-Multimedia original source is dual-licensed:
7 *
8 * 1. GNU Lesser General Public License v3.0 (or later)
9 * You may redistribute and/or modify this file under the terms of the
10 * GNU Lesser General Public License as published by the Free Software
11 * Foundation, either version 3 of the License, or (at your option)
12 * any later version.
13 *
14 * 2. Commercial license
15 * Alternatively, this file may be used under the terms of a commercial
16 * license agreement with the copyright holder
17 * (David C. Manuelda <StormByte@gmail.com>).
18 *
19 * Both licenses apply only to original StormByte-Multimedia source in this
20 * file. Third-party components — including FFmpeg and embedded trained data —
21 * remain under their own licenses and are not covered by the commercial grant.
22 *
23 * A written StormByte commercial agreement may license this original source
24 * on terms other than the LGPL, including specific use, distribution or
25 * linking arrangements such as static linking, as stated in that agreement.
26 * It does not grant rights to dependencies or waive their license conditions.
27 * Enabling WITH_GPL or WITH_NONFREE may include components with separate
28 * obligations for modification, linking (static or dynamic), redistribution
29 * or works that incorporate them. The person modifying, linking, packaging or
30 * distributing the resulting work is responsible for determining and meeting
31 * all applicable requirements, including any needed patent permissions.
32 * A StormByte commercial agreement does not provide those rights for GPL or
33 * nonfree components.
34 *
35 * Neither license grants any patent rights. Any patent licenses required
36 * to use this software or third-party components must be obtained separately
37 * from the patent holders.
38 *
39 * StormByte-Multimedia is distributed in the hope that it will be useful,
40 * but WITHOUT ANY WARRANTY; without even the implied warranty of
41 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
42 * GNU Lesser General Public License for more details.
43 *
44 * You should have received a copy of the GNU Lesser General Public License
45 * version 3 along with StormByte-Multimedia. If not, see
46 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
47 *
48 * SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-StormByte-Commercial
49 */
50
51#pragma once
52
56#include <StormByte/safe/string.hxx>
57#include <StormByte/safe/unordered_map.hxx>
58#include <StormByte/safe/vector.hxx>
59#include <StormByte/size.hxx>
60
61#include <span>
62#include <string_view>
63
68namespace StormByte {
73 namespace Multimedia {
78 namespace Tables {
83 namespace Codec {
88 struct CodecDef;
89 }
90
95 namespace Container {
100 struct ContainerDef;
101 }
102 }
103
116 public:
121 Registry(const Registry& other) = delete;
122
127 Registry(Registry&& other) = delete;
128
132 ~Registry() noexcept;
133
139 Registry& operator=(const Registry& other) = delete;
140
146 Registry& operator=(Registry&& other) = delete;
147
153
161
168
175 ExpectedCodec FindCodec(std::string_view name) const;
176
183 ExpectedContainer FindContainer(std::string_view name) const;
184
185 private:
189 Registry();
190
194 void Initialize();
195
199 void Load();
200
204 void LoadCodecs();
205
211 void LoadCodecs(Type type, std::span<const Tables::Codec::CodecDef> table);
212
218 void Add(Type type, const Tables::Codec::CodecDef& def);
219
223 void LoadContainers();
224
229 void Add(const Tables::Container::ContainerDef& def);
230
236 Access ProbeContainer(const Tables::Container::ContainerDef& def) const noexcept;
237
244 void Resolve(const Tables::Container::ContainerDef& def, Container& container);
245
246 StormByte::Safe::Vector<StormByte::Safe::Shared<Codec>> m_codecs;
247 StormByte::Safe::UnorderedMap<StormByte::Safe::String, StormByte::Size> m_by_name;
248 StormByte::Safe::UnorderedMap<Type, StormByte::Size> m_by_type_start;
249 StormByte::Safe::UnorderedMap<Type, StormByte::Size> m_by_type_count;
250 StormByte::Safe::Vector<StormByte::Safe::Shared<Container>> m_containers;
251 StormByte::Safe::UnorderedMap<StormByte::Safe::String, StormByte::Size> m_container_by_name;
252 };
253 }
254}
255
STORMBYTE_DECLARE_MAYBE_SAFE(StormByte::Buffer::Bridge)
Bitmask of Operation flags for a codec.
Definition type.hxx:114
Immutable codec identity owned by Registry.
Definition codec.hxx:94
Immutable container identity owned by StormByte::Multimedia::Registry.
Definition container.hxx:84
ExpectedCodec FindCodec(std::string_view name) const
Looks up by StormByte name or FFmpeg codec id.
Registry(const Registry &other)=delete
Copy is disabled.
ExpectedContainer FindContainer(std::string_view name) const
Looks up by StormByte name or FFmpeg format id.
Registry(Registry &&other)=delete
Move is disabled.
ContainerRefs ContainerList() const
All loaded containers.
static Registry & Instance()
Process-wide instance.
CodecRefs CodecList(Type type) const
Codecs of one Type.
~Registry() noexcept
Destroys provider-owned storage in the multimedia library.
Multimedia module of the StormByte suite.
Codec identity table declarations.
Container identity table declarations.
Private codec and container identity table declarations.
Multimedia module of the StormByte suite.
Safe::Vector< CodecRef > CodecRefs
Safe-owned list of borrowed codecs, not codec ownership.
Definition typedefs.hxx:312
StormByte::Expected< ContainerRef, ContainerNotFoundException > ExpectedContainer
Result of FindContainer.
Definition typedefs.hxx:292
StormByte::Expected< CodecRef, CodecNotFoundException > ExpectedCodec
Result of FindCodec.
Definition typedefs.hxx:284
Safe::Vector< ContainerRef > ContainerRefs
Safe-owned list of borrowed containers, not container ownership.
Definition typedefs.hxx:320
Root namespace of the StormByte C++ suite.
STL namespace.
Codec identity table row.
Container identity table row.
#define STORMBYTE_MULTIMEDIA_PUBLIC
Definition visibility.h:61