1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
|
/*
(c) Copyright 2001-2009 The world wide DirectFB Open Source Community (directfb.org)
(c) Copyright 2000-2004 Convergence (integrated media) GmbH
All rights reserved.
Written by Denis Oliver Kropp <dok@directfb.org>,
Andreas Hundt <andi@fischlustig.de>,
Sven Neumann <neo@directfb.org>,
Ville Syrjälä <syrjala@sci.fi> and
Claudio Ciccani <klan@users.sf.net>.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#ifndef __CORE__LAYERS_H__
#define __CORE__LAYERS_H__
#include <directfb.h>
#include <core/coretypes.h>
#include <core/gfxcard.h>
#include <core/surface_buffer.h>
struct __DFB_CoreLayerRegionConfig {
int width; /* width of the source in pixels */
int height; /* height of the source in pixels */
DFBSurfacePixelFormat format; /* pixel format of the source surface */
DFBSurfaceCapabilities surface_caps; /* capabilities of the source surface */
DFBDisplayLayerBufferMode buffermode; /* surface buffer configuration */
DFBDisplayLayerOptions options; /* various configuration options */
DFBDisplayLayerSourceID source_id; /* selected source */
DFBRectangle source; /* viewport within source (input) */
DFBRectangle dest; /* viewport on screen (output) */
u8 opacity; /* global region alpha */
DFBColorKey src_key; /* source color key */
DFBColorKey dst_key; /* destination color key */
int parity; /* field parity (for interlaced) */
u8 alpha_ramp[4]; /* alpha values for 1 or 2 bit lookup */
DFBRegion *clips; /* clip regions */
int num_clips; /* number of clip regions */
DFBBoolean positive; /* show or cut out regions */
};
#if D_DEBUG_ENABLED
#define DFB_CORE_LAYER_REGION_CONFIG_DEBUG_AT( domain, config ) \
do { \
const CoreLayerRegionConfig *_config = config; \
\
D_DEBUG_AT( domain, " -> size %dx%d\n", _config->width, _config->height ); \
D_DEBUG_AT( domain, " -> format %s\n", dfb_pixelformat_name( _config->format ) ); \
D_DEBUG_AT( domain, " -> surf caps 0x%08x\n", _config->surface_caps ); \
D_DEBUG_AT( domain, " -> buffermode %d\n", _config->buffermode ); \
D_DEBUG_AT( domain, " -> options 0x%08x\n", _config->options ); \
D_DEBUG_AT( domain, " -> source %d,%d-%dx%d\n", DFB_RECTANGLE_VALS(&_config->source) ); \
D_DEBUG_AT( domain, " -> dest %d,%d-%dx%d\n", DFB_RECTANGLE_VALS(&_config->dest) ); \
D_DEBUG_AT( domain, " -> opacity %d\n", _config->opacity ); \
D_DEBUG_AT( domain, " -> src_key %02x%02x%02x (index %d)\n", DFB_COLORKEY_VALS(&_config->src_key) ); \
D_DEBUG_AT( domain, " -> dst_key %02x%02x%02x (index %d)\n", DFB_COLORKEY_VALS(&_config->dst_key) ); \
} while (0)
#else
#define DFB_CORE_LAYER_REGION_CONFIG_DEBUG_AT( domain, config ) \
do { \
} while (0)
#endif
typedef enum {
CLRCF_NONE = 0x00000000,
CLRCF_WIDTH = 0x00000001,
CLRCF_HEIGHT = 0x00000002,
CLRCF_FORMAT = 0x00000004,
CLRCF_SURFACE_CAPS = 0x00000008,
CLRCF_BUFFERMODE = 0x00000010,
CLRCF_OPTIONS = 0x00000020,
CLRCF_SOURCE_ID = 0x00000040,
CLRCF_SOURCE = 0x00000100,
CLRCF_DEST = 0x00000200,
CLRCF_CLIPS = 0x00000400,
CLRCF_OPACITY = 0x00001000,
CLRCF_ALPHA_RAMP = 0x00002000,
CLRCF_SRCKEY = 0x00010000,
CLRCF_DSTKEY = 0x00020000,
CLRCF_PARITY = 0x00100000,
CLRCF_SURFACE = 0x10000000,
CLRCF_PALETTE = 0x20000000,
CLRCF_FREEZE = 0x80000000,
CLRCF_ALL = 0xB013377F
} CoreLayerRegionConfigFlags;
typedef struct {
/** Driver Control **/
/*
* Return size of layer data (shared memory).
*/
int (*LayerDataSize) ( void );
/*
* Return size of region data (shared memory).
*/
int (*RegionDataSize)( void );
/*
* Called once by the master to initialize layer data and reset hardware.
* Return layer description, default configuration and color adjustment.
*/
DFBResult (*InitLayer) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
DFBDisplayLayerDescription *description,
DFBDisplayLayerConfig *config,
DFBColorAdjustment *adjustment );
/*
* Called once by the master for each source.
* Driver fills description.
*/
DFBResult (*InitSource) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
int source,
DFBDisplayLayerSourceDescription *description );
/** Layer Control **/
/*
* Return the currently displayed field (interlaced only).
*/
DFBResult (*GetCurrentOutputField)( CoreLayer *layer,
void *driver_data,
void *layer_data,
int *field );
/*
* Return the z position of the layer.
*/
DFBResult (*GetLevel) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
int *level );
/*
* Move the layer below or on top of others (z position).
*/
DFBResult (*SetLevel) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
int level );
/** Configuration **/
/*
* Adjust brightness, contrast, saturation etc.
*/
DFBResult (*SetColorAdjustment) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
DFBColorAdjustment *adjustment );
/** Region Control **/
/*
* Check all parameters and return if this region is supported.
*/
DFBResult (*TestRegion) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
CoreLayerRegionConfig *config,
CoreLayerRegionConfigFlags *failed );
/*
* Add a new region to the layer, but don't program hardware, yet.
*/
DFBResult (*AddRegion) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreLayerRegionConfig *config );
/*
* Setup hardware, called once after AddRegion() or when parameters
* have changed. Surface and palette are only set if updated or new.
*/
DFBResult (*SetRegion) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreLayerRegionConfig *config,
CoreLayerRegionConfigFlags updated,
CoreSurface *surface,
CorePalette *palette,
CoreSurfaceBufferLock *lock );
/*
* Remove a region from the layer.
*/
DFBResult (*RemoveRegion) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data );
/*
* Flip the surface of the region.
*/
DFBResult (*FlipRegion) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreSurface *surface,
DFBSurfaceFlipFlags flags,
CoreSurfaceBufferLock *lock );
/*
* Indicate updates to the front buffer content.
*/
DFBResult (*UpdateRegion) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreSurface *surface,
const DFBRegion *update,
CoreSurfaceBufferLock *lock );
/*
* Control hardware deinterlacing.
*/
DFBResult (*SetInputField)( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
int field );
/** Override defaults. Subject to change. **/
/*
* Allocate the surface of the region.
*/
DFBResult (*AllocateSurface) ( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreLayerRegionConfig *config,
CoreSurface **ret_surface );
/*
* Reallocate the surface of the region.
*/
DFBResult (*ReallocateSurface)( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreLayerRegionConfig *config,
CoreSurface *surface );
/*
* Deallocate the surface of the region.
*/
DFBResult (*DeallocateSurface)( CoreLayer *layer,
void *driver_data,
void *layer_data,
void *region_data,
CoreSurface *surface );
} DisplayLayerFuncs;
/*
* Add a layer to a graphics device by pointing to a table
* containing driver functions. The supplied driver data
* will be passed to these functions.
*/
CoreLayer *dfb_layers_register( CoreScreen *screen,
void *driver_data,
const DisplayLayerFuncs *funcs );
/*
* Replace functions of the primary layer implementation by passing
* an alternative driver function table. All non-NULL functions in the new
* table replace the functions in the original function table.
* The original function table is written to 'primary_funcs' before to allow
* drivers to use existing functionality from the original implementation.
*/
CoreLayer *dfb_layers_hook_primary( CoreGraphicsDevice *device,
void *driver_data,
DisplayLayerFuncs *funcs,
DisplayLayerFuncs *primary_funcs,
void **primary_driver_data );
/*
* Replace functions of the primary layer implementation completely by passing
* an alternative driver function table.
*/
CoreLayer *dfb_layers_replace_primary( CoreGraphicsDevice *device,
void *driver_data,
DisplayLayerFuncs *funcs );
typedef DFBEnumerationResult (*DisplayLayerCallback) (CoreLayer *layer,
void *ctx);
void dfb_layers_enumerate( DisplayLayerCallback callback,
void *ctx );
int dfb_layer_num( void );
CoreLayer *dfb_layer_at( DFBDisplayLayerID id );
CoreLayer *dfb_layer_at_translated( DFBDisplayLayerID id );
void dfb_layer_get_description( const CoreLayer *layer,
DFBDisplayLayerDescription *desc );
CoreScreen *dfb_layer_screen( const CoreLayer *layer );
CardState *dfb_layer_state( CoreLayer *layer );
DFBDisplayLayerID dfb_layer_id( const CoreLayer *layer );
DFBDisplayLayerID dfb_layer_id_translated( const CoreLayer *layer );
DFBSurfacePixelFormat dfb_primary_layer_pixelformat( void );
#endif
|
