vl_video_buffer.h revision 3a2b906805985e0a4258bcbaed4cdff758875514 
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#define VL_MAX_PLANES 3
34
35/**
36 * implementation of a planar ycbcr buffer
37 */
38
39/* resources of a buffer */
40typedef struct pipe_resource *vl_resources[VL_MAX_PLANES];
41
42/* sampler views of a buffer */
43typedef struct pipe_sampler_view *vl_sampler_views[VL_MAX_PLANES];
44
45/* surfaces of a buffer */
46typedef struct pipe_surface *vl_surfaces[VL_MAX_PLANES];
47
48/* planar buffer for vl data upload and manipulation */
49struct vl_video_buffer
50{
51   struct pipe_context *pipe;
52   unsigned            num_planes;
53   vl_resources        resources;
54   vl_sampler_views    sampler_views;
55   vl_surfaces         surfaces;
56};
57
58/**
59 * initialize a buffer, creating its resources
60 */
61bool vl_video_buffer_init(struct vl_video_buffer *buffer,
62                          struct pipe_context *pipe,
63                          unsigned width, unsigned height, unsigned depth,
64                          enum pipe_video_chroma_format chroma_format,
65                          unsigned num_planes,
66                          const enum pipe_format resource_formats[VL_MAX_PLANES],
67                          unsigned usage);
68
69/**
70 * create default sampler views for the buffer on demand
71 */
72vl_sampler_views *vl_video_buffer_sampler_views(struct vl_video_buffer *buffer);
73
74/**
75 * create default surfaces for the buffer on demand
76 */
77vl_surfaces *vl_video_buffer_surfaces(struct vl_video_buffer *buffer);
78
79/**
80 * cleanup the buffer destroying all its resources
81 */
82void vl_video_buffer_cleanup(struct vl_video_buffer *buffer);
83
84#endif
85