1 /*
2  * Copyright (c) 2007-2013 Intel Corporation. All Rights Reserved.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the
6  * "Software"), to deal in the Software without restriction, including
7  * without limitation the rights to use, copy, modify, merge, publish,
8  * distribute, sub license, and/or sell copies of the Software, and to
9  * permit persons to whom the Software is furnished to do so, subject to
10  * the following conditions:
11  *
12  * The above copyright notice and this permission notice (including the
13  * next paragraph) shall be included in all copies or substantial portions
14  * of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
19  * IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR
20  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23  */
24 
25 /**
26  * \file va_enc_jpeg.h
27  * \brief JPEG encoding API
28  *
29  * This file contains the \ref api_enc_jpeg "JPEG encoding API".
30  */
31 
32 #ifndef VA_ENC_JPEG_H
33 #define VA_ENC_JPEG_H
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 /**
40  * \defgroup api_enc_jpeg JPEG encoding API
41  *
42  * @{
43  */
44 
45 /**
46  * \brief JPEG Encoding Picture Parameter Buffer Structure
47  *
48  * This structure conveys picture level parameters.
49  *
50  */
51 typedef struct  _VAEncPictureParameterBufferJPEG
52 {
53     /** \brief holds reconstructed picture. */
54     VASurfaceID reconstructed_picture;
55     /** \brief picture width. */
56     unsigned short picture_width;
57     /** \brief picture height. */
58     unsigned short picture_height;
59     /** \brief holds coded data. */
60     VABufferID coded_buf;
61 
62     /**
63      * \brief pic_flags
64      *
65      */
66     union {
67         struct {
68             /**
69              * \brief profile:
70              * 0 - Baseline, 1 - Extended, 2 - Lossless, 3 - Hierarchical
71              */
72             unsigned int profile     : 2;
73             /**
74              * \brief progressive:
75              * 0 - sequential, 1 - extended, 2 - progressive
76              */
77             unsigned int progressive : 1;
78             /**
79              * \brief huffman:
80              * 0 - arithmetic, 1 - huffman
81              */
82             unsigned int huffman     : 1;
83             /**
84              * \brief interleaved:
85              * 0 - non interleaved, 1 - interleaved
86              */
87             unsigned int interleaved : 1;
88             /**
89              * \brief differential:
90              * 0 - non differential, 1 - differential
91              */
92             unsigned int differential   : 1;
93         } bits;
94         unsigned int value;
95     } pic_flags;
96 
97     /** \brief number of bits per sample. */
98     unsigned char    sample_bit_depth;
99     /** \brief total number of scans in image. */
100     unsigned char    num_scan;
101     /** \brief number of image components in frame. */
102     unsigned short   num_components;
103     /** \brief Component identifier (Ci). */
104     unsigned char    component_id[4];
105     /** \brief Quantization table selector (Tqi). */
106     unsigned char    quantiser_table_selector[4];
107     /** \brief number from 1 to 100 that specifies quality of image. */
108     unsigned char    quality;
109 
110 } VAEncPictureParameterBufferJPEG;
111 
112 
113 /**
114  * \brief Slice parameter for JPEG encoding.
115  *
116  * This structure conveys slice (scan) level parameters.
117  *
118  */
119 typedef struct _VAEncSliceParameterBufferJPEG {
120     /** \brief Restart interval definition (Ri). */
121     unsigned short    restart_interval;
122     /** \brief number of image components in a scan. */
123     unsigned short    num_components;
124     struct {
125         /** \brief Scan component selector (Csj). */
126         unsigned char   component_selector;
127         /** \brief DC entropy coding table selector (Tdj). */
128         unsigned char   dc_table_selector;
129         /** \brief AC entropy coding table selector (Taj). */
130         unsigned char   ac_table_selector;
131     } components[4];
132 } VAEncSliceParameterBufferJPEG;
133 
134 /**
135  * \brief Quantization table for JPEG encoding.
136  *
137  */
138 typedef struct _VAQMatrixBufferJPEG
139 {
140     /** \brief load luma quantization table. */
141     int load_lum_quantiser_matrix;
142     /** \brief load chroma quantization table. */
143     int load_chroma_quantiser_matrix;
144     /** \brief luma quantization table. */
145     unsigned char lum_quantiser_matrix[64];
146     /** \brief chroma quantization table. */
147     unsigned char chroma_quantiser_matrix[64];
148 } VAQMatrixBufferJPEG;
149 
150 /**@}*/
151 
152 #include <va/va_dec_jpeg.h>
153 
154 #ifdef __cplusplus
155 }
156 #endif
157 
158 #endif /* VA_ENC_JPEG_H */
159