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