Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
19 /**
20  * @file
21  * Libavfilter multithreading support
22  */
24 #include "config.h"
26 #include "libavutil/common.h"
27 #include "libavutil/cpu.h"
28 #include "libavutil/mem.h"
29 #include "libavutil/thread.h"
30 #include "libavutil/slicethread.h"
32 #include "avfilter.h"
33 #include "internal.h"
34 #include "thread.h"
36 typedef struct ThreadContext {
41  /* per-execute parameters */
43  void *arg;
44  int *rets;
47 static void worker_func(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads)
48 {
49  ThreadContext *c = priv;
50  int ret = c->func(c->ctx, c->arg, jobnr, nb_jobs);
51  if (c->rets)
52  c->rets[jobnr] = ret;
53 }
56 {
58 }
61  void *arg, int *ret, int nb_jobs)
62 {
65  if (nb_jobs <= 0)
66  return 0;
67  c->ctx = ctx;
68  c->arg = arg;
69  c->func = func;
70  c->rets = ret;
72  avpriv_slicethread_execute(c->thread, nb_jobs, 0);
73  return 0;
74 }
76 static int thread_init_internal(ThreadContext *c, int nb_threads)
77 {
78  nb_threads = avpriv_slicethread_create(&c->thread, c, worker_func, NULL, nb_threads);
79  if (nb_threads <= 1)
81  return FFMAX(nb_threads, 1);
82 }
85 {
86  int ret;
88  if (graph->nb_threads == 1) {
89  graph->thread_type = 0;
90  return 0;
91  }
93  graph->internal->thread = av_mallocz(sizeof(ThreadContext));
94  if (!graph->internal->thread)
95  return AVERROR(ENOMEM);
97  ret = thread_init_internal(graph->internal->thread, graph->nb_threads);
98  if (ret <= 1) {
99  av_freep(&graph->internal->thread);
100  graph->thread_type = 0;
101  graph->nb_threads = 1;
102  return (ret < 0) ? ret : 0;
103  }
104  graph->nb_threads = ret;
108  return 0;
109 }
112 {
113  if (graph->internal->thread)
115  av_freep(&graph->internal->thread);
116 }
#define NULL
Definition: coverity.c:32
int thread_type
Type of multithreading allowed for filters in this graph.
Definition: avfilter.h:872
Main libavfilter public API header.
Memory handling functions.
static int thread_execute(AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
Definition: pthread.c:60
avfilter_action_func * func
Definition: pthread.c:39
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
Definition: mem.c:237
struct AVFilterGraph * graph
filtergraph this filter belongs to
Definition: avfilter.h:358
struct AVSliceThread AVSliceThread
Definition: slicethread.h:22
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
int nb_threads
Maximum number of threads used by filters in this graph.
Definition: avfilter.h:879
static void worker_func(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads)
Definition: pthread.c:47
#define FFMAX(a, b)
Definition: common.h:103
AVSliceThread * thread
Definition: pthread.c:38
void * arg
Definition: pthread.c:43
AVFilterGraph * graph
Definition: pthread.c:37
void ff_graph_thread_free(AVFilterGraph *graph)
Definition: pthread.c:111
void avpriv_slicethread_free(AVSliceThread **pctx)
Destroy slice threading context.
Definition: slicethread.c:250
int( avfilter_action_func)(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
A function pointer passed to the AVFilterGraph::execute callback to be executed multiple times...
Definition: avfilter.h:833
AVFilterGraphInternal * internal
Opaque object for libavfilter internal use.
Definition: avfilter.h:884
int avpriv_slicethread_create(AVSliceThread **pctx, void *priv, void(*worker_func)(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads), void(*main_func)(void *priv), int nb_threads)
Create slice threading context.
Definition: slicethread.c:236
static void slice_thread_uninit(ThreadContext *c)
Definition: pthread.c:55
void avpriv_slicethread_execute(AVSliceThread *ctx, int nb_jobs, int execute_main)
Execute slice threading.
Definition: slicethread.c:245
static int thread_init_internal(ThreadContext *c, int nb_threads)
Definition: pthread.c:76
common internal and external API header
avfilter_execute_func * thread_execute
Definition: internal.h:131
int ff_graph_thread_init(AVFilterGraph *graph)
Definition: pthread.c:84
An instance of a filter.
Definition: avfilter.h:341
int * rets
Definition: pthread.c:44
#define av_freep(p)
internal API functions
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
AVFilterContext * ctx
Definition: pthread.c:42