OLD | NEW |
1 /* | 1 /* |
2 * Copyright (c) 2010 The WebM project authors. All Rights Reserved. | 2 * Copyright (c) 2010 The WebM project authors. All Rights Reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 | 11 |
12 /*!\defgroup vp8_decoder WebM VP8 Decoder | 12 /*!\defgroup vp8_decoder WebM VP8/VP9 Decoder |
13 * \ingroup vp8 | 13 * \ingroup vp8 |
14 * | 14 * |
15 * @{ | 15 * @{ |
16 */ | 16 */ |
17 /*!\file | 17 /*!\file |
18 * \brief Provides definitions for using the VP8 algorithm within the vpx Decode
r | 18 * \brief Provides definitions for using VP8 or VP9 within the vpx Decoder |
19 * interface. | 19 * interface. |
20 */ | 20 */ |
21 #ifndef VPX_VP8DX_H_ | 21 #ifndef VPX_VP8DX_H_ |
22 #define VPX_VP8DX_H_ | 22 #define VPX_VP8DX_H_ |
23 | 23 |
24 #ifdef __cplusplus | 24 #ifdef __cplusplus |
25 extern "C" { | 25 extern "C" { |
26 #endif | 26 #endif |
27 | 27 |
28 /* Include controls common to both the encoder and decoder */ | 28 /* Include controls common to both the encoder and decoder */ |
29 #include "./vp8.h" | 29 #include "./vp8.h" |
30 | 30 |
31 /*!\name Algorithm interface for VP8 | 31 /*!\name Algorithm interface for VP8 |
32 * | 32 * |
33 * This interface provides the capability to decode raw VP8 streams, as would | 33 * This interface provides the capability to decode VP8 streams. |
34 * be found in AVI files and other non-Flash uses. | |
35 * @{ | 34 * @{ |
36 */ | 35 */ |
37 extern vpx_codec_iface_t vpx_codec_vp8_dx_algo; | 36 extern vpx_codec_iface_t vpx_codec_vp8_dx_algo; |
38 extern vpx_codec_iface_t *vpx_codec_vp8_dx(void); | 37 extern vpx_codec_iface_t *vpx_codec_vp8_dx(void); |
| 38 /*!@} - end algorithm interface member group*/ |
39 | 39 |
40 /* TODO(jkoleszar): These move to VP9 in a later patch set. */ | 40 /*!\name Algorithm interface for VP9 |
| 41 * |
| 42 * This interface provides the capability to decode VP9 streams. |
| 43 * @{ |
| 44 */ |
41 extern vpx_codec_iface_t vpx_codec_vp9_dx_algo; | 45 extern vpx_codec_iface_t vpx_codec_vp9_dx_algo; |
42 extern vpx_codec_iface_t *vpx_codec_vp9_dx(void); | 46 extern vpx_codec_iface_t *vpx_codec_vp9_dx(void); |
43 /*!@} - end algorithm interface member group*/ | 47 /*!@} - end algorithm interface member group*/ |
44 | 48 |
45 | 49 |
46 /*!\enum vp8_dec_control_id | 50 /*!\enum vp8_dec_control_id |
47 * \brief VP8 decoder control functions | 51 * \brief VP8 decoder control functions |
48 * | 52 * |
49 * This set of macros define the control functions available for the VP8 | 53 * This set of macros define the control functions available for the VP8 |
50 * decoder interface. | 54 * decoder interface. |
(...skipping 27 matching lines...) Expand all Loading... |
78 /** control function to get the bit depth of the stream. */ | 82 /** control function to get the bit depth of the stream. */ |
79 VP9D_GET_BIT_DEPTH, | 83 VP9D_GET_BIT_DEPTH, |
80 | 84 |
81 /** control function to set the byte alignment of the planes in the reference | 85 /** control function to set the byte alignment of the planes in the reference |
82 * buffers. Valid values are power of 2, from 32 to 1024. A value of 0 sets | 86 * buffers. Valid values are power of 2, from 32 to 1024. A value of 0 sets |
83 * legacy alignment. I.e. Y plane is aligned to 32 bytes, U plane directly | 87 * legacy alignment. I.e. Y plane is aligned to 32 bytes, U plane directly |
84 * follows Y plane, and V plane directly follows U plane. Default value is 0. | 88 * follows Y plane, and V plane directly follows U plane. Default value is 0. |
85 */ | 89 */ |
86 VP9_SET_BYTE_ALIGNMENT, | 90 VP9_SET_BYTE_ALIGNMENT, |
87 | 91 |
88 /** For testing. */ | 92 /** control function to invert the decoding order to from right to left. The |
| 93 * function is used in a test to confirm the decoding independence of tile |
| 94 * columns. The function may be used in application where this order |
| 95 * of decoding is desired. |
| 96 * |
| 97 * TODO(yaowu): Rework the unit test that uses this control, and in a future |
| 98 * release, this test-only control shall be removed. |
| 99 */ |
89 VP9_INVERT_TILE_DECODE_ORDER, | 100 VP9_INVERT_TILE_DECODE_ORDER, |
90 | 101 |
91 VP8_DECODER_CTRL_ID_MAX | 102 VP8_DECODER_CTRL_ID_MAX |
92 }; | 103 }; |
93 | 104 |
94 /** Decrypt n bytes of data from input -> output, using the decrypt_state | 105 /** Decrypt n bytes of data from input -> output, using the decrypt_state |
95 * passed in VPXD_SET_DECRYPTOR. | 106 * passed in VPXD_SET_DECRYPTOR. |
96 */ | 107 */ |
97 typedef void (*vpx_decrypt_cb)(void *decrypt_state, const unsigned char *input, | 108 typedef void (*vpx_decrypt_cb)(void *decrypt_state, const unsigned char *input, |
98 unsigned char *output, int count); | 109 unsigned char *output, int count); |
(...skipping 32 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
131 VPX_CTRL_USE_TYPE(VP9D_GET_BIT_DEPTH, unsigned int *) | 142 VPX_CTRL_USE_TYPE(VP9D_GET_BIT_DEPTH, unsigned int *) |
132 VPX_CTRL_USE_TYPE(VP9_INVERT_TILE_DECODE_ORDER, int) | 143 VPX_CTRL_USE_TYPE(VP9_INVERT_TILE_DECODE_ORDER, int) |
133 | 144 |
134 /*! @} - end defgroup vp8_decoder */ | 145 /*! @} - end defgroup vp8_decoder */ |
135 | 146 |
136 #ifdef __cplusplus | 147 #ifdef __cplusplus |
137 } // extern "C" | 148 } // extern "C" |
138 #endif | 149 #endif |
139 | 150 |
140 #endif // VPX_VP8DX_H_ | 151 #endif // VPX_VP8DX_H_ |
OLD | NEW |