Mercurial > libavcodec.hg
annotate pixdesc.h @ 9323:f347365f2da4 libavcodec
Make the step and offset fields of the component descriptor express a
number of bits for bitstreams formats.
author | stefano |
---|---|
date | Tue, 31 Mar 2009 22:48:18 +0000 |
parents | fdd902365b49 |
children | f8cc0e2e7740 |
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 | |
22 #include <inttypes.h> | |
23 | |
24 #include "libavutil/intreadwrite.h" | |
25 | |
26 typedef struct AVComponentDescriptor{ | |
27 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
|
28 |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
29 /** |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
30 * 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
|
31 * 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
|
32 */ |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
33 uint16_t step_minus1 :3; |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
34 |
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 * 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
|
37 * 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
|
38 */ |
f347365f2da4
Make the step and offset fields of the component descriptor express a
stefano
parents:
9321
diff
changeset
|
39 uint16_t offset_plus1 :3; |
9170 | 40 uint16_t shift :3; ///< number of least significant bits that must be shifted away to get the value |
9018 | 41 uint16_t depth_minus1 :4; ///< number of bits in the component minus 1 |
42 }AVComponentDescriptor; | |
43 | |
9019 | 44 /** |
9043 | 45 * Descriptor that unambiguously describes how the bits of a pixel are |
9019 | 46 * stored in the up to 4 data planes of an image. It also stores the |
47 * subsampling factors and number of components. | |
48 * | |
9043 | 49 * @note This is separate of the colorspace (RGB, YCbCr, YPbPr, JPEG-style YUV |
50 * and all the YUV variants) AVPixFmtDescriptor just stores how values | |
51 * are stored not what these values represent. | |
9019 | 52 */ |
9018 | 53 typedef struct AVPixFmtDescriptor{ |
9187 | 54 const char *name; |
9018 | 55 uint8_t nb_channels; ///< The number of components each pixel has, (1-4) |
56 | |
57 /** | |
9043 | 58 * Amount to shift the luma width right to find the chroma width. |
59 * For YV12 this is 1 for example. | |
60 * chroma_width = -((-luma_width) >> log2_chroma_w) | |
61 * The note above is needed to ensure rounding up. | |
9018 | 62 */ |
63 uint8_t log2_chroma_w; ///< chroma_width = -((-luma_width )>>log2_chroma_w) | |
64 | |
65 /** | |
9043 | 66 * Amount to shift the luma height right to find the chroma height. |
67 * For YV12 this is 1 for example. | |
68 * chroma_height= -((-luma_height) >> log2_chroma_h) | |
69 * The note above is needed to ensure rounding up. | |
9018 | 70 */ |
71 uint8_t log2_chroma_h; | |
72 uint8_t flags; | |
9043 | 73 AVComponentDescriptor comp[4]; ///< parameters that describe how pixels are packed |
9018 | 74 }AVPixFmtDescriptor; |
75 | |
9043 | 76 #define PIX_FMT_BE 1 ///< big-endian |
9129 | 77 #define PIX_FMT_PAL 2 ///< Pixel format has a palette in data[1], values are indexes in this palette. |
9043 | 78 #define PIX_FMT_BITSTREAM 4 ///< All values of a component are bit-wise packed end to end. |
9018 | 79 |
9234
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
80 /** |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
81 * The array of all the pixel format descriptors. |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
82 */ |
49340eb6f96f
Export to pixdesc.h the av_pix_fmt_descriptors array.
stefano
parents:
9187
diff
changeset
|
83 extern const AVPixFmtDescriptor av_pix_fmt_descriptors[]; |
9018 | 84 |
9321 | 85 /** |
86 * Reads a line from an image, and writes to \p dst the values of the | |
87 * pixel format component \p c. | |
88 * | |
89 * @param data the array containing the pointers to the planes of the image | |
90 * @param linesizes the array containing the linesizes of the image | |
91 * @param desc the pixel format descriptor for the image | |
92 * @param x the horizontal coordinate of the first pixel to read | |
93 * @param y the vertical coordinate of the first pixel to read | |
94 * @param w the width of the line to read, that is the number of | |
95 * values to write to \p dst | |
96 */ | |
9310
ef6fd4b99c50
Make read_line() take as parameter a const AVPixFmtDescriptor * rather than a
stefano
parents:
9234
diff
changeset
|
97 static inline void read_line(uint16_t *dst, const uint8_t *data[4], const int linesize[4], const AVPixFmtDescriptor *desc, int x, int y, int c, int w) |
9018 | 98 { |
99 AVComponentDescriptor comp= desc->comp[c]; | |
100 int plane= comp.plane; | |
101 int depth= comp.depth_minus1+1; | |
102 int mask = (1<<depth)-1; | |
103 int shift= comp.shift; | |
104 int step = comp.step_minus1+1; | |
105 int flags= desc->flags; | |
106 const uint8_t *p= data[plane]+y*linesize[plane] + x * step + comp.offset_plus1 - 1; | |
107 | |
108 //FIXME initial x in case of PIX_FMT_BITSTREAM is wrong | |
109 | |
110 while(w--){ | |
111 int val; | |
112 if(flags & PIX_FMT_BE) val= AV_RB16(p); | |
113 else val= AV_RL16(p); | |
114 val = (val>>shift) & mask; | |
115 if(flags & PIX_FMT_PAL) | |
116 val= data[1][4*val + c]; | |
117 if(flags & PIX_FMT_BITSTREAM){ | |
118 shift-=depth; | |
119 while(shift<0){ | |
120 shift+=8; | |
121 p++; | |
122 } | |
123 }else | |
124 p+= step; | |
125 *dst++= val; | |
126 } | |
127 } |