FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
vf_tile.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012 Nicolas George
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 /**
22  * @file
23  * tile video filter
24  */
25 
26 #include "libavutil/opt.h"
27 #include "libavutil/pixdesc.h"
28 #include "avfilter.h"
29 #include "drawutils.h"
30 #include "formats.h"
31 #include "video.h"
32 #include "internal.h"
33 
34 typedef struct {
35  const AVClass *class;
36  unsigned w, h;
37  unsigned margin;
38  unsigned padding;
39  unsigned current;
40  unsigned nb_frames;
44  uint8_t rgba_color[4];
45 } TileContext;
46 
47 #define REASONABLE_SIZE 1024
48 
49 #define OFFSET(x) offsetof(TileContext, x)
50 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
51 
52 static const AVOption tile_options[] = {
53  { "layout", "set grid size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE,
54  {.str = "6x5"}, 0, 0, FLAGS },
55  { "nb_frames", "set maximum number of frame to render", OFFSET(nb_frames),
56  AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, FLAGS },
57  { "margin", "set outer border margin in pixels", OFFSET(margin),
58  AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1024, FLAGS },
59  { "padding", "set inner border thickness in pixels", OFFSET(padding),
60  AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1024, FLAGS },
61  { "color", "set the color of the unused area", OFFSET(rgba_color), AV_OPT_TYPE_COLOR, {.str = "black"}, .flags = FLAGS },
62  { NULL }
63 };
64 
66 
67 static av_cold int init(AVFilterContext *ctx)
68 {
69  TileContext *tile = ctx->priv;
70 
71  if (tile->w > REASONABLE_SIZE || tile->h > REASONABLE_SIZE) {
72  av_log(ctx, AV_LOG_ERROR, "Tile size %ux%u is insane.\n",
73  tile->w, tile->h);
74  return AVERROR(EINVAL);
75  }
76 
77  if (tile->nb_frames == 0) {
78  tile->nb_frames = tile->w * tile->h;
79  } else if (tile->nb_frames > tile->w * tile->h) {
80  av_log(ctx, AV_LOG_ERROR, "nb_frames must be less than or equal to %dx%d=%d\n",
81  tile->w, tile->h, tile->w * tile->h);
82  return AVERROR(EINVAL);
83  }
84 
85  return 0;
86 }
87 
89 {
91 }
92 
93 static int config_props(AVFilterLink *outlink)
94 {
95  AVFilterContext *ctx = outlink->src;
96  TileContext *tile = ctx->priv;
97  AVFilterLink *inlink = ctx->inputs[0];
98  const unsigned total_margin_w = (tile->w - 1) * tile->padding + 2*tile->margin;
99  const unsigned total_margin_h = (tile->h - 1) * tile->padding + 2*tile->margin;
100 
101  if (inlink->w > (INT_MAX - total_margin_w) / tile->w) {
102  av_log(ctx, AV_LOG_ERROR, "Total width %ux%u is too much.\n",
103  tile->w, inlink->w);
104  return AVERROR(EINVAL);
105  }
106  if (inlink->h > (INT_MAX - total_margin_h) / tile->h) {
107  av_log(ctx, AV_LOG_ERROR, "Total height %ux%u is too much.\n",
108  tile->h, inlink->h);
109  return AVERROR(EINVAL);
110  }
111  outlink->w = tile->w * inlink->w + total_margin_w;
112  outlink->h = tile->h * inlink->h + total_margin_h;
113  outlink->sample_aspect_ratio = inlink->sample_aspect_ratio;
114  outlink->frame_rate = av_mul_q(inlink->frame_rate,
115  av_make_q(1, tile->nb_frames));
116  ff_draw_init(&tile->draw, inlink->format, 0);
117  ff_draw_color(&tile->draw, &tile->blank, tile->rgba_color);
118 
119  outlink->flags |= FF_LINK_FLAG_REQUEST_LOOP;
120 
121  return 0;
122 }
123 
124 static void get_current_tile_pos(AVFilterContext *ctx, unsigned *x, unsigned *y)
125 {
126  TileContext *tile = ctx->priv;
127  AVFilterLink *inlink = ctx->inputs[0];
128  const unsigned tx = tile->current % tile->w;
129  const unsigned ty = tile->current / tile->w;
130 
131  *x = tile->margin + (inlink->w + tile->padding) * tx;
132  *y = tile->margin + (inlink->h + tile->padding) * ty;
133 }
134 
135 static void draw_blank_frame(AVFilterContext *ctx, AVFrame *out_buf)
136 {
137  TileContext *tile = ctx->priv;
138  AVFilterLink *inlink = ctx->inputs[0];
139  unsigned x0, y0;
140 
141  get_current_tile_pos(ctx, &x0, &y0);
142  ff_fill_rectangle(&tile->draw, &tile->blank,
143  out_buf->data, out_buf->linesize,
144  x0, y0, inlink->w, inlink->h);
145  tile->current++;
146 }
148 {
149  TileContext *tile = ctx->priv;
150  AVFilterLink *outlink = ctx->outputs[0];
151  AVFrame *out_buf = tile->out_ref;
152  int ret;
153 
154  while (tile->current < tile->nb_frames)
155  draw_blank_frame(ctx, out_buf);
156  ret = ff_filter_frame(outlink, out_buf);
157  tile->current = 0;
158  return ret;
159 }
160 
161 /* Note: direct rendering is not possible since there is no guarantee that
162  * buffers are fed to filter_frame in the order they were obtained from
163  * get_buffer (think B-frames). */
164 
165 static int filter_frame(AVFilterLink *inlink, AVFrame *picref)
166 {
167  AVFilterContext *ctx = inlink->dst;
168  TileContext *tile = ctx->priv;
169  AVFilterLink *outlink = ctx->outputs[0];
170  unsigned x0, y0;
171 
172  if (!tile->current) {
173  tile->out_ref = ff_get_video_buffer(outlink, outlink->w, outlink->h);
174  if (!tile->out_ref) {
175  av_frame_free(&picref);
176  return AVERROR(ENOMEM);
177  }
178  av_frame_copy_props(tile->out_ref, picref);
179  tile->out_ref->width = outlink->w;
180  tile->out_ref->height = outlink->h;
181 
182  /* fill surface once for margin/padding */
183  if (tile->margin || tile->padding)
184  ff_fill_rectangle(&tile->draw, &tile->blank,
185  tile->out_ref->data,
186  tile->out_ref->linesize,
187  0, 0, outlink->w, outlink->h);
188  }
189 
190  get_current_tile_pos(ctx, &x0, &y0);
191  ff_copy_rectangle2(&tile->draw,
192  tile->out_ref->data, tile->out_ref->linesize,
193  picref->data, picref->linesize,
194  x0, y0, 0, 0, inlink->w, inlink->h);
195 
196  av_frame_free(&picref);
197  if (++tile->current == tile->nb_frames)
198  return end_last_frame(ctx);
199 
200  return 0;
201 }
202 
203 static int request_frame(AVFilterLink *outlink)
204 {
205  AVFilterContext *ctx = outlink->src;
206  TileContext *tile = ctx->priv;
207  AVFilterLink *inlink = ctx->inputs[0];
208  int r;
209 
210  r = ff_request_frame(inlink);
211  if (r == AVERROR_EOF && tile->current)
212  r = end_last_frame(ctx);
213  return r;
214 }
215 
216 static const AVFilterPad tile_inputs[] = {
217  {
218  .name = "default",
219  .type = AVMEDIA_TYPE_VIDEO,
220  .filter_frame = filter_frame,
221  },
222  { NULL }
223 };
224 
225 static const AVFilterPad tile_outputs[] = {
226  {
227  .name = "default",
228  .type = AVMEDIA_TYPE_VIDEO,
229  .config_props = config_props,
230  .request_frame = request_frame,
231  },
232  { NULL }
233 };
234 
236  .name = "tile",
237  .description = NULL_IF_CONFIG_SMALL("Tile several successive frames together."),
238  .init = init,
239  .query_formats = query_formats,
240  .priv_size = sizeof(TileContext),
241  .inputs = tile_inputs,
242  .outputs = tile_outputs,
243  .priv_class = &tile_class,
244 };
AVFilterFormats * ff_draw_supported_pixel_formats(unsigned flags)
Return the list of pixel formats supported by the draw functions.
Definition: drawutils.c:530
#define NULL
Definition: coverity.c:32
This structure describes decoded (raw) audio or video data.
Definition: frame.h:171
void ff_copy_rectangle2(FFDrawContext *draw, uint8_t *dst[], int dst_linesize[], uint8_t *src[], int src_linesize[], int dst_x, int dst_y, int src_x, int src_y, int w, int h)
Copy a rectangle from an image to another.
Definition: drawutils.c:243
AVOption.
Definition: opt.h:255
static int request_frame(AVFilterLink *outlink)
Definition: vf_tile.c:203
static const AVFilterPad outputs[]
Definition: af_ashowinfo.c:248
Main libavfilter public API header.
uint8_t rgba_color[4]
Definition: vf_tile.c:44
unsigned padding
Definition: vf_tile.c:38
#define REASONABLE_SIZE
Definition: vf_tile.c:47
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
Definition: video.c:109
static int filter_frame(AVFilterLink *inlink, AVFrame *picref)
Definition: vf_tile.c:165
static AVRational av_make_q(int num, int den)
Create a rational.
Definition: rational.h:53
const char * name
Pad name.
Definition: internal.h:69
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:641
unsigned nb_frames
Definition: vf_tile.c:40
static int end_last_frame(AVFilterContext *ctx)
Definition: vf_tile.c:147
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1158
uint8_t
#define av_cold
Definition: attributes.h:74
AVOptions.
static int config_props(AVFilterLink *outlink)
Definition: vf_tile.c:93
AVRational av_mul_q(AVRational b, AVRational c)
Multiply two rationals.
Definition: rational.c:80
#define AVERROR_EOF
End of file.
Definition: error.h:55
static void get_current_tile_pos(AVFilterContext *ctx, unsigned *x, unsigned *y)
Definition: vf_tile.c:124
static const AVFilterPad tile_inputs[]
Definition: vf_tile.c:216
#define av_log(a,...)
A filter pad used for either input or output.
Definition: internal.h:63
int width
width and height of the video frame
Definition: frame.h:220
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
int ff_set_common_formats(AVFilterContext *ctx, AVFilterFormats *formats)
A helper for query_formats() which sets all links to the same list of formats.
Definition: formats.c:542
static void draw_blank_frame(AVFilterContext *ctx, AVFrame *out_buf)
Definition: vf_tile.c:135
#define AVERROR(e)
Definition: error.h:43
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:148
AVFILTER_DEFINE_CLASS(tile)
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:175
const char * r
Definition: vf_curves.c:107
void * priv
private data for use by the filter
Definition: avfilter.h:654
void ff_draw_color(FFDrawContext *draw, FFDrawColor *color, const uint8_t rgba[4])
Prepare a color.
Definition: drawutils.c:203
unsigned current
Definition: vf_tile.c:39
static int query_formats(AVFilterContext *ctx)
Definition: vf_tile.c:88
float y
static const AVFilterPad tile_outputs[]
Definition: vf_tile.c:225
static av_cold int init(AVFilterContext *ctx)
Definition: vf_tile.c:67
Frame requests may need to loop in order to be fulfilled.
Definition: internal.h:374
misc drawing utilities
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:199
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:470
static const AVFilterPad inputs[]
Definition: af_ashowinfo.c:239
const char * name
Filter name.
Definition: avfilter.h:474
int ff_draw_init(FFDrawContext *draw, enum AVPixelFormat format, unsigned flags)
Init a draw context.
Definition: drawutils.c:161
AVFrame * out_ref
Definition: vf_tile.c:43
offset must point to two consecutive integers
Definition: opt.h:232
unsigned h
Definition: vf_tile.c:36
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:648
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:182
unsigned w
Definition: vf_tile.c:36
#define FLAGS
Definition: vf_tile.c:50
unsigned margin
Definition: vf_tile.c:37
FFDrawColor blank
Definition: vf_tile.c:42
static const AVOption tile_options[]
Definition: vf_tile.c:52
void ff_fill_rectangle(FFDrawContext *draw, FFDrawColor *color, uint8_t *dst[], int dst_linesize[], int dst_x, int dst_y, int w, int h)
Fill a rectangle with an uniform color.
Definition: drawutils.c:265
An instance of a filter.
Definition: avfilter.h:633
int height
Definition: frame.h:220
AVFilter ff_vf_tile
Definition: vf_tile.c:235
int ff_request_frame(AVFilterLink *link)
Request an input frame from the filter at the other end of the link.
Definition: avfilter.c:343
internal API functions
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:553
#define OFFSET(x)
Definition: vf_tile.c:49
FFDrawContext draw
Definition: vf_tile.c:41