src/gallium/auxiliary/vl/vl_ycbcr_buffer.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2011 Christian König.
   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_ycbcr_buffer_h
  29 #define vl_ycbcr_buffer_h
  30
  31 #include <pipe/p_state.h>
  32
  33 /**
  34  * implementation of a planar ycbcr buffer
  35  */
  36
  37 /* resources of a buffer */
  38 struct vl_ycbcr_resources
  39 {
  40    struct pipe_resource *y, *cb, *cr;
  41 };
  42
  43 /* sampler views of a buffer */
  44 struct vl_ycbcr_sampler_views
  45 {
  46    struct pipe_sampler_view *y, *cb, *cr;
  47 };
  48
  49 /* surfaces of a buffer */
  50 struct vl_ycbcr_surfaces
  51 {
  52    struct pipe_surface *y, *cb, *cr;
  53 };
  54
  55 /* planar buffer for vl data upload and manipulation */
  56 struct vl_ycbcr_buffer
  57 {
  58    struct pipe_context           *pipe;
  59    struct vl_ycbcr_resources     resources;
  60    struct vl_ycbcr_sampler_views sampler_views;
  61    struct vl_ycbcr_surfaces      surfaces;
  62 };
  63
  64 /**
  65  * initialize a buffer, creating its resources
  66  */
  67 bool vl_ycbcr_buffer_init(struct vl_ycbcr_buffer *buffer,
  68                           struct pipe_context *pipe,
  69                           unsigned width, unsigned height,
  70                           enum pipe_video_chroma_format chroma_format,
  71                           enum pipe_format resource_format,
  72                           unsigned usage);
  73
  74 /**
  75  * create default sampler views for the buffer on demand
  76  */
  77 struct vl_ycbcr_sampler_views *vl_ycbcr_get_sampler_views(struct vl_ycbcr_buffer *buffer);
  78
  79 /**
  80  * create default surfaces for the buffer on demand
  81  */
  82 struct vl_ycbcr_surfaces *vl_ycbcr_get_surfaces(struct vl_ycbcr_buffer *buffer);
  83
  84 /**
  85  * cleanup the buffer destroying all its resources
  86  */
  87 void vl_ycbcr_buffer_cleanup(struct vl_ycbcr_buffer *buffer);
  88
  89 #endif