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
|
/*
* 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 "libavutil/slicethread.h"
#include "swscale.h"
#include "utils.h"
/**
* Represents a view into a single field of frame data.
*/
typedef struct SwsImg {
enum AVPixelFormat fmt;
uint8_t *data[4]; /* points to y=0 */
int linesize[4];
} SwsImg;
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 SwsImg *out, const SwsImg *in,
int y, int h, const SwsPass *pass);
/**
* 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.
*/
SwsImg output;
/**
* Called once from the main thread before running the filter. Optional.
* `out` and `in` always point to the main image input/output, regardless
* of `input` and `output` fields.
*/
void (*setup)(const SwsImg *out, const SwsImg *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 */
int incomplete; /* set during init() if formats had to be inferred */
int noop; /* set during init() if the graph is a no-op */
/** 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 sws_graph_run */
struct {
const SwsPass *pass; /* current filter pass */
SwsImg input;
SwsImg output;
} exec;
} SwsGraph;
/**
* Allocate and initialize the filter graph. Returns 0 or a negative error.
*/
int sws_graph_create(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src,
int field, SwsGraph **out_graph);
/**
* Uninitialize any state associate with this filter graph and free it.
*/
void sws_graph_free(SwsGraph **graph);
/**
* Wrapper around sws_graph_create that does nothing if the format is
* unchanged. Must be called after changing any of the fields in `ctx`, or else
* they will have no effect.
*/
int sws_graph_reinit(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src,
int field, SwsGraph **graph);
/**
* Dispatch the filter graph on a single field. Internally threaded.
*/
void sws_graph_run(SwsGraph *graph, uint8_t *const out_data[4],
const int out_linesize[4],
const uint8_t *const in_data[4],
const int in_linesize[4]);
#endif /* SWSCALE_GRAPH_H */
|
