StormByte C++ Library: Multimedia module 0.0.9999
StormByte-Multimedia is a StormByte library module for parsing configuration files
Loading...
Searching...
No Matches
tonemap.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 * Neither license grants any patent rights. Any patent licenses required
24 * to use this software or third-party components must be obtained separately
25 * from the patent holders.
26 *
27 * StormByte-Multimedia is distributed in the hope that it will be useful,
28 * but WITHOUT ANY WARRANTY; without even the implied warranty of
29 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
30 * GNU Lesser General Public License for more details.
31 *
32 * You should have received a copy of the GNU Lesser General Public License
33 * version 3 along with StormByte-Multimedia. If not, see
34 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
35 *
36 * SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-StormByte-Commercial
37 */
38
39#pragma once
40
41#include <StormByte/logger/log.hxx>
45
46#include <memory>
47#include <optional>
48#include <string>
49#include <string_view>
50
88 public:
95 Tonemap(std::shared_ptr<StormByte::Logger::Log> log,
96 std::optional<std::string> op = {}) noexcept;
97
98 Tonemap(const Tonemap& other) = delete;
99 Tonemap(Tonemap&& other) noexcept = delete;
100 ~Tonemap() noexcept override = default;
101 Tonemap& operator=(const Tonemap& other) = delete;
102 Tonemap& operator=(Tonemap&& other) noexcept = delete;
103
108 enum StormByte::Multimedia::Type Media() const noexcept override;
109
113 void Clean() noexcept override;
114
118 void Setup() noexcept override;
119
124 void Process(const Pipeline::Frame& frame) noexcept override;
125
129 void Eof() noexcept override;
130
131 private:
137 static bool NeedsMap(const StormByte::Multimedia::FFmpeg::AVFrame& src) noexcept;
138
144 std::string Chain(const StormByte::Multimedia::FFmpeg::AVFrame& src) const noexcept;
145
149 std::string_view Operator() const noexcept;
150
151 std::optional<std::string> m_opIn;
152 std::unique_ptr<StormByte::Multimedia::FFmpeg::AVFilterGraph> m_graph;
153 };
154}
FFmpeg(const FFmpeg &other)=delete
Copy is not allowed.
const StormByte::Multimedia::FFmpeg::AVFrame & AVFrame() const noexcept
Borrowed RAII handle of the current frame.
One-pass filter that mutates decoded frames.
Definition ffmpeg.hxx:753
void Process(const Pipeline::Frame &frame) noexcept override
Tone-maps one HDR frame to SDR and Save, or no-op.
enum StormByte::Multimedia::Type Media() const noexcept override
Media this filter handles.
Tonemap(std::shared_ptr< StormByte::Logger::Log > log, std::optional< std::string > op={}) noexcept
HDR → BT.709 SDR (tonemap).
void Eof() noexcept override
Drains a frame still held by the graph, if any.
void Setup() noexcept override
Resets the graph before the first frame.
void Clean() noexcept override
Drops the cached graph.
One decoded access unit.
Definition frame.hxx:81
Video leaves (Process and Analytics).
Definition frames.hxx:59
Demux / decode / filter / encode / mux types.
Public multimedia types: codecs, containers, streams and files.
Type
Kind of media stream or codec.
Definition type.hxx:55
#define STORMBYTE_MULTIMEDIA_PUBLIC
Imported symbol.
Definition visibility.h:47