FFmpeg
ops_backend.c
Go to the documentation of this file.
1 /**
2  * Copyright (C) 2025 Niklas Haas
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #include "ops_backend.h"
22 
23 #if AV_GCC_VERSION_AT_LEAST(4, 4)
24 #pragma GCC optimize ("finite-math-only")
25 #endif
26 
27 /* Array-based reference implementation */
28 
29 #ifndef SWS_BLOCK_SIZE
30 # define SWS_BLOCK_SIZE 32
31 #endif
32 
33 typedef uint8_t u8block_t[SWS_BLOCK_SIZE];
34 typedef uint16_t u16block_t[SWS_BLOCK_SIZE];
35 typedef uint32_t u32block_t[SWS_BLOCK_SIZE];
36 typedef float f32block_t[SWS_BLOCK_SIZE];
37 
38 #define BIT_DEPTH 8
39 # include "ops_tmpl_int.c"
40 #undef BIT_DEPTH
41 
42 #define BIT_DEPTH 16
43 # include "ops_tmpl_int.c"
44 #undef BIT_DEPTH
45 
46 #define BIT_DEPTH 32
47 # include "ops_tmpl_int.c"
48 # include "ops_tmpl_float.c"
49 #undef BIT_DEPTH
50 
51 static const SwsOpTable *const tables[] = {
52  &bitfn(op_table_int, u8),
53  &bitfn(op_table_int, u16),
54  &bitfn(op_table_int, u32),
55  &bitfn(op_table_float, f32),
56 };
57 
59 {
60  int ret;
61 
63  if (!chain)
64  return AVERROR(ENOMEM);
65 
66  av_assert0(ops->num_ops > 0);
67  const SwsPixelType read_type = ops->ops[0].type;
68 
69  /* Make on-stack copy of `ops` to iterate over */
70  SwsOpList rest = *ops;
71  do {
73  SWS_BLOCK_SIZE, chain);
74  } while (ret == AVERROR(EAGAIN));
75 
76  if (ret < 0) {
77  ff_sws_op_chain_free(chain);
78  if (rest.num_ops < ops->num_ops) {
79  av_log(ctx, AV_LOG_TRACE, "Uncompiled remainder:\n");
81  }
82  return ret;
83  }
84 
85  *out = (SwsCompiledOp) {
86  .slice_align = 1,
87  .block_size = SWS_BLOCK_SIZE,
88  .cpu_flags = chain->cpu_flags,
89  .priv = chain,
91  };
92 
93  switch (read_type) {
94  case SWS_PIXEL_U8: out->func = process_u8; break;
95  case SWS_PIXEL_U16: out->func = process_u16; break;
96  case SWS_PIXEL_U32: out->func = process_u32; break;
97  case SWS_PIXEL_F32: out->func = process_f32; break;
98  default: av_unreachable("Invalid pixel type!");
99  }
100 
101  return 0;
102 }
103 
105  .name = "c",
106  .compile = compile,
107  .hw_format = AV_PIX_FMT_NONE,
108 };
SwsOpTable
Definition: ops_chain.h:125
compile
static int compile(SwsContext *ctx, SwsOpList *ops, SwsCompiledOp *out)
Definition: ops_backend.c:58
SWS_PIXEL_U16
@ SWS_PIXEL_U16
Definition: ops.h:33
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
ops_backend.h
f32block_t
float f32block_t[SWS_BLOCK_SIZE]
Definition: ops_backend.c:36
out
static FILE * out
Definition: movenc.c:55
backend_c
const SwsOpBackend backend_c
Copyright (C) 2025 Niklas Haas.
Definition: ops_backend.c:104
SWS_PIXEL_U32
@ SWS_PIXEL_U32
Definition: ops.h:34
SwsOpBackend::name
const char * name
Definition: ops_internal.h:56
SwsOpChain::cpu_flags
int cpu_flags
Definition: ops_chain.h:87
SwsPixelType
SwsPixelType
Copyright (C) 2025 Niklas Haas.
Definition: ops.h:30
ff_sws_op_list_print
void ff_sws_op_list_print(void *log, int lev, int lev_extra, const SwsOpList *ops)
Print out the contents of an operation list.
Definition: ops.c:754
SWS_PIXEL_F32
@ SWS_PIXEL_F32
Definition: ops.h:35
SwsOpList::num_ops
int num_ops
Definition: ops.h:226
SWS_PIXEL_U8
@ SWS_PIXEL_U8
Definition: ops.h:32
AV_LOG_TRACE
#define AV_LOG_TRACE
Extremely verbose debugging, useful for libav* development.
Definition: log.h:236
FF_ARRAY_ELEMS
#define FF_ARRAY_ELEMS(a)
Definition: sinewin_tablegen.c:29
u8block_t
uint8_t u8block_t[SWS_BLOCK_SIZE]
Definition: ops_backend.c:33
ff_sws_op_chain_alloc
SwsOpChain * ff_sws_op_chain_alloc(void)
Definition: ops_chain.c:29
u16block_t
uint16_t u16block_t[SWS_BLOCK_SIZE]
Definition: ops_backend.c:34
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:42
ctx
static AVFormatContext * ctx
Definition: movenc.c:49
u32block_t
uint32_t u32block_t[SWS_BLOCK_SIZE]
Definition: ops_backend.c:35
bitfn
#define bitfn(name, ext)
Definition: ops_backend.h:65
SwsOpBackend
Definition: ops_internal.h:55
ops_tmpl_int.c
SWS_BLOCK_SIZE
#define SWS_BLOCK_SIZE
Copyright (C) 2025 Niklas Haas.
Definition: ops_backend.c:30
SwsOpChain
Compiled "chain" of operations, which can be dispatched efficiently.
Definition: ops_chain.h:82
ff_sws_op_compile_tables
int ff_sws_op_compile_tables(const SwsOpTable *const tables[], int num_tables, SwsOpList *ops, const int block_size, SwsOpChain *chain)
"Compile" a single op by looking it up in a list of fixed size op tables.
Definition: ops_chain.c:196
av_unreachable
#define av_unreachable(msg)
Asserts that are used as compiler optimization hints depending upon ASSERT_LEVEL and NBDEBUG.
Definition: avassert.h:116
ops_tmpl_float.c
SwsOp::type
SwsPixelType type
Definition: ops.h:190
ff_sws_op_chain_free_cb
void ff_sws_op_chain_free_cb(void *ptr)
Definition: ops_chain.c:34
SwsOpChain::free
void(* free[SWS_MAX_OPS+1])(void *)
Definition: ops_chain.h:85
ff_sws_op_chain_free
static void ff_sws_op_chain_free(SwsOpChain *chain)
Definition: ops_chain.h:92
SwsOpList::ops
SwsOp * ops
Definition: ops.h:225
ret
ret
Definition: filter_design.txt:187
SwsCompiledOp
Definition: ops_dispatch.h:75
tables
static const SwsOpTable *const tables[]
Definition: ops_backend.c:51
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:72
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
SwsOpList
Helper struct for representing a list of operations.
Definition: ops.h:224
SwsContext
Main external API structure.
Definition: swscale.h:191