p_video_decoder.h revision d3770d6229d95e9beb67358ae2b2c8824ed3ae58 
1/**************************************************************************
2 *
3 * Copyright 2009 Younes Manton.
4 * All Rights Reserved.
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
13 *
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
16 * of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 *
26 **************************************************************************/
27
28#ifndef PIPE_VIDEO_CONTEXT_H
29#define PIPE_VIDEO_CONTEXT_H
30
31#ifdef __cplusplus
32extern "C" {
33#endif
34
35#include <pipe/p_video_state.h>
36
37struct pipe_screen;
38struct pipe_surface;
39struct pipe_macroblock;
40struct pipe_picture_desc;
41struct pipe_fence_handle;
42
43/**
44 * Gallium video decoder for a specific codec/profile
45 */
46struct pipe_video_decoder
47{
48   struct pipe_context *context;
49
50   enum pipe_video_profile profile;
51   enum pipe_video_entrypoint entrypoint;
52   enum pipe_video_chroma_format chroma_format;
53   unsigned width;
54   unsigned height;
55
56   /**
57    * destroy this video decoder
58    */
59   void (*destroy)(struct pipe_video_decoder *decoder);
60
61   /**
62    * Creates a decoder buffer
63    */
64   void *(*create_buffer)(struct pipe_video_decoder *decoder);
65
66   /**
67    * Destroys a decoder buffer
68    */
69   void (*destroy_buffer)(struct pipe_video_decoder *decoder, void *buffer);
70
71   /**
72    * set the current decoder buffer
73    */
74   void (*set_decode_buffer)(struct pipe_video_decoder *decoder, void *buffer);
75
76   /**
77    * set the picture parameters for the next frame
78    * only used for bitstream decoding
79    */
80   void (*set_picture_parameters)(struct pipe_video_decoder *decoder,
81                                  struct pipe_picture_desc *picture);
82
83   /**
84    * set the quantification matrixes
85    */
86   void (*set_quant_matrix)(struct pipe_video_decoder *decoder,
87                            const uint8_t intra_matrix[64],
88                            const uint8_t non_intra_matrix[64]);
89
90   /**
91    * set target where video data is decoded to
92    */
93   void (*set_decode_target)(struct pipe_video_decoder *decoder,
94                             struct pipe_video_buffer *target);
95
96   /**
97    * set reference frames for motion compensation
98    */
99   void (*set_reference_frames)(struct pipe_video_decoder *decoder,
100                                struct pipe_video_buffer **ref_frames,
101                                unsigned num_ref_frames);
102
103   /**
104    * start decoding of a new frame
105    */
106   void (*begin_frame)(struct pipe_video_decoder *decoder);
107
108   /**
109    * decode a macroblock
110    */
111   void (*decode_macroblock)(struct pipe_video_decoder *decoder,
112                             const struct pipe_macroblock *macroblocks,
113                             unsigned num_macroblocks);
114
115   /**
116    * decode a bitstream
117    */
118   void (*decode_bitstream)(struct pipe_video_decoder *decoder,
119                            unsigned num_bytes, const void *data);
120
121   /**
122    * end decoding of the current frame
123    */
124   void (*end_frame)(struct pipe_video_decoder *decoder);
125
126   /**
127    * flush any outstanding command buffers to the hardware
128    * should be called before a video_buffer is acessed by the state tracker again
129    */
130   void (*flush)(struct pipe_video_decoder *decoder);
131};
132
133/**
134 * output for decoding / input for displaying
135 */
136struct pipe_video_buffer
137{
138   struct pipe_context *context;
139
140   enum pipe_format buffer_format;
141   enum pipe_video_chroma_format chroma_format;
142   unsigned width;
143   unsigned height;
144
145   /**
146    * destroy this video buffer
147    */
148   void (*destroy)(struct pipe_video_buffer *buffer);
149
150   /**
151    * get a individual sampler view for each plane
152    */
153   struct pipe_sampler_view **(*get_sampler_view_planes)(struct pipe_video_buffer *buffer);
154
155   /**
156    * get a individual sampler view for each component
157    */
158   struct pipe_sampler_view **(*get_sampler_view_components)(struct pipe_video_buffer *buffer);
159
160   /**
161    * get a individual surfaces for each plane
162    */
163   struct pipe_surface **(*get_surfaces)(struct pipe_video_buffer *buffer);
164};
165
166#ifdef __cplusplus
167}
168#endif
169
170#endif /* PIPE_VIDEO_CONTEXT_H */
171