Mercurial > libavcodec.hg
annotate pixdesc.h @ 10398:11b685acd280 libavcodec
Print a warning message when avcodec_default_free_buffers finds unreleased
buffers, this hopefully should help detect codecs that do not release all
buffers e.g. in the decode_end function.
author | reimar |
---|---|
date | Tue, 13 Oct 2009 20:48:51 +0000 |
parents | 2887f410011f |
children | 0a97bc8da768 |
rev | line source |
---|---|
9018 | 1 /* |
9043 | 2 * pixel format descriptor |
9018 | 3 * Copyright (c) 2009 Michael Niedermayer <michaelni@gmx.at> |
4 * | |
5 * This file is part of FFmpeg. | |
6 * | |
7 * FFmpeg is free software; you can redistribute it and/or | |
8 * modify it under the terms of the GNU Lesser General Public | |
9 * License as published by the Free Software Foundation; either | |
10 * version 2.1 of the License, or (at your option) any later version. | |
11 * | |
12 * FFmpeg is distributed in the hope that it will be useful, | |
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
15 * Lesser General Public License for more details. | |
16 * | |
17 * You should have received a copy of the GNU Lesser General Public | |
18 * License along with FFmpeg; if not, write to the Free Software | |
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | |
20 */ | |
21 | |
9529 | 22 #ifndef AVCODEC_PIXDESC_H |
23 #define AVCODEC_PIXDESC_H | |
24 | |
9018 | 25 #include <inttypes.h> |
26 | |
27 #include "libavutil/intreadwrite.h" | |
28 | |
29 typedef struct AVComponentDescriptor{ | |
30 uint16_t plane :2; ///< which of the 4 planes contains the component | |
9323
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
31 |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
32 /** |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
33 * Number of elements between 2 horizontally consecutive pixels minus 1. |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
34 * Elements are bits for bitstream formats, bytes otherwise. |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
35 */ |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
36 uint16_t step_minus1 :3; |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
37 |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
38 /** |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
39 * Number of elements before the component of the first pixel plus 1. |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
40 * Elements are bits for bitstream formats, bytes otherwise. |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
41 */ |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
42 uint16_t offset_plus1 :3; |
9170 | 43 uint16_t shift :3; ///< number of least significant bits that must be shifted away to get the value |
9018 | 44 uint16_t depth_minus1 :4; ///< number of bits in the component minus 1 |
45 }AVComponentDescriptor; | |
46 | |
9019 | 47 /** |
9043 | 48 * Descriptor that unambiguously describes how the bits of a pixel are |
9019 | 49 * stored in the up to 4 data planes of an image. It also stores the |
50 * subsampling factors and number of components. | |
51 * | |
9043 | 52 * @note This is separate of the colorspace (RGB, YCbCr, YPbPr, JPEG-style YUV |
53 * and all the YUV variants) AVPixFmtDescriptor just stores how values | |
54 * are stored not what these values represent. | |
9019 | 55 */ |
9018 | 56 typedef struct AVPixFmtDescriptor{ |
9187 | 57 const char *name; |
9018 | 58 uint8_t nb_channels; ///< The number of components each pixel has, (1-4) |
59 | |
60 /** | |
9043 | 61 * Amount to shift the luma width right to find the chroma width. |
62 * For YV12 this is 1 for example. | |
63 * chroma_width = -((-luma_width) >> log2_chroma_w) | |
64 * The note above is needed to ensure rounding up. | |
9018 | 65 */ |
66 uint8_t log2_chroma_w; ///< chroma_width = -((-luma_width )>>log2_chroma_w) | |
67 | |
68 /** | |
9043 | 69 * Amount to shift the luma height right to find the chroma height. |
70 * For YV12 this is 1 for example. | |
71 * chroma_height= -((-luma_height) >> log2_chroma_h) | |
72 * The note above is needed to ensure rounding up. | |
9018 | 73 */ |
74 uint8_t log2_chroma_h; | |
75 uint8_t flags; | |
9043 | 76 AVComponentDescriptor comp[4]; ///< parameters that describe how pixels are packed |
9018 | 77 }AVPixFmtDescriptor; |
78 | |
9043 | 79 #define PIX_FMT_BE 1 ///< big-endian |
9129 | 80 #define PIX_FMT_PAL 2 ///< Pixel format has a palette in data[1], values are indexes in this palette. |
9043 | 81 #define PIX_FMT_BITSTREAM 4 ///< All values of a component are bit-wise packed end to end. |
9018 | 82 |
9234
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
83 /** |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
84 * The array of all the pixel format descriptors. |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
85 */ |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
86 extern const AVPixFmtDescriptor av_pix_fmt_descriptors[]; |
9018 | 87 |
9321 | 88 /** |
9822
2887f410011f
Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents:
9579
diff
changeset
|
89 * Reads a line from an image, and writes to dst the values of the |
2887f410011f
Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents:
9579
diff
changeset
|
90 * pixel format component c. |
9321 | 91 * |
92 * @param data the array containing the pointers to the planes of the image | |
93 * @param linesizes the array containing the linesizes of the image | |
94 * @param desc the pixel format descriptor for the image | |
95 * @param x the horizontal coordinate of the first pixel to read | |
96 * @param y the vertical coordinate of the first pixel to read | |
97 * @param w the width of the line to read, that is the number of | |
9822
2887f410011f
Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents:
9579
diff
changeset
|
98 * values to write to dst |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
99 * @param read_pal_component if not zero and the format is a paletted |
9822
2887f410011f
Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents:
9579
diff
changeset
|
100 * format writes to dst the values corresponding to the palette |
2887f410011f
Remove '\p', '\c' and '\e' doxygen markup from doxy, as it should
stefano
parents:
9579
diff
changeset
|
101 * component c in data[1], rather than the palette indexes in |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
102 * data[0]. The behavior is undefined if the format is not paletted. |
9321 | 103 */ |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
104 static inline void read_line(uint16_t *dst, const uint8_t *data[4], const int linesize[4], |
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
105 const AVPixFmtDescriptor *desc, int x, int y, int c, int w, int read_pal_component) |
9018 | 106 { |
107 AVComponentDescriptor comp= desc->comp[c]; | |
108 int plane= comp.plane; | |
109 int depth= comp.depth_minus1+1; | |
110 int mask = (1<<depth)-1; | |
111 int shift= comp.shift; | |
112 int step = comp.step_minus1+1; | |
113 int flags= desc->flags; | |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
114 |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
115 if (flags & PIX_FMT_BITSTREAM){ |
9534
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
116 int skip = x*step + comp.offset_plus1-1; |
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
117 const uint8_t *p = data[plane] + y*linesize[plane] + (skip>>3); |
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
118 int shift = 8 - depth - (skip&7); |
9018 | 119 |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
120 while(w--){ |
9534
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
121 int val = (*p >> shift) & mask; |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
122 if(read_pal_component) |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
123 val= data[1][4*val + c]; |
9534
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
124 shift -= step; |
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
125 p -= shift>>3; |
717f799077ad
Make read_line() do not depend on put_bits.h and speed up it.
stefano
parents:
9529
diff
changeset
|
126 shift &= 7; |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
127 *dst++= val; |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
128 } |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
129 } else { |
9325 | 130 const uint8_t *p = data[plane]+ y*linesize[plane] + x*step + comp.offset_plus1-1; |
9018 | 131 |
9325 | 132 while(w--){ |
133 int val; | |
134 if(flags & PIX_FMT_BE) val= AV_RB16(p); | |
135 else val= AV_RL16(p); | |
136 val = (val>>shift) & mask; | |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
137 if(read_pal_component) |
9325 | 138 val= data[1][4*val + c]; |
9018 | 139 p+= step; |
9325 | 140 *dst++= val; |
141 } | |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
142 } |
9018 | 143 } |
9528 | 144 |
145 /** | |
146 * Writes the values from src to the pixel format component c of an | |
147 * image line. | |
148 * | |
149 * @param src array containing the values to write | |
150 * @param data the array containing the pointers to the planes of the | |
151 * image to write into. It is supposed to be zeroed. | |
152 * @param linesizes the array containing the linesizes of the image | |
153 * @param desc the pixel format descriptor for the image | |
154 * @param x the horizontal coordinate of the first pixel to write | |
155 * @param y the vertical coordinate of the first pixel to write | |
156 * @param w the width of the line to write, that is the number of | |
157 * values to write to the image line | |
158 */ | |
159 static inline void write_line(const uint16_t *src, uint8_t *data[4], const int linesize[4], | |
160 const AVPixFmtDescriptor *desc, int x, int y, int c, int w) | |
161 { | |
162 AVComponentDescriptor comp = desc->comp[c]; | |
163 int plane = comp.plane; | |
164 int depth = comp.depth_minus1+1; | |
165 int step = comp.step_minus1+1; | |
166 int flags = desc->flags; | |
167 | |
168 if (flags & PIX_FMT_BITSTREAM) { | |
169 int skip = x*step + comp.offset_plus1-1; | |
170 uint8_t *p = data[plane] + y*linesize[plane] + (skip>>3); | |
171 int shift = 8 - depth - (skip&7); | |
172 | |
173 while (w--) { | |
174 *p |= *src++ << shift; | |
175 shift -= step; | |
176 p -= shift>>3; | |
177 shift &= 7; | |
178 } | |
179 } else { | |
180 int shift = comp.shift; | |
181 uint8_t *p = data[plane]+ y*linesize[plane] + x*step + comp.offset_plus1-1; | |
182 | |
183 while (w--) { | |
184 if (flags & PIX_FMT_BE) { | |
185 uint16_t val = AV_RB16(p) | (*src++<<shift); | |
186 AV_WB16(p, val); | |
187 } else { | |
188 uint16_t val = AV_RL16(p) | (*src++<<shift); | |
189 AV_WL16(p, val); | |
190 } | |
191 p+= step; | |
192 } | |
193 } | |
194 } | |
9529 | 195 |
9579 | 196 /** |
197 * Returns the number of bits per pixel used by the pixel format | |
198 * described by pixdesc. | |
199 * | |
200 * The returned number of bits refers to the number of bits actually | |
201 * used for storing the pixel information, that is padding bits are | |
202 * not counted. | |
203 */ | |
204 int av_get_bits_per_pixel(const AVPixFmtDescriptor *pixdesc); | |
205 | |
9529 | 206 #endif /* AVCODEC_PIXDESC_H */ |