1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
/*
* Copyright (C) 2024 Niklas Haas
*
* This file is part of FFmpeg.
*
* FFmpeg is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* FFmpeg is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with FFmpeg; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef SWSCALE_GRAPH_H
#define SWSCALE_GRAPH_H
#include <stdbool.h>
#include "libavutil/slicethread.h"
#include "libavutil/buffer.h"
#include "swscale.h"
#include "format.h"
static av_always_inline av_const int ff_fmt_vshift(enum AVPixelFormat fmt, int plane)
{
const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(fmt);
return (plane == 1 || plane == 2) ? desc->log2_chroma_h : 0;
}
typedef struct SwsPass SwsPass;
typedef struct SwsGraph SwsGraph;
/**
* Output `h` lines of filtered data. `out` and `in` point to the
* start of the image buffer for this pass.
*/
typedef void (*sws_filter_run_t)(const SwsFrame *out, const SwsFrame *in,
int y, int h, const SwsPass *pass);
/**
* Represents an allocated output buffer for a filter pass.
*/
typedef struct SwsPassBuffer {
SwsFrame frame;
int width, height; /* dimensions of this buffer */
AVFrame *avframe; /* backing storage for `frame` */
} SwsPassBuffer;
/**
* Represents a single filter pass in the scaling graph. Each filter will
* read from some previous pass's output, and write to a buffer associated
* with the pass (or into the final output image).
*/
struct SwsPass {
const SwsGraph *graph;
/**
* Filter main execution function. Called from multiple threads, with
* the granularity dictated by `slice_h`. Individual slices sent to `run`
* are always equal to (or smaller than, for the last slice) `slice_h`.
*/
sws_filter_run_t run;
enum AVPixelFormat format; /* new pixel format */
int width, height; /* new output size */
int slice_h; /* filter granularity */
int num_slices;
/**
* Filter input. This pass's output will be resolved to form this pass's.
* input. If NULL, the original input image is used.
*/
const SwsPass *input;
/**
* Filter output buffer. Allocated on demand and freed automatically.
*/
SwsPassBuffer *output; /* refstruct */
/**
* Called once from the main thread before running the filter. Optional.
*/
void (*setup)(const SwsFrame *out, const SwsFrame *in, const SwsPass *pass);
/**
* Optional private state and associated free() function.
*/
void (*free)(void *priv);
void *priv;
};
/**
* Filter graph, which represents a 'baked' pixel format conversion.
*/
typedef struct SwsGraph {
SwsContext *ctx;
AVSliceThread *slicethread;
int num_threads; /* resolved at init() time */
bool incomplete; /* set during init() if formats had to be inferred */
bool noop; /* set during init() if the graph is a no-op */
AVBufferRef *hw_frames_ref;
/** Sorted sequence of filter passes to apply */
SwsPass **passes;
int num_passes;
/**
* Cached copy of the public options that were used to construct this
* SwsGraph. Used only to detect when the graph needs to be reinitialized.
*/
SwsContext opts_copy;
/**
* Currently active format and processing parameters.
*/
SwsFormat src, dst;
int field;
/**
* Temporary execution state inside ff_sws_graph_run(); used to pass
* data to worker threads.
*/
struct {
const SwsPass *pass; /* current filter pass */
const SwsFrame *input; /* current filter pass input/output */
const SwsFrame *output;
} exec;
} SwsGraph;
/**
* Allocate and initialize the filter graph. Returns 0 or a negative error.
*/
int ff_sws_graph_create(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src,
int field, SwsGraph **out_graph);
/**
* Allocate and add a new pass to the filter graph.
*
* @param graph Filter graph to add the pass to.
* @param fmt Pixel format of the output image.
* @param w Width of the output image.
* @param h Height of the output image.
* @param input Previous pass to read from, or NULL for the input image.
* @param align Minimum slice alignment for this pass, or 0 for no threading.
* @param priv Private state for the filter run function.
* @param run Filter function to run.
* @param out_pass The newly added pass will be written here on success.
* @return 0 or a negative error code
*/
int ff_sws_graph_add_pass(SwsGraph *graph, enum AVPixelFormat fmt,
int width, int height, SwsPass *input,
int align, void *priv, sws_filter_run_t run,
SwsPass **out_pass);
/**
* Uninitialize any state associate with this filter graph and free it.
*/
void ff_sws_graph_free(SwsGraph **graph);
/**
* Update dynamic per-frame HDR metadata without requiring a full reinit.
*/
void ff_sws_graph_update_metadata(SwsGraph *graph, const SwsColor *color);
/**
* Wrapper around ff_sws_graph_create() that reuses the existing graph if the
* format is compatible. This will also update dynamic per-frame metadata.
* Must be called after changing any of the fields in `ctx`, or else they will
* have no effect.
*/
int ff_sws_graph_reinit(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src,
int field, SwsGraph **graph);
/**
* Dispatch the filter graph on a single field of the given frames. Internally
* threaded.
*/
void ff_sws_graph_run(SwsGraph *graph, const AVFrame *dst, const AVFrame *src);
#endif /* SWSCALE_GRAPH_H */
|
