1 /*****************************************************************************
2 * video_output.c : video output thread
3 * This module describes the programming interface for video output threads.
4 * It includes functions allowing to open a new thread, send pictures to a
5 * thread, and destroy a previously oppened video output thread.
6 *****************************************************************************
7 * Copyright (C) 2000 VideoLAN
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
24 *****************************************************************************/
26 /*****************************************************************************
28 *****************************************************************************/
31 #include <errno.h> /* ENOMEM */
32 #include <stdlib.h> /* free() */
33 #include <stdio.h> /* sprintf() */
34 #include <string.h> /* strerror() */
42 #include "video_output.h"
43 #include "video_text.h"
44 #include "video_spu.h"
45 #include "video_yuv.h"
50 #include "vdec_idct.h"
51 #include "video_decoder.h"
53 /*****************************************************************************
55 *****************************************************************************/
56 static int BinaryLog ( u32 i );
57 static void MaskToShift ( int *pi_left, int *pi_right, u32 i_mask );
58 static int InitThread ( vout_thread_t *p_vout );
59 static void RunThread ( vout_thread_t *p_vout );
60 static void ErrorThread ( vout_thread_t *p_vout );
61 static void EndThread ( vout_thread_t *p_vout );
62 static void DestroyThread ( vout_thread_t *p_vout, int i_status );
63 static void Print ( vout_thread_t *p_vout, int i_x, int i_y,
64 int i_h_align, int i_v_align,
65 unsigned char *psz_text );
66 static void SetBufferArea ( vout_thread_t *p_vout, int i_x, int i_y,
68 static void SetBufferPicture ( vout_thread_t *p_vout, picture_t *p_pic );
69 static void RenderPicture ( vout_thread_t *p_vout, picture_t *p_pic );
70 static void RenderPictureInfo ( vout_thread_t *p_vout, picture_t *p_pic );
71 static void RenderSubPicture ( vout_thread_t *p_vout,
72 subpicture_t *p_subpic );
73 static void RenderInterface ( vout_thread_t *p_vout );
74 static int RenderIdle ( vout_thread_t *p_vout );
75 static int RenderSplash ( vout_thread_t *p_vout );
76 static void RenderInfo ( vout_thread_t *p_vout );
77 static int Manage ( vout_thread_t *p_vout );
78 static int Align ( vout_thread_t *p_vout, int *pi_x,
79 int *pi_y, int i_width, int i_height,
80 int i_h_align, int i_v_align );
81 static void SetPalette ( p_vout_thread_t p_vout, u16 *red,
82 u16 *green, u16 *blue, u16 *transp );
84 /*****************************************************************************
85 * vout_CreateThread: creates a new video output thread
86 *****************************************************************************
87 * This function creates a new video output thread, and returns a pointer
88 * to its description. On error, it returns NULL.
89 * If pi_status is NULL, then the function will block until the thread is ready.
90 * If not, it will be updated using one of the THREAD_* constants.
91 *****************************************************************************/
92 vout_thread_t * vout_CreateThread ( char *psz_display, int i_root_window,
93 int i_width, int i_height, int *pi_status,
94 int i_method, void *p_data )
96 vout_thread_t * p_vout; /* thread descriptor */
97 typedef void ( vout_getplugin_t ) ( vout_thread_t * p_vout );
98 int i_status; /* thread status */
99 int i_index; /* index for array initialization */
100 int i_best_index = 0, i_best_score = 0;
102 /* Allocate descriptor */
104 p_vout = (vout_thread_t *) malloc( sizeof(vout_thread_t) );
107 intf_ErrMsg( "error: %s\n", strerror(ENOMEM) );
111 p_vout->p_set_palette = SetPalette;
113 /* Get a suitable video plugin */
114 for( i_index = 0 ; i_index < p_main->p_bank->i_plugin_count ; i_index++ )
116 /* If there's a plugin in p_info ... */
117 if( p_main->p_bank->p_info[ i_index ] != NULL )
119 /* ... and if this plugin provides the functions we want ... */
120 if( p_main->p_bank->p_info[ i_index ]->vout_GetPlugin != NULL )
122 /* ... and if this plugin has a good score ... */
123 if( p_main->p_bank->p_info[ i_index ]->i_score > i_best_score )
125 /* ... then take it */
126 i_best_score = p_main->p_bank->p_info[ i_index ]->i_score;
127 i_best_index = i_index;
133 if( i_best_score == 0 )
139 /* Get the plugin functions */
140 ( (vout_getplugin_t *)
141 p_main->p_bank->p_info[ i_best_index ]->vout_GetPlugin )( p_vout );
143 /* Initialize thread properties - thread id and locks will be initialized
147 p_vout->b_active = 0;
148 p_vout->pi_status = (pi_status != NULL) ? pi_status : &i_status;
149 *p_vout->pi_status = THREAD_CREATE;
151 /* Initialize some fields used by the system-dependant method - these
152 * fields will probably be modified by the method, and are only
154 p_vout->i_changes = 0;
155 p_vout->i_width = i_width;
156 p_vout->i_height = i_height;
157 p_vout->i_bytes_per_line = i_width * 2;
158 p_vout->i_screen_depth = 15;
159 p_vout->i_bytes_per_pixel = 2;
160 p_vout->f_gamma = VOUT_GAMMA;
162 p_vout->b_grayscale = main_GetIntVariable( VOUT_GRAYSCALE_VAR,
163 VOUT_GRAYSCALE_DEFAULT );
164 p_vout->vdec_DecodeMacroblock = vdec_DecodeMacroblockC;
166 p_vout->b_interface = 0;
169 intf_DbgMsg( "wished configuration: %dx%d, %d/%d bpp (%d Bpl)\n",
170 p_vout->i_width, p_vout->i_height, p_vout->i_screen_depth,
171 p_vout->i_bytes_per_pixel * 8, p_vout->i_bytes_per_line );
173 /* Initialize idle screen */
174 p_vout->last_display_date = 0;
175 p_vout->last_idle_date = 0;
176 p_vout->init_display_date = mdate();
177 p_vout->render_time = 10000;
179 /* Initialize statistics fields */
180 p_vout->c_fps_samples = 0;
182 /* Initialize buffer index */
183 p_vout->i_buffer_index = 0;
185 /* Initialize pictures and subpictures - translation tables and functions
186 * will be initialized later in InitThread */
187 for( i_index = 0; i_index < VOUT_MAX_PICTURES; i_index++)
189 p_vout->p_picture[i_index].i_type = EMPTY_PICTURE;
190 p_vout->p_picture[i_index].i_status = FREE_PICTURE;
192 for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++)
194 p_vout->p_subpicture[i_index].i_type = EMPTY_SUBPICTURE;
195 p_vout->p_subpicture[i_index].i_status= FREE_SUBPICTURE;
197 p_vout->i_pictures = 0;
199 /* Create and initialize system-dependant method - this function issues its
200 * own error messages */
201 if( p_vout->p_sys_create( p_vout, psz_display, i_root_window, p_data ) )
206 intf_DbgMsg( "actual configuration: %dx%d, %d/%d bpp (%d Bpl), "
207 "masks: 0x%x/0x%x/0x%x\n",
208 p_vout->i_width, p_vout->i_height, p_vout->i_screen_depth,
209 p_vout->i_bytes_per_pixel * 8, p_vout->i_bytes_per_line,
210 p_vout->i_red_mask, p_vout->i_green_mask,
211 p_vout->i_blue_mask );
213 /* Calculate shifts from system-updated masks */
214 MaskToShift( &p_vout->i_red_lshift, &p_vout->i_red_rshift,
215 p_vout->i_red_mask );
216 MaskToShift( &p_vout->i_green_lshift, &p_vout->i_green_rshift,
217 p_vout->i_green_mask );
218 MaskToShift( &p_vout->i_blue_lshift, &p_vout->i_blue_rshift,
219 p_vout->i_blue_mask );
221 /* Set some useful colors */
222 p_vout->i_white_pixel = RGB2PIXEL( p_vout, 255, 255, 255 );
223 p_vout->i_black_pixel = RGB2PIXEL( p_vout, 0, 0, 0 );
224 p_vout->i_gray_pixel = RGB2PIXEL( p_vout, 128, 128, 128 );
225 p_vout->i_blue_pixel = RGB2PIXEL( p_vout, 0, 0, 50 );
227 /* Load fonts - fonts must be initialized after the system method since
228 * they may be dependant on screen depth and other thread properties */
229 p_vout->p_default_font = vout_LoadFont( DATA_PATH "/" VOUT_DEFAULT_FONT );
230 if( p_vout->p_default_font == NULL )
232 p_vout->p_default_font = vout_LoadFont( "share/" VOUT_DEFAULT_FONT );
234 if( p_vout->p_default_font == NULL )
236 intf_ErrMsg( "vout error: could not load default font\n" );
237 p_vout->p_sys_destroy( p_vout );
241 p_vout->p_large_font = vout_LoadFont( DATA_PATH "/" VOUT_LARGE_FONT );
242 if( p_vout->p_large_font == NULL )
244 p_vout->p_large_font = vout_LoadFont( "share/" VOUT_LARGE_FONT );
246 if( p_vout->p_large_font == NULL )
248 intf_ErrMsg( "vout error: could not load large font\n" );
249 vout_UnloadFont( p_vout->p_default_font );
250 p_vout->p_sys_destroy( p_vout );
255 /* Create thread and set locks */
256 vlc_mutex_init( &p_vout->picture_lock );
257 vlc_mutex_init( &p_vout->subpicture_lock );
258 vlc_mutex_init( &p_vout->change_lock );
259 vlc_mutex_lock( &p_vout->change_lock );
260 if( vlc_thread_create( &p_vout->thread_id, "video output",
261 (void *) RunThread, (void *) p_vout) )
263 intf_ErrMsg("error: %s\n", strerror(ENOMEM));
264 vout_UnloadFont( p_vout->p_default_font );
265 vout_UnloadFont( p_vout->p_large_font );
266 p_vout->p_sys_destroy( p_vout );
271 intf_Msg( "Video display initialized (%dx%d, %d/%d bpp)\n", p_vout->i_width,
272 p_vout->i_height, p_vout->i_screen_depth,
273 p_vout->i_bytes_per_pixel * 8 );
275 /* If status is NULL, wait until the thread is created */
276 if( pi_status == NULL )
280 msleep( THREAD_SLEEP );
281 }while( (i_status != THREAD_READY) && (i_status != THREAD_ERROR)
282 && (i_status != THREAD_FATAL) );
283 if( i_status != THREAD_READY )
291 /*****************************************************************************
292 * vout_DestroyThread: destroys a previously created thread
293 *****************************************************************************
294 * Destroy a terminated thread.
295 * The function will request a destruction of the specified thread. If pi_error
296 * is NULL, it will return once the thread is destroyed. Else, it will be
297 * update using one of the THREAD_* constants.
298 *****************************************************************************/
299 void vout_DestroyThread( vout_thread_t *p_vout, int *pi_status )
301 int i_status; /* thread status */
305 p_vout->pi_status = (pi_status != NULL) ? pi_status : &i_status;
306 *p_vout->pi_status = THREAD_DESTROY;
308 /* Request thread destruction */
311 /* If status is NULL, wait until thread has been destroyed */
312 if( pi_status == NULL )
316 msleep( THREAD_SLEEP );
317 }while( (i_status != THREAD_OVER) && (i_status != THREAD_ERROR)
318 && (i_status != THREAD_FATAL) );
322 /*****************************************************************************
323 * vout_DisplaySubPicture: display a subpicture unit
324 *****************************************************************************
325 * Remove the reservation flag of an subpicture, which will cause it to be ready
326 * for display. The picture does not need to be locked, since it is ignored by
327 * the output thread if is reserved.
328 *****************************************************************************/
329 void vout_DisplaySubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
332 char psz_begin_date[MSTRTIME_MAX_SIZE]; /* buffer for date string */
333 char psz_end_date[MSTRTIME_MAX_SIZE]; /* buffer for date string */
337 /* Check if status is valid */
338 if( p_subpic->i_status != RESERVED_SUBPICTURE )
340 intf_DbgMsg("error: subpicture %p has invalid status %d\n", p_subpic,
341 p_subpic->i_status );
345 /* Remove reservation flag */
346 p_subpic->i_status = READY_SUBPICTURE;
349 /* Send subpicture information */
350 intf_DbgMsg("subpicture %p: type=%d, begin date=%s, end date=%s\n",
351 p_subpic, p_subpic->i_type,
352 mstrtime( psz_begin_date, p_subpic->begin_date ),
353 mstrtime( psz_end_date, p_subpic->end_date ) );
357 /*****************************************************************************
358 * vout_CreateSubPicture: allocate a subpicture in the video output heap.
359 *****************************************************************************
360 * This function create a reserved subpicture in the video output heap.
361 * A null pointer is returned if the function fails. This method provides an
362 * already allocated zone of memory in the spu data fields. It needs locking
363 * since several pictures can be created by several producers threads.
364 *****************************************************************************/
365 subpicture_t *vout_CreateSubPicture( vout_thread_t *p_vout, int i_type,
368 int i_subpic; /* subpicture index */
369 subpicture_t * p_free_subpic = NULL; /* first free subpicture */
370 subpicture_t * p_destroyed_subpic = NULL; /* first destroyed subpic */
373 vlc_mutex_lock( &p_vout->subpicture_lock );
376 * Look for an empty place
378 for( i_subpic = 0; i_subpic < VOUT_MAX_SUBPICTURES; i_subpic++ )
380 if( p_vout->p_subpicture[i_subpic].i_status == DESTROYED_SUBPICTURE )
382 /* Subpicture is marked for destruction, but is still allocated */
383 if( (p_vout->p_subpicture[i_subpic].i_type == i_type) &&
384 (p_vout->p_subpicture[i_subpic].i_size >= i_size) )
386 /* Memory size do match or is smaller : memory will not be
387 * reallocated, and function can end immediately - this is
388 * the best possible case, since no memory allocation needs
390 p_vout->p_subpicture[i_subpic].i_status = RESERVED_SUBPICTURE;
392 intf_DbgMsg("subpicture %p (in destroyed subpicture slot)\n",
393 &p_vout->p_subpicture[i_subpic] );
395 vlc_mutex_unlock( &p_vout->subpicture_lock );
396 return( &p_vout->p_subpicture[i_subpic] );
398 else if( p_destroyed_subpic == NULL )
400 /* Memory size do not match, but subpicture index will be kept in
401 * case no other place are left */
402 p_destroyed_subpic = &p_vout->p_subpicture[i_subpic];
405 else if( (p_free_subpic == NULL) &&
406 (p_vout->p_subpicture[i_subpic].i_status == FREE_SUBPICTURE ))
408 /* Subpicture is empty and ready for allocation */
409 p_free_subpic = &p_vout->p_subpicture[i_subpic];
413 /* If no free subpictures are available, use a destroyed subpicture */
414 if( (p_free_subpic == NULL) && (p_destroyed_subpic != NULL ) )
416 /* No free subpicture or matching destroyed subpictures have been
417 * found, but a destroyed subpicture is still avalaible */
418 free( p_destroyed_subpic->p_data );
419 p_free_subpic = p_destroyed_subpic;
425 if( p_free_subpic != NULL )
427 /* Allocate memory */
430 case TEXT_SUBPICTURE: /* text subpicture */
431 p_free_subpic->p_data = malloc( i_size + 1 );
433 case DVD_SUBPICTURE: /* DVD subpicture unit */
434 p_free_subpic->p_data = malloc( i_size );
438 intf_DbgMsg("error: unknown subpicture type %d\n", i_type );
439 p_free_subpic->p_data = NULL;
444 if( p_free_subpic->p_data != NULL )
446 /* Copy subpicture information, set some default values */
447 p_free_subpic->i_type = i_type;
448 p_free_subpic->i_status = RESERVED_SUBPICTURE;
449 p_free_subpic->i_size = i_size;
450 p_free_subpic->i_x = 0;
451 p_free_subpic->i_y = 0;
452 p_free_subpic->i_width = 0;
453 p_free_subpic->i_height = 0;
454 p_free_subpic->i_horizontal_align = CENTER_RALIGN;
455 p_free_subpic->i_vertical_align = CENTER_RALIGN;
459 /* Memory allocation failed : set subpicture as empty */
460 p_free_subpic->i_type = EMPTY_SUBPICTURE;
461 p_free_subpic->i_status = FREE_SUBPICTURE;
462 p_free_subpic = NULL;
463 intf_ErrMsg("spu warning: %s\n", strerror( ENOMEM ) );
467 intf_DbgMsg("subpicture %p (in free subpicture slot)\n", p_free_subpic );
469 vlc_mutex_unlock( &p_vout->subpicture_lock );
470 return( p_free_subpic );
473 /* No free or destroyed subpicture could be found */
474 intf_DbgMsg( "warning: subpicture heap is full\n" );
475 vlc_mutex_unlock( &p_vout->subpicture_lock );
479 /*****************************************************************************
480 * vout_DestroySubPicture: remove a subpicture from the heap
481 *****************************************************************************
482 * This function frees a previously reserved subpicture.
483 * It is meant to be used when the construction of a picture aborted.
484 * This function does not need locking since reserved subpictures are ignored
485 * by the output thread.
486 *****************************************************************************/
487 void vout_DestroySubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
490 /* Check if status is valid */
491 if( p_subpic->i_status != RESERVED_SUBPICTURE )
493 intf_DbgMsg("error: subpicture %p has invalid status %d\n",
494 p_subpic, p_subpic->i_status );
498 p_subpic->i_status = DESTROYED_SUBPICTURE;
501 intf_DbgMsg("subpicture %p\n", p_subpic);
505 /*****************************************************************************
506 * vout_DisplayPicture: display a picture
507 *****************************************************************************
508 * Remove the reservation flag of a picture, which will cause it to be ready for
509 * display. The picture won't be displayed until vout_DatePicture has been
511 *****************************************************************************/
512 void vout_DisplayPicture( vout_thread_t *p_vout, picture_t *p_pic )
514 vlc_mutex_lock( &p_vout->picture_lock );
515 switch( p_pic->i_status )
517 case RESERVED_PICTURE:
518 p_pic->i_status = RESERVED_DISP_PICTURE;
520 case RESERVED_DATED_PICTURE:
521 p_pic->i_status = READY_PICTURE;
525 intf_DbgMsg("error: picture %p has invalid status %d\n", p_pic, p_pic->i_status );
531 intf_DbgMsg("picture %p\n", p_pic);
533 vlc_mutex_unlock( &p_vout->picture_lock );
536 /*****************************************************************************
537 * vout_DatePicture: date a picture
538 *****************************************************************************
539 * Remove the reservation flag of a picture, which will cause it to be ready for
540 * display. The picture won't be displayed until vout_DisplayPicture has been
542 *****************************************************************************/
543 void vout_DatePicture( vout_thread_t *p_vout, picture_t *p_pic, mtime_t date )
546 char psz_date[MSTRTIME_MAX_SIZE]; /* date */
549 vlc_mutex_lock( &p_vout->picture_lock );
551 switch( p_pic->i_status )
553 case RESERVED_PICTURE:
554 p_pic->i_status = RESERVED_DATED_PICTURE;
556 case RESERVED_DISP_PICTURE:
557 p_pic->i_status = READY_PICTURE;
561 intf_DbgMsg("error: picture %p has invalid status %d\n", p_pic, p_pic->i_status );
567 intf_DbgMsg("picture %p, display date: %s\n", p_pic, mstrtime( psz_date, p_pic->date) );
569 vlc_mutex_unlock( &p_vout->picture_lock );
572 /*****************************************************************************
573 * vout_CreatePicture: allocate a picture in the video output heap.
574 *****************************************************************************
575 * This function create a reserved image in the video output heap.
576 * A null pointer is returned if the function fails. This method provides an
577 * already allocated zone of memory in the picture data fields. It needs locking
578 * since several pictures can be created by several producers threads.
579 *****************************************************************************/
580 picture_t *vout_CreatePicture( vout_thread_t *p_vout, int i_type,
581 int i_width, int i_height )
583 int i_picture; /* picture index */
584 int i_chroma_width = 0; /* chroma width */
585 picture_t * p_free_picture = NULL; /* first free picture */
586 picture_t * p_destroyed_picture = NULL; /* first destroyed picture */
589 vlc_mutex_lock( &p_vout->picture_lock );
592 * Look for an empty place
594 for( i_picture = 0; i_picture < VOUT_MAX_PICTURES; i_picture++ )
596 if( p_vout->p_picture[i_picture].i_status == DESTROYED_PICTURE )
598 /* Picture is marked for destruction, but is still allocated - note
599 * that if width and type are the same for two pictures, chroma_width
600 * should also be the same */
601 if( (p_vout->p_picture[i_picture].i_type == i_type) &&
602 (p_vout->p_picture[i_picture].i_height == i_height) &&
603 (p_vout->p_picture[i_picture].i_width == i_width) )
605 /* Memory size do match : memory will not be reallocated, and function
606 * can end immediately - this is the best possible case, since no
607 * memory allocation needs to be done */
608 p_vout->p_picture[i_picture].i_status = RESERVED_PICTURE;
609 p_vout->i_pictures++;
611 intf_DbgMsg("picture %p (in destroyed picture slot)\n",
612 &p_vout->p_picture[i_picture] );
614 vlc_mutex_unlock( &p_vout->picture_lock );
615 return( &p_vout->p_picture[i_picture] );
617 else if( p_destroyed_picture == NULL )
619 /* Memory size do not match, but picture index will be kept in
620 * case no other place are left */
621 p_destroyed_picture = &p_vout->p_picture[i_picture];
624 else if( (p_free_picture == NULL) &&
625 (p_vout->p_picture[i_picture].i_status == FREE_PICTURE ))
627 /* Picture is empty and ready for allocation */
628 p_free_picture = &p_vout->p_picture[i_picture];
632 /* If no free picture is available, use a destroyed picture */
633 if( (p_free_picture == NULL) && (p_destroyed_picture != NULL ) )
635 /* No free picture or matching destroyed picture has been found, but
636 * a destroyed picture is still avalaible */
637 free( p_destroyed_picture->p_data );
638 p_free_picture = p_destroyed_picture;
644 if( p_free_picture != NULL )
646 /* Allocate memory */
649 case YUV_420_PICTURE: /* YUV 420: 1,1/4,1/4 samples per pixel */
650 i_chroma_width = i_width / 2;
651 p_free_picture->p_data = malloc( i_height * i_chroma_width * 3 * sizeof( yuv_data_t ) );
652 p_free_picture->p_y = (yuv_data_t *)p_free_picture->p_data;
653 p_free_picture->p_u = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*4/2;
654 p_free_picture->p_v = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*5/2;
656 case YUV_422_PICTURE: /* YUV 422: 1,1/2,1/2 samples per pixel */
657 i_chroma_width = i_width / 2;
658 p_free_picture->p_data = malloc( i_height * i_chroma_width * 4 * sizeof( yuv_data_t ) );
659 p_free_picture->p_y = (yuv_data_t *)p_free_picture->p_data;
660 p_free_picture->p_u = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*2;
661 p_free_picture->p_v = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*3;
663 case YUV_444_PICTURE: /* YUV 444: 1,1,1 samples per pixel */
664 i_chroma_width = i_width;
665 p_free_picture->p_data = malloc( i_height * i_chroma_width * 3 * sizeof( yuv_data_t ) );
666 p_free_picture->p_y = (yuv_data_t *)p_free_picture->p_data;
667 p_free_picture->p_u = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width;
668 p_free_picture->p_v = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*2;
672 intf_DbgMsg("error: unknown picture type %d\n", i_type );
673 p_free_picture->p_data = NULL;
678 if( p_free_picture->p_data != NULL )
680 /* Copy picture information, set some default values */
681 p_free_picture->i_type = i_type;
682 p_free_picture->i_status = RESERVED_PICTURE;
683 p_free_picture->i_matrix_coefficients = 1;
684 p_free_picture->i_width = i_width;
685 p_free_picture->i_height = i_height;
686 p_free_picture->i_chroma_width = i_chroma_width;
687 p_free_picture->i_display_horizontal_offset = 0;
688 p_free_picture->i_display_vertical_offset = 0;
689 p_free_picture->i_display_width = i_width;
690 p_free_picture->i_display_height = i_height;
691 p_free_picture->i_aspect_ratio = AR_SQUARE_PICTURE;
692 p_free_picture->i_refcount = 0;
693 p_vout->i_pictures++;
697 /* Memory allocation failed : set picture as empty */
698 p_free_picture->i_type = EMPTY_PICTURE;
699 p_free_picture->i_status = FREE_PICTURE;
700 p_free_picture = NULL;
701 intf_ErrMsg( "vout warning: %s\n", strerror( ENOMEM ) );
705 intf_DbgMsg("picture %p (in free picture slot)\n", p_free_picture );
707 vlc_mutex_unlock( &p_vout->picture_lock );
708 return( p_free_picture );
711 /* No free or destroyed picture could be found */
712 intf_DbgMsg( "warning: picture heap is full\n" );
713 vlc_mutex_unlock( &p_vout->picture_lock );
717 /*****************************************************************************
718 * vout_DestroyPicture: remove a permanent or reserved picture from the heap
719 *****************************************************************************
720 * This function frees a previously reserved picture or a permanent
721 * picture. It is meant to be used when the construction of a picture aborted.
722 * Note that the picture will be destroyed even if it is linked !
723 *****************************************************************************/
724 void vout_DestroyPicture( vout_thread_t *p_vout, picture_t *p_pic )
726 vlc_mutex_lock( &p_vout->picture_lock );
729 /* Check if picture status is valid */
730 if( (p_pic->i_status != RESERVED_PICTURE) &&
731 (p_pic->i_status != RESERVED_DATED_PICTURE) &&
732 (p_pic->i_status != RESERVED_DISP_PICTURE) )
734 intf_DbgMsg("error: picture %p has invalid status %d\n", p_pic, p_pic->i_status );
738 p_pic->i_status = DESTROYED_PICTURE;
739 p_vout->i_pictures--;
742 intf_DbgMsg("picture %p\n", p_pic);
744 vlc_mutex_unlock( &p_vout->picture_lock );
747 /*****************************************************************************
748 * vout_LinkPicture: increment reference counter of a picture
749 *****************************************************************************
750 * This function increment the reference counter of a picture in the video
751 * heap. It needs a lock since several producer threads can access the picture.
752 *****************************************************************************/
753 void vout_LinkPicture( vout_thread_t *p_vout, picture_t *p_pic )
755 vlc_mutex_lock( &p_vout->picture_lock );
759 intf_DbgMsg("picture %p refcount=%d\n", p_pic, p_pic->i_refcount );
762 vlc_mutex_unlock( &p_vout->picture_lock );
765 /*****************************************************************************
766 * vout_UnlinkPicture: decrement reference counter of a picture
767 *****************************************************************************
768 * This function decrement the reference counter of a picture in the video heap.
769 *****************************************************************************/
770 void vout_UnlinkPicture( vout_thread_t *p_vout, picture_t *p_pic )
772 vlc_mutex_lock( &p_vout->picture_lock );
776 if( p_pic->i_refcount < 0 )
778 intf_DbgMsg("error: refcount < 0\n");
779 p_pic->i_refcount = 0;
783 if( (p_pic->i_refcount == 0) && (p_pic->i_status == DISPLAYED_PICTURE) )
785 p_pic->i_status = DESTROYED_PICTURE;
786 p_vout->i_pictures--;
790 intf_DbgMsg("picture %p refcount=%d\n", p_pic, p_pic->i_refcount );
793 vlc_mutex_unlock( &p_vout->picture_lock );
796 /*****************************************************************************
797 * vout_SetBuffers: set buffers adresses
798 *****************************************************************************
799 * This function is called by system drivers to set buffers video memory
801 *****************************************************************************/
802 void vout_SetBuffers( vout_thread_t *p_vout, void *p_buf1, void *p_buf2 )
804 /* No picture previously */
805 p_vout->p_buffer[0].i_pic_x = 0;
806 p_vout->p_buffer[0].i_pic_y = 0;
807 p_vout->p_buffer[0].i_pic_width = 0;
808 p_vout->p_buffer[0].i_pic_height = 0;
809 p_vout->p_buffer[1].i_pic_x = 0;
810 p_vout->p_buffer[1].i_pic_y = 0;
811 p_vout->p_buffer[1].i_pic_width = 0;
812 p_vout->p_buffer[1].i_pic_height = 0;
814 /* The first area covers all the screen */
815 p_vout->p_buffer[0].i_areas = 1;
816 p_vout->p_buffer[0].pi_area_begin[0] = 0;
817 p_vout->p_buffer[0].pi_area_end[0] = p_vout->i_height - 1;
818 p_vout->p_buffer[1].i_areas = 1;
819 p_vout->p_buffer[1].pi_area_begin[0] = 0;
820 p_vout->p_buffer[1].pi_area_end[0] = p_vout->i_height - 1;
823 p_vout->p_buffer[0].p_data = p_buf1;
824 p_vout->p_buffer[1].p_data = p_buf2;
827 /*****************************************************************************
828 * vout_Pixel2RGB: return red, green and blue from pixel value
829 *****************************************************************************
830 * Return color values, in 0-255 range, of the decomposition of a pixel. This
831 * is a slow routine and should only be used for initialization phase.
832 *****************************************************************************/
833 void vout_Pixel2RGB( vout_thread_t *p_vout, u32 i_pixel, int *pi_red, int *pi_green, int *pi_blue )
835 *pi_red = i_pixel & p_vout->i_red_mask;
836 *pi_green = i_pixel & p_vout->i_green_mask;
837 *pi_blue = i_pixel & p_vout->i_blue_mask;
840 /* following functions are local */
842 /*****************************************************************************
843 * BinaryLog: computes the base 2 log of a binary value
844 *****************************************************************************
845 * This functions is used by MaskToShift, to get a bit index from a binary
847 *****************************************************************************/
848 static int BinaryLog(u32 i)
873 if (i != ((u32)1 << i_log))
875 intf_DbgMsg("internal error: binary log overflow\n");
881 /*****************************************************************************
882 * MaskToShift: transform a color mask into right and left shifts
883 *****************************************************************************
884 * This function is used for obtaining color shifts from masks.
885 *****************************************************************************/
886 static void MaskToShift( int *pi_left, int *pi_right, u32 i_mask )
888 u32 i_low, i_high; /* lower hand higher bits of the mask */
891 i_low = i_mask & (- i_mask); /* lower bit of the mask */
892 i_high = i_mask + i_low; /* higher bit of the mask */
894 /* Transform bits into an index */
895 i_low = BinaryLog (i_low);
896 i_high = BinaryLog (i_high);
898 /* Update pointers and return */
900 *pi_right = (8 - i_high + i_low);
903 /*****************************************************************************
904 * InitThread: initialize video output thread
905 *****************************************************************************
906 * This function is called from RunThread and performs the second step of the
907 * initialization. It returns 0 on success. Note that the thread's flag are not
908 * modified inside this function.
909 *****************************************************************************/
910 static int InitThread( vout_thread_t *p_vout )
914 *p_vout->pi_status = THREAD_START;
916 /* Initialize output method - this function issues its own error messages */
917 if( p_vout->p_sys_init( p_vout ) )
922 /* Initialize convertion tables and functions */
923 if( vout_InitYUV( p_vout ) )
925 intf_ErrMsg("error: can't allocate YUV translation tables\n");
929 /* Mark thread as running and return */
930 p_vout->b_active = 1;
931 *p_vout->pi_status = THREAD_READY;
934 intf_DbgMsg("thread ready\n");
938 /*****************************************************************************
939 * RunThread: video output thread
940 *****************************************************************************
941 * Video output thread. This function does only returns when the thread is
942 * terminated. It handles the pictures arriving in the video heap and the
943 * display device events.
944 *****************************************************************************/
945 static void RunThread( vout_thread_t *p_vout)
947 int i_index; /* index in heap */
948 mtime_t current_date; /* current date */
949 mtime_t display_date; /* display date */
950 boolean_t b_display; /* display flag */
951 picture_t * p_pic; /* picture pointer */
952 subpicture_t * p_subpic; /* subpicture pointer */
957 p_vout->b_error = InitThread( p_vout );
958 if( p_vout->b_error )
960 DestroyThread( p_vout, THREAD_ERROR );
966 * Main loop - it is not executed if an error occured during
969 while( (!p_vout->b_die) && (!p_vout->b_error) )
971 /* Initialize loop variables */
975 current_date = mdate();
978 * Find the picture to display - this operation does not need lock,
979 * since only READY_PICTUREs are handled
981 for( i_index = 0; i_index < VOUT_MAX_PICTURES; i_index++ )
983 if( (p_vout->p_picture[i_index].i_status == READY_PICTURE) &&
985 (p_vout->p_picture[i_index].date < display_date) ) )
987 p_pic = &p_vout->p_picture[i_index];
988 display_date = p_pic->date;
994 /* Computes FPS rate */
995 p_vout->p_fps_sample[ p_vout->c_fps_samples++ % VOUT_FPS_SAMPLES ] = display_date;
997 if( display_date < current_date )
999 /* Picture is late: it will be destroyed and the thread
1000 * will sleep and go to next picture */
1002 vlc_mutex_lock( &p_vout->picture_lock );
1003 if( p_pic->i_refcount )
1005 p_pic->i_status = DISPLAYED_PICTURE;
1009 p_pic->i_status = DESTROYED_PICTURE;
1010 p_vout->i_pictures--;
1013 "warning: late picture skipped (%p)\n", p_pic );
1014 vlc_mutex_unlock( &p_vout->picture_lock );
1018 else if( display_date > current_date + VOUT_DISPLAY_DELAY )
1020 /* A picture is ready to be rendered, but its rendering date
1021 * is far from the current one so the thread will perform an
1022 * empty loop as if no picture were found. The picture state
1029 * Find the subpictures to display - this operation does not need
1030 * lock, since only READY_SUBPICTURE are handled. If no picture
1031 * has been selected, display_date will depend on the subpicture.
1032 * We get an easily parsable chained list of subpictures which
1033 * ends with NULL since p_subpic was initialized to NULL.
1035 for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++ )
1037 if( p_vout->p_subpicture[i_index].i_status == READY_SUBPICTURE )
1039 p_vout->p_subpicture[i_index].p_next = p_subpic;
1040 p_subpic = &p_vout->p_subpicture[i_index];
1045 * Perform rendering, sleep and display rendered picture
1047 if( p_pic ) /* picture and perhaps subpicture */
1049 b_display = p_vout->b_active;
1050 p_vout->last_display_date = display_date;
1054 /* Set picture dimensions and clear buffer */
1055 SetBufferPicture( p_vout, p_pic );
1057 /* Render picture and information */
1058 RenderPicture( p_vout, p_pic );
1059 if( p_vout->b_info )
1061 RenderPictureInfo( p_vout, p_pic );
1062 RenderInfo( p_vout );
1066 RenderSubPicture( p_vout, p_subpic );
1070 /* Render interface and subpicture */
1071 if( b_display && p_vout->b_interface )
1073 RenderInterface( p_vout );
1077 else if( p_vout->b_active && p_vout->init_display_date == 0) /* idle or interface screen alone */
1079 if( p_vout->b_interface && 0 /* && XXX?? intf_change */ )
1081 /* Interface has changed, so a new rendering is required - force
1082 * it by setting last idle date to 0 */
1083 p_vout->last_idle_date = 0;
1086 /* Render idle screen and update idle date, then render interface if
1088 b_display = RenderIdle( p_vout );
1091 p_vout->last_idle_date = current_date;
1092 if( p_vout->b_interface )
1094 RenderInterface( p_vout );
1106 * chech for the current time and
1107 * display splash screen if everything is on time
1109 if( p_vout->init_display_date > 0)
1111 if( p_vout->b_active &&
1112 mdate()-p_vout->init_display_date < 5000000)
1114 /* there is something to display ! */
1116 RenderSplash( p_vout );
1119 /* no splash screen ! */
1120 intf_ErrMsgImm("End of splash screen\n");
1121 p_vout->init_display_date=0;
1129 * Sleep, wake up and display rendered picture
1132 if( display_date != 0 )
1134 /* Store render time */
1135 p_vout->render_time += mdate() - current_date;
1136 p_vout->render_time >>= 1;
1139 /* Give back change lock */
1140 vlc_mutex_unlock( &p_vout->change_lock );
1142 /* Sleep a while or until a given date */
1143 if( display_date != 0 )
1145 mwait( display_date - VOUT_MWAIT_TOLERANCE );
1149 msleep( VOUT_IDLE_SLEEP );
1152 /* On awakening, take back lock and send immediately picture to display,
1153 * then swap buffers */
1154 vlc_mutex_lock( &p_vout->change_lock );
1156 intf_DbgMsg( "picture %p, subpicture %p in buffer %d, display=%d\n", p_pic, p_subpic,
1157 p_vout->i_buffer_index, b_display /* && !(p_vout->i_changes & VOUT_NODISPLAY_CHANGE) */ );
1159 if( b_display /* && !(p_vout->i_changes & VOUT_NODISPLAY_CHANGE) */ )
1161 p_vout->p_sys_display( p_vout );
1163 p_vout->i_buffer_index = ++p_vout->i_buffer_index & 1;
1169 /* Remove picture from heap */
1170 vlc_mutex_lock( &p_vout->picture_lock );
1171 if( p_pic->i_refcount )
1173 p_pic->i_status = DISPLAYED_PICTURE;
1177 p_pic->i_status = DESTROYED_PICTURE;
1178 p_vout->i_pictures--;
1180 vlc_mutex_unlock( &p_vout->picture_lock );
1185 * Check events and manage thread
1187 if( p_vout->p_sys_manage( p_vout ) | Manage( p_vout ) )
1189 /* A fatal error occured, and the thread must terminate immediately,
1190 * without displaying anything - setting b_error to 1 cause the
1191 * immediate end of the main while() loop. */
1192 p_vout->b_error = 1;
1197 * Error loop - wait until the thread destruction is requested
1199 if( p_vout->b_error )
1201 ErrorThread( p_vout );
1205 EndThread( p_vout );
1206 DestroyThread( p_vout, THREAD_OVER );
1207 intf_DbgMsg( "thread end\n" );
1210 /*****************************************************************************
1211 * ErrorThread: RunThread() error loop
1212 *****************************************************************************
1213 * This function is called when an error occured during thread main's loop. The
1214 * thread can still receive feed, but must be ready to terminate as soon as
1216 *****************************************************************************/
1217 static void ErrorThread( vout_thread_t *p_vout )
1219 /* Wait until a `die' order */
1221 while( !p_vout->b_die )
1224 msleep( VOUT_IDLE_SLEEP );
1228 /*****************************************************************************
1229 * EndThread: thread destruction
1230 *****************************************************************************
1231 * This function is called when the thread ends after a sucessful
1232 * initialization. It frees all ressources allocated by InitThread.
1233 *****************************************************************************/
1234 static void EndThread( vout_thread_t *p_vout )
1236 int i_index; /* index in heap */
1240 *p_vout->pi_status = THREAD_END;
1242 /* Destroy all remaining pictures and subpictures */
1243 for( i_index = 0; i_index < VOUT_MAX_PICTURES; i_index++ )
1245 if( p_vout->p_picture[i_index].i_status != FREE_PICTURE )
1247 free( p_vout->p_picture[i_index].p_data );
1250 for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++ )
1252 if( p_vout->p_subpicture[i_index].i_status != FREE_SUBPICTURE )
1254 free( p_vout->p_subpicture[i_index].p_data );
1258 /* Destroy translation tables */
1259 vout_EndYUV( p_vout );
1260 p_vout->p_sys_end( p_vout );
1263 /*****************************************************************************
1264 * DestroyThread: thread destruction
1265 *****************************************************************************
1266 * This function is called when the thread ends. It frees all ressources
1267 * allocated by CreateThread. Status is available at this stage.
1268 *****************************************************************************/
1269 static void DestroyThread( vout_thread_t *p_vout, int i_status )
1271 int *pi_status; /* status adress */
1273 /* Store status adress */
1275 pi_status = p_vout->pi_status;
1277 /* Destroy thread structures allocated by Create and InitThread */
1278 vout_UnloadFont( p_vout->p_default_font );
1279 vout_UnloadFont( p_vout->p_large_font );
1280 p_vout->p_sys_destroy( p_vout );
1282 /* Free structure */
1284 *pi_status = i_status;
1287 /*****************************************************************************
1288 * Print: print simple text on a picture
1289 *****************************************************************************
1290 * This function will print a simple text on the picture. It is designed to
1291 * print debugging or general information.
1292 *****************************************************************************/
1293 void Print( vout_thread_t *p_vout, int i_x, int i_y, int i_h_align, int i_v_align, unsigned char *psz_text )
1295 int i_text_height; /* total text height */
1296 int i_text_width; /* total text width */
1298 /* Update upper left coordinates according to alignment */
1299 vout_TextSize( p_vout->p_default_font, 0, psz_text, &i_text_width, &i_text_height );
1300 if( !Align( p_vout, &i_x, &i_y, i_text_width, i_text_height, i_h_align, i_v_align ) )
1302 /* Set area and print text */
1303 SetBufferArea( p_vout, i_x, i_y, i_text_width, i_text_height );
1304 vout_Print( p_vout->p_default_font, p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1305 i_y * p_vout->i_bytes_per_line + i_x * p_vout->i_bytes_per_pixel,
1306 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1307 p_vout->i_white_pixel, 0, 0,
1312 /*****************************************************************************
1313 * SetBufferArea: activate an area in current buffer
1314 *****************************************************************************
1315 * This function is called when something is rendered on the current buffer.
1316 * It set the area as active and prepare it to be cleared on next rendering.
1317 * Pay attention to the fact that in this functions, i_h is in fact the end y
1318 * coordinate of the new area.
1319 *****************************************************************************/
1320 static void SetBufferArea( vout_thread_t *p_vout, int i_x, int i_y, int i_w, int i_h )
1322 vout_buffer_t * p_buffer; /* current buffer */
1323 int i_area_begin, i_area_end; /* area vertical extension */
1324 int i_area, i_area_copy; /* area index */
1325 int i_area_shift; /* shift distance for areas */
1327 /* Choose buffer and modify h to end of area position */
1328 p_buffer = &p_vout->p_buffer[ p_vout->i_buffer_index ];
1332 * Remove part of the area which is inside the picture - this is done
1333 * by calling again SetBufferArea with the correct areas dimensions.
1335 if( (i_x >= p_buffer->i_pic_x) && (i_x + i_w <= p_buffer->i_pic_x + p_buffer->i_pic_width) )
1337 i_area_begin = p_buffer->i_pic_y;
1338 i_area_end = i_area_begin + p_buffer->i_pic_height - 1;
1340 if( ((i_y >= i_area_begin) && (i_y <= i_area_end)) ||
1341 ((i_h >= i_area_begin) && (i_h <= i_area_end)) ||
1342 ((i_y < i_area_begin) && (i_h > i_area_end)) )
1344 /* Keep the stripe above the picture, if any */
1345 if( i_y < i_area_begin )
1347 SetBufferArea( p_vout, i_x, i_y, i_w, i_area_begin - i_y );
1349 /* Keep the stripe below the picture, if any */
1350 if( i_h > i_area_end )
1352 SetBufferArea( p_vout, i_x, i_area_end, i_w, i_h - i_area_end );
1358 /* Skip some extensions until interesting areas */
1360 (i_area < p_buffer->i_areas) &&
1361 (p_buffer->pi_area_end[i_area] + 1 <= i_y);
1367 if( i_area == p_buffer->i_areas )
1369 /* New area is below all existing ones: just add it at the end of the
1370 * array, if possible - otherwise, append it to the last one */
1371 if( i_area < VOUT_MAX_AREAS )
1373 p_buffer->pi_area_begin[i_area] = i_y;
1374 p_buffer->pi_area_end[i_area] = i_h;
1375 p_buffer->i_areas++;
1380 intf_DbgMsg("area overflow\n");
1382 p_buffer->pi_area_end[VOUT_MAX_AREAS - 1] = i_h;
1387 i_area_begin = p_buffer->pi_area_begin[i_area];
1388 i_area_end = p_buffer->pi_area_end[i_area];
1390 if( i_y < i_area_begin )
1392 if( i_h >= i_area_begin - 1 )
1394 /* Extend area above */
1395 p_buffer->pi_area_begin[i_area] = i_y;
1399 /* Create a new area above : merge last area if overflow, then
1400 * move all old areas down */
1401 if( p_buffer->i_areas == VOUT_MAX_AREAS )
1404 intf_DbgMsg("areas overflow\n");
1406 p_buffer->pi_area_end[VOUT_MAX_AREAS - 2] = p_buffer->pi_area_end[VOUT_MAX_AREAS - 1];
1410 p_buffer->i_areas++;
1412 for( i_area_copy = p_buffer->i_areas - 1; i_area_copy > i_area; i_area_copy-- )
1414 p_buffer->pi_area_begin[i_area_copy] = p_buffer->pi_area_begin[i_area_copy - 1];
1415 p_buffer->pi_area_end[i_area_copy] = p_buffer->pi_area_end[i_area_copy - 1];
1417 p_buffer->pi_area_begin[i_area] = i_y;
1418 p_buffer->pi_area_end[i_area] = i_h;
1422 if( i_h > i_area_end )
1424 /* Find further areas which can be merged with the new one */
1425 for( i_area_copy = i_area + 1;
1426 (i_area_copy < p_buffer->i_areas) &&
1427 (p_buffer->pi_area_begin[i_area] <= i_h);
1434 if( i_area_copy != i_area )
1436 /* Merge with last possible areas */
1437 p_buffer->pi_area_end[i_area] = MAX( i_h, p_buffer->pi_area_end[i_area_copy] );
1439 /* Shift lower areas upward */
1440 i_area_shift = i_area_copy - i_area;
1441 p_buffer->i_areas -= i_area_shift;
1442 for( i_area_copy = i_area + 1; i_area_copy < p_buffer->i_areas; i_area_copy++ )
1444 p_buffer->pi_area_begin[i_area_copy] = p_buffer->pi_area_begin[i_area_copy + i_area_shift];
1445 p_buffer->pi_area_end[i_area_copy] = p_buffer->pi_area_end[i_area_copy + i_area_shift];
1450 /* Extend area below */
1451 p_buffer->pi_area_end[i_area] = i_h;
1457 /*****************************************************************************
1458 * SetBufferPicture: clear buffer and set picture area
1459 *****************************************************************************
1460 * This function is called before any rendering. It clears the current
1461 * rendering buffer and set the new picture area. If the picture pointer is
1462 * NULL, then no picture area is defined. Floating operations are avoided since
1463 * some MMX calculations may follow.
1464 *****************************************************************************/
1465 static void SetBufferPicture( vout_thread_t *p_vout, picture_t *p_pic )
1467 vout_buffer_t * p_buffer; /* current buffer */
1468 int i_pic_x, i_pic_y; /* picture position */
1469 int i_pic_width, i_pic_height; /* picture dimensions */
1470 int i_old_pic_y, i_old_pic_height; /* old picture area */
1471 int i_vout_width, i_vout_height; /* display dimensions */
1472 int i_area; /* area index */
1473 int i_data_index; /* area data index */
1474 int i_data_size; /* area data size, in 256 bytes blocs */
1475 u64 * p_data; /* area data, for clearing */
1476 byte_t * p_data8; /* area data, for clearing (slow) */
1478 /* Choose buffer and set display dimensions */
1479 p_buffer = &p_vout->p_buffer[ p_vout->i_buffer_index ];
1480 i_vout_width = p_vout->i_width;
1481 i_vout_height = p_vout->i_height;
1484 * Computes new picture size
1488 /* Try horizontal scaling first - width must be a mutiple of 16 */
1489 i_pic_width = (( p_vout->b_scale || (p_pic->i_width > i_vout_width)) ?
1490 i_vout_width : p_pic->i_width) & ~0xf;
1491 switch( p_pic->i_aspect_ratio )
1493 case AR_3_4_PICTURE:
1494 i_pic_height = i_pic_width * 3 / 4;
1496 case AR_16_9_PICTURE:
1497 i_pic_height = i_pic_width * 9 / 16;
1499 case AR_221_1_PICTURE:
1500 i_pic_height = i_pic_width * 100 / 221;
1502 case AR_SQUARE_PICTURE:
1504 i_pic_height = p_pic->i_height * i_pic_width / p_pic->i_width;
1508 /* If picture dimensions using horizontal scaling are too large, use
1509 * vertical scaling. Since width must be a multiple of 16, height is
1510 * adjusted again after. */
1511 if( i_pic_height > i_vout_height )
1513 i_pic_height = ( p_vout->b_scale || (p_pic->i_height > i_vout_height)) ?
1514 i_vout_height : p_pic->i_height;
1515 switch( p_pic->i_aspect_ratio )
1517 case AR_3_4_PICTURE:
1518 i_pic_width = (i_pic_height * 4 / 3) & ~0xf;
1519 i_pic_height = i_pic_width * 3 / 4;
1521 case AR_16_9_PICTURE:
1522 i_pic_width = (i_pic_height * 16 / 9) & ~0xf;
1523 i_pic_height = i_pic_width * 9 / 16;
1525 case AR_221_1_PICTURE:
1526 i_pic_width = (i_pic_height * 221 / 100) & ~0xf;
1527 i_pic_height = i_pic_width * 100 / 221;
1529 case AR_SQUARE_PICTURE:
1531 i_pic_width = (p_pic->i_width * i_pic_height / p_pic->i_height) & ~0xf;
1532 i_pic_height = p_pic->i_height * i_pic_width / p_pic->i_width;
1537 /* Set picture position */
1538 i_pic_x = (p_vout->i_width - i_pic_width) / 2;
1539 i_pic_y = (p_vout->i_height - i_pic_height) / 2;
1543 /* No picture: size is 0 */
1551 * Set new picture size - if it is smaller than the previous one, clear
1552 * around it. Since picture are centered, only their size is tested.
1554 if( (p_buffer->i_pic_width > i_pic_width) || (p_buffer->i_pic_height > i_pic_height) )
1556 i_old_pic_y = p_buffer->i_pic_y;
1557 i_old_pic_height = p_buffer->i_pic_height;
1558 p_buffer->i_pic_x = i_pic_x;
1559 p_buffer->i_pic_y = i_pic_y;
1560 p_buffer->i_pic_width = i_pic_width;
1561 p_buffer->i_pic_height = i_pic_height;
1562 SetBufferArea( p_vout, 0, i_old_pic_y, p_vout->i_width, i_old_pic_height );
1566 p_buffer->i_pic_x = i_pic_x;
1567 p_buffer->i_pic_y = i_pic_y;
1568 p_buffer->i_pic_width = i_pic_width;
1569 p_buffer->i_pic_height = i_pic_height;
1575 for( i_area = 0; i_area < p_buffer->i_areas; i_area++ )
1578 intf_DbgMsg("clearing picture %p area in buffer %d: %d-%d\n", p_pic,
1579 p_vout->i_buffer_index, p_buffer->pi_area_begin[i_area], p_buffer->pi_area_end[i_area] );
1581 i_data_size = (p_buffer->pi_area_end[i_area] - p_buffer->pi_area_begin[i_area] + 1) * p_vout->i_bytes_per_line;
1582 p_data = (u64*) (p_buffer->p_data + p_vout->i_bytes_per_line * p_buffer->pi_area_begin[i_area]);
1583 for( i_data_index = i_data_size / 256; i_data_index-- ; )
1585 /* Clear 256 bytes block */
1586 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1587 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1588 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1589 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1590 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1591 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1592 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1593 *p_data++ = 0; *p_data++ = 0; *p_data++ = 0; *p_data++ = 0;
1595 for( i_data_index = (i_data_size % 256) / 16; i_data_index--; )
1597 /* Clear remaining 16 bytes blocks */
1598 *p_data++ = 0; *p_data++ = 0;
1600 p_data8 = (byte_t *)p_data;
1601 for( i_data_index = i_data_size % 16; i_data_index--; )
1603 /* Clear remaining bytes */
1611 p_buffer->i_areas = 0;
1614 /*****************************************************************************
1615 * RenderPicture: render a picture
1616 *****************************************************************************
1617 * This function converts a picture from a video heap to a pixel-encoded image
1618 * and copies it to the current rendering buffer. No lock is required, since
1619 * the * rendered picture has been determined as existant, and will only be
1620 * destroyed by the vout thread later.
1621 *****************************************************************************/
1622 static void RenderPicture( vout_thread_t *p_vout, picture_t *p_pic )
1625 char psz_date[MSTRTIME_MAX_SIZE]; /* picture date */
1626 mtime_t render_time; /* picture rendering time */
1628 vout_buffer_t * p_buffer; /* rendering buffer */
1629 byte_t * p_pic_data; /* convertion destination */
1631 /* Get and set rendering information */
1632 p_buffer = &p_vout->p_buffer[ p_vout->i_buffer_index ];
1633 p_pic_data = p_buffer->p_data +
1634 p_buffer->i_pic_x * p_vout->i_bytes_per_pixel +
1635 p_buffer->i_pic_y * p_vout->i_bytes_per_line;
1637 render_time = mdate();
1641 * Choose appropriate rendering function and render picture
1643 switch( p_pic->i_type )
1645 case YUV_420_PICTURE:
1646 p_vout->yuv.p_Convert420( p_vout, p_pic_data,
1647 p_pic->p_y, p_pic->p_u, p_pic->p_v,
1648 p_pic->i_width, p_pic->i_height,
1649 p_buffer->i_pic_width, p_buffer->i_pic_height,
1650 p_vout->i_bytes_per_line / p_vout->i_bytes_per_pixel,
1651 p_pic->i_matrix_coefficients );
1653 case YUV_422_PICTURE:
1654 p_vout->yuv.p_Convert422( p_vout, p_pic_data,
1655 p_pic->p_y, p_pic->p_u, p_pic->p_v,
1656 p_pic->i_width, p_pic->i_height,
1657 p_buffer->i_pic_width, p_buffer->i_pic_height,
1658 p_vout->i_bytes_per_line / p_vout->i_bytes_per_pixel,
1659 p_pic->i_matrix_coefficients );
1661 case YUV_444_PICTURE:
1662 p_vout->yuv.p_Convert444( p_vout, p_pic_data,
1663 p_pic->p_y, p_pic->p_u, p_pic->p_v,
1664 p_pic->i_width, p_pic->i_height,
1665 p_buffer->i_pic_width, p_buffer->i_pic_height,
1666 p_vout->i_bytes_per_line / p_vout->i_bytes_per_pixel,
1667 p_pic->i_matrix_coefficients );
1671 intf_DbgMsg("error: unknown picture type %d\n", p_pic->i_type );
1677 /* Print picture date and rendering time */
1678 intf_DbgMsg("picture %p rendered in buffer %d (%ld us), display date: %s\n", p_pic,
1679 p_vout->i_buffer_index, (long) (mdate() - render_time),
1680 mstrtime( psz_date, p_pic->date ));
1684 /*****************************************************************************
1685 * RenderPictureInfo: print additionnal information on a picture
1686 *****************************************************************************
1687 * This function will print information such as fps and other picture
1688 * dependant information.
1689 *****************************************************************************/
1690 static void RenderPictureInfo( vout_thread_t *p_vout, picture_t *p_pic )
1692 char psz_buffer[256]; /* string buffer */
1695 * Print FPS rate in upper right corner
1697 if( p_vout->c_fps_samples > VOUT_FPS_SAMPLES )
1699 long i_fps = VOUT_FPS_SAMPLES * 1000000 * 10 /
1700 ( p_vout->p_fps_sample[ (p_vout->c_fps_samples - 1)
1701 % VOUT_FPS_SAMPLES ] -
1702 p_vout->p_fps_sample[ p_vout->c_fps_samples
1703 % VOUT_FPS_SAMPLES ] );
1704 sprintf( psz_buffer, "%li.%i fps", i_fps / 10, (int)i_fps % 10 );
1705 Print( p_vout, 0, 0, RIGHT_RALIGN, TOP_RALIGN, psz_buffer );
1709 * Print frames count and loop time in upper left corner
1711 sprintf( psz_buffer, "%ld frames, render: %ldus",
1712 (long) p_vout->c_fps_samples, (long) p_vout->render_time );
1713 Print( p_vout, 0, 0, LEFT_RALIGN, TOP_RALIGN, psz_buffer );
1717 * Print picture information in lower right corner
1719 sprintf( psz_buffer, "%s picture %dx%d (%dx%d%+d%+d %s) -> %dx%d+%d+%d",
1720 (p_pic->i_type == YUV_420_PICTURE) ? "4:2:0" :
1721 ((p_pic->i_type == YUV_422_PICTURE) ? "4:2:2" :
1722 ((p_pic->i_type == YUV_444_PICTURE) ? "4:4:4" : "ukn-type")),
1723 p_pic->i_width, p_pic->i_height,
1724 p_pic->i_display_width, p_pic->i_display_height,
1725 p_pic->i_display_horizontal_offset, p_pic->i_display_vertical_offset,
1726 (p_pic->i_aspect_ratio == AR_SQUARE_PICTURE) ? "sq" :
1727 ((p_pic->i_aspect_ratio == AR_3_4_PICTURE) ? "4:3" :
1728 ((p_pic->i_aspect_ratio == AR_16_9_PICTURE) ? "16:9" :
1729 ((p_pic->i_aspect_ratio == AR_221_1_PICTURE) ? "2.21:1" : "ukn-ar" ))),
1730 p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_width,
1731 p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_height,
1732 p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_x,
1733 p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_y );
1734 Print( p_vout, 0, 0, RIGHT_RALIGN, BOTTOM_RALIGN, psz_buffer );
1738 /*****************************************************************************
1739 * RenderSplash: render splash picture
1740 *****************************************************************************
1741 * This function will print something on the screen. It will return 0 if
1742 * nothing has been rendered, or 1 if something has been changed on the screen.
1743 * Note that if you absolutely want something to be printed, you will have
1744 * to force it by setting the last idle date to 0.
1745 * Unlike other rendering functions, this one calls the SetBufferPicture
1746 * function when needed.
1747 *****************************************************************************/
1748 int RenderSplash( vout_thread_t *p_vout )
1750 int i_x = 0, i_y = 0; /* text position */
1751 int i_width, i_height; /* text size */
1752 char *psz_text = "VideoLAN Client (" VERSION ")"; /* text to display */
1754 memset( p_vout->p_buffer[ p_vout->i_buffer_index ].p_data,
1755 p_vout->i_bytes_per_line * p_vout->i_height, 12);
1757 // SetBufferPicture( p_vout, NULL );
1758 vout_TextSize( p_vout->p_large_font, WIDE_TEXT | OUTLINED_TEXT, psz_text,
1759 &i_width, &i_height );
1760 if( !Align( p_vout, &i_x, &i_y, i_width, i_height, CENTER_RALIGN, CENTER_RALIGN ) )
1762 vout_Print( p_vout->p_large_font,
1763 p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1764 i_x * p_vout->i_bytes_per_pixel + (i_y - 16 ) * p_vout->i_bytes_per_line,
1765 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1766 p_vout->i_white_pixel, p_vout->i_gray_pixel, 0,
1767 WIDE_TEXT | OUTLINED_TEXT, psz_text, 100);
1768 SetBufferArea( p_vout, i_x, i_y, i_width, i_height);
1774 /*****************************************************************************
1775 * RenderIdle: render idle picture
1776 *****************************************************************************
1777 * This function will print something on the screen. It will return 0 if
1778 * nothing has been rendered, or 1 if something has been changed on the screen.
1779 * Note that if you absolutely want something to be printed, you will have
1780 * to force it by setting the last idle date to 0.
1781 * Unlike other rendering functions, this one calls the SetBufferPicture
1782 * function when needed.
1783 *****************************************************************************/
1784 int RenderIdle( vout_thread_t *p_vout )
1786 int i_x = 0, i_y = 0; /* text position */
1787 int i_width, i_height; /* text size */
1788 mtime_t current_date; /* current date */
1789 int i_amount = 0; /* amount to draw */
1790 char *psz_text = "Waiting for stream"; /* text to display */
1791 char *psz_wtext = "[................]";
1794 memset( p_vout->p_buffer[ p_vout->i_buffer_index ].p_data,
1795 p_vout->i_bytes_per_line * p_vout->i_height, 12);
1798 current_date = mdate();
1799 if( (current_date - p_vout->last_display_date) > VOUT_IDLE_DELAY
1800 // && (current_date - p_vout->last_idle_date) > VOUT_IDLE_DELAY
1803 SetBufferPicture( p_vout, NULL );
1804 vout_TextSize( p_vout->p_large_font, WIDE_TEXT | OUTLINED_TEXT, psz_text,
1805 &i_width, &i_height );
1806 if( !Align( p_vout, &i_x, &i_y, i_width, i_height * 2, CENTER_RALIGN, CENTER_RALIGN ) )
1808 i_amount = (int) ((current_date - p_vout->last_display_date ) / 5000LL);
1809 vout_Print( p_vout->p_large_font,
1810 p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1811 i_x * p_vout->i_bytes_per_pixel + i_y * p_vout->i_bytes_per_line,
1812 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1813 p_vout->i_white_pixel, p_vout->i_gray_pixel, 0,
1814 WIDE_TEXT | OUTLINED_TEXT, psz_text, (i_amount / 3 ) %110);
1816 vout_Print( p_vout->p_large_font,
1817 p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1818 i_x * p_vout->i_bytes_per_pixel + (i_y + 16) * p_vout->i_bytes_per_line,
1819 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1820 p_vout->i_white_pixel, p_vout->i_gray_pixel, 0,
1821 WIDE_TEXT | OUTLINED_TEXT, psz_wtext, (i_amount/5)%110 );
1824 SetBufferArea( p_vout, i_x, i_y, i_width, i_height * 2 );
1831 /*****************************************************************************
1832 * RenderInfo: render additionnal information
1833 *****************************************************************************
1834 * This function renders information which do not depend on the current
1836 *****************************************************************************/
1837 static void RenderInfo( vout_thread_t *p_vout )
1840 char psz_buffer[256]; /* string buffer */
1841 int i_ready_pic = 0; /* ready pictures */
1842 int i_reserved_pic = 0; /* reserved pictures */
1843 int i_picture; /* picture index */
1848 * Print thread state in lower left corner
1850 for( i_picture = 0; i_picture < VOUT_MAX_PICTURES; i_picture++ )
1852 switch( p_vout->p_picture[i_picture].i_status )
1854 case RESERVED_PICTURE:
1855 case RESERVED_DATED_PICTURE:
1856 case RESERVED_DISP_PICTURE:
1864 sprintf( psz_buffer, "pic: %d (%d/%d)/%d",
1865 p_vout->i_pictures, i_reserved_pic, i_ready_pic, VOUT_MAX_PICTURES );
1866 Print( p_vout, 0, 0, LEFT_RALIGN, BOTTOM_RALIGN, psz_buffer );
1870 /*****************************************************************************
1871 * RenderSubPicture: render a subpicture
1872 *****************************************************************************
1873 * This function renders a sub picture unit.
1874 *****************************************************************************/
1875 static void RenderSubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
1877 p_vout_font_t p_font; /* text font */
1878 int i_width, i_height; /* subpicture dimensions */
1880 while( p_subpic != NULL )
1882 switch( p_subpic->i_type )
1884 case DVD_SUBPICTURE: /* DVD subpicture unit */
1885 /* test if the picture really has to be displayed */
1886 if( mdate() < p_subpic->begin_date )
1888 /* not yet, see you later */
1891 if( mdate() > p_subpic->end_date )
1893 /* too late, destroying the subpic */
1894 vout_DestroySubPicture( p_vout, p_subpic );
1897 vout_RenderSPU( &p_vout->p_buffer[ p_vout->i_buffer_index ],
1898 p_subpic, p_vout->i_bytes_per_pixel,
1899 p_vout->i_bytes_per_line );
1901 case TEXT_SUBPICTURE: /* single line text */
1902 /* Select default font if not specified */
1903 p_font = p_subpic->type.text.p_font;
1904 if( p_font == NULL )
1906 p_font = p_vout->p_default_font;
1909 /* Compute text size (width and height fields are ignored)
1911 vout_TextSize( p_font, p_subpic->type.text.i_style,
1912 p_subpic->p_data, &i_width, &i_height );
1913 if( !Align( p_vout, &p_subpic->i_x, &p_subpic->i_y,
1914 i_width, i_height, p_subpic->i_horizontal_align,
1915 p_subpic->i_vertical_align ) )
1918 p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1919 p_subpic->i_x * p_vout->i_bytes_per_pixel +
1920 p_subpic->i_y * p_vout->i_bytes_per_line,
1921 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1922 p_subpic->type.text.i_char_color,
1923 p_subpic->type.text.i_border_color,
1924 p_subpic->type.text.i_bg_color,
1925 p_subpic->type.text.i_style, p_subpic->p_data, 100 );
1926 SetBufferArea( p_vout, p_subpic->i_x, p_subpic->i_y,
1927 i_width, i_height );
1933 intf_DbgMsg( "error: unknown subpicture %p type %d\n",
1934 p_subpic, p_subpic->i_type );
1938 p_subpic = p_subpic->p_next;
1942 /*****************************************************************************
1943 * RenderInterface: render the interface
1944 *****************************************************************************
1945 * This function renders the interface, if any.
1946 *****************************************************************************/
1947 static void RenderInterface( vout_thread_t *p_vout )
1949 int i_height, i_text_height; /* total and text height */
1950 int i_width_1, i_width_2; /* text width */
1951 int i_byte; /* byte index */
1952 const char *psz_text_1 = "[1-9] Channel [i]nfo [c]olor [g/G]amma";
1953 const char *psz_text_2 = "[+/-] Volume [m]ute [s]caling [Q]uit";
1956 vout_TextSize( p_vout->p_large_font, OUTLINED_TEXT, psz_text_1, &i_width_1, &i_height );
1957 vout_TextSize( p_vout->p_large_font, OUTLINED_TEXT, psz_text_2, &i_width_2, &i_text_height );
1958 i_height += i_text_height;
1960 /* Render background */
1961 for( i_byte = (p_vout->i_height - i_height) * p_vout->i_bytes_per_line;
1962 i_byte < p_vout->i_height * p_vout->i_bytes_per_line;
1966 p_vout->p_buffer[ p_vout->i_buffer_index ].p_data[ i_byte ] = p_vout->i_blue_pixel;
1969 /* Render text, if not larger than screen */
1970 if( i_width_1 < p_vout->i_width )
1972 vout_Print( p_vout->p_large_font, p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1973 (p_vout->i_height - i_height) * p_vout->i_bytes_per_line,
1974 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1975 p_vout->i_white_pixel, p_vout->i_black_pixel, 0,
1976 OUTLINED_TEXT, psz_text_1, 100 );
1978 if( i_width_2 < p_vout->i_width )
1980 vout_Print( p_vout->p_large_font, p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1981 (p_vout->i_height - i_height + i_text_height) * p_vout->i_bytes_per_line,
1982 p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1983 p_vout->i_white_pixel, p_vout->i_black_pixel, 0,
1984 OUTLINED_TEXT, psz_text_2, 100 );
1987 /* Activate modified area */
1988 SetBufferArea( p_vout, 0, p_vout->i_height - i_height, p_vout->i_width, i_height );
1991 /*****************************************************************************
1992 * Manage: manage thread
1993 *****************************************************************************
1994 * This function will handle changes in thread configuration.
1995 *****************************************************************************/
1996 static int Manage( vout_thread_t *p_vout )
1999 if( p_vout->i_changes )
2001 intf_DbgMsg("changes: 0x%x (no display: 0x%x)\n", p_vout->i_changes,
2002 0 /* p_vout->i_changes & VOUT_NODISPLAY_CHANGE */ );
2006 /* On gamma or grayscale change, rebuild tables */
2007 if( p_vout->i_changes & (VOUT_GAMMA_CHANGE | VOUT_GRAYSCALE_CHANGE |
2010 /* Change vdec_DecodeMacroblock when switching between BW and C */
2011 if( !p_vout->b_grayscale )
2013 p_vout->vdec_DecodeMacroblock = vdec_DecodeMacroblockC;
2015 else if( p_vout->b_grayscale)
2017 p_vout->vdec_DecodeMacroblock = vdec_DecodeMacroblockBW;
2019 if( vout_ResetYUV( p_vout ) )
2021 intf_ErrMsg("error: can't rebuild convertion tables\n");
2026 /* Clear changes flags which does not need management or have been
2028 p_vout->i_changes &= ~(VOUT_GAMMA_CHANGE | VOUT_GRAYSCALE_CHANGE |
2029 VOUT_YUV_CHANGE | VOUT_INFO_CHANGE |
2030 VOUT_INTF_CHANGE | VOUT_SCALE_CHANGE );
2032 /* Detect unauthorized changes */
2033 if( p_vout->i_changes )
2035 /* Some changes were not acknowledged by p_vout->p_sys_manage or this
2036 * function, it means they should not be authorized */
2037 intf_ErrMsg( "error: unauthorized changes in the video output thread\n" );
2044 /*****************************************************************************
2045 * Align: align a subpicture in the screen
2046 *****************************************************************************
2047 * This function is used for rendering text or subpictures. It returns non 0
2048 * it the final aera is not fully included in display area. Return coordinates
2050 *****************************************************************************/
2051 static int Align( vout_thread_t *p_vout, int *pi_x, int *pi_y,
2052 int i_width, int i_height, int i_h_align, int i_v_align )
2054 /* Align horizontally */
2058 *pi_x -= i_width / 2;
2061 *pi_x += (p_vout->i_width - i_width) / 2;
2067 *pi_x += p_vout->i_width - i_width;
2071 /* Align vertically */
2075 *pi_y -= i_height / 2;
2078 *pi_y += (p_vout->i_height - i_height) / 2;
2084 *pi_y += p_vout->i_height - i_height;
2086 case SUBTITLE_RALIGN:
2087 *pi_y += (p_vout->i_height + p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_y +
2088 p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_height - i_height) / 2;
2092 /* Return non 0 if clipping failed */
2093 return( (*pi_x < 0) || (*pi_y < 0) ||
2094 (*pi_x + i_width > p_vout->i_width) || (*pi_y + i_height > p_vout->i_height) );
2097 /*****************************************************************************
2098 * SetPalette: sets an 8 bpp palette
2099 *****************************************************************************
2100 * This function is just a prototype that does nothing. Architectures that
2101 * support palette allocation should override it.
2102 *****************************************************************************/
2103 static void SetPalette ( p_vout_thread_t p_vout, u16 *red,
2104 u16 *green, u16 *blue, u16 *transp )
2106 intf_ErrMsg( "SetPalette: method does not support palette changing\n" );