vl_compositor.h revision bd5fd67a3e3cda4b7676dd4745fc5d5524709210 
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 vl_compositor_h
29#define vl_compositor_h
30
31#include <pipe/p_state.h>
32#include <pipe/p_video_context.h>
33#include <pipe/p_video_state.h>
34
35#include "vl_types.h"
36
37struct pipe_context;
38
39/**
40 * composing and displaying of image data
41 */
42
43#define VL_COMPOSITOR_MAX_LAYERS 16
44
45struct vl_compositor_layer
46{
47   bool clearing;
48
49   void *fs;
50   void *samplers[3];
51
52   struct pipe_sampler_view *sampler_views[3];
53   struct {
54      struct vertex2f tl, br;
55   } src, dst;
56};
57
58struct vl_compositor
59{
60   struct pipe_context *pipe;
61
62   struct pipe_framebuffer_state fb_state;
63   struct pipe_viewport_state viewport;
64   struct pipe_vertex_buffer vertex_buf;
65   struct pipe_resource *csc_matrix;
66
67   void *sampler_linear;
68   void *sampler_nearest;
69   void *blend;
70   void *rast;
71   void *vertex_elems_state;
72
73   void *vs;
74   void *fs_video_buffer;
75   void *fs_palette;
76   void *fs_rgba;
77
78   float clear_color[4];
79   struct vertex2f dirty_tl, dirty_br;
80
81   unsigned used_layers:VL_COMPOSITOR_MAX_LAYERS;
82   struct vl_compositor_layer layers[VL_COMPOSITOR_MAX_LAYERS];
83};
84
85/**
86 * initialize this compositor
87 */
88bool
89vl_compositor_init(struct vl_compositor *compositor, struct pipe_context *pipe);
90
91/**
92 * set yuv -> rgba conversion matrix
93 */
94void
95vl_compositor_set_csc_matrix(struct vl_compositor *compositor, const float mat[16]);
96
97/**
98 * reset dirty area, so it's cleared with the clear colour
99 */
100void
101vl_compositor_reset_dirty_area(struct vl_compositor *compositor);
102
103/**
104 * set the clear color
105 */
106void
107vl_compositor_set_clear_color(struct vl_compositor *compositor, float color[4]);
108
109/**
110 * set overlay samplers
111 */
112/*@{*/
113
114/**
115 * reset all currently set layers
116 */
117void
118vl_compositor_clear_layers(struct vl_compositor *compositor);
119
120/**
121 * set a video buffer as a layer to render
122 */
123void
124vl_compositor_set_buffer_layer(struct vl_compositor *compositor,
125                               unsigned layer,
126                               struct pipe_video_buffer *buffer,
127                               struct pipe_video_rect *src_rect,
128                               struct pipe_video_rect *dst_rect);
129
130/**
131 * set a paletted sampler as a layer to render
132 */
133void
134vl_compositor_set_palette_layer(struct vl_compositor *compositor,
135                                unsigned layer,
136                                struct pipe_sampler_view *indexes,
137                                struct pipe_sampler_view *palette,
138                                struct pipe_video_rect *src_rect,
139                                struct pipe_video_rect *dst_rect);
140
141/**
142 * set a rgba sampler as a layer to render
143 */
144void
145vl_compositor_set_rgba_layer(struct vl_compositor *compositor,
146                             unsigned layer,
147                             struct pipe_sampler_view *rgba,
148                             struct pipe_video_rect *src_rect,
149                             struct pipe_video_rect *dst_rect);
150
151/*@}*/
152
153/**
154 * render the layers to the frontbuffer
155 */
156void
157vl_compositor_render(struct vl_compositor          *compositor,
158                     enum pipe_mpeg12_picture_type picture_type,
159                     struct pipe_surface           *dst_surface,
160                     struct pipe_video_rect        *dst_area,
161                     struct pipe_fence_handle      **fence);
162
163/**
164* destroy this compositor
165*/
166void
167vl_compositor_cleanup(struct vl_compositor *compositor);
168
169#endif /* vl_compositor_h */
170