Mercurial > libavcore.hg
annotate imgutils.h @ 16:1a1faa090ff1 libavcore
Implement inline function av_fill_image_max_pixstep() and use it for
factorizing code.
author | stefano |
---|---|
date | Wed, 18 Aug 2010 21:02:38 +0000 |
parents | 665cb0c97133 |
children | 046c1e516605 |
rev | line source |
---|---|
8
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
1 /* |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
2 * This file is part of FFmpeg. |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
3 * |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
4 * FFmpeg is free software; you can redistribute it and/or |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
5 * modify it under the terms of the GNU Lesser General Public |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
6 * License as published by the Free Software Foundation; either |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
7 * version 2.1 of the License, or (at your option) any later version. |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
8 * |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
9 * FFmpeg is distributed in the hope that it will be useful, |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
12 * Lesser General Public License for more details. |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
13 * |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
14 * You should have received a copy of the GNU Lesser General Public |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
15 * License along with FFmpeg; if not, write to the Free Software |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
17 */ |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
18 |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
19 #ifndef AVCORE_IMGUTILS_H |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
20 #define AVCORE_IMGUTILS_H |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
21 |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
22 /** |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
23 * @file |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
24 * misc image utilities |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
25 */ |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
26 |
16
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
27 #include "libavutil/pixdesc.h" |
8
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
28 #include "avcore.h" |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
29 |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
30 /** |
16
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
31 * Compute the max pixel step for each plane of an image with a |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
32 * format described by pixdesc |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
33 * |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
34 * The pixel step is the distance in bytes between the first byte of |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
35 * the group of bytes which describe a pixel component and the first |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
36 * byte of the successive group in the same plane for the same |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
37 * component. |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
38 * |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
39 * @param max_pixstep an array which is filled with the max pixel step |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
40 * for each plane. Since a plane may contain different pixel |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
41 * components, the computed max_pixstep[plane] is relative to the |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
42 * component in the plane with the max pixel step. |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
43 * @param max_pixstep_comp an array which is filled with the component |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
44 * for each plane which has the max pixel step. May be NULL. |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
45 */ |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
46 static inline void av_fill_image_max_pixstep(int max_pixstep[4], int max_pixstep_comp[4], |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
47 const AVPixFmtDescriptor *pixdesc) |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
48 { |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
49 int i; |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
50 memset(max_pixstep, 0, 4*sizeof(max_pixstep[0])); |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
51 if (max_pixstep_comp) |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
52 memset(max_pixstep_comp, 0, 4*sizeof(max_pixstep_comp[0])); |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
53 |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
54 for (i = 0; i < 4; i++) { |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
55 const AVComponentDescriptor *comp = &(pixdesc->comp[i]); |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
56 if ((comp->step_minus1+1) > max_pixstep[comp->plane]) { |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
57 max_pixstep[comp->plane] = comp->step_minus1+1; |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
58 if (max_pixstep_comp) |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
59 max_pixstep_comp[comp->plane] = i; |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
60 } |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
61 } |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
62 } |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
63 |
1a1faa090ff1
Implement inline function av_fill_image_max_pixstep() and use it for
stefano
parents:
15
diff
changeset
|
64 /** |
15 | 65 * Compute the size of an image line with format pix_fmt and width |
66 * width for the plane plane. | |
67 * | |
68 * @return the computed size in bytes | |
69 */ | |
70 int av_get_image_linesize(enum PixelFormat pix_fmt, int width, int plane); | |
71 | |
72 /** | |
8
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
73 * Fill plane linesizes for an image with pixel format pix_fmt and |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
74 * width width. |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
75 * |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
76 * @param linesizes array to be filled with the linesize for each plane |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
77 * @return >= 0 in case of success, a negative error code otherwise |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
78 */ |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
79 int av_fill_image_linesizes(int linesizes[4], enum PixelFormat pix_fmt, int width); |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
80 |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
81 /** |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
82 * Fill plane data pointers for an image with pixel format pix_fmt and |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
83 * height height. |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
84 * |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
85 * @param data pointers array to be filled with the pointer for each image plane |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
86 * @param ptr the pointer to a buffer which will contain the image |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
87 * @param linesizes[4] the array containing the linesize for each |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
88 * plane, should be filled by av_fill_image_linesizes() |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
89 * @return the size in bytes required for the image buffer, a negative |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
90 * error code in case of failure |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
91 */ |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
92 int av_fill_image_pointers(uint8_t *data[4], enum PixelFormat pix_fmt, int height, |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
93 uint8_t *ptr, const int linesizes[4]); |
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
94 |
13
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
95 /** |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
96 * Check if the given dimension of an image is valid, meaning that all |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
97 * bytes of the image can be addressed with a signed int. |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
98 * |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
99 * @param w the width of the picture |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
100 * @param h the height of the picture |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
101 * @param log_offset the offset to sum to the log level for logging with log_ctx |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
102 * @param log_ctx the parent logging context, it may be NULL |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
103 * @return >= 0 if valid, a negative error code otherwise |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
104 */ |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
105 int av_check_image_size(unsigned int w, unsigned int h, int log_offset, void *log_ctx); |
97c3fe501477
Deprecate avcodec_check_dimensions() in favor of the new function
stefano
parents:
8
diff
changeset
|
106 |
8
f214f755f5de
Move fill_image_linesize() and fill_image_data_ptr() from
stefano
parents:
diff
changeset
|
107 #endif /* AVCORE_IMGUTILS_H */ |