Home | History | Annotate | Download | only in vl 
      1 /**************************************************************************
      2  *
      3  * Copyright 2011 Christian Knig.
      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 vl_video_buffer_h
     29 #define vl_video_buffer_h
     30 
     31 #include "pipe/p_context.h"
     32 #include "pipe/p_video_decoder.h"
     33 
     34 #include "vl_defines.h"
     35 
     36 /**
     37  * implementation of a planar ycbcr buffer
     38  */
     39 
     40 /* planar buffer for vl data upload and manipulation */
     41 struct vl_video_buffer
     42 {
     43    struct pipe_video_buffer base;
     44    unsigned                 num_planes;
     45    struct pipe_resource     *resources[VL_NUM_COMPONENTS];
     46    struct pipe_sampler_view *sampler_view_planes[VL_NUM_COMPONENTS];
     47    struct pipe_sampler_view *sampler_view_components[VL_NUM_COMPONENTS];
     48    struct pipe_surface      *surfaces[VL_MAX_SURFACES];
     49 };
     50 
     51 /**
     52  * get subformats for each plane
     53  */
     54 const enum pipe_format *
     55 vl_video_buffer_formats(struct pipe_screen *screen, enum pipe_format format);
     56 
     57 /**
     58  * get YUV plane order
     59  */
     60 const unsigned *
     61 vl_video_buffer_plane_order(enum pipe_format format);
     62 
     63 /**
     64  * get maximum size of video buffers
     65  */
     66 unsigned
     67 vl_video_buffer_max_size(struct pipe_screen *screen);
     68 
     69 /**
     70  * check if video buffer format is supported for a codec/profile
     71  * can be used as default implementation of screen->is_video_format_supported
     72  */
     73 boolean
     74 vl_video_buffer_is_format_supported(struct pipe_screen *screen,
     75                                     enum pipe_format format,
     76                                     enum pipe_video_profile profile);
     77 
     78 /*
     79  * set the associated data for the given video buffer
     80  */
     81 void
     82 vl_video_buffer_set_associated_data(struct pipe_video_buffer *vbuf,
     83                                     struct pipe_video_decoder *vdec,
     84                                     void *associated_data,
     85                                     void (*destroy_associated_data)(void *));
     86 
     87 /*
     88  * get the associated data for the given video buffer
     89  */
     90 void *
     91 vl_video_buffer_get_associated_data(struct pipe_video_buffer *vbuf,
     92                                     struct pipe_video_decoder *vdec);
     93 
     94 /**
     95  * fill a resource template for the given plane
     96  */
     97 void
     98 vl_vide_buffer_template(struct pipe_resource *templ,
     99 			const struct pipe_video_buffer *templat,
    100                         enum pipe_format resource_format,
    101                         unsigned depth, unsigned usage, unsigned plane);
    102 
    103 /**
    104  * creates a video buffer, can be used as a standard implementation for pipe->create_video_buffer
    105  */
    106 struct pipe_video_buffer *
    107 vl_video_buffer_create(struct pipe_context *pipe,
    108                        const struct pipe_video_buffer *templat);
    109 
    110 /**
    111  * extended create function, gets depth, usage and formats for each plane seperately
    112  */
    113 struct pipe_video_buffer *
    114 vl_video_buffer_create_ex(struct pipe_context *pipe,
    115                           const struct pipe_video_buffer *templat,
    116                           const enum pipe_format resource_formats[VL_NUM_COMPONENTS],
    117                           unsigned depth, unsigned usage);
    118 
    119 /**
    120  * even more extended create function, provide the pipe_resource for each plane
    121  */
    122 struct pipe_video_buffer *
    123 vl_video_buffer_create_ex2(struct pipe_context *pipe,
    124                            const struct pipe_video_buffer *templat,
    125                            struct pipe_resource *resources[VL_NUM_COMPONENTS]);
    126 
    127 #endif /* vl_video_buffer_h */
    128