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-2001 VideoLAN
8 * $Id: video_output.c,v 1.216 2003/03/25 17:07:45 gbazin Exp $
10 * Authors: Vincent Seguin <seguin@via.ecp.fr>
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
25 *****************************************************************************/
27 /*****************************************************************************
29 *****************************************************************************/
30 #include <stdlib.h> /* free() */
34 #ifdef HAVE_SYS_TIMES_H
35 # include <sys/times.h>
39 #include "video_output.h"
40 #include <vlc/input.h> /* for input_thread_t and i_pts_delay */
42 #if defined( SYS_DARWIN )
43 #include "darwin_specific.h"
46 /*****************************************************************************
48 *****************************************************************************/
49 static int InitThread ( vout_thread_t * );
50 static void RunThread ( vout_thread_t * );
51 static void ErrorThread ( vout_thread_t * );
52 static void EndThread ( vout_thread_t * );
53 static void DestroyThread ( vout_thread_t * );
55 static int ReduceHeight ( int );
56 static int BinaryLog ( uint32_t );
57 static void MaskToShift ( int *, int *, uint32_t );
58 static void InitWindowSize ( vout_thread_t *, int *, int * );
60 /*****************************************************************************
61 * vout_Request: find a video output thread, create one, or destroy one.
62 *****************************************************************************
63 * This function looks for a video output thread matching the current
64 * properties. If not found, it spawns a new one.
65 *****************************************************************************/
66 vout_thread_t * __vout_Request ( vlc_object_t *p_this, vout_thread_t *p_vout,
67 unsigned int i_width, unsigned int i_height,
68 vlc_fourcc_t i_chroma, unsigned int i_aspect )
70 if( !i_width || !i_height || !i_chroma )
72 /* Reattach video output to input before bailing out */
75 vlc_object_t *p_input;
76 char *psz_sout = config_GetPsz( p_this, "sout" );
78 p_input = vlc_object_find( p_this, VLC_OBJECT_INPUT, FIND_PARENT );
80 if( p_input && (!psz_sout || !*psz_sout) )
82 vlc_object_detach( p_vout );
83 vlc_object_attach( p_vout, p_input );
87 vlc_object_detach( p_vout );
88 vlc_object_release( p_vout );
89 vout_Destroy( p_vout );
91 if( psz_sout ) free( psz_sout );
92 if( p_input ) vlc_object_release( p_input );
98 /* If a video output was provided, lock it, otherwise look for one. */
101 vlc_object_yield( p_vout );
105 p_vout = vlc_object_find( p_this, VLC_OBJECT_VOUT, FIND_CHILD );
109 vlc_object_t *p_input;
111 p_input = vlc_object_find( p_this, VLC_OBJECT_INPUT, FIND_PARENT );
114 p_vout = vlc_object_find( p_input, VLC_OBJECT_VOUT,
116 vlc_object_release( p_input );
121 /* If we now have a video output, check it has the right properties */
124 char *psz_filter_chain;
126 /* We don't directly check for the "filter" variable for obvious
127 * performance reasons. */
128 if( p_vout->b_filter_change )
130 psz_filter_chain = config_GetPsz( p_this, "filter" );
132 if( psz_filter_chain && !*psz_filter_chain )
134 free( psz_filter_chain );
135 psz_filter_chain = NULL;
137 if( p_vout->psz_filter_chain && !*p_vout->psz_filter_chain )
139 free( p_vout->psz_filter_chain );
140 p_vout->psz_filter_chain = NULL;
143 if( ( !psz_filter_chain && !p_vout->psz_filter_chain ) ||
144 ( psz_filter_chain && p_vout->psz_filter_chain &&
145 !strcmp( psz_filter_chain, p_vout->psz_filter_chain ) ) )
147 p_vout->b_filter_change = VLC_FALSE;
150 if( psz_filter_chain ) free( psz_filter_chain );
153 if( ( p_vout->render.i_width != i_width ) ||
154 ( p_vout->render.i_height != i_height ) ||
155 ( p_vout->render.i_chroma != i_chroma ) ||
156 ( p_vout->render.i_aspect != i_aspect
157 && !p_vout->b_override_aspect ) ||
158 p_vout->b_filter_change )
160 /* We are not interested in this format, close this vout */
161 vlc_object_detach( p_vout );
162 vlc_object_release( p_vout );
163 vout_Destroy( p_vout );
168 /* This video output is cool! Hijack it. */
169 vlc_object_detach( p_vout );
170 vlc_object_attach( p_vout, p_this );
171 vlc_object_release( p_vout );
177 msg_Dbg( p_this, "no usable vout present, spawning one" );
179 p_vout = vout_Create( p_this, i_width, i_height, i_chroma, i_aspect );
185 /*****************************************************************************
186 * vout_Create: creates a new video output thread
187 *****************************************************************************
188 * This function creates a new video output thread, and returns a pointer
189 * to its description. On error, it returns NULL.
190 *****************************************************************************/
191 vout_thread_t * __vout_Create( vlc_object_t *p_parent,
192 unsigned int i_width, unsigned int i_height,
193 vlc_fourcc_t i_chroma, unsigned int i_aspect )
195 vout_thread_t * p_vout; /* thread descriptor */
196 input_thread_t * p_input_thread;
197 int i_index; /* loop variable */
201 /* Allocate descriptor */
202 p_vout = vlc_object_create( p_parent, VLC_OBJECT_VOUT );
205 msg_Err( p_parent, "out of memory" );
209 var_Create( p_vout, "intf-change", VLC_VAR_BOOL );
210 val.b_bool = VLC_TRUE;
211 var_Set( p_vout, "intf-change", val );
213 p_vout->b_override_aspect = VLC_FALSE;
215 /* If the parent is not a VOUT object, that means we are at the start of
216 * the video output pipe */
217 if( p_parent->i_object_type != VLC_OBJECT_VOUT )
219 char *psz_aspect = config_GetPsz( p_parent, "aspect-ratio" );
221 /* Check whether the user tried to override aspect ratio */
224 unsigned int i_new_aspect = i_aspect;
225 char *psz_parser = strchr( psz_aspect, ':' );
229 *psz_parser++ = '\0';
230 i_new_aspect = atoi( psz_aspect ) * VOUT_ASPECT_FACTOR
231 / atoi( psz_parser );
235 i_new_aspect = i_width * VOUT_ASPECT_FACTOR
242 if( i_new_aspect && i_new_aspect != i_aspect )
244 int i_pgcd = ReduceHeight( i_new_aspect );
246 msg_Dbg( p_vout, "overriding source aspect ratio to %i:%i",
247 i_new_aspect / i_pgcd, VOUT_ASPECT_FACTOR / i_pgcd );
249 i_aspect = i_new_aspect;
251 p_vout->b_override_aspect = VLC_TRUE;
255 /* Look for the default filter configuration */
256 p_vout->psz_filter_chain = config_GetPsz( p_parent, "filter" );
260 /* continue the parent's filter chain */
263 psz_end = strchr( ((vout_thread_t *)p_parent)->psz_filter_chain, ':' );
264 if( psz_end && *(psz_end+1) )
265 p_vout->psz_filter_chain = strdup( psz_end+1 );
266 else p_vout->psz_filter_chain = NULL;
269 /* Choose the video output module */
270 if( !p_vout->psz_filter_chain || !*p_vout->psz_filter_chain )
272 psz_plugin = config_GetPsz( p_parent, "vout" );
276 /* the filter chain is a string list of filters separated by double
280 psz_end = strchr( p_vout->psz_filter_chain, ':' );
282 psz_plugin = strndup( p_vout->psz_filter_chain,
283 psz_end - p_vout->psz_filter_chain );
284 else psz_plugin = strdup( p_vout->psz_filter_chain );
287 /* Initialize pictures and subpictures - translation tables and functions
288 * will be initialized later in InitThread */
289 for( i_index = 0; i_index < 2 * VOUT_MAX_PICTURES; i_index++)
291 p_vout->p_picture[i_index].i_status = FREE_PICTURE;
292 p_vout->p_picture[i_index].i_type = EMPTY_PICTURE;
295 for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++)
297 p_vout->p_subpicture[i_index].i_status = FREE_SUBPICTURE;
298 p_vout->p_subpicture[i_index].i_type = EMPTY_SUBPICTURE;
301 /* No images in the heap */
302 p_vout->i_heap_size = 0;
304 /* Initialize the rendering heap */
305 I_RENDERPICTURES = 0;
306 p_vout->render.i_width = i_width;
307 p_vout->render.i_height = i_height;
308 p_vout->render.i_chroma = i_chroma;
309 p_vout->render.i_aspect = i_aspect;
311 p_vout->render.i_rmask = 0;
312 p_vout->render.i_gmask = 0;
313 p_vout->render.i_bmask = 0;
315 p_vout->render.i_last_used_pic = -1;
316 p_vout->render.b_allow_modify_pics = 1;
318 /* Zero the output heap */
319 I_OUTPUTPICTURES = 0;
320 p_vout->output.i_width = 0;
321 p_vout->output.i_height = 0;
322 p_vout->output.i_chroma = 0;
323 p_vout->output.i_aspect = 0;
325 p_vout->output.i_rmask = 0;
326 p_vout->output.i_gmask = 0;
327 p_vout->output.i_bmask = 0;
329 /* Initialize misc stuff */
330 p_vout->i_changes = 0;
332 p_vout->b_grayscale = 0;
334 p_vout->b_interface = 0;
336 p_vout->b_fullscreen = 0;
337 p_vout->render_time = 10;
338 p_vout->c_fps_samples = 0;
339 p_vout->b_filter_change = 0;
341 /* Mouse coordinates */
342 var_Create( p_vout, "mouse-x", VLC_VAR_INTEGER );
343 var_Create( p_vout, "mouse-y", VLC_VAR_INTEGER );
344 var_Create( p_vout, "mouse-button-down", VLC_VAR_INTEGER );
345 var_Create( p_vout, "mouse-moved", VLC_VAR_BOOL );
346 var_Create( p_vout, "mouse-clicked", VLC_VAR_INTEGER );
347 var_Create( p_vout, "key-pressed", VLC_VAR_STRING );
349 /* user requested fullscreen? */
350 if( config_GetInt( p_vout, "fullscreen" ) )
352 p_vout->i_changes |= VOUT_FULLSCREEN_CHANGE;
355 /* Initialize the dimensions of the video window */
356 InitWindowSize( p_vout, &p_vout->i_window_width,
357 &p_vout->i_window_height );
360 p_vout->p_module = module_Need( p_vout,
361 ( p_vout->psz_filter_chain &&
362 *p_vout->psz_filter_chain ) ?
363 "video filter" : "video output",
366 if( psz_plugin ) free( psz_plugin );
367 if( p_vout->p_module == NULL )
369 msg_Err( p_vout, "no suitable vout module" );
370 vlc_object_destroy( p_vout );
374 /* Calculate delay created by internal caching */
375 p_input_thread = (input_thread_t *)vlc_object_find( p_vout,
376 VLC_OBJECT_INPUT, FIND_ANYWHERE );
379 p_vout->i_pts_delay = p_input_thread->i_pts_delay;
380 vlc_object_release( p_input_thread );
384 p_vout->i_pts_delay = DEFAULT_PTS_DELAY;
387 /* Create thread and set locks */
388 vlc_mutex_init( p_vout, &p_vout->picture_lock );
389 vlc_mutex_init( p_vout, &p_vout->subpicture_lock );
390 vlc_mutex_init( p_vout, &p_vout->change_lock );
392 vlc_object_attach( p_vout, p_parent );
394 if( vlc_thread_create( p_vout, "video output", RunThread,
395 VLC_THREAD_PRIORITY_OUTPUT, VLC_FALSE ) )
397 msg_Err( p_vout, "out of memory" );
398 module_Unneed( p_vout, p_vout->p_module );
399 vlc_object_destroy( p_vout );
406 /*****************************************************************************
407 * vout_Destroy: destroys a previously created video output
408 *****************************************************************************
409 * Destroy a terminated thread.
410 * The function will request a destruction of the specified thread. If pi_error
411 * is NULL, it will return once the thread is destroyed. Else, it will be
412 * update using one of the THREAD_* constants.
413 *****************************************************************************/
414 void vout_Destroy( vout_thread_t *p_vout )
416 /* Request thread destruction */
417 p_vout->b_die = VLC_TRUE;
418 vlc_thread_join( p_vout );
420 var_Destroy( p_vout, "intf-change" );
423 vlc_object_destroy( p_vout );
426 /*****************************************************************************
427 * InitThread: initialize video output thread
428 *****************************************************************************
429 * This function is called from RunThread and performs the second step of the
430 * initialization. It returns 0 on success. Note that the thread's flag are not
431 * modified inside this function.
432 *****************************************************************************/
433 static int InitThread( vout_thread_t *p_vout )
437 vlc_mutex_lock( &p_vout->change_lock );
443 /* Initialize output method, it allocates direct buffers for us */
444 if( p_vout->pf_init( p_vout ) )
446 vlc_mutex_unlock( &p_vout->change_lock );
450 if( !I_OUTPUTPICTURES )
452 msg_Err( p_vout, "plugin was unable to allocate at least "
453 "one direct buffer" );
454 p_vout->pf_end( p_vout );
455 vlc_mutex_unlock( &p_vout->change_lock );
459 if( I_OUTPUTPICTURES > VOUT_MAX_PICTURES )
461 msg_Err( p_vout, "plugin allocated too many direct buffers, "
462 "our internal buffers must have overflown." );
463 p_vout->pf_end( p_vout );
464 vlc_mutex_unlock( &p_vout->change_lock );
468 msg_Dbg( p_vout, "got %i direct buffer(s)", I_OUTPUTPICTURES );
471 if( !p_vout->psz_filter_chain )
473 char *psz_aspect = config_GetPsz( p_vout, "pixel-ratio" );
477 int i_new_aspect = p_vout->output.i_width * VOUT_ASPECT_FACTOR
479 / p_vout->output.i_height;
482 if( i_new_aspect && i_new_aspect != p_vout->output.i_aspect )
484 int i_pgcd = ReduceHeight( i_new_aspect );
485 msg_Dbg( p_vout, "output ratio forced to %i:%i\n",
486 i_new_aspect / i_pgcd, VOUT_ASPECT_FACTOR / i_pgcd );
487 p_vout->output.i_aspect = i_new_aspect;
493 i_pgcd = ReduceHeight( p_vout->render.i_aspect );
495 "picture in %ix%i, chroma 0x%.8x (%4.4s), aspect ratio %i:%i",
496 p_vout->render.i_width, p_vout->render.i_height,
497 p_vout->render.i_chroma, (char*)&p_vout->render.i_chroma,
498 p_vout->render.i_aspect / i_pgcd, VOUT_ASPECT_FACTOR / i_pgcd );
500 i_pgcd = ReduceHeight( p_vout->output.i_aspect );
502 "picture out %ix%i, chroma 0x%.8x (%4.4s), aspect ratio %i:%i",
503 p_vout->output.i_width, p_vout->output.i_height,
504 p_vout->output.i_chroma, (char*)&p_vout->output.i_chroma,
505 p_vout->output.i_aspect / i_pgcd, VOUT_ASPECT_FACTOR / i_pgcd );
507 /* Calculate shifts from system-updated masks */
508 MaskToShift( &p_vout->output.i_lrshift, &p_vout->output.i_rrshift,
509 p_vout->output.i_rmask );
510 MaskToShift( &p_vout->output.i_lgshift, &p_vout->output.i_rgshift,
511 p_vout->output.i_gmask );
512 MaskToShift( &p_vout->output.i_lbshift, &p_vout->output.i_rbshift,
513 p_vout->output.i_bmask );
515 /* Check whether we managed to create direct buffers similar to
516 * the render buffers, ie same size and chroma */
517 if( ( p_vout->output.i_width == p_vout->render.i_width )
518 && ( p_vout->output.i_height == p_vout->render.i_height )
519 && ( vout_ChromaCmp( p_vout->output.i_chroma, p_vout->render.i_chroma ) ) )
521 /* Cool ! We have direct buffers, we can ask the decoder to
522 * directly decode into them ! Map the first render buffers to
523 * the first direct buffers, but keep the first direct buffer
524 * for memcpy operations */
525 p_vout->b_direct = 1;
527 for( i = 1; i < VOUT_MAX_PICTURES; i++ )
529 if( p_vout->p_picture[ i ].i_type != DIRECT_PICTURE &&
530 I_RENDERPICTURES >= VOUT_MIN_DIRECT_PICTURES - 1 &&
531 p_vout->p_picture[ i - 1 ].i_type == DIRECT_PICTURE )
533 /* We have enough direct buffers so there's no need to
534 * try to use system memory buffers. */
537 PP_RENDERPICTURE[ I_RENDERPICTURES ] = &p_vout->p_picture[ i ];
541 msg_Dbg( p_vout, "direct render, mapping "
542 "render pictures 0-%i to system pictures 1-%i",
543 VOUT_MAX_PICTURES - 2, VOUT_MAX_PICTURES - 1 );
547 /* Rats... Something is wrong here, we could not find an output
548 * plugin able to directly render what we decode. See if we can
549 * find a chroma plugin to do the conversion */
550 p_vout->b_direct = 0;
552 /* Choose the best module */
553 p_vout->chroma.p_module = module_Need( p_vout, "chroma", NULL );
555 if( p_vout->chroma.p_module == NULL )
557 msg_Err( p_vout, "no chroma module for %4.4s to %4.4s",
558 (char*)&p_vout->render.i_chroma,
559 (char*)&p_vout->output.i_chroma );
560 p_vout->pf_end( p_vout );
561 vlc_mutex_unlock( &p_vout->change_lock );
565 msg_Dbg( p_vout, "indirect render, mapping "
566 "render pictures 0-%i to system pictures %i-%i",
567 VOUT_MAX_PICTURES - 1, I_OUTPUTPICTURES,
568 I_OUTPUTPICTURES + VOUT_MAX_PICTURES - 1 );
570 /* Append render buffers after the direct buffers */
571 for( i = I_OUTPUTPICTURES; i < 2 * VOUT_MAX_PICTURES; i++ )
573 PP_RENDERPICTURE[ I_RENDERPICTURES ] = &p_vout->p_picture[ i ];
576 /* Check if we have enough render pictures */
577 if( I_RENDERPICTURES == VOUT_MAX_PICTURES )
582 /* Link pictures back to their heap */
583 for( i = 0 ; i < I_RENDERPICTURES ; i++ )
585 PP_RENDERPICTURE[ i ]->p_heap = &p_vout->render;
588 for( i = 0 ; i < I_OUTPUTPICTURES ; i++ )
590 PP_OUTPUTPICTURE[ i ]->p_heap = &p_vout->output;
593 /* XXX XXX mark thread ready */
597 /*****************************************************************************
598 * RunThread: video output thread
599 *****************************************************************************
600 * Video output thread. This function does only returns when the thread is
601 * terminated. It handles the pictures arriving in the video heap and the
602 * display device events.
603 *****************************************************************************/
604 static void RunThread( vout_thread_t *p_vout)
606 int i_index; /* index in heap */
607 int i_idle_loops = 0; /* loops without displaying a picture */
608 mtime_t current_date; /* current date */
609 mtime_t display_date; /* display date */
611 picture_t * p_picture; /* picture pointer */
612 picture_t * p_last_picture = NULL; /* last picture */
613 picture_t * p_directbuffer; /* direct buffer to display */
615 subpicture_t * p_subpic; /* subpicture pointer */
620 p_vout->b_error = InitThread( p_vout );
621 if( p_vout->b_error )
623 /* Destroy thread structures allocated by Create and InitThread */
624 DestroyThread( p_vout );
629 * Main loop - it is not executed if an error occured during
632 while( (!p_vout->b_die) && (!p_vout->b_error) )
634 /* Initialize loop variables */
637 current_date = mdate();
641 if( !(p_vout->c_loops % VOUT_STATS_NB_LOOPS) )
643 msg_Dbg( p_vout, "picture heap: %d/%d",
644 I_RENDERPICTURES, p_vout->i_heap_size );
649 * Find the picture to display (the one with the earliest date).
650 * This operation does not need lock, since only READY_PICTUREs
652 for( i_index = 0; i_index < I_RENDERPICTURES; i_index++ )
654 if( (PP_RENDERPICTURE[i_index]->i_status == READY_PICTURE)
655 && ( (p_picture == NULL) ||
656 (PP_RENDERPICTURE[i_index]->date < display_date) ) )
658 p_picture = PP_RENDERPICTURE[i_index];
659 display_date = p_picture->date;
665 /* If we met the last picture, parse again to see whether there is
666 * a more appropriate one. */
667 if( p_picture == p_last_picture )
669 for( i_index = 0; i_index < I_RENDERPICTURES; i_index++ )
671 if( (PP_RENDERPICTURE[i_index]->i_status == READY_PICTURE)
672 && (PP_RENDERPICTURE[i_index] != p_last_picture)
673 && ((p_picture == p_last_picture) ||
674 (PP_RENDERPICTURE[i_index]->date < display_date)) )
676 p_picture = PP_RENDERPICTURE[i_index];
677 display_date = p_picture->date;
682 /* If we found better than the last picture, destroy it */
683 if( p_last_picture && p_picture != p_last_picture )
685 vlc_mutex_lock( &p_vout->picture_lock );
686 if( p_last_picture->i_refcount )
688 p_last_picture->i_status = DISPLAYED_PICTURE;
692 p_last_picture->i_status = DESTROYED_PICTURE;
693 p_vout->i_heap_size--;
695 vlc_mutex_unlock( &p_vout->picture_lock );
696 p_last_picture = NULL;
699 /* Compute FPS rate */
700 p_vout->p_fps_sample[ p_vout->c_fps_samples++ % VOUT_FPS_SAMPLES ]
703 if( !p_picture->b_force &&
704 p_picture != p_last_picture &&
705 display_date < current_date + p_vout->render_time )
707 /* Picture is late: it will be destroyed and the thread
708 * will directly choose the next picture */
709 vlc_mutex_lock( &p_vout->picture_lock );
710 if( p_picture->i_refcount )
712 /* Pretend we displayed the picture, but don't destroy
713 * it since the decoder might still need it. */
714 p_picture->i_status = DISPLAYED_PICTURE;
718 /* Destroy the picture without displaying it */
719 p_picture->i_status = DESTROYED_PICTURE;
720 p_vout->i_heap_size--;
722 msg_Warn( p_vout, "late picture skipped ("I64Fd")",
723 current_date - display_date );
724 vlc_mutex_unlock( &p_vout->picture_lock );
730 current_date + p_vout->i_pts_delay + VOUT_BOGUS_DELAY )
732 /* Picture is waaay too early: it will be destroyed */
733 vlc_mutex_lock( &p_vout->picture_lock );
734 if( p_picture->i_refcount )
736 /* Pretend we displayed the picture, but don't destroy
737 * it since the decoder might still need it. */
738 p_picture->i_status = DISPLAYED_PICTURE;
742 /* Destroy the picture without displaying it */
743 p_picture->i_status = DESTROYED_PICTURE;
744 p_vout->i_heap_size--;
746 msg_Warn( p_vout, "vout warning: early picture skipped "
747 "("I64Fd")", display_date - current_date
748 - p_vout->i_pts_delay );
749 vlc_mutex_unlock( &p_vout->picture_lock );
754 if( display_date > current_date + VOUT_DISPLAY_DELAY )
756 /* A picture is ready to be rendered, but its rendering date
757 * is far from the current one so the thread will perform an
758 * empty loop as if no picture were found. The picture state
763 else if( p_picture == p_last_picture )
765 /* We are asked to repeat the previous picture, but we first
766 * wait for a couple of idle loops */
767 if( i_idle_loops < 4 )
774 /* We set the display date to something high, otherwise
775 * we'll have lots of problems with late pictures */
776 display_date = current_date + p_vout->render_time;
781 if( p_picture == NULL )
787 * Check for subpictures to display
789 p_subpic = vout_SortSubPictures( p_vout, display_date );
794 p_directbuffer = vout_RenderPicture( p_vout, p_picture, p_subpic );
797 * Call the plugin-specific rendering method if there is one
799 if( p_picture != NULL && p_vout->pf_render )
801 /* Render the direct buffer returned by vout_RenderPicture */
802 p_vout->pf_render( p_vout, p_directbuffer );
808 if( display_date != 0 )
810 /* Store render time using a sliding mean */
811 p_vout->render_time += mdate() - current_date;
812 p_vout->render_time >>= 1;
815 /* Give back change lock */
816 vlc_mutex_unlock( &p_vout->change_lock );
818 /* Sleep a while or until a given date */
819 if( display_date != 0 )
821 mwait( display_date - VOUT_MWAIT_TOLERANCE );
825 msleep( VOUT_IDLE_SLEEP );
828 /* On awakening, take back lock and send immediately picture
830 vlc_mutex_lock( &p_vout->change_lock );
833 * Display the previously rendered picture
835 if( p_picture != NULL )
837 /* Display the direct buffer returned by vout_RenderPicture */
838 if( p_vout->pf_display )
840 p_vout->pf_display( p_vout, p_directbuffer );
843 /* Reinitialize idle loop count */
846 /* Tell the vout this was the last picture and that it does not
847 * need to be forced anymore. */
848 p_last_picture = p_picture;
849 p_last_picture->b_force = 0;
853 * Check events and manage thread
855 if( p_vout->pf_manage && p_vout->pf_manage( p_vout ) )
857 /* A fatal error occured, and the thread must terminate
858 * immediately, without displaying anything - setting b_error to 1
859 * causes the immediate end of the main while() loop. */
863 if( p_vout->i_changes & VOUT_SIZE_CHANGE )
865 /* this must only happen when the vout plugin is incapable of
866 * rescaling the picture itself. In this case we need to destroy
867 * the current picture buffers and recreate new ones with the right
871 p_vout->i_changes &= ~VOUT_SIZE_CHANGE;
873 p_vout->pf_end( p_vout );
874 for( i = 0; i < I_OUTPUTPICTURES; i++ )
875 p_vout->p_picture[ i ].i_status = FREE_PICTURE;
877 I_OUTPUTPICTURES = 0;
878 if( p_vout->pf_init( p_vout ) )
880 msg_Err( p_vout, "cannot resize display" );
881 /* FIXME: pf_end will be called again in EndThread() */
885 /* Need to reinitialise the chroma plugin */
886 p_vout->chroma.p_module->pf_deactivate( VLC_OBJECT(p_vout) );
887 p_vout->chroma.p_module->pf_activate( VLC_OBJECT(p_vout) );
892 * Error loop - wait until the thread destruction is requested
894 if( p_vout->b_error )
896 ErrorThread( p_vout );
902 /* Destroy thread structures allocated by CreateThread */
903 DestroyThread( p_vout );
906 /*****************************************************************************
907 * ErrorThread: RunThread() error loop
908 *****************************************************************************
909 * This function is called when an error occured during thread main's loop. The
910 * thread can still receive feed, but must be ready to terminate as soon as
912 *****************************************************************************/
913 static void ErrorThread( vout_thread_t *p_vout )
915 /* Wait until a `die' order */
916 while( !p_vout->b_die )
919 msleep( VOUT_IDLE_SLEEP );
923 /*****************************************************************************
924 * EndThread: thread destruction
925 *****************************************************************************
926 * This function is called when the thread ends after a sucessful
927 * initialization. It frees all ressources allocated by InitThread.
928 *****************************************************************************/
929 static void EndThread( vout_thread_t *p_vout )
931 int i_index; /* index in heap */
935 struct tms cpu_usage;
938 msg_Dbg( p_vout, "cpu usage (user: %d, system: %d)",
939 cpu_usage.tms_utime, cpu_usage.tms_stime );
943 if( !p_vout->b_direct )
945 module_Unneed( p_vout, p_vout->chroma.p_module );
948 /* Destroy all remaining pictures */
949 for( i_index = 0; i_index < 2 * VOUT_MAX_PICTURES; i_index++ )
951 if ( p_vout->p_picture[i_index].i_type == MEMORY_PICTURE )
953 free( p_vout->p_picture[i_index].p_data_orig );
957 /* Destroy all remaining subpictures */
958 for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++ )
960 if( p_vout->p_subpicture[i_index].i_status != FREE_SUBPICTURE )
962 vout_DestroySubPicture( p_vout,
963 &p_vout->p_subpicture[i_index] );
967 /* Destroy translation tables */
968 p_vout->pf_end( p_vout );
970 /* Release the change lock */
971 vlc_mutex_unlock( &p_vout->change_lock );
974 /*****************************************************************************
975 * DestroyThread: thread destruction
976 *****************************************************************************
977 * This function is called when the thread ends. It frees all ressources
978 * allocated by CreateThread. Status is available at this stage.
979 *****************************************************************************/
980 static void DestroyThread( vout_thread_t *p_vout )
982 /* Destroy the locks */
983 vlc_mutex_destroy( &p_vout->picture_lock );
984 vlc_mutex_destroy( &p_vout->subpicture_lock );
985 vlc_mutex_destroy( &p_vout->change_lock );
987 /* Release the module */
988 module_Unneed( p_vout, p_vout->p_module );
991 /* following functions are local */
993 static int ReduceHeight( int i_ratio )
995 int i_dummy = VOUT_ASPECT_FACTOR;
1003 /* VOUT_ASPECT_FACTOR is (2^7 * 3^3 * 5^3), we just check for 2, 3 and 5 */
1004 while( !(i_ratio & 1) && !(i_dummy & 1) )
1011 while( !(i_ratio % 3) && !(i_dummy % 3) )
1018 while( !(i_ratio % 5) && !(i_dummy % 5) )
1028 /*****************************************************************************
1029 * BinaryLog: computes the base 2 log of a binary value
1030 *****************************************************************************
1031 * This functions is used by MaskToShift, to get a bit index from a binary
1033 *****************************************************************************/
1034 static int BinaryLog( uint32_t i )
1038 if( i == 0 ) return -31337;
1040 if( i & 0xffff0000 ) i_log += 16;
1041 if( i & 0xff00ff00 ) i_log += 8;
1042 if( i & 0xf0f0f0f0 ) i_log += 4;
1043 if( i & 0xcccccccc ) i_log += 2;
1044 if( i & 0xaaaaaaaa ) i_log += 1;
1049 /*****************************************************************************
1050 * MaskToShift: transform a color mask into right and left shifts
1051 *****************************************************************************
1052 * This function is used for obtaining color shifts from masks.
1053 *****************************************************************************/
1054 static void MaskToShift( int *pi_left, int *pi_right, uint32_t i_mask )
1056 uint32_t i_low, i_high; /* lower hand higher bits of the mask */
1060 *pi_left = *pi_right = 0;
1065 i_low = i_mask & (- (int32_t)i_mask); /* lower bit of the mask */
1066 i_high = i_mask + i_low; /* higher bit of the mask */
1068 /* Transform bits into an index */
1069 i_low = BinaryLog (i_low);
1070 i_high = BinaryLog (i_high);
1072 /* Update pointers and return */
1074 *pi_right = (8 - i_high + i_low);
1077 /*****************************************************************************
1078 * InitWindowSize: find the initial dimensions the video window should have.
1079 *****************************************************************************
1080 * This function will check the "width", "height" and "zoom" config options and
1081 * will calculate the size that the video window should have.
1082 *****************************************************************************/
1083 static void InitWindowSize( vout_thread_t *p_vout, int *pi_width,
1086 int i_width, i_height;
1089 #define FP_FACTOR 1000 /* our fixed point factor */
1091 i_width = config_GetInt( p_vout, "width" );
1092 i_height = config_GetInt( p_vout, "height" );
1093 ll_zoom = (uint64_t)( FP_FACTOR * config_GetFloat( p_vout, "zoom" ) );
1095 if( (i_width >= 0) && (i_height >= 0))
1097 *pi_width = (int)( i_width * ll_zoom / FP_FACTOR );
1098 *pi_height = (int)( i_height * ll_zoom / FP_FACTOR );
1101 else if( i_width >= 0 )
1103 *pi_width = (int)( i_width * ll_zoom / FP_FACTOR );
1104 *pi_height = (int)( i_width * ll_zoom * VOUT_ASPECT_FACTOR /
1105 p_vout->render.i_aspect / FP_FACTOR );
1108 else if( i_height >= 0 )
1110 *pi_height = (int)( i_height * ll_zoom / FP_FACTOR );
1111 *pi_width = (int)( i_height * ll_zoom * p_vout->render.i_aspect /
1112 VOUT_ASPECT_FACTOR / FP_FACTOR );
1116 if( p_vout->render.i_height * p_vout->render.i_aspect
1117 >= p_vout->render.i_width * VOUT_ASPECT_FACTOR )
1119 *pi_width = (int)( p_vout->render.i_height * ll_zoom
1120 * p_vout->render.i_aspect / VOUT_ASPECT_FACTOR / FP_FACTOR );
1121 *pi_height = (int)( p_vout->render.i_height * ll_zoom / FP_FACTOR );
1125 *pi_width = (int)( p_vout->render.i_width * ll_zoom / FP_FACTOR );
1126 *pi_height = (int)( p_vout->render.i_width * ll_zoom
1127 * VOUT_ASPECT_FACTOR / p_vout->render.i_aspect / FP_FACTOR );
1133 /*****************************************************************************
1134 * vout_VarCallback: generic callback for intf variables
1135 *****************************************************************************/
1136 int vout_VarCallback( vlc_object_t * p_this, const char * psz_variable,
1137 vlc_value_t old_value, vlc_value_t new_value,
1140 vout_thread_t * p_vout = (vout_thread_t *)p_this;
1143 var_Set( p_vout, "intf-change", val );