drawutils.h
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
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
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  */
18 
19 #ifndef AVFILTER_DRAWUTILS_H
20 #define AVFILTER_DRAWUTILS_H
21 
22 /**
23  * @file
24  * misc drawing utilities
25  */
26 
27 #include <stdint.h>
28 #include "avfilter.h"
29 #include "libavutil/pixfmt.h"
30 
31 int ff_fill_rgba_map(uint8_t *rgba_map, enum AVPixelFormat pix_fmt);
32 
33 int ff_fill_line_with_color(uint8_t *line[4], int pixel_step[4], int w,
34  uint8_t dst_color[4],
35  enum AVPixelFormat pix_fmt, uint8_t rgba_color[4],
36  int *is_packed_rgba, uint8_t rgba_map[4]);
37 
38 void ff_draw_rectangle(uint8_t *dst[4], int dst_linesize[4],
39  uint8_t *src[4], int pixelstep[4],
40  int hsub, int vsub, int x, int y, int w, int h);
41 
42 void ff_copy_rectangle(uint8_t *dst[4], int dst_linesize[4],
43  uint8_t *src[4], int src_linesize[4], int pixelstep[4],
44  int hsub, int vsub, int x, int y, int y2, int w, int h);
45 
46 #define MAX_PLANES 4
47 
48 typedef struct FFDrawContext {
49  const struct AVPixFmtDescriptor *desc;
51  unsigned nb_planes;
52  int pixelstep[MAX_PLANES]; /*< offset between pixels */
53  uint8_t comp_mask[MAX_PLANES]; /*< bitmask of used non-alpha components */
54  uint8_t hsub[MAX_PLANES]; /*< horizontal subsampling */
55  uint8_t vsub[MAX_PLANES]; /*< vertical subsampling */
59 
60 typedef struct FFDrawColor {
61  uint8_t rgba[4];
62  union {
63  uint32_t u32;
64  uint16_t u16;
65  uint8_t u8[4];
66  } comp[MAX_PLANES];
67 } FFDrawColor;
68 
69 /**
70  * Init a draw context.
71  *
72  * Only a limited number of pixel formats are supported, if format is not
73  * supported the function will return an error.
74  * No flags currently defined.
75  * @return 0 for success, < 0 for error
76  */
77 int ff_draw_init(FFDrawContext *draw, enum AVPixelFormat format, unsigned flags);
78 
79 /**
80  * Prepare a color.
81  */
82 void ff_draw_color(FFDrawContext *draw, FFDrawColor *color, const uint8_t rgba[4]);
83 
84 /**
85  * Copy a rectangle from an image to another.
86  *
87  * The coordinates must be as even as the subsampling requires.
88  */
90  uint8_t *dst[], int dst_linesize[],
91  uint8_t *src[], int src_linesize[],
92  int dst_x, int dst_y, int src_x, int src_y,
93  int w, int h);
94 
95 /**
96  * Fill a rectangle with an uniform color.
97  *
98  * The coordinates must be as even as the subsampling requires.
99  * The color needs to be inited with ff_draw_color.
100  */
102  uint8_t *dst[], int dst_linesize[],
103  int dst_x, int dst_y, int w, int h);
104 
105 /**
106  * Blend a rectangle with an uniform color.
107  */
109  uint8_t *dst[], int dst_linesize[],
110  int dst_w, int dst_h,
111  int x0, int y0, int w, int h);
112 
113 /**
114  * Blend an alpha mask with an uniform color.
115  *
116  * @param draw draw context
117  * @param color color for the overlay;
118  * @param dst destination image
119  * @param dst_linesize line stride of the destination
120  * @param dst_w width of the destination image
121  * @param dst_h height of the destination image
122  * @param mask mask
123  * @param mask_linesize line stride of the mask
124  * @param mask_w width of the mask
125  * @param mask_h height of the mask
126  * @param l2depth log2 of depth of the mask (0 for 1bpp, 3 for 8bpp)
127  * @param endianness bit order of the mask (0: MSB to the left)
128  * @param x0 horizontal position of the overlay
129  * @param y0 vertical position of the overlay
130  */
132  uint8_t *dst[], int dst_linesize[], int dst_w, int dst_h,
133  uint8_t *mask, int mask_linesize, int mask_w, int mask_h,
134  int l2depth, unsigned endianness, int x0, int y0);
135 
136 /**
137  * Round a dimension according to subsampling.
138  *
139  * @param draw draw context
140  * @param sub_dir 0 for horizontal, 1 for vertical
141  * @param round_dir 0 nearest, -1 round down, +1 round up
142  * @param value value to round
143  * @return the rounded value
144  */
145 int ff_draw_round_to_sub(FFDrawContext *draw, int sub_dir, int round_dir,
146  int value);
147 
148 /**
149  * Return the list of pixel formats supported by the draw functions.
150  *
151  * The flags are the same as ff_draw_init, i.e., none currently.
152  */
154 
155 #endif /* AVFILTER_DRAWUTILS_H */
struct FFDrawContext FFDrawContext
#define MAX_PLANES
Definition: drawutils.h:46
uint16_t u16
Definition: drawutils.h:64
uint8_t hsub[MAX_PLANES]
Definition: drawutils.h:54
external API header
int ff_draw_init(FFDrawContext *draw, enum AVPixelFormat format, unsigned flags)
Init a draw context.
Definition: drawutils.c:135
output residual component w
struct FFDrawColor FFDrawColor
int ff_fill_line_with_color(uint8_t *line[4], int pixel_step[4], int w, uint8_t dst_color[4], enum AVPixelFormat pix_fmt, uint8_t rgba_color[4], int *is_packed_rgba, uint8_t rgba_map[4])
Definition: drawutils.c:52
AVFilterFormats * ff_draw_supported_pixel_formats(unsigned flags)
Return the list of pixel formats supported by the draw functions.
Definition: drawutils.c:501
uint8_t
static const uint32_t color[16+AV_CLASS_CATEGORY_NB]
Definition: log.c:77
void ff_draw_color(FFDrawContext *draw, FFDrawColor *color, const uint8_t rgba[4])
Prepare a color.
Definition: drawutils.c:179
uint8_t comp_mask[MAX_PLANES]
Definition: drawutils.h:53
enum AVPixelFormat pix_fmt
Definition: v4l.c:63
Discrete Time axis x
static const uint16_t mask[17]
Definition: lzw.c:37
Definition: graph2dot.c:48
uint8_t vsub_max
Definition: drawutils.h:57
uint32_t u32
Definition: drawutils.h:63
y2
Definition: lab5.m:34
void ff_blend_mask(FFDrawContext *draw, FFDrawColor *color, uint8_t *dst[], int dst_linesize[], int dst_w, int dst_h, uint8_t *mask, int mask_linesize, int mask_w, int mask_h, int l2depth, unsigned endianness, int x0, int y0)
Blend an alpha mask with an uniform color.
Definition: drawutils.c:429
AVS_Value src
Definition: avisynth_c.h:523
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:214
int ff_fill_rgba_map(uint8_t *rgba_map, enum AVPixelFormat pix_fmt)
Definition: drawutils.c:33
unsigned nb_planes
Definition: drawutils.h:51
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:55
uint8_t hsub_max
Definition: drawutils.h:56
double value
Definition: eval.c:82
void ff_copy_rectangle(uint8_t *dst[4], int dst_linesize[4], uint8_t *src[4], int src_linesize[4], int pixelstep[4], int hsub, int vsub, int x, int y, int y2, int w, int h)
Definition: drawutils.c:115
static int flags
Definition: cpu.c:23
void ff_blend_rectangle(FFDrawContext *draw, FFDrawColor *color, uint8_t *dst[], int dst_linesize[], int dst_w, int dst_h, int x0, int y0, int w, int h)
Blend a rectangle with an uniform color.
Definition: drawutils.c:331
function y
Definition: D.m:1
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:236
pixel format definitions
else dst[i][x+y *dst_stride[i]]
Definition: vf_mcdeint.c:160
int pixelstep[MAX_PLANES]
Definition: drawutils.h:52
A list of supported formats for one end of a filter link.
Definition: formats.h:64
const struct AVPixFmtDescriptor * desc
Definition: drawutils.h:49
void ff_draw_rectangle(uint8_t *dst[4], int dst_linesize[4], uint8_t *src[4], int pixelstep[4], int hsub, int vsub, int x, int y, int w, int h)
Definition: drawutils.c:95
uint8_t vsub[MAX_PLANES]
Definition: drawutils.h:55
static void comp(unsigned char *dst, int dst_stride, unsigned char *src, int src_stride, int add)
Definition: eamad.c:71
AVPixelFormat
Pixel format.
Definition: pixfmt.h:66
int ff_draw_round_to_sub(FFDrawContext *draw, int sub_dir, int round_dir, int value)
Round a dimension according to subsampling.
Definition: drawutils.c:489
enum AVPixelFormat format
Definition: drawutils.h:50