]> git.sesse.net Git - vlc/blob - modules/video_output/ggi.c
b_menu_change: remove write-only variable
[vlc] / modules / video_output / ggi.c
1 /*****************************************************************************
2  * ggi.c : GGI plugin for vlc
3  *****************************************************************************
4  * Copyright (C) 2000, 2001 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Vincent Seguin <seguin@via.ecp.fr>
8  *          Samuel Hocevar <sam@zoy.org>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23  *****************************************************************************/
24
25 /*****************************************************************************
26  * Preamble
27  *****************************************************************************/
28 #include <errno.h>                                                 /* ENOMEM */
29
30 #include <ggi/ggi.h>
31
32 #ifdef HAVE_CONFIG_H
33 # include "config.h"
34 #endif
35
36 #include <vlc_common.h>
37 #include <vlc_plugin.h>
38 #include <vlc_interface.h>
39 #include <vlc_vout.h>
40
41 /*****************************************************************************
42  * Local prototypes
43  *****************************************************************************/
44 static int  Create    ( vlc_object_t * );
45 static void Destroy   ( vlc_object_t * );
46
47 static int  Init      ( vout_thread_t * );
48 static void End       ( vout_thread_t * );
49 static int  Manage    ( vout_thread_t * );
50 static void Display   ( vout_thread_t *, picture_t * );
51
52 static int  OpenDisplay    ( vout_thread_t * );
53 static void CloseDisplay   ( vout_thread_t * );
54 static void SetPalette     ( vout_thread_t *, uint16_t *, uint16_t *, uint16_t * );
55
56 /*****************************************************************************
57  * Module descriptor
58  *****************************************************************************/
59 #define DISPLAY_TEXT N_("X11 display")
60 #define DISPLAY_LONGTEXT N_( \
61             "X11 hardware display to use.\n" \
62             "By default, VLC will use the value of the DISPLAY " \
63             "environment variable.")
64
65 vlc_module_begin ()
66     add_string( "ggi-display", NULL, NULL, DISPLAY_TEXT, DISPLAY_LONGTEXT, true )
67     set_description( "General Graphics Interface video output" )
68     set_capability( "video output", 30 )
69     set_callbacks( Create, Destroy )
70 vlc_module_end ()
71
72 /*****************************************************************************
73  * vout_sys_t: video output GGI method descriptor
74  *****************************************************************************
75  * This structure is part of the video output thread descriptor.
76  * It describes the GGI specific properties of an output thread.
77  *****************************************************************************/
78 struct vout_sys_t
79 {
80     /* GGI system information */
81     ggi_visual_t        p_display;                         /* display device */
82
83     ggi_mode            mode;                             /* mode descriptor */
84     int                 i_bits_per_pixel;
85
86     /* Buffer information */
87     ggi_directbuffer *  pp_buffer[2];                             /* buffers */
88     int                 i_index;
89
90     bool          b_must_acquire;   /* must be acquired before writing */
91 };
92
93 /*****************************************************************************
94  * Create: allocate GGI video thread output method
95  *****************************************************************************
96  * This function allocate and initialize a GGI vout method. It uses some of the
97  * vout properties to choose the correct mode, and change them according to the
98  * mode actually used.
99  *****************************************************************************/
100 static int Create( vlc_object_t *p_this )
101 {
102     vout_thread_t *p_vout = (vout_thread_t *)p_this;
103
104     /* Allocate structure */
105     p_vout->p_sys = malloc( sizeof( vout_sys_t ) );
106     if( p_vout->p_sys == NULL )
107         return( 1 );
108
109     /* Open and initialize device */
110     if( OpenDisplay( p_vout ) )
111     {
112         msg_Err( p_vout, "cannot initialize GGI display" );
113         free( p_vout->p_sys );
114         return( 1 );
115     }
116
117     p_vout->pf_init = Init;
118     p_vout->pf_end = End;
119     p_vout->pf_manage = Manage;
120     p_vout->pf_render = NULL;
121     p_vout->pf_display = Display;
122
123     return( 0 );
124 }
125
126 /*****************************************************************************
127  * Init: initialize GGI video thread output method
128  *****************************************************************************
129  * This function initialize the GGI display device.
130  *****************************************************************************/
131 static int Init( vout_thread_t *p_vout )
132 {
133 #define p_b p_vout->p_sys->pp_buffer
134     int i_index;
135     picture_t *p_pic;
136
137     I_OUTPUTPICTURES = 0;
138
139     p_vout->output.i_width  = p_vout->p_sys->mode.visible.x;
140     p_vout->output.i_height = p_vout->p_sys->mode.visible.y;
141     p_vout->output.i_aspect = p_vout->p_sys->mode.visible.x
142                                * VOUT_ASPECT_FACTOR
143                                / p_vout->p_sys->mode.visible.y;
144
145     switch( p_vout->p_sys->i_bits_per_pixel )
146     {
147         case 8:
148             p_vout->output.i_chroma = VLC_FOURCC('R','G','B','2');
149             p_vout->output.pf_setpalette = SetPalette;
150             break;
151         case 15:
152             p_vout->output.i_chroma = VLC_FOURCC('R','V','1','5'); break;
153         case 16:
154             p_vout->output.i_chroma = VLC_FOURCC('R','V','1','6'); break;
155         case 24:
156             p_vout->output.i_chroma = VLC_FOURCC('R','V','2','4'); break;
157         case 32:
158             p_vout->output.i_chroma = VLC_FOURCC('R','V','3','2'); break;
159         default:
160             msg_Err( p_vout, "unknown screen depth %i",
161                      p_vout->p_sys->i_bits_per_pixel );
162             return 0;
163     }
164
165     /* Only useful for bits_per_pixel != 8 */
166     p_vout->output.i_rmask = p_b[ 0 ]->buffer.plb.pixelformat->red_mask;
167     p_vout->output.i_gmask = p_b[ 0 ]->buffer.plb.pixelformat->green_mask;
168     p_vout->output.i_bmask = p_b[ 0 ]->buffer.plb.pixelformat->blue_mask;
169
170     p_pic = NULL;
171
172     /* Find an empty picture slot */
173     for( i_index = 0 ; i_index < VOUT_MAX_PICTURES ; i_index++ )
174     {
175         if( p_vout->p_picture[ i_index ].i_status == FREE_PICTURE )
176         {
177             p_pic = p_vout->p_picture + i_index;
178             break;
179         }
180     }
181
182     if( p_pic == NULL )
183     {
184         return 0;
185     }
186
187     /* We know the chroma, allocate a buffer which will be used
188      * directly by the decoder */
189     p_vout->p_sys->i_index = 0;
190     p_pic->p->p_pixels = p_b[ 0 ]->write;
191     p_pic->p->i_pixel_pitch = p_b[ 0 ]->buffer.plb.pixelformat->size / 8;
192     p_pic->p->i_lines = p_vout->p_sys->mode.visible.y;
193     p_pic->p->i_visible_lines = p_vout->p_sys->mode.visible.y;
194
195     p_pic->p->i_pitch = p_b[ 0 ]->buffer.plb.stride;
196
197     if( p_b[ 0 ]->buffer.plb.pixelformat->size / 8
198          * p_vout->p_sys->mode.visible.x
199         != p_b[ 0 ]->buffer.plb.stride )
200     {
201         p_pic->p->i_visible_pitch = p_b[ 0 ]->buffer.plb.pixelformat->size
202                                      / 8 * p_vout->p_sys->mode.visible.x;
203     }
204     else
205     {
206         p_pic->p->i_visible_pitch = p_b[ 0 ]->buffer.plb.stride;
207     }
208
209     p_pic->i_planes = 1;
210
211     p_pic->i_status = DESTROYED_PICTURE;
212     p_pic->i_type   = DIRECT_PICTURE;
213
214     PP_OUTPUTPICTURE[ I_OUTPUTPICTURES ] = p_pic;
215
216     I_OUTPUTPICTURES++;
217
218     /* Acquire first buffer */
219     if( p_vout->p_sys->b_must_acquire )
220     {
221         ggiResourceAcquire( p_b[ 0 ]->resource,
222                             GGI_ACTYPE_WRITE );
223     }
224
225     /* Listen to the keyboard and the mouse buttons */
226     ggiSetEventMask( p_vout->p_sys->p_display,
227                      emKeyboard | emPtrButtonPress | emPtrButtonRelease );
228
229     /* Set asynchronous display mode -- usually quite faster */
230     ggiAddFlags( p_vout->p_sys->p_display, GGIFLAG_ASYNC );
231
232     return( 0 );
233 #undef p_b
234 }
235
236 /*****************************************************************************
237  * End: terminate GGI video thread output method
238  *****************************************************************************
239  * Terminate an output method created by Create
240  *****************************************************************************/
241 static void End( vout_thread_t *p_vout )
242 {
243 #define p_b p_vout->p_sys->pp_buffer
244     /* Release buffer */
245     if( p_vout->p_sys->b_must_acquire )
246     {
247         ggiResourceRelease( p_b[ p_vout->p_sys->i_index ]->resource );
248     }
249 #undef p_b
250 }
251
252 /*****************************************************************************
253  * Destroy: destroy GGI video thread output method
254  *****************************************************************************
255  * Terminate an output method created by Create
256  *****************************************************************************/
257 static void Destroy( vlc_object_t *p_this )
258 {
259     vout_thread_t *p_vout = (vout_thread_t *)p_this;
260
261     CloseDisplay( p_vout );
262
263     free( p_vout->p_sys );
264 }
265
266 /*****************************************************************************
267  * Manage: handle GGI events
268  *****************************************************************************
269  * This function should be called regularly by video output thread. It returns
270  * a non null value if an error occurred.
271  *****************************************************************************/
272 static int Manage( vout_thread_t *p_vout )
273 {
274     struct timeval tv = { 0, 1000 };                        /* 1 millisecond */
275     gii_event_mask mask;
276     gii_event      event;
277     vlc_value_t    val;
278
279     mask = emKeyboard | emPtrButtonPress | emPtrButtonRelease;
280
281     ggiEventPoll( p_vout->p_sys->p_display, mask, &tv );
282
283     while( ggiEventsQueued( p_vout->p_sys->p_display, mask) )
284     {
285         ggiEventRead( p_vout->p_sys->p_display, &event, mask);
286
287         switch( event.any.type )
288         {
289             case evKeyRelease:
290
291                 switch( event.key.sym )
292                 {
293                     case 'q':
294                     case 'Q':
295                     case GIIUC_Escape:
296                         vlc_object_kill( p_vout->p_libvlc );
297                         break;
298
299                     default:
300                         break;
301                 }
302                 break;
303
304             case evPtrButtonRelease:
305
306                 switch( event.pbutton.button )
307                 {
308                     case GII_PBUTTON_LEFT:
309                         val.b_bool = true;
310                         var_Set( p_vout, "mouse-clicked", val );
311                         break;
312
313                     case GII_PBUTTON_RIGHT:
314                         /* trigger contextual menu here */
315                         break;
316                 }
317                 break;
318
319             default:
320                 break;
321         }
322     }
323
324     return( 0 );
325 }
326
327 /*****************************************************************************
328  * Display: displays previously rendered output
329  *****************************************************************************/
330 static void Display( vout_thread_t *p_vout, picture_t *p_pic )
331 {
332 #define p_b p_vout->p_sys->pp_buffer
333     p_pic->p->p_pixels = p_b[ p_vout->p_sys->i_index ]->write;
334
335     /* Change display frame */
336     if( p_vout->p_sys->b_must_acquire )
337     {
338         ggiResourceRelease( p_b[ p_vout->p_sys->i_index ]->resource );
339     }
340     ggiSetDisplayFrame( p_vout->p_sys->p_display,
341                         p_b[ p_vout->p_sys->i_index ]->frame );
342
343     /* Swap buffers and change write frame */
344     p_vout->p_sys->i_index ^= 1;
345     p_pic->p->p_pixels = p_b[ p_vout->p_sys->i_index ]->write;
346
347     if( p_vout->p_sys->b_must_acquire )
348     {
349         ggiResourceAcquire( p_b[ p_vout->p_sys->i_index ]->resource,
350                             GGI_ACTYPE_WRITE );
351     }
352     ggiSetWriteFrame( p_vout->p_sys->p_display,
353                       p_b[ p_vout->p_sys->i_index ]->frame );
354
355     /* Flush the output so that it actually displays */
356     ggiFlush( p_vout->p_sys->p_display );
357 #undef p_b
358 }
359
360 /* following functions are local */
361
362 /*****************************************************************************
363  * OpenDisplay: open and initialize GGI device
364  *****************************************************************************
365  * Open and initialize display according to preferences specified in the vout
366  * thread fields.
367  *****************************************************************************/
368 static int OpenDisplay( vout_thread_t *p_vout )
369 {
370 #define p_b p_vout->p_sys->pp_buffer
371     ggi_color   col_fg;                                  /* foreground color */
372     ggi_color   col_bg;                                  /* background color */
373     int         i_index;                               /* all purposes index */
374     char        *psz_display;
375
376     /* Initialize library */
377     if( ggiInit() )
378     {
379         msg_Err( p_vout, "cannot initialize GGI library" );
380         return( 1 );
381     }
382
383     /* Open display */
384     psz_display = config_GetPsz( p_vout, "ggi_display" );
385
386     p_vout->p_sys->p_display = ggiOpen( psz_display, NULL );
387     free( psz_display );
388
389     if( p_vout->p_sys->p_display == NULL )
390     {
391         msg_Err( p_vout, "cannot open GGI default display" );
392         ggiExit();
393         return( 1 );
394     }
395
396     /* Find most appropriate mode */
397     p_vout->p_sys->mode.frames =    2;                          /* 2 buffers */
398     p_vout->p_sys->mode.visible.x = config_GetInt( p_vout, "width" );
399     p_vout->p_sys->mode.visible.y = config_GetInt( p_vout, "height" );
400     p_vout->p_sys->mode.virt.x =    GGI_AUTO;
401     p_vout->p_sys->mode.virt.y =    GGI_AUTO;
402     p_vout->p_sys->mode.size.x =    GGI_AUTO;
403     p_vout->p_sys->mode.size.y =    GGI_AUTO;
404     p_vout->p_sys->mode.graphtype = GT_15BIT;        /* minimum usable depth */
405     p_vout->p_sys->mode.dpp.x =     GGI_AUTO;
406     p_vout->p_sys->mode.dpp.y =     GGI_AUTO;
407     ggiCheckMode( p_vout->p_sys->p_display, &p_vout->p_sys->mode );
408
409     /* FIXME: Check that returned mode has some minimum properties */
410
411     /* Set mode */
412     if( ggiSetMode( p_vout->p_sys->p_display, &p_vout->p_sys->mode ) )
413     {
414         msg_Err( p_vout, "cannot set GGI mode" );
415         ggiClose( p_vout->p_sys->p_display );
416         ggiExit();
417         return( 1 );
418     }
419
420     /* Check buffers properties */
421     p_vout->p_sys->b_must_acquire = 0;
422     for( i_index = 0; i_index < 2; i_index++ )
423     {
424         /* Get buffer address */
425         p_vout->p_sys->pp_buffer[ i_index ] =
426             (ggi_directbuffer *)ggiDBGetBuffer( p_vout->p_sys->p_display,
427                                                 i_index );
428         if( p_b[ i_index ] == NULL )
429         {
430             msg_Err( p_vout, "double buffering is not possible" );
431             ggiClose( p_vout->p_sys->p_display );
432             ggiExit();
433             return( 1 );
434         }
435
436         /* Check buffer properties */
437         if( ! ( p_b[ i_index ]->type & GGI_DB_SIMPLE_PLB )
438            || ( p_b[ i_index ]->page_size != 0 )
439            || ( p_b[ i_index ]->write == NULL )
440            || ( p_b[ i_index ]->noaccess != 0 )
441            || ( p_b[ i_index ]->align != 0 ) )
442         {
443             msg_Err( p_vout, "incorrect video memory type" );
444             ggiClose( p_vout->p_sys->p_display );
445             ggiExit();
446             return( 1 );
447         }
448
449         /* Check if buffer needs to be acquired before write */
450         if( ggiResourceMustAcquire( p_b[ i_index ]->resource ) )
451         {
452             p_vout->p_sys->b_must_acquire = 1;
453         }
454     }
455
456     /* Set graphic context colors */
457     col_fg.r = col_fg.g = col_fg.b = -1;
458     col_bg.r = col_bg.g = col_bg.b = 0;
459     if( ggiSetGCForeground(p_vout->p_sys->p_display,
460                            ggiMapColor(p_vout->p_sys->p_display,&col_fg)) ||
461         ggiSetGCBackground(p_vout->p_sys->p_display,
462                            ggiMapColor(p_vout->p_sys->p_display,&col_bg)) )
463     {
464         msg_Err( p_vout, "cannot set colors" );
465         ggiClose( p_vout->p_sys->p_display );
466         ggiExit();
467         return( 1 );
468     }
469
470     /* Set clipping for text */
471     if( ggiSetGCClipping( p_vout->p_sys->p_display, 0, 0,
472                           p_vout->p_sys->mode.visible.x,
473                           p_vout->p_sys->mode.visible.y ) )
474     {
475         msg_Err( p_vout, "cannot set clipping" );
476         ggiClose( p_vout->p_sys->p_display );
477         ggiExit();
478         return( 1 );
479     }
480
481     /* FIXME: set palette in 8bpp */
482     p_vout->p_sys->i_bits_per_pixel = p_b[ 0 ]->buffer.plb.pixelformat->depth;
483
484     return( 0 );
485 #undef p_b
486 }
487
488 /*****************************************************************************
489  * CloseDisplay: close and reset GGI device
490  *****************************************************************************
491  * This function returns all resources allocated by OpenDisplay and restore
492  * the original state of the device.
493  *****************************************************************************/
494 static void CloseDisplay( vout_thread_t *p_vout )
495 {
496     /* Restore original mode and close display */
497     ggiClose( p_vout->p_sys->p_display );
498
499     /* Exit library */
500     ggiExit();
501 }
502
503 /*****************************************************************************
504  * SetPalette: sets an 8 bpp palette
505  *****************************************************************************/
506 static void SetPalette( vout_thread_t *p_vout,
507                         uint16_t *red, uint16_t *green, uint16_t *blue )
508 {
509     ggi_color colors[256];
510     int i;
511
512     /* Fill colors with color information */
513     for( i = 0; i < 256; i++ )
514     {
515         colors[ i ].r = red[ i ];
516         colors[ i ].g = green[ i ];
517         colors[ i ].b = blue[ i ];
518         colors[ i ].a = 0;
519     }
520
521     /* Set palette */
522     if( ggiSetPalette( p_vout->p_sys->p_display, 0, 256, colors ) < 0 )
523     {
524         msg_Err( p_vout, "failed to set palette" );
525     }
526 }
527