src/gallium/include/pipe/p_video_context.h

   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
  32 extern "C" {
  33 #endif
  34
  35 #include <pipe/p_video_state.h>
  36
  37 struct pipe_screen;
  38 struct pipe_surface;
  39 struct pipe_macroblock;
  40 struct pipe_picture_desc;
  41 struct pipe_fence_handle;
  42
  43 /**
  44  * Gallium video rendering context
  45  */
  46 struct pipe_video_context
  47 {
  48    struct pipe_screen *screen;
  49
  50    void *priv; /**< context private data (for DRI for example) */
  51
  52    /**
  53     * destroy context, all objects created from this context
  54     * (buffers, decoders, compositors etc...) must be freed before calling this
  55     */
  56    void (*destroy)(struct pipe_video_context *context);
  57
  58    /**
  59     * Query an integer-valued capability/parameter/limit
  60     * \param param  one of PIPE_CAP_x
  61     */
  62    int (*get_param)(struct pipe_video_context *context, int param);
  63
  64    /**
  65     * Check if the given pipe_format is supported as a texture or
  66     * drawing surface.
  67     */
  68    boolean (*is_format_supported)(struct pipe_video_context *context,
  69                                   enum pipe_format format,
  70                                   unsigned usage);
  71
  72    /**
  73     * create a surface of a texture
  74     */
  75    struct pipe_surface *(*create_surface)(struct pipe_video_context *context,
  76                                           struct pipe_resource *resource,
  77                                           const struct pipe_surface *templ);
  78
  79    /**
  80     * sampler view handling, used for subpictures for example
  81     */
  82    /*@{*/
  83
  84    /**
  85     * create a sampler view of a texture, for subpictures for example
  86     */
  87    struct pipe_sampler_view *(*create_sampler_view)(struct pipe_video_context *context,
  88                                                     struct pipe_resource *resource,
  89                                                     const struct pipe_sampler_view *templ);
  90
  91    /**
  92     * upload image data to a sampler
  93     */
  94    void (*upload_sampler)(struct pipe_video_context *context,
  95                           struct pipe_sampler_view *dst,
  96                           const struct pipe_box *dst_box,
  97                           const void *src, unsigned src_stride,
  98                           unsigned src_x, unsigned src_y);
  99
 100    /**
 101     * clear a sampler with a specific rgba color
 102     */
 103    void (*clear_sampler)(struct pipe_video_context *context,
 104                          struct pipe_sampler_view *dst,
 105                          const struct pipe_box *dst_box,
 106                          const float *rgba);
 107
 108    /*}@*/
 109
 110    /**
 111     * create a decoder for a specific video profile
 112     */
 113    struct pipe_video_decoder *(*create_decoder)(struct pipe_video_context *context,
 114                                                 enum pipe_video_profile profile,
 115                                                 enum pipe_video_entrypoint entrypoint,
 116                                                 enum pipe_video_chroma_format chroma_format,
 117                                                 unsigned width, unsigned height);
 118
 119    /**
 120     * Creates a buffer as decoding target
 121     */
 122    struct pipe_video_buffer *(*create_buffer)(struct pipe_video_context *context,
 123                                               enum pipe_format buffer_format,
 124                                               enum pipe_video_chroma_format chroma_format,
 125                                               unsigned width, unsigned height);
 126
 127    /**
 128     * Creates a video compositor
 129     */
 130    struct pipe_video_compositor *(*create_compositor)(struct pipe_video_context *context);
 131 };
 132
 133 /**
 134  * decoder for a specific video codec
 135  */
 136 struct pipe_video_decoder
 137 {
 138    struct pipe_video_context *context;
 139
 140    enum pipe_video_profile profile;
 141    enum pipe_video_entrypoint entrypoint;
 142    enum pipe_video_chroma_format chroma_format;
 143    unsigned width;
 144    unsigned height;
 145
 146    /**
 147     * destroy this video decoder
 148     */
 149    void (*destroy)(struct pipe_video_decoder *decoder);
 150
 151    /**
 152     * Creates a buffer as decoding input
 153     */
 154    struct pipe_video_decode_buffer *(*create_buffer)(struct pipe_video_decoder *decoder);
 155
 156    /**
 157     * flush decoder buffer to video hardware
 158     */
 159    void (*flush_buffer)(struct pipe_video_decode_buffer *decbuf,
 160                         unsigned num_ycbcr_blocks[3],
 161                         struct pipe_video_buffer *ref_frames[2],
 162                         struct pipe_video_buffer *dst,
 163                         struct pipe_fence_handle **fence);
 164 };
 165
 166 /**
 167  * input buffer for a decoder
 168  */
 169 struct pipe_video_decode_buffer
 170 {
 171    struct pipe_video_decoder *decoder;
 172
 173    /**
 174     * destroy this decode buffer
 175     */
 176    void (*destroy)(struct pipe_video_decode_buffer *decbuf);
 177
 178    /**
 179     * map the input buffer into memory before starting decoding
 180     */
 181    void (*map)(struct pipe_video_decode_buffer *decbuf);
 182
 183    /**
 184     * get the pointer where to put the ycbcr blocks of a component
 185     */
 186    struct pipe_ycbcr_block *(*get_ycbcr_stream)(struct pipe_video_decode_buffer *, int component);
 187
 188    /**
 189     * get the pointer where to put the ycbcr dct block data of a component
 190     */
 191    short *(*get_ycbcr_buffer)(struct pipe_video_decode_buffer *, int component);
 192
 193    /**
 194     * get the stride of the mv buffer
 195     */
 196    unsigned (*get_mv_stream_stride)(struct pipe_video_decode_buffer *decbuf);
 197
 198    /**
 199     * get the pointer where to put the motion vectors of a ref frame
 200     */
 201    struct pipe_motionvector *(*get_mv_stream)(struct pipe_video_decode_buffer *decbuf, int ref_frame);
 202
 203 #if 0
 204    /**
 205     * decode a bitstream
 206     */
 207    void (*decode_bitstream)(struct pipe_video_decode_buffer *decbuf,
 208                             unsigned num_bufs,
 209                             struct pipe_buffer **bitstream_buf);
 210 #endif
 211
 212    /**
 213     * unmap decoder buffer before flushing
 214     */
 215    void (*unmap)(struct pipe_video_decode_buffer *decbuf);
 216 };
 217
 218 /**
 219  * output for decoding / input for displaying
 220  */
 221 struct pipe_video_buffer
 222 {
 223    struct pipe_video_context *context;
 224
 225    enum pipe_format buffer_format;
 226    enum pipe_video_chroma_format chroma_format;
 227    unsigned width;
 228    unsigned height;
 229
 230    /**
 231     * destroy this video buffer
 232     */
 233    void (*destroy)(struct pipe_video_buffer *buffer);
 234
 235    /**
 236     * get a individual sampler view for each plane
 237     */
 238    struct pipe_sampler_view **(*get_sampler_view_planes)(struct pipe_video_buffer *buffer);
 239
 240    /**
 241     * get a individual sampler view for each component
 242     */
 243    struct pipe_sampler_view **(*get_sampler_view_components)(struct pipe_video_buffer *buffer);
 244
 245    /**
 246     * get a individual surfaces for each plane
 247     */
 248    struct pipe_surface **(*get_surfaces)(struct pipe_video_buffer *buffer);
 249 };
 250
 251 /**
 252  * composing and displaying of image data
 253  */
 254 struct pipe_video_compositor
 255 {
 256    struct pipe_video_context *context;
 257
 258    /**
 259     * destroy this compositor
 260     */
 261    void (*destroy)(struct pipe_video_compositor *compositor);
 262
 263    /**
 264     * set yuv -> rgba conversion matrix
 265     */
 266    void (*set_csc_matrix)(struct pipe_video_compositor *compositor, const float mat[16]);
 267
 268    /**
 269     * set overlay samplers
 270     */
 271    /*@{*/
 272
 273    /**
 274     * reset all currently set layers
 275     */
 276    void (*clear_layers)(struct pipe_video_compositor *compositor);
 277
 278    /**
 279     * set a video buffer as a layer to render
 280     */
 281    void (*set_buffer_layer)(struct pipe_video_compositor *compositor,
 282                             unsigned layer,
 283                             struct pipe_video_buffer *buffer,
 284                             struct pipe_video_rect *src_rect,
 285                             struct pipe_video_rect *dst_rect);
 286
 287    /**
 288     * set a paletted sampler as a layer to render
 289     */
 290    void (*set_palette_layer)(struct pipe_video_compositor *compositor,
 291                              unsigned layer,
 292                              struct pipe_sampler_view *indexes,
 293                              struct pipe_sampler_view *palette,
 294                              struct pipe_video_rect *src_rect,
 295                              struct pipe_video_rect *dst_rect);
 296
 297    /**
 298     * set a rgba sampler as a layer to render
 299     */
 300    void (*set_rgba_layer)(struct pipe_video_compositor *compositor,
 301                           unsigned layer,
 302                           struct pipe_sampler_view *rgba,
 303                           struct pipe_video_rect *src_rect,
 304                           struct pipe_video_rect *dst_rect);
 305
 306    /*@}*/
 307
 308    /**
 309     * render the layers to the frontbuffer
 310     */
 311    void (*render_picture)(struct pipe_video_compositor  *compositor,
 312                           enum pipe_mpeg12_picture_type picture_type,
 313                           struct pipe_surface           *dst_surface,
 314                           struct pipe_video_rect        *dst_area,
 315                           struct pipe_fence_handle      **fence);
 316
 317 };
 318
 319 #ifdef __cplusplus
 320 }
 321 #endif
 322
 323 #endif /* PIPE_VIDEO_CONTEXT_H */