Mercurial > libavcodec.hg
annotate pixdesc.h @ 9529:e885f6298a7a libavcodec
Add missing header inclusion guard.
author | stefano |
---|---|
date | Tue, 21 Apr 2009 21:51:01 +0000 |
parents | dad1c3ed61f1 |
children | 717f799077ad |
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" | |
9430
e806d2145e72
Do not use full include path for get_bits.h, since the header is in
stefano
parents:
9428
diff
changeset
|
28 #include "get_bits.h" |
9018 | 29 |
30 typedef struct AVComponentDescriptor{ | |
31 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
|
32 |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
33 /** |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
34 * 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
|
35 * 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
|
36 */ |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
37 uint16_t step_minus1 :3; |
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 /** |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
40 * 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
|
41 * 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
|
42 */ |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
43 uint16_t offset_plus1 :3; |
9170 | 44 uint16_t shift :3; ///< number of least significant bits that must be shifted away to get the value |
9018 | 45 uint16_t depth_minus1 :4; ///< number of bits in the component minus 1 |
46 }AVComponentDescriptor; | |
47 | |
9019 | 48 /** |
9043 | 49 * Descriptor that unambiguously describes how the bits of a pixel are |
9019 | 50 * stored in the up to 4 data planes of an image. It also stores the |
51 * subsampling factors and number of components. | |
52 * | |
9043 | 53 * @note This is separate of the colorspace (RGB, YCbCr, YPbPr, JPEG-style YUV |
54 * and all the YUV variants) AVPixFmtDescriptor just stores how values | |
55 * are stored not what these values represent. | |
9019 | 56 */ |
9018 | 57 typedef struct AVPixFmtDescriptor{ |
9187 | 58 const char *name; |
9018 | 59 uint8_t nb_channels; ///< The number of components each pixel has, (1-4) |
60 | |
61 /** | |
9043 | 62 * Amount to shift the luma width right to find the chroma width. |
63 * For YV12 this is 1 for example. | |
64 * chroma_width = -((-luma_width) >> log2_chroma_w) | |
65 * The note above is needed to ensure rounding up. | |
9018 | 66 */ |
67 uint8_t log2_chroma_w; ///< chroma_width = -((-luma_width )>>log2_chroma_w) | |
68 | |
69 /** | |
9043 | 70 * Amount to shift the luma height right to find the chroma height. |
71 * For YV12 this is 1 for example. | |
72 * chroma_height= -((-luma_height) >> log2_chroma_h) | |
73 * The note above is needed to ensure rounding up. | |
9018 | 74 */ |
75 uint8_t log2_chroma_h; | |
76 uint8_t flags; | |
9043 | 77 AVComponentDescriptor comp[4]; ///< parameters that describe how pixels are packed |
9018 | 78 }AVPixFmtDescriptor; |
79 | |
9043 | 80 #define PIX_FMT_BE 1 ///< big-endian |
9129 | 81 #define PIX_FMT_PAL 2 ///< Pixel format has a palette in data[1], values are indexes in this palette. |
9043 | 82 #define PIX_FMT_BITSTREAM 4 ///< All values of a component are bit-wise packed end to end. |
9018 | 83 |
9234
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
84 /** |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
85 * The array of all the pixel format descriptors. |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
86 */ |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
87 extern const AVPixFmtDescriptor av_pix_fmt_descriptors[]; |
9018 | 88 |
9321 | 89 /** |
90 * Reads a line from an image, and writes to \p dst the values of the | |
91 * pixel format component \p c. | |
92 * | |
93 * @param data the array containing the pointers to the planes of the image | |
94 * @param linesizes the array containing the linesizes of the image | |
95 * @param desc the pixel format descriptor for the image | |
96 * @param x the horizontal coordinate of the first pixel to read | |
97 * @param y the vertical coordinate of the first pixel to read | |
98 * @param w the width of the line to read, that is the number of | |
99 * values to write to \p dst | |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
100 * @param read_pal_component if not zero and the format is a paletted |
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
101 * format writes to \p dst the values corresponding to the palette |
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
102 * component \p c in data[1], rather than the palette indexes in |
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
103 * data[0]. The behavior is undefined if the format is not paletted. |
9321 | 104 */ |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
105 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
|
106 const AVPixFmtDescriptor *desc, int x, int y, int c, int w, int read_pal_component) |
9018 | 107 { |
108 AVComponentDescriptor comp= desc->comp[c]; | |
109 int plane= comp.plane; | |
110 int depth= comp.depth_minus1+1; | |
111 int mask = (1<<depth)-1; | |
112 int shift= comp.shift; | |
113 int step = comp.step_minus1+1; | |
114 int flags= desc->flags; | |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
115 |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
116 if (flags & PIX_FMT_BITSTREAM){ |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
117 GetBitContext gb; |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
118 init_get_bits(&gb, data[plane] + y*linesize[plane], linesize[plane]*8); |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
119 skip_bits_long(&gb, x*step + comp.offset_plus1-1); |
9018 | 120 |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
121 while(w--){ |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
122 int val = show_bits(&gb, depth); |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
123 if(read_pal_component) |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
124 val= data[1][4*val + c]; |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
125 skip_bits(&gb, step); |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
126 *dst++= val; |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
127 } |
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
128 } else { |
9325 | 129 const uint8_t *p = data[plane]+ y*linesize[plane] + x*step + comp.offset_plus1-1; |
9018 | 130 |
9325 | 131 while(w--){ |
132 int val; | |
133 if(flags & PIX_FMT_BE) val= AV_RB16(p); | |
134 else val= AV_RL16(p); | |
135 val = (val>>shift) & mask; | |
9330
f01741cc9471
Extend read_line() to make it take a read_pal_component parameter.
stefano
parents:
9325
diff
changeset
|
136 if(read_pal_component) |
9325 | 137 val= data[1][4*val + c]; |
9018 | 138 p+= step; |
9325 | 139 *dst++= val; |
140 } | |
9324
f8cc0e2e7740
Add/fix support for bitstream formats reading in read_line().
stefano
parents:
9323
diff
changeset
|
141 } |
9018 | 142 } |
9528 | 143 |
144 /** | |
145 * Writes the values from src to the pixel format component c of an | |
146 * image line. | |
147 * | |
148 * @param src array containing the values to write | |
149 * @param data the array containing the pointers to the planes of the | |
150 * image to write into. It is supposed to be zeroed. | |
151 * @param linesizes the array containing the linesizes of the image | |
152 * @param desc the pixel format descriptor for the image | |
153 * @param x the horizontal coordinate of the first pixel to write | |
154 * @param y the vertical coordinate of the first pixel to write | |
155 * @param w the width of the line to write, that is the number of | |
156 * values to write to the image line | |
157 */ | |
158 static inline void write_line(const uint16_t *src, uint8_t *data[4], const int linesize[4], | |
159 const AVPixFmtDescriptor *desc, int x, int y, int c, int w) | |
160 { | |
161 AVComponentDescriptor comp = desc->comp[c]; | |
162 int plane = comp.plane; | |
163 int depth = comp.depth_minus1+1; | |
164 int step = comp.step_minus1+1; | |
165 int flags = desc->flags; | |
166 | |
167 if (flags & PIX_FMT_BITSTREAM) { | |
168 int skip = x*step + comp.offset_plus1-1; | |
169 uint8_t *p = data[plane] + y*linesize[plane] + (skip>>3); | |
170 int shift = 8 - depth - (skip&7); | |
171 | |
172 while (w--) { | |
173 *p |= *src++ << shift; | |
174 shift -= step; | |
175 p -= shift>>3; | |
176 shift &= 7; | |
177 } | |
178 } else { | |
179 int shift = comp.shift; | |
180 uint8_t *p = data[plane]+ y*linesize[plane] + x*step + comp.offset_plus1-1; | |
181 | |
182 while (w--) { | |
183 if (flags & PIX_FMT_BE) { | |
184 uint16_t val = AV_RB16(p) | (*src++<<shift); | |
185 AV_WB16(p, val); | |
186 } else { | |
187 uint16_t val = AV_RL16(p) | (*src++<<shift); | |
188 AV_WL16(p, val); | |
189 } | |
190 p+= step; | |
191 } | |
192 } | |
193 } | |
9529 | 194 |
195 #endif /* AVCODEC_PIXDESC_H */ |