git.sesse.net Git - vlc/blob - src/video_output/video_output.c

   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
   8  *
   9  * Authors:
  10  *
  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.
  15  *
  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.
  20  *
  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  *****************************************************************************/
  25
  26 /*****************************************************************************
  27  * Preamble
  28  *****************************************************************************/
  29 #include "defs.h"
  30
  31 #include <errno.h>                                                 /* ENOMEM */
  32 #include <stdlib.h>                                                /* free() */
  33 #include <stdio.h>                                              /* sprintf() */
  34 #include <string.h>                                            /* strerror() */
  35
  36 #ifdef STATS
  37 #   include <sys/times.h>
  38 #endif
  39
  40 #include "config.h"
  41 #include "common.h"
  42 #include "threads.h"
  43 #include "mtime.h"
  44 #include "plugins.h"
  45 #include "video.h"
  46 #include "video_output.h"
  47 #include "video_text.h"
  48 #include "video_spu.h"
  49 #include "video_yuv.h"
  50
  51 #include "intf_msg.h"
  52 #include "main.h"
  53
  54 /*****************************************************************************
  55  * Local prototypes
  56  *****************************************************************************/
  57 static int      BinaryLog         ( u32 i );
  58 static void     MaskToShift       ( int *pi_left, int *pi_right, u32 i_mask );
  59 static int      InitThread        ( vout_thread_t *p_vout );
  60 static void     RunThread         ( vout_thread_t *p_vout );
  61 static void     ErrorThread       ( vout_thread_t *p_vout );
  62 static void     EndThread         ( vout_thread_t *p_vout );
  63 static void     DestroyThread     ( vout_thread_t *p_vout, int i_status );
  64 static void     Print             ( vout_thread_t *p_vout, int i_x, int i_y,
  65                                     int i_h_align, int i_v_align,
  66                                     unsigned char *psz_text );
  67 static void     SetBufferArea     ( vout_thread_t *p_vout, int i_x, int i_y,
  68                                     int i_w, int i_h );
  69 static void     SetBufferPicture  ( vout_thread_t *p_vout, picture_t *p_pic );
  70 static void     RenderPicture     ( vout_thread_t *p_vout, picture_t *p_pic );
  71 static void     RenderPictureInfo ( vout_thread_t *p_vout, picture_t *p_pic );
  72 static void     RenderSubPicture  ( vout_thread_t *p_vout,
  73                                     subpicture_t *p_subpic );
  74 static void     RenderInterface   ( vout_thread_t *p_vout );
  75 static int      RenderIdle        ( vout_thread_t *p_vout );
  76 static int      RenderSplash      ( vout_thread_t *p_vout );
  77 static void     RenderInfo        ( vout_thread_t *p_vout );
  78 static int      Manage            ( vout_thread_t *p_vout );
  79 static int      Align             ( vout_thread_t *p_vout, int *pi_x,
  80                                     int *pi_y, int i_width, int i_height,
  81                                     int i_h_align, int i_v_align );
  82 static void     SetPalette        ( p_vout_thread_t p_vout, u16 *red,
  83                                     u16 *green, u16 *blue, u16 *transp );
  84
  85 /*****************************************************************************
  86  * vout_CreateThread: creates a new video output thread
  87  *****************************************************************************
  88  * This function creates a new video output thread, and returns a pointer
  89  * to its description. On error, it returns NULL.
  90  * If pi_status is NULL, then the function will block until the thread is ready.
  91  * If not, it will be updated using one of the THREAD_* constants.
  92  *****************************************************************************/
  93 vout_thread_t * vout_CreateThread   ( char *psz_display, int i_root_window,
  94                           int i_width, int i_height, int *pi_status,
  95                           int i_method, void *p_data )
  96 {
  97     vout_thread_t * p_vout;                             /* thread descriptor */
  98     typedef void    ( vout_getplugin_t ) ( vout_thread_t * p_vout );
  99     int             i_status;                               /* thread status */
 100     int             i_index;               /* index for array initialization */
 101     int             i_best_index = 0, i_best_score = 0;
 102
 103     /* Allocate descriptor */
 104     p_vout = (vout_thread_t *) malloc( sizeof(vout_thread_t) );
 105     if( p_vout == NULL )
 106     {
 107         intf_ErrMsg( "vout error: vout thread creation returned %s",
 108                      strerror(ENOMEM) );
 109         return( NULL );
 110     }
 111
 112     p_vout->p_set_palette       = SetPalette;
 113
 114     /* Get a suitable video plugin */
 115     for( i_index = 0 ; i_index < p_main->p_bank->i_plugin_count ; i_index++ )
 116     {
 117         /* If there's a plugin in p_info ... */
 118         if( p_main->p_bank->p_info[ i_index ] != NULL )
 119         {
 120             /* ... and if this plugin provides the functions we want ... */
 121             if( p_main->p_bank->p_info[ i_index ]->vout_GetPlugin != NULL )
 122             {
 123                 /* ... and if this plugin has a good score ... */
 124                 if( p_main->p_bank->p_info[ i_index ]->i_score > i_best_score )
 125                 {
 126                     /* ... then take it */
 127                     i_best_score = p_main->p_bank->p_info[ i_index ]->i_score;
 128                     i_best_index = i_index;
 129                 }
 130             }
 131         }
 132     }
 133
 134     if( i_best_score == 0 )
 135     {
 136         free( p_vout );
 137         return( NULL );
 138     }
 139
 140     /* Get the plugin functions */
 141     ( (vout_getplugin_t *)
 142       p_main->p_bank->p_info[ i_best_index ]->vout_GetPlugin )( p_vout );
 143
 144     /* Initialize thread properties - thread id and locks will be initialized
 145      * later */
 146     p_vout->b_die               = 0;
 147     p_vout->b_error             = 0;
 148     p_vout->b_active            = 0;
 149     p_vout->pi_status           = (pi_status != NULL) ? pi_status : &i_status;
 150     *p_vout->pi_status          = THREAD_CREATE;
 151
 152     /* Initialize some fields used by the system-dependant method - these
 153      * fields will probably be modified by the method, and are only
 154      * preferences */
 155     p_vout->i_changes             = 0;
 156     p_vout->i_width               = i_width;
 157     p_vout->i_height              = i_height;
 158     p_vout->i_bytes_per_line      = i_width * 2;
 159     p_vout->i_screen_depth        = 15;
 160     p_vout->i_bytes_per_pixel     = 2;
 161     p_vout->f_gamma               = VOUT_GAMMA;
 162     p_vout->b_need_render         = 1;
 163
 164     p_vout->b_grayscale           = main_GetIntVariable( VOUT_GRAYSCALE_VAR,
 165                                                        VOUT_GRAYSCALE_DEFAULT );
 166     p_vout->b_info                = 0;
 167     p_vout->b_interface           = 0;
 168     p_vout->b_scale               = 1;
 169
 170     intf_DbgMsg( "wished configuration: %dx%d, %d/%d bpp (%d Bpl)",
 171                  p_vout->i_width, p_vout->i_height, p_vout->i_screen_depth,
 172                  p_vout->i_bytes_per_pixel * 8, p_vout->i_bytes_per_line );
 173
 174     /* Initialize idle screen */
 175     p_vout->last_display_date   = 0;
 176     p_vout->last_idle_date      = 0;
 177     p_vout->init_display_date   = mdate();
 178     p_vout->render_time         = 10000;
 179
 180     /* Initialize statistics fields */
 181     p_vout->c_fps_samples       = 0;
 182
 183     /* Initialize buffer index */
 184     p_vout->i_buffer_index      = 0;
 185
 186     /* Initialize pictures and subpictures - translation tables and functions
 187      * will be initialized later in InitThread */
 188     for( i_index = 0; i_index < VOUT_MAX_PICTURES; i_index++)
 189     {
 190         p_vout->p_picture[i_index].i_type   =   EMPTY_PICTURE;
 191         p_vout->p_picture[i_index].i_status =   FREE_PICTURE;
 192     }
 193     for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++)
 194     {
 195         p_vout->p_subpicture[i_index].i_type  = EMPTY_SUBPICTURE;
 196         p_vout->p_subpicture[i_index].i_status= FREE_SUBPICTURE;
 197     }
 198     p_vout->i_pictures = 0;
 199
 200     /* Create and initialize system-dependant method - this function issues its
 201      * own error messages */
 202     if( p_vout->p_sys_create( p_vout, psz_display, i_root_window, p_data ) )
 203     {
 204         free( p_vout );
 205         return( NULL );
 206     }
 207     intf_DbgMsg( "actual configuration: %dx%d, %d/%d bpp (%d Bpl), "
 208                  "masks: 0x%x/0x%x/0x%x",
 209                  p_vout->i_width, p_vout->i_height, p_vout->i_screen_depth,
 210                  p_vout->i_bytes_per_pixel * 8, p_vout->i_bytes_per_line,
 211                  p_vout->i_red_mask, p_vout->i_green_mask,
 212                  p_vout->i_blue_mask );
 213
 214     /* Calculate shifts from system-updated masks */
 215     MaskToShift( &p_vout->i_red_lshift, &p_vout->i_red_rshift,
 216                  p_vout->i_red_mask );
 217     MaskToShift( &p_vout->i_green_lshift, &p_vout->i_green_rshift,
 218                  p_vout->i_green_mask );
 219     MaskToShift( &p_vout->i_blue_lshift, &p_vout->i_blue_rshift,
 220                  p_vout->i_blue_mask );
 221
 222     /* Set some useful colors */
 223     p_vout->i_white_pixel = RGB2PIXEL( p_vout, 255, 255, 255 );
 224     p_vout->i_black_pixel = RGB2PIXEL( p_vout, 0, 0, 0 );
 225     p_vout->i_gray_pixel  = RGB2PIXEL( p_vout, 128, 128, 128 );
 226     p_vout->i_blue_pixel  = RGB2PIXEL( p_vout, 0, 0, 50 );
 227
 228     /* Load fonts - fonts must be initialized after the system method since
 229      * they may be dependant on screen depth and other thread properties */
 230     p_vout->p_default_font = vout_LoadFont( DATA_PATH "/" VOUT_DEFAULT_FONT );
 231     if( p_vout->p_default_font == NULL )
 232     {
 233         p_vout->p_default_font = vout_LoadFont( "share/" VOUT_DEFAULT_FONT );
 234     }
 235     if( p_vout->p_default_font == NULL )
 236     {
 237         intf_ErrMsg( "vout error: could not load default font" );
 238         p_vout->p_sys_destroy( p_vout );
 239         free( p_vout );
 240         return( NULL );
 241     }
 242     p_vout->p_large_font = vout_LoadFont( DATA_PATH "/" VOUT_LARGE_FONT );
 243     if( p_vout->p_large_font == NULL )
 244     {
 245         p_vout->p_large_font = vout_LoadFont( "share/" VOUT_LARGE_FONT );
 246     }
 247     if( p_vout->p_large_font == NULL )
 248     {
 249         intf_ErrMsg( "vout error: could not load large font" );
 250         vout_UnloadFont( p_vout->p_default_font );
 251         p_vout->p_sys_destroy( p_vout );
 252         free( p_vout );
 253         return( NULL );
 254     }
 255
 256     /* Create thread and set locks */
 257     vlc_mutex_init( &p_vout->picture_lock );
 258     vlc_mutex_init( &p_vout->subpicture_lock );
 259     vlc_mutex_init( &p_vout->change_lock );
 260
 261     if( vlc_thread_create( &p_vout->thread_id, "video output",
 262                            (void *) RunThread, (void *) p_vout) )
 263     {
 264         intf_ErrMsg("vout error: %s", strerror(ENOMEM));
 265         vout_UnloadFont( p_vout->p_default_font );
 266         vout_UnloadFont( p_vout->p_large_font );
 267         p_vout->p_sys_destroy( p_vout );
 268         free( p_vout );
 269         return( NULL );
 270     }
 271
 272     intf_Msg( "vout: video display initialized (%dx%d, %d/%d bpp)",
 273               p_vout->i_width, p_vout->i_height, p_vout->i_screen_depth,
 274               p_vout->i_bytes_per_pixel * 8 );
 275
 276     /* If status is NULL, wait until the thread is created */
 277     if( pi_status == NULL )
 278     {
 279         do
 280         {
 281             msleep( THREAD_SLEEP );
 282         }while( (i_status != THREAD_READY) && (i_status != THREAD_ERROR)
 283                 && (i_status != THREAD_FATAL) );
 284         if( i_status != THREAD_READY )
 285         {
 286             return( NULL );
 287         }
 288     }
 289     return( p_vout );
 290 }
 291
 292 /*****************************************************************************
 293  * vout_DestroyThread: destroys a previously created thread
 294  *****************************************************************************
 295  * Destroy a terminated thread.
 296  * The function will request a destruction of the specified thread. If pi_error
 297  * is NULL, it will return once the thread is destroyed. Else, it will be
 298  * update using one of the THREAD_* constants.
 299  *****************************************************************************/
 300 void vout_DestroyThread( vout_thread_t *p_vout, int *pi_status )
 301 {
 302     int     i_status;                                       /* thread status */
 303
 304     /* Set status */
 305     intf_DbgMsg("");
 306     p_vout->pi_status = (pi_status != NULL) ? pi_status : &i_status;
 307     *p_vout->pi_status = THREAD_DESTROY;
 308
 309     /* Request thread destruction */
 310     p_vout->b_die = 1;
 311
 312     /* If status is NULL, wait until thread has been destroyed */
 313     if( pi_status == NULL )
 314     {
 315         do
 316         {
 317             msleep( THREAD_SLEEP );
 318         }while( (i_status != THREAD_OVER) && (i_status != THREAD_ERROR)
 319                 && (i_status != THREAD_FATAL) );
 320     }
 321 }
 322
 323 /*****************************************************************************
 324  * vout_DisplaySubPicture: display a subpicture unit
 325  *****************************************************************************
 326  * Remove the reservation flag of an subpicture, which will cause it to be ready
 327  * for display. The picture does not need to be locked, since it is ignored by
 328  * the output thread if is reserved.
 329  *****************************************************************************/
 330 void  vout_DisplaySubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
 331 {
 332 #ifdef DEBUG_VOUT
 333     char        psz_begin_date[MSTRTIME_MAX_SIZE]; /* buffer for date string */
 334     char        psz_end_date[MSTRTIME_MAX_SIZE];   /* buffer for date string */
 335 #endif
 336
 337 #ifdef DEBUG
 338     /* Check if status is valid */
 339     if( p_subpic->i_status != RESERVED_SUBPICTURE )
 340     {
 341         intf_DbgMsg("error: subpicture %p has invalid status %d", p_subpic,
 342                     p_subpic->i_status );
 343     }
 344 #endif
 345
 346     /* Remove reservation flag */
 347     p_subpic->i_status = READY_SUBPICTURE;
 348
 349 #ifdef DEBUG_VOUT
 350     /* Send subpicture information */
 351     intf_DbgMsg("subpicture %p: type=%d, begin date=%s, end date=%s",
 352                 p_subpic, p_subpic->i_type,
 353                 mstrtime( psz_begin_date, p_subpic->begin_date ),
 354                 mstrtime( psz_end_date, p_subpic->end_date ) );
 355 #endif
 356 }
 357
 358 /*****************************************************************************
 359  * vout_CreateSubPicture: allocate a subpicture in the video output heap.
 360  *****************************************************************************
 361  * This function create a reserved subpicture in the video output heap.
 362  * A null pointer is returned if the function fails. This method provides an
 363  * already allocated zone of memory in the spu data fields. It needs locking
 364  * since several pictures can be created by several producers threads.
 365  *****************************************************************************/
 366 subpicture_t *vout_CreateSubPicture( vout_thread_t *p_vout, int i_type,
 367                                      int i_size )
 368 {
 369     int                 i_subpic;                        /* subpicture index */
 370     subpicture_t *      p_free_subpic = NULL;       /* first free subpicture */
 371     subpicture_t *      p_destroyed_subpic = NULL; /* first destroyed subpic */
 372
 373     /* Get lock */
 374     vlc_mutex_lock( &p_vout->subpicture_lock );
 375
 376     /*
 377      * Look for an empty place
 378      */
 379     for( i_subpic = 0; i_subpic < VOUT_MAX_SUBPICTURES; i_subpic++ )
 380     {
 381         if( p_vout->p_subpicture[i_subpic].i_status == DESTROYED_SUBPICTURE )
 382         {
 383             /* Subpicture is marked for destruction, but is still allocated */
 384             if( (p_vout->p_subpicture[i_subpic].i_type  == i_type)   &&
 385                 (p_vout->p_subpicture[i_subpic].i_size  >= i_size) )
 386             {
 387                 /* Memory size do match or is smaller : memory will not be
 388                  * reallocated, and function can end immediately - this is
 389                  * the best possible case, since no memory allocation needs
 390                  * to be done */
 391                 p_vout->p_subpicture[i_subpic].i_status = RESERVED_SUBPICTURE;
 392 #ifdef DEBUG_VOUT
 393                 intf_DbgMsg("subpicture %p (in destroyed subpicture slot)",
 394                             &p_vout->p_subpicture[i_subpic] );
 395 #endif
 396                 vlc_mutex_unlock( &p_vout->subpicture_lock );
 397                 return( &p_vout->p_subpicture[i_subpic] );
 398             }
 399             else if( p_destroyed_subpic == NULL )
 400             {
 401                 /* Memory size do not match, but subpicture index will be kept in
 402                  * case no other place are left */
 403                 p_destroyed_subpic = &p_vout->p_subpicture[i_subpic];
 404             }
 405         }
 406         else if( (p_free_subpic == NULL) &&
 407                  (p_vout->p_subpicture[i_subpic].i_status == FREE_SUBPICTURE ))
 408         {
 409             /* Subpicture is empty and ready for allocation */
 410             p_free_subpic = &p_vout->p_subpicture[i_subpic];
 411         }
 412     }
 413
 414     /* If no free subpictures are available, use a destroyed subpicture */
 415     if( (p_free_subpic == NULL) && (p_destroyed_subpic != NULL ) )
 416     {
 417         /* No free subpicture or matching destroyed subpictures have been
 418          * found, but a destroyed subpicture is still avalaible */
 419         free( p_destroyed_subpic->p_data );
 420         p_free_subpic = p_destroyed_subpic;
 421     }
 422
 423     /*
 424      * Prepare subpicture
 425      */
 426     if( p_free_subpic != NULL )
 427     {
 428         /* Allocate memory */
 429         switch( i_type )
 430         {
 431         case TEXT_SUBPICTURE:                             /* text subpicture */
 432             p_free_subpic->p_data = malloc( i_size + 1 );
 433             break;
 434         case DVD_SUBPICTURE:                          /* DVD subpicture unit */
 435             p_free_subpic->p_data = malloc( i_size );
 436             break;
 437 #ifdef DEBUG
 438         default:
 439             intf_DbgMsg("error: unknown subpicture type %d", i_type );
 440             p_free_subpic->p_data   =  NULL;
 441             break;
 442 #endif
 443         }
 444
 445         if( p_free_subpic->p_data != NULL )
 446         {
 447             /* Copy subpicture information, set some default values */
 448             p_free_subpic->i_type                      = i_type;
 449             p_free_subpic->i_status                    = RESERVED_SUBPICTURE;
 450             p_free_subpic->i_size                      = i_size;
 451             p_free_subpic->i_x                         = 0;
 452             p_free_subpic->i_y                         = 0;
 453             p_free_subpic->i_width                     = 0;
 454             p_free_subpic->i_height                    = 0;
 455             p_free_subpic->i_horizontal_align          = CENTER_RALIGN;
 456             p_free_subpic->i_vertical_align            = CENTER_RALIGN;
 457         }
 458         else
 459         {
 460             /* Memory allocation failed : set subpicture as empty */
 461             p_free_subpic->i_type   =  EMPTY_SUBPICTURE;
 462             p_free_subpic->i_status =  FREE_SUBPICTURE;
 463             p_free_subpic =            NULL;
 464             intf_ErrMsg( "vout error: spu allocation returned %s",
 465                          strerror( ENOMEM ) );
 466         }
 467
 468 #ifdef DEBUG_VOUT
 469         intf_DbgMsg("subpicture %p (in free subpicture slot)", p_free_subpic );
 470 #endif
 471         vlc_mutex_unlock( &p_vout->subpicture_lock );
 472         return( p_free_subpic );
 473     }
 474
 475     /* No free or destroyed subpicture could be found */
 476     intf_DbgMsg( "warning: subpicture heap is full" );
 477     vlc_mutex_unlock( &p_vout->subpicture_lock );
 478     return( NULL );
 479 }
 480
 481 /*****************************************************************************
 482  * vout_DestroySubPicture: remove a subpicture from the heap
 483  *****************************************************************************
 484  * This function frees a previously reserved subpicture.
 485  * It is meant to be used when the construction of a picture aborted.
 486  * This function does not need locking since reserved subpictures are ignored
 487  * by the output thread.
 488  *****************************************************************************/
 489 void vout_DestroySubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
 490 {
 491 #ifdef DEBUG
 492    /* Check if status is valid */
 493    if( p_subpic->i_status != RESERVED_SUBPICTURE )
 494    {
 495        intf_DbgMsg("error: subpicture %p has invalid status %d",
 496                    p_subpic, p_subpic->i_status );
 497    }
 498 #endif
 499
 500     p_subpic->i_status = DESTROYED_SUBPICTURE;
 501
 502 #ifdef DEBUG_VOUT
 503     intf_DbgMsg("subpicture %p", p_subpic);
 504 #endif
 505 }
 506
 507 /*****************************************************************************
 508  * vout_DisplayPicture: display a picture
 509  *****************************************************************************
 510  * Remove the reservation flag of a picture, which will cause it to be ready for
 511  * display. The picture won't be displayed until vout_DatePicture has been
 512  * called.
 513  *****************************************************************************/
 514 void  vout_DisplayPicture( vout_thread_t *p_vout, picture_t *p_pic )
 515 {
 516     vlc_mutex_lock( &p_vout->picture_lock );
 517     switch( p_pic->i_status )
 518     {
 519     case RESERVED_PICTURE:
 520         p_pic->i_status = RESERVED_DISP_PICTURE;
 521         break;
 522     case RESERVED_DATED_PICTURE:
 523         p_pic->i_status = READY_PICTURE;
 524         break;
 525 #ifdef DEBUG
 526     default:
 527         intf_DbgMsg("error: picture %p has invalid status %d", p_pic, p_pic->i_status );
 528         break;
 529 #endif
 530     }
 531
 532 #ifdef DEBUG_VOUT
 533     intf_DbgMsg("picture %p", p_pic);
 534 #endif
 535     vlc_mutex_unlock( &p_vout->picture_lock );
 536 }
 537
 538 /*****************************************************************************
 539  * vout_DatePicture: date a picture
 540  *****************************************************************************
 541  * Remove the reservation flag of a picture, which will cause it to be ready for
 542  * display. The picture won't be displayed until vout_DisplayPicture has been
 543  * called.
 544  *****************************************************************************/
 545 void  vout_DatePicture( vout_thread_t *p_vout, picture_t *p_pic, mtime_t date )
 546 {
 547 #ifdef DEBUG_VOUT
 548     char        psz_date[MSTRTIME_MAX_SIZE];                         /* date */
 549 #endif
 550
 551     vlc_mutex_lock( &p_vout->picture_lock );
 552     p_pic->date = date;
 553     switch( p_pic->i_status )
 554     {
 555     case RESERVED_PICTURE:
 556         p_pic->i_status = RESERVED_DATED_PICTURE;
 557         break;
 558     case RESERVED_DISP_PICTURE:
 559         p_pic->i_status = READY_PICTURE;
 560         break;
 561 #ifdef DEBUG
 562     default:
 563         intf_DbgMsg("error: picture %p has invalid status %d", p_pic, p_pic->i_status );
 564         break;
 565 #endif
 566     }
 567
 568 #ifdef DEBUG_VOUT
 569     intf_DbgMsg("picture %p, display date: %s", p_pic, mstrtime( psz_date, p_pic->date) );
 570 #endif
 571     vlc_mutex_unlock( &p_vout->picture_lock );
 572 }
 573
 574 /*****************************************************************************
 575  * vout_CreatePicture: allocate a picture in the video output heap.
 576  *****************************************************************************
 577  * This function create a reserved image in the video output heap.
 578  * A null pointer is returned if the function fails. This method provides an
 579  * already allocated zone of memory in the picture data fields. It needs locking
 580  * since several pictures can be created by several producers threads.
 581  *****************************************************************************/
 582 picture_t *vout_CreatePicture( vout_thread_t *p_vout, int i_type,
 583                                int i_width, int i_height )
 584 {
 585     int         i_picture;                                  /* picture index */
 586     int         i_chroma_width = 0;                          /* chroma width */
 587     picture_t * p_free_picture = NULL;                 /* first free picture */
 588     picture_t * p_destroyed_picture = NULL;       /* first destroyed picture */
 589
 590     /* Get lock */
 591     vlc_mutex_lock( &p_vout->picture_lock );
 592
 593     /*
 594      * Look for an empty place
 595      */
 596     for( i_picture = 0; i_picture < VOUT_MAX_PICTURES; i_picture++ )
 597     {
 598         if( p_vout->p_picture[i_picture].i_status == DESTROYED_PICTURE )
 599         {
 600             /* Picture is marked for destruction, but is still allocated - note
 601              * that if width and type are the same for two pictures, chroma_width
 602              * should also be the same */
 603             if( (p_vout->p_picture[i_picture].i_type           == i_type)   &&
 604                 (p_vout->p_picture[i_picture].i_height         == i_height) &&
 605                 (p_vout->p_picture[i_picture].i_width          == i_width) )
 606             {
 607                 /* Memory size do match : memory will not be reallocated, and function
 608                  * can end immediately - this is the best possible case, since no
 609                  * memory allocation needs to be done */
 610                 p_vout->p_picture[i_picture].i_status = RESERVED_PICTURE;
 611                 p_vout->i_pictures++;
 612 #ifdef DEBUG_VOUT
 613                 intf_DbgMsg("picture %p (in destroyed picture slot)",
 614                             &p_vout->p_picture[i_picture] );
 615 #endif
 616                 vlc_mutex_unlock( &p_vout->picture_lock );
 617                 return( &p_vout->p_picture[i_picture] );
 618             }
 619             else if( p_destroyed_picture == NULL )
 620             {
 621                 /* Memory size do not match, but picture index will be kept in
 622                  * case no other place are left */
 623                 p_destroyed_picture = &p_vout->p_picture[i_picture];
 624             }
 625         }
 626         else if( (p_free_picture == NULL) &&
 627                  (p_vout->p_picture[i_picture].i_status == FREE_PICTURE ))
 628         {
 629             /* Picture is empty and ready for allocation */
 630             p_free_picture = &p_vout->p_picture[i_picture];
 631         }
 632     }
 633
 634     /* If no free picture is available, use a destroyed picture */
 635     if( (p_free_picture == NULL) && (p_destroyed_picture != NULL ) )
 636     {
 637         /* No free picture or matching destroyed picture has been found, but
 638          * a destroyed picture is still avalaible */
 639         free( p_destroyed_picture->p_data );
 640         p_free_picture = p_destroyed_picture;
 641     }
 642
 643     /*
 644      * Prepare picture
 645      */
 646     if( p_free_picture != NULL )
 647     {
 648         /* Allocate memory */
 649         switch( i_type )
 650         {
 651         case YUV_420_PICTURE:        /* YUV 420: 1,1/4,1/4 samples per pixel */
 652             i_chroma_width = i_width / 2;
 653             p_free_picture->p_data = malloc( i_height * i_chroma_width * 3 * sizeof( yuv_data_t ) );
 654             p_free_picture->p_y = (yuv_data_t *)p_free_picture->p_data;
 655             p_free_picture->p_u = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*4/2;
 656             p_free_picture->p_v = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*5/2;
 657             break;
 658         case YUV_422_PICTURE:        /* YUV 422: 1,1/2,1/2 samples per pixel */
 659             i_chroma_width = i_width / 2;
 660             p_free_picture->p_data = malloc( i_height * i_chroma_width * 4 * sizeof( yuv_data_t ) );
 661             p_free_picture->p_y = (yuv_data_t *)p_free_picture->p_data;
 662             p_free_picture->p_u = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*2;
 663             p_free_picture->p_v = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*3;
 664             break;
 665         case YUV_444_PICTURE:            /* YUV 444: 1,1,1 samples per pixel */
 666             i_chroma_width = i_width;
 667             p_free_picture->p_data = malloc( i_height * i_chroma_width * 3 * sizeof( yuv_data_t ) );
 668             p_free_picture->p_y = (yuv_data_t *)p_free_picture->p_data;
 669             p_free_picture->p_u = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width;
 670             p_free_picture->p_v = (yuv_data_t *)p_free_picture->p_data +i_height*i_chroma_width*2;
 671             break;
 672 #ifdef DEBUG
 673         default:
 674             intf_DbgMsg("error: unknown picture type %d", i_type );
 675             p_free_picture->p_data   =  NULL;
 676             break;
 677 #endif
 678         }
 679
 680         if( p_free_picture->p_data != NULL )
 681         {
 682             /* Copy picture information, set some default values */
 683             p_free_picture->i_type                      = i_type;
 684             p_free_picture->i_status                    = RESERVED_PICTURE;
 685             p_free_picture->i_matrix_coefficients       = 1;
 686             p_free_picture->i_width                     = i_width;
 687             p_free_picture->i_height                    = i_height;
 688             p_free_picture->i_chroma_width              = i_chroma_width;
 689             p_free_picture->i_display_horizontal_offset = 0;
 690             p_free_picture->i_display_vertical_offset   = 0;
 691             p_free_picture->i_display_width             = i_width;
 692             p_free_picture->i_display_height            = i_height;
 693             p_free_picture->i_aspect_ratio              = AR_SQUARE_PICTURE;
 694             p_free_picture->i_refcount                  = 0;
 695             p_vout->i_pictures++;
 696         }
 697         else
 698         {
 699             /* Memory allocation failed : set picture as empty */
 700             p_free_picture->i_type   =  EMPTY_PICTURE;
 701             p_free_picture->i_status =  FREE_PICTURE;
 702             p_free_picture =            NULL;
 703             intf_ErrMsg( "vout error: picture allocation returned %s",
 704                          strerror( ENOMEM ) );
 705         }
 706
 707 #ifdef DEBUG_VOUT
 708         intf_DbgMsg("picture %p (in free picture slot)", p_free_picture );
 709 #endif
 710         vlc_mutex_unlock( &p_vout->picture_lock );
 711
 712         /* Initialize mutex */
 713         vlc_mutex_init( &(p_free_picture->lock_deccount) );
 714
 715         return( p_free_picture );
 716     }
 717
 718     /* No free or destroyed picture could be found */
 719     intf_DbgMsg( "warning: picture heap is full" );
 720     vlc_mutex_unlock( &p_vout->picture_lock );
 721     return( NULL );
 722 }
 723
 724 /*****************************************************************************
 725  * vout_DestroyPicture: remove a permanent or reserved picture from the heap
 726  *****************************************************************************
 727  * This function frees a previously reserved picture or a permanent
 728  * picture. It is meant to be used when the construction of a picture aborted.
 729  * Note that the picture will be destroyed even if it is linked !
 730  *****************************************************************************/
 731 void vout_DestroyPicture( vout_thread_t *p_vout, picture_t *p_pic )
 732 {
 733     vlc_mutex_lock( &p_vout->picture_lock );
 734
 735 #ifdef DEBUG
 736     /* Check if picture status is valid */
 737     if( (p_pic->i_status != RESERVED_PICTURE) &&
 738         (p_pic->i_status != RESERVED_DATED_PICTURE) &&
 739         (p_pic->i_status != RESERVED_DISP_PICTURE) )
 740     {
 741         intf_DbgMsg("error: picture %p has invalid status %d", p_pic, p_pic->i_status );
 742     }
 743 #endif
 744
 745     p_pic->i_status = DESTROYED_PICTURE;
 746     p_vout->i_pictures--;
 747
 748 #ifdef DEBUG_VOUT
 749     intf_DbgMsg("picture %p", p_pic);
 750 #endif
 751
 752     /* destroy the lock that had been initialized in CreatePicture */
 753     vlc_mutex_destroy( &(p_pic->lock_deccount) );
 754
 755     vlc_mutex_unlock( &p_vout->picture_lock );
 756 }
 757
 758 /*****************************************************************************
 759  * vout_LinkPicture: increment reference counter of a picture
 760  *****************************************************************************
 761  * This function increment the reference counter of a picture in the video
 762  * heap. It needs a lock since several producer threads can access the picture.
 763  *****************************************************************************/
 764 void vout_LinkPicture( vout_thread_t *p_vout, picture_t *p_pic )
 765 {
 766     vlc_mutex_lock( &p_vout->picture_lock );
 767     p_pic->i_refcount++;
 768
 769 #ifdef DEBUG_VOUT
 770     intf_DbgMsg("picture %p refcount=%d", p_pic, p_pic->i_refcount );
 771 #endif
 772
 773     vlc_mutex_unlock( &p_vout->picture_lock );
 774 }
 775
 776 /*****************************************************************************
 777  * vout_UnlinkPicture: decrement reference counter of a picture
 778  *****************************************************************************
 779  * This function decrement the reference counter of a picture in the video heap.
 780  *****************************************************************************/
 781 void vout_UnlinkPicture( vout_thread_t *p_vout, picture_t *p_pic )
 782 {
 783     vlc_mutex_lock( &p_vout->picture_lock );
 784     p_pic->i_refcount--;
 785
 786 #ifdef DEBUG_VOUT
 787     if( p_pic->i_refcount < 0 )
 788     {
 789         intf_DbgMsg("error: refcount < 0");
 790         p_pic->i_refcount = 0;
 791     }
 792 #endif
 793
 794     if( (p_pic->i_refcount == 0) && (p_pic->i_status == DISPLAYED_PICTURE) )
 795     {
 796         p_pic->i_status = DESTROYED_PICTURE;
 797         p_vout->i_pictures--;
 798     }
 799
 800 #ifdef DEBUG_VOUT
 801     intf_DbgMsg("picture %p refcount=%d", p_pic, p_pic->i_refcount );
 802 #endif
 803
 804     vlc_mutex_unlock( &p_vout->picture_lock );
 805 }
 806
 807 /*****************************************************************************
 808  * vout_SetBuffers: set buffers adresses
 809  *****************************************************************************
 810  * This function is called by system drivers to set buffers video memory
 811  * adresses.
 812  *****************************************************************************/
 813 void vout_SetBuffers( vout_thread_t *p_vout, void *p_buf1, void *p_buf2 )
 814 {
 815     /* No picture previously */
 816     p_vout->p_buffer[0].i_pic_x =         0;
 817     p_vout->p_buffer[0].i_pic_y =         0;
 818     p_vout->p_buffer[0].i_pic_width =     0;
 819     p_vout->p_buffer[0].i_pic_height =    0;
 820     p_vout->p_buffer[1].i_pic_x =         0;
 821     p_vout->p_buffer[1].i_pic_y =         0;
 822     p_vout->p_buffer[1].i_pic_width =     0;
 823     p_vout->p_buffer[1].i_pic_height =    0;
 824
 825     /* The first area covers all the screen */
 826     p_vout->p_buffer[0].i_areas =                 1;
 827     p_vout->p_buffer[0].pi_area_begin[0] =        0;
 828     p_vout->p_buffer[0].pi_area_end[0] =          p_vout->i_height - 1;
 829     p_vout->p_buffer[1].i_areas =                 1;
 830     p_vout->p_buffer[1].pi_area_begin[0] =        0;
 831     p_vout->p_buffer[1].pi_area_end[0] =          p_vout->i_height - 1;
 832
 833     /* Set adresses */
 834     p_vout->p_buffer[0].p_data = p_buf1;
 835     p_vout->p_buffer[1].p_data = p_buf2;
 836 }
 837
 838 /*****************************************************************************
 839  * vout_Pixel2RGB: return red, green and blue from pixel value
 840  *****************************************************************************
 841  * Return color values, in 0-255 range, of the decomposition of a pixel. This
 842  * is a slow routine and should only be used for initialization phase.
 843  *****************************************************************************/
 844 void vout_Pixel2RGB( vout_thread_t *p_vout, u32 i_pixel, int *pi_red, int *pi_green, int *pi_blue )
 845 {
 846     *pi_red =   i_pixel & p_vout->i_red_mask;
 847     *pi_green = i_pixel & p_vout->i_green_mask;
 848     *pi_blue =  i_pixel & p_vout->i_blue_mask;
 849 }
 850
 851 /* following functions are local */
 852
 853 /*****************************************************************************
 854  * BinaryLog: computes the base 2 log of a binary value
 855  *****************************************************************************
 856  * This functions is used by MaskToShift, to get a bit index from a binary
 857  * value.
 858  *****************************************************************************/
 859 static int BinaryLog(u32 i)
 860 {
 861     int i_log = 0;
 862
 863     if(i & 0xffff0000)
 864     {
 865         i_log += 16;
 866     }
 867     if(i & 0xff00ff00)
 868     {
 869         i_log += 8;
 870     }
 871     if(i & 0xf0f0f0f0)
 872     {
 873         i_log += 4;
 874     }
 875     if(i & 0xcccccccc)
 876     {
 877         i_log += 2;
 878     }
 879     if(i & 0xaaaaaaaa)
 880     {
 881         i_log += 1;
 882     }
 883
 884     if (i != ((u32)1 << i_log))
 885     {
 886         intf_DbgMsg("internal error: binary log overflow");
 887     }
 888
 889     return( i_log );
 890 }
 891
 892 /*****************************************************************************
 893  * MaskToShift: transform a color mask into right and left shifts
 894  *****************************************************************************
 895  * This function is used for obtaining color shifts from masks.
 896  *****************************************************************************/
 897 static void MaskToShift( int *pi_left, int *pi_right, u32 i_mask )
 898 {
 899     u32 i_low, i_high;                 /* lower hand higher bits of the mask */
 900
 901     /* Get bits */
 902     i_low =  i_mask & (- i_mask);                   /* lower bit of the mask */
 903     i_high = i_mask + i_low;                       /* higher bit of the mask */
 904
 905     /* Transform bits into an index */
 906     i_low =  BinaryLog (i_low);
 907     i_high = BinaryLog (i_high);
 908
 909     /* Update pointers and return */
 910     *pi_left =   i_low;
 911     *pi_right = (8 - i_high + i_low);
 912 }
 913
 914 /*****************************************************************************
 915  * InitThread: initialize video output thread
 916  *****************************************************************************
 917  * This function is called from RunThread and performs the second step of the
 918  * initialization. It returns 0 on success. Note that the thread's flag are not
 919  * modified inside this function.
 920  *****************************************************************************/
 921 static int InitThread( vout_thread_t *p_vout )
 922 {
 923     /* Update status */
 924     *p_vout->pi_status = THREAD_START;
 925
 926     vlc_mutex_lock( &p_vout->change_lock );
 927
 928 #ifdef STATS
 929     p_vout->c_loops = 0;
 930 #endif
 931
 932    /* Initialize output method - this function issues its own error messages */
 933     if( p_vout->p_sys_init( p_vout ) )
 934     {
 935         return( 1 );
 936     }
 937
 938     if( p_vout->b_need_render )
 939     {
 940         /* Initialize convertion tables and functions */
 941         if( vout_InitYUV( p_vout ) )
 942         {
 943             intf_ErrMsg("vout error: can't allocate YUV translation tables");
 944             return( 1 );
 945         }
 946     }
 947
 948     /* Mark thread as running and return */
 949     p_vout->b_active =          1;
 950     *p_vout->pi_status =        THREAD_READY;
 951
 952
 953     intf_DbgMsg("thread ready");
 954     return( 0 );
 955 }
 956
 957 /*****************************************************************************
 958  * RunThread: video output thread
 959  *****************************************************************************
 960  * Video output thread. This function does only returns when the thread is
 961  * terminated. It handles the pictures arriving in the video heap and the
 962  * display device events.
 963  *****************************************************************************/
 964 static void RunThread( vout_thread_t *p_vout)
 965 {
 966     int             i_index;                                /* index in heap */
 967     mtime_t         current_date;                            /* current date */
 968     mtime_t         display_date;                            /* display date */
 969     boolean_t       b_display;                               /* display flag */
 970     picture_t *     p_pic;                                /* picture pointer */
 971     subpicture_t *  p_subpic;                          /* subpicture pointer */
 972
 973     /*
 974      * Initialize thread
 975      */
 976     p_vout->b_error = InitThread( p_vout );
 977     if( p_vout->b_error )
 978     {
 979         DestroyThread( p_vout, THREAD_ERROR );
 980         return;
 981     }
 982
 983     /*
 984      * Main loop - it is not executed if an error occured during
 985      * initialization
 986      */
 987     while( (!p_vout->b_die) && (!p_vout->b_error) )
 988     {
 989         /* Initialize loop variables */
 990         p_pic =         NULL;
 991         p_subpic =      NULL;
 992         display_date =  0;
 993         current_date =  mdate();
 994 #ifdef STATS
 995         p_vout->c_loops++;
 996         if( !(p_vout->c_loops % VOUT_STATS_NB_LOOPS) )
 997         {
 998             intf_Msg("vout stats: picture heap: %d/%d",
 999                      p_vout->i_pictures, VOUT_MAX_PICTURES);
1000         }
1001 #endif
1002
1003         /*
1004          * Find the picture to display - this operation does not need lock,
1005          * since only READY_PICTUREs are handled
1006          */
1007         for( i_index = 0; i_index < VOUT_MAX_PICTURES; i_index++ )
1008         {
1009             if( (p_vout->p_picture[i_index].i_status == READY_PICTURE) &&
1010             ( (p_pic == NULL) ||
1011               (p_vout->p_picture[i_index].date < display_date) ) )
1012             {
1013                 p_pic = &p_vout->p_picture[i_index];
1014                 display_date = p_pic->date;
1015             }
1016         }
1017
1018         if( p_pic )
1019         {
1020             /* Computes FPS rate */
1021             p_vout->p_fps_sample[ p_vout->c_fps_samples++ % VOUT_FPS_SAMPLES ] = display_date;
1022
1023             if( display_date < current_date - p_vout->render_time )
1024             {
1025                 /* Picture is late: it will be destroyed and the thread
1026                  * will sleep and go to next picture */
1027
1028                 vlc_mutex_lock( &p_vout->picture_lock );
1029                 if( p_pic->i_refcount )
1030                 {
1031                     p_pic->i_status = DISPLAYED_PICTURE;
1032                 }
1033                 else
1034                 {
1035                     p_pic->i_status = DESTROYED_PICTURE;
1036                     p_vout->i_pictures--;
1037                 }
1038                 intf_WarnMsg( 3,
1039                         "warning: late picture skipped (%p)", p_pic );
1040                 vlc_mutex_unlock( &p_vout->picture_lock );
1041
1042                 continue;
1043             }
1044             else if( display_date > current_date + VOUT_DISPLAY_DELAY )
1045             {
1046                 /* A picture is ready to be rendered, but its rendering date
1047                  * is far from the current one so the thread will perform an
1048                  * empty loop as if no picture were found. The picture state
1049                  * is unchanged */
1050                 p_pic =         NULL;
1051                 display_date =  0;
1052             }
1053         }
1054         /*
1055          * Find the subpictures to display - this operation does not need
1056          * lock, since only READY_SUBPICTURE are handled. If no picture
1057          * has been selected, display_date will depend on the subpicture.
1058          * We get an easily parsable chained list of subpictures which
1059          * ends with NULL since p_subpic was initialized to NULL.
1060          */
1061         for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++ )
1062         {
1063             if( p_vout->p_subpicture[i_index].i_status == READY_SUBPICTURE )
1064             {
1065                 p_vout->p_subpicture[i_index].p_next = p_subpic;
1066                 p_subpic = &p_vout->p_subpicture[i_index];
1067             }
1068         }
1069
1070         /*
1071          * Perform rendering, sleep and display rendered picture
1072          */
1073         if( p_pic )                        /* picture and perhaps subpicture */
1074         {
1075             b_display = p_vout->b_active;
1076             p_vout->last_display_date = display_date;
1077             p_vout->p_rendered_pic = p_pic;
1078
1079
1080
1081
1082             /* Set picture dimensions and clear buffer */
1083             SetBufferPicture( p_vout, p_pic );
1084
1085             /* FIXME: if b_need_render == 0 we need to do something with
1086              * the subpictures one day. */
1087
1088             if( p_vout->b_need_render && b_display )
1089             {
1090                 /* Render picture and information */
1091                 RenderPicture( p_vout, p_pic );
1092                 if( p_vout->b_info )
1093                 {
1094                     RenderPictureInfo( p_vout, p_pic );
1095                     RenderInfo( p_vout );
1096                 }
1097                 if( p_subpic )
1098                 {
1099                     RenderSubPicture( p_vout, p_subpic );
1100                 }
1101             }
1102
1103             /* Render interface and subpicture */
1104             if( b_display && p_vout->b_interface && p_vout->b_need_render )
1105             {
1106                 RenderInterface( p_vout );
1107             }
1108
1109         }
1110         else if( p_vout->b_active && p_vout->b_need_render
1111                   && p_vout->init_display_date == 0)
1112         {
1113             /* Idle or interface screen alone */
1114
1115             if( p_vout->b_interface && 0 /* && XXX?? intf_change */ )
1116             {
1117                 /* Interface has changed, so a new rendering is required - force
1118                  * it by setting last idle date to 0 */
1119                 p_vout->last_idle_date = 0;
1120             }
1121
1122             /* Render idle screen and update idle date, then render interface if
1123              * required */
1124             b_display = RenderIdle( p_vout );
1125             if( b_display )
1126             {
1127                 p_vout->last_idle_date = current_date;
1128                 if( p_vout->b_interface )
1129                 {
1130                     RenderInterface( p_vout );
1131                 }
1132             }
1133
1134         }
1135         else
1136         {
1137             b_display = 0;
1138         }
1139
1140
1141         /*
1142          * Check for the current time and
1143          * display splash screen if everything is on time
1144          */
1145         if( p_vout->init_display_date > 0 && p_vout->b_need_render )
1146         {
1147             if( p_vout->b_active &&
1148                     mdate()-p_vout->init_display_date < 5000000)
1149             {
1150                 /* there is something to display ! */
1151                     b_display = 1;
1152                     RenderSplash( p_vout );
1153
1154             } else {
1155                 /* no splash screen ! */
1156                 p_vout->init_display_date=0;
1157             }
1158         }
1159
1160
1161         /*
1162          * Sleep, wake up and display rendered picture
1163          */
1164
1165         if( display_date != 0 )
1166         {
1167             /* Store render time using Bresenham algorithm */
1168             p_vout->render_time += mdate() - current_date;
1169             p_vout->render_time >>= 1;
1170         }
1171
1172         /* Give back change lock */
1173         vlc_mutex_unlock( &p_vout->change_lock );
1174
1175         /* Sleep a while or until a given date */
1176         if( display_date != 0 )
1177         {
1178             mwait( display_date - VOUT_MWAIT_TOLERANCE );
1179         }
1180         else
1181         {
1182             msleep( VOUT_IDLE_SLEEP );
1183         }
1184
1185         /* On awakening, take back lock and send immediately picture to display,
1186          * then swap buffers */
1187         vlc_mutex_lock( &p_vout->change_lock );
1188 #ifdef DEBUG_VOUT
1189         intf_DbgMsg( "picture %p, subpicture %p in buffer %d, display=%d", p_pic, p_subpic,
1190                      p_vout->i_buffer_index, b_display /* && !(p_vout->i_changes & VOUT_NODISPLAY_CHANGE) */ );
1191 #endif
1192         if( b_display /* && !(p_vout->i_changes & VOUT_NODISPLAY_CHANGE) */ )
1193         {
1194             p_vout->p_sys_display( p_vout );
1195 #ifndef SYS_BEOS
1196             p_vout->i_buffer_index = ++p_vout->i_buffer_index & 1;
1197 #endif
1198         }
1199
1200         if( p_pic )
1201         {
1202             /* Remove picture from heap */
1203             vlc_mutex_lock( &p_vout->picture_lock );
1204             if( p_pic->i_refcount )
1205             {
1206                 p_pic->i_status = DISPLAYED_PICTURE;
1207             }
1208             else
1209             {
1210                 p_pic->i_status = DESTROYED_PICTURE;
1211                 p_vout->i_pictures--;
1212             }
1213             vlc_mutex_unlock( &p_vout->picture_lock );
1214         }
1215
1216
1217         /*
1218          * Check events and manage thread
1219          */
1220         if( p_vout->p_sys_manage( p_vout ) | Manage( p_vout ) )
1221         {
1222             /* A fatal error occured, and the thread must terminate immediately,
1223              * without displaying anything - setting b_error to 1 cause the
1224              * immediate end of the main while() loop. */
1225             p_vout->b_error = 1;
1226         }
1227     }
1228
1229     /*
1230      * Error loop - wait until the thread destruction is requested
1231      */
1232     if( p_vout->b_error )
1233     {
1234         ErrorThread( p_vout );
1235     }
1236
1237     /* End of thread */
1238     EndThread( p_vout );
1239     DestroyThread( p_vout, THREAD_OVER );
1240     intf_DbgMsg( "thread end" );
1241 }
1242
1243 /*****************************************************************************
1244  * ErrorThread: RunThread() error loop
1245  *****************************************************************************
1246  * This function is called when an error occured during thread main's loop. The
1247  * thread can still receive feed, but must be ready to terminate as soon as
1248  * possible.
1249  *****************************************************************************/
1250 static void ErrorThread( vout_thread_t *p_vout )
1251 {
1252     /* Wait until a `die' order */
1253     while( !p_vout->b_die )
1254     {
1255         /* Sleep a while */
1256         msleep( VOUT_IDLE_SLEEP );
1257     }
1258 }
1259
1260 /*****************************************************************************
1261  * EndThread: thread destruction
1262  *****************************************************************************
1263  * This function is called when the thread ends after a sucessful
1264  * initialization. It frees all ressources allocated by InitThread.
1265  *****************************************************************************/
1266 static void EndThread( vout_thread_t *p_vout )
1267 {
1268     int     i_index;                                        /* index in heap */
1269
1270     /* Store status */
1271     *p_vout->pi_status = THREAD_END;
1272
1273 #ifdef STATS
1274     {
1275         struct tms cpu_usage;
1276         times( &cpu_usage );
1277
1278         intf_Msg( "vout stats: cpu usage (user: %d, system: %d)",
1279                   cpu_usage.tms_utime, cpu_usage.tms_stime );
1280     }
1281 #endif
1282
1283     /* Destroy all remaining pictures and subpictures */
1284     for( i_index = 0; i_index < VOUT_MAX_PICTURES; i_index++ )
1285     {
1286         if( p_vout->p_picture[i_index].i_status != FREE_PICTURE )
1287         {
1288             free( p_vout->p_picture[i_index].p_data );
1289         }
1290     }
1291
1292     for( i_index = 0; i_index < VOUT_MAX_SUBPICTURES; i_index++ )
1293     {
1294         if( p_vout->p_subpicture[i_index].i_status != FREE_SUBPICTURE )
1295         {
1296             free( p_vout->p_subpicture[i_index].p_data );
1297         }
1298     }
1299
1300     /* Destroy translation tables */
1301     vout_EndYUV( p_vout );
1302     p_vout->p_sys_end( p_vout );
1303
1304     /* Release the change lock */
1305     vlc_mutex_unlock( &p_vout->change_lock );
1306 }
1307
1308 /*****************************************************************************
1309  * DestroyThread: thread destruction
1310  *****************************************************************************
1311  * This function is called when the thread ends. It frees all ressources
1312  * allocated by CreateThread. Status is available at this stage.
1313  *****************************************************************************/
1314 static void DestroyThread( vout_thread_t *p_vout, int i_status )
1315 {
1316     int *pi_status;                                         /* status adress */
1317
1318     /* Store status adress */
1319     pi_status = p_vout->pi_status;
1320
1321     /* Destroy thread structures allocated by Create and InitThread */
1322     vout_UnloadFont( p_vout->p_default_font );
1323     vout_UnloadFont( p_vout->p_large_font );
1324     p_vout->p_sys_destroy( p_vout );
1325
1326     /* Destroy the locks */
1327     vlc_mutex_destroy( &p_vout->picture_lock );
1328     vlc_mutex_destroy( &p_vout->subpicture_lock );
1329     vlc_mutex_destroy( &p_vout->change_lock );
1330
1331     /* Free structure */
1332     free( p_vout );
1333     *pi_status = i_status;
1334 }
1335
1336 /*****************************************************************************
1337  * Print: print simple text on a picture
1338  *****************************************************************************
1339  * This function will print a simple text on the picture. It is designed to
1340  * print debugging or general information.
1341  *****************************************************************************/
1342 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 )
1343 {
1344     int                 i_text_height;                  /* total text height */
1345     int                 i_text_width;                    /* total text width */
1346
1347     /* Update upper left coordinates according to alignment */
1348     vout_TextSize( p_vout->p_default_font, 0, psz_text, &i_text_width, &i_text_height );
1349     if( !Align( p_vout, &i_x, &i_y, i_text_width, i_text_height, i_h_align, i_v_align ) )
1350     {
1351         /* Set area and print text */
1352         SetBufferArea( p_vout, i_x, i_y, i_text_width, i_text_height );
1353         vout_Print( p_vout->p_default_font, p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1354                     i_y * p_vout->i_bytes_per_line + i_x * p_vout->i_bytes_per_pixel,
1355                     p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1356                     p_vout->i_white_pixel, 0, 0,
1357                     0, psz_text, 100 );
1358     }
1359 }
1360
1361 /*****************************************************************************
1362  * SetBufferArea: activate an area in current buffer
1363  *****************************************************************************
1364  * This function is called when something is rendered on the current buffer.
1365  * It set the area as active and prepare it to be cleared on next rendering.
1366  * Pay attention to the fact that in this functions, i_h is in fact the end y
1367  * coordinate of the new area.
1368  *****************************************************************************/
1369 static void SetBufferArea( vout_thread_t *p_vout, int i_x, int i_y, int i_w, int i_h )
1370 {
1371     vout_buffer_t *     p_buffer;                          /* current buffer */
1372     int                 i_area_begin, i_area_end; /* area vertical extension */
1373     int                 i_area, i_area_copy;                   /* area index */
1374     int                 i_area_shift;            /* shift distance for areas */
1375
1376     /* Choose buffer and modify h to end of area position */
1377     p_buffer =  &p_vout->p_buffer[ p_vout->i_buffer_index ];
1378     i_h +=      i_y - 1;
1379
1380     /*
1381      * Remove part of the area which is inside the picture - this is done
1382      * by calling again SetBufferArea with the correct areas dimensions.
1383      */
1384     if( (i_x >= p_buffer->i_pic_x) && (i_x + i_w <= p_buffer->i_pic_x + p_buffer->i_pic_width) )
1385     {
1386         i_area_begin =  p_buffer->i_pic_y;
1387         i_area_end =    i_area_begin + p_buffer->i_pic_height - 1;
1388
1389         if( ((i_y >= i_area_begin) && (i_y <= i_area_end)) ||
1390             ((i_h >= i_area_begin) && (i_h <= i_area_end)) ||
1391             ((i_y <  i_area_begin) && (i_h > i_area_end)) )
1392         {
1393             /* Keep the stripe above the picture, if any */
1394             if( i_y < i_area_begin )
1395             {
1396                 SetBufferArea( p_vout, i_x, i_y, i_w, i_area_begin - i_y );
1397             }
1398             /* Keep the stripe below the picture, if any */
1399             if( i_h > i_area_end )
1400             {
1401                 SetBufferArea( p_vout, i_x, i_area_end, i_w, i_h - i_area_end );
1402             }
1403             return;
1404         }
1405     }
1406
1407     /* Skip some extensions until interesting areas */
1408     for( i_area = 0;
1409          (i_area < p_buffer->i_areas) &&
1410              (p_buffer->pi_area_end[i_area] + 1 <= i_y);
1411          i_area++ )
1412     {
1413         ;
1414     }
1415
1416     if( i_area == p_buffer->i_areas )
1417     {
1418         /* New area is below all existing ones: just add it at the end of the
1419          * array, if possible - otherwise, append it to the last one */
1420         if( i_area < VOUT_MAX_AREAS )
1421         {
1422             p_buffer->pi_area_begin[i_area] = i_y;
1423             p_buffer->pi_area_end[i_area] = i_h;
1424             p_buffer->i_areas++;
1425         }
1426         else
1427         {
1428 #ifdef DEBUG_VOUT
1429             intf_DbgMsg("area overflow");
1430 #endif
1431             p_buffer->pi_area_end[VOUT_MAX_AREAS - 1] = i_h;
1432         }
1433     }
1434     else
1435     {
1436         i_area_begin =  p_buffer->pi_area_begin[i_area];
1437         i_area_end =    p_buffer->pi_area_end[i_area];
1438
1439         if( i_y < i_area_begin )
1440         {
1441             if( i_h >= i_area_begin - 1 )
1442             {
1443                 /* Extend area above */
1444                 p_buffer->pi_area_begin[i_area] = i_y;
1445             }
1446             else
1447             {
1448                 /* Create a new area above : merge last area if overflow, then
1449                  * move all old areas down */
1450                 if( p_buffer->i_areas == VOUT_MAX_AREAS )
1451                 {
1452 #ifdef DEBUG_VOUT
1453                     intf_DbgMsg("areas overflow");
1454 #endif
1455                     p_buffer->pi_area_end[VOUT_MAX_AREAS - 2] = p_buffer->pi_area_end[VOUT_MAX_AREAS - 1];
1456                 }
1457                 else
1458                 {
1459                     p_buffer->i_areas++;
1460                 }
1461                 for( i_area_copy = p_buffer->i_areas - 1; i_area_copy > i_area; i_area_copy-- )
1462                 {
1463                     p_buffer->pi_area_begin[i_area_copy] = p_buffer->pi_area_begin[i_area_copy - 1];
1464                     p_buffer->pi_area_end[i_area_copy] =   p_buffer->pi_area_end[i_area_copy - 1];
1465                 }
1466                 p_buffer->pi_area_begin[i_area] = i_y;
1467                 p_buffer->pi_area_end[i_area] = i_h;
1468                 return;
1469             }
1470         }
1471         if( i_h > i_area_end )
1472         {
1473             /* Find further areas which can be merged with the new one */
1474             for( i_area_copy = i_area + 1;
1475                  (i_area_copy < p_buffer->i_areas) &&
1476                      (p_buffer->pi_area_begin[i_area] <= i_h);
1477                  i_area_copy++ )
1478             {
1479                 ;
1480             }
1481             i_area_copy--;
1482
1483             if( i_area_copy != i_area )
1484             {
1485                 /* Merge with last possible areas */
1486                 p_buffer->pi_area_end[i_area] = MAX( i_h, p_buffer->pi_area_end[i_area_copy] );
1487
1488                 /* Shift lower areas upward */
1489                 i_area_shift = i_area_copy - i_area;
1490                 p_buffer->i_areas -= i_area_shift;
1491                 for( i_area_copy = i_area + 1; i_area_copy < p_buffer->i_areas; i_area_copy++ )
1492                 {
1493                     p_buffer->pi_area_begin[i_area_copy] = p_buffer->pi_area_begin[i_area_copy + i_area_shift];
1494                     p_buffer->pi_area_end[i_area_copy] =   p_buffer->pi_area_end[i_area_copy + i_area_shift];
1495                 }
1496             }
1497             else
1498             {
1499                 /* Extend area below */
1500                 p_buffer->pi_area_end[i_area] = i_h;
1501             }
1502         }
1503     }
1504 }
1505
1506 /*****************************************************************************
1507  * SetBufferPicture: clear buffer and set picture area
1508  *****************************************************************************
1509  * This function is called before any rendering. It clears the current
1510  * rendering buffer and set the new picture area. If the picture pointer is
1511  * NULL, then no picture area is defined. Floating operations are avoided since
1512  * some MMX calculations may follow.
1513  *****************************************************************************/
1514 static void SetBufferPicture( vout_thread_t *p_vout, picture_t *p_pic )
1515 {
1516     vout_buffer_t *     p_buffer;                          /* current buffer */
1517     int                 i_pic_x, i_pic_y;                /* picture position */
1518     int                 i_pic_width, i_pic_height;     /* picture dimensions */
1519     int                 i_old_pic_y, i_old_pic_height;   /* old picture area */
1520     int                 i_vout_width, i_vout_height;   /* display dimensions */
1521     int                 i_area;                                /* area index */
1522     int                 i_data_index;                     /* area data index */
1523     int                 i_data_size;   /* area data size, in 256 bytes blocs */
1524     u64 *               p_data;                   /* area data, for clearing */
1525     byte_t *            p_data8;           /* area data, for clearing (slow) */
1526
1527     /* Choose buffer and set display dimensions */
1528     p_buffer =          &p_vout->p_buffer[ p_vout->i_buffer_index ];
1529     i_vout_width =      p_vout->i_width;
1530     i_vout_height =     p_vout->i_height;
1531
1532     /*
1533      * Computes new picture size
1534      */
1535     if( p_pic != NULL )
1536     {
1537         /* Try horizontal scaling first - width must be a mutiple of 16 */
1538         i_pic_width = (( p_vout->b_scale || (p_pic->i_width > i_vout_width)) ?
1539                        i_vout_width : p_pic->i_width) & ~0xf;
1540         switch( p_pic->i_aspect_ratio )
1541         {
1542         case AR_3_4_PICTURE:
1543             i_pic_height = i_pic_width * 3 / 4;
1544             break;
1545         case AR_16_9_PICTURE:
1546             i_pic_height = i_pic_width * 9 / 16;
1547             break;
1548         case AR_221_1_PICTURE:
1549             i_pic_height = i_pic_width * 100 / 221;
1550             break;
1551         case AR_SQUARE_PICTURE:
1552         default:
1553             i_pic_height = p_pic->i_height * i_pic_width / p_pic->i_width;
1554             break;
1555         }
1556
1557         /* If picture dimensions using horizontal scaling are too large, use
1558          * vertical scaling. Since width must be a multiple of 16, height is
1559          * adjusted again after. */
1560         if( i_pic_height > i_vout_height )
1561         {
1562             i_pic_height = ( p_vout->b_scale || (p_pic->i_height > i_vout_height)) ?
1563                 i_vout_height : p_pic->i_height;
1564             switch( p_pic->i_aspect_ratio )
1565             {
1566             case AR_3_4_PICTURE:
1567                 i_pic_width = (i_pic_height * 4 / 3) & ~0xf;
1568                 i_pic_height = i_pic_width * 3 / 4;
1569                 break;
1570             case AR_16_9_PICTURE:
1571                 i_pic_width = (i_pic_height * 16 / 9) & ~0xf;
1572                 i_pic_height = i_pic_width * 9 / 16;
1573                 break;
1574             case AR_221_1_PICTURE:
1575                 i_pic_width = (i_pic_height * 221 / 100) & ~0xf;
1576                 i_pic_height = i_pic_width * 100 / 221;
1577                 break;
1578             case AR_SQUARE_PICTURE:
1579             default:
1580                 i_pic_width = (p_pic->i_width * i_pic_height / p_pic->i_height) & ~0xf;
1581                 i_pic_height = p_pic->i_height * i_pic_width / p_pic->i_width;
1582                 break;
1583             }
1584         }
1585
1586         /* Set picture position */
1587         i_pic_x = (p_vout->i_width - i_pic_width) / 2;
1588         i_pic_y = (p_vout->i_height - i_pic_height) / 2;
1589
1590     }
1591     else
1592     {
1593         /* No picture: size is 0 */
1594         i_pic_x =       0;
1595         i_pic_y =       0;
1596         i_pic_width =   0;
1597         i_pic_height =  0;
1598     }
1599
1600     /*
1601      * Set new picture size - if it is smaller than the previous one, clear
1602      * around it. Since picture are centered, only their size is tested.
1603      */
1604     if( (p_buffer->i_pic_width > i_pic_width) || (p_buffer->i_pic_height > i_pic_height) )
1605     {
1606         i_old_pic_y =            p_buffer->i_pic_y;
1607         i_old_pic_height =       p_buffer->i_pic_height;
1608         p_buffer->i_pic_x =      i_pic_x;
1609         p_buffer->i_pic_y =      i_pic_y;
1610         p_buffer->i_pic_width =  i_pic_width;
1611         p_buffer->i_pic_height = i_pic_height;
1612         SetBufferArea( p_vout, 0, i_old_pic_y, p_vout->i_width, i_old_pic_height );
1613     }
1614     else
1615     {
1616         p_buffer->i_pic_x =      i_pic_x;
1617         p_buffer->i_pic_y =      i_pic_y;
1618         p_buffer->i_pic_width =  i_pic_width;
1619         p_buffer->i_pic_height = i_pic_height;
1620     }
1621
1622     /*
1623      * Clear areas
1624      */
1625     for( i_area = 0; i_area < p_buffer->i_areas; i_area++ )
1626     {
1627 #ifdef DEBUG_VOUT
1628         intf_DbgMsg("clearing picture %p area in buffer %d: %d-%d", p_pic,
1629                     p_vout->i_buffer_index, p_buffer->pi_area_begin[i_area], p_buffer->pi_area_end[i_area] );
1630 #endif
1631         i_data_size = (p_buffer->pi_area_end[i_area] - p_buffer->pi_area_begin[i_area] + 1) * p_vout->i_bytes_per_line;
1632         p_data = (u64*) (p_buffer->p_data + p_vout->i_bytes_per_line * p_buffer->pi_area_begin[i_area]);
1633         for( i_data_index = i_data_size / 256; i_data_index-- ; )
1634         {
1635             /* Clear 256 bytes block */
1636             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1637             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1638             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1639             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1640             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1641             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1642             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1643             *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;  *p_data++ = 0;
1644         }
1645         for( i_data_index = (i_data_size % 256) / 16; i_data_index--; )
1646         {
1647             /* Clear remaining 16 bytes blocks */
1648             *p_data++ = 0;  *p_data++ = 0;
1649         }
1650         p_data8 = (byte_t *)p_data;
1651         for( i_data_index = i_data_size % 16; i_data_index--; )
1652         {
1653             /* Clear remaining bytes */
1654             *p_data8++ = 0;
1655         }
1656     }
1657
1658     /*
1659      * Clear areas array
1660      */
1661     p_buffer->i_areas = 0;
1662 }
1663
1664 /*****************************************************************************
1665  * RenderPicture: render a picture
1666  *****************************************************************************
1667  * This function converts a picture from a video heap to a pixel-encoded image
1668  * and copies it to the current rendering buffer. No lock is required, since
1669  * the * rendered picture has been determined as existant, and will only be
1670  * destroyed by the vout thread later.
1671  *****************************************************************************/
1672 static void RenderPicture( vout_thread_t *p_vout, picture_t *p_pic )
1673 {
1674 #ifdef DEBUG_VOUT
1675     char                psz_date[MSTRTIME_MAX_SIZE];         /* picture date */
1676     mtime_t             render_time;               /* picture rendering time */
1677 #endif
1678     vout_buffer_t *     p_buffer;                        /* rendering buffer */
1679     byte_t *            p_pic_data;                /* convertion destination */
1680
1681     /* Get and set rendering information */
1682     p_buffer =          &p_vout->p_buffer[ p_vout->i_buffer_index ];
1683     p_pic_data =        p_buffer->p_data +
1684                         p_buffer->i_pic_x * p_vout->i_bytes_per_pixel +
1685                         p_buffer->i_pic_y * p_vout->i_bytes_per_line;
1686 #ifdef DEBUG_VOUT
1687     render_time = mdate();
1688 #endif
1689
1690
1691
1692     /*
1693      * Choose appropriate rendering function and render picture
1694      */
1695     switch( p_pic->i_type )
1696     {
1697     case YUV_420_PICTURE:
1698         p_vout->yuv.p_Convert420( p_vout, p_pic_data,
1699                                   p_pic->p_y, p_pic->p_u, p_pic->p_v,
1700                                   p_pic->i_width, p_pic->i_height,
1701                                   p_buffer->i_pic_width, p_buffer->i_pic_height,
1702                                   p_vout->i_bytes_per_line / p_vout->i_bytes_per_pixel,
1703                                   p_pic->i_matrix_coefficients );
1704         break;
1705     case YUV_422_PICTURE:
1706         p_vout->yuv.p_Convert422( p_vout, p_pic_data,
1707                                   p_pic->p_y, p_pic->p_u, p_pic->p_v,
1708                                   p_pic->i_width, p_pic->i_height,
1709                                   p_buffer->i_pic_width, p_buffer->i_pic_height,
1710                                   p_vout->i_bytes_per_line / p_vout->i_bytes_per_pixel,
1711                                   p_pic->i_matrix_coefficients );
1712         break;
1713     case YUV_444_PICTURE:
1714         p_vout->yuv.p_Convert444( p_vout, p_pic_data,
1715                                   p_pic->p_y, p_pic->p_u, p_pic->p_v,
1716                                   p_pic->i_width, p_pic->i_height,
1717                                   p_buffer->i_pic_width, p_buffer->i_pic_height,
1718                                   p_vout->i_bytes_per_line / p_vout->i_bytes_per_pixel,
1719                                   p_pic->i_matrix_coefficients );
1720         break;
1721 #ifdef DEBUG
1722     default:
1723         intf_DbgMsg("error: unknown picture type %d", p_pic->i_type );
1724         break;
1725 #endif
1726     }
1727
1728 #ifdef DEBUG_VOUT
1729     /* Print picture date and rendering time */
1730     intf_DbgMsg("picture %p rendered in buffer %d (%ld us), display date: %s", p_pic,
1731                 p_vout->i_buffer_index, (long) (mdate() - render_time),
1732                 mstrtime( psz_date, p_pic->date ));
1733 #endif
1734 }
1735
1736 /*****************************************************************************
1737  * RenderPictureInfo: print additionnal information on a picture
1738  *****************************************************************************
1739  * This function will print information such as fps and other picture
1740  * dependant information.
1741  *****************************************************************************/
1742 static void RenderPictureInfo( vout_thread_t *p_vout, picture_t *p_pic )
1743 {
1744     char        psz_buffer[256];                            /* string buffer */
1745
1746     /*
1747      * Print FPS rate in upper right corner
1748      */
1749     if( p_vout->c_fps_samples > VOUT_FPS_SAMPLES )
1750     {
1751         long i_fps = VOUT_FPS_SAMPLES * 1000000 * 10 /
1752                            ( p_vout->p_fps_sample[ (p_vout->c_fps_samples - 1)
1753                                                    % VOUT_FPS_SAMPLES ] -
1754                              p_vout->p_fps_sample[ p_vout->c_fps_samples
1755                                                    % VOUT_FPS_SAMPLES ] );
1756         sprintf( psz_buffer, "%li.%i fps", i_fps / 10, (int)i_fps % 10 );
1757         Print( p_vout, 0, 0, RIGHT_RALIGN, TOP_RALIGN, psz_buffer );
1758     }
1759
1760     /*
1761      * Print frames count and loop time in upper left corner
1762      */
1763     sprintf( psz_buffer, "%ld frames, render: %ldus",
1764              (long) p_vout->c_fps_samples, (long) p_vout->render_time );
1765     Print( p_vout, 0, 0, LEFT_RALIGN, TOP_RALIGN, psz_buffer );
1766
1767 #ifdef STATS
1768     /*
1769      * Print picture information in lower right corner
1770      */
1771     sprintf( psz_buffer, "%s picture %dx%d (%dx%d%+d%+d %s) -> %dx%d+%d+%d",
1772              (p_pic->i_type == YUV_420_PICTURE) ? "4:2:0" :
1773              ((p_pic->i_type == YUV_422_PICTURE) ? "4:2:2" :
1774               ((p_pic->i_type == YUV_444_PICTURE) ? "4:4:4" : "ukn-type")),
1775              p_pic->i_width, p_pic->i_height,
1776              p_pic->i_display_width, p_pic->i_display_height,
1777              p_pic->i_display_horizontal_offset, p_pic->i_display_vertical_offset,
1778              (p_pic->i_aspect_ratio == AR_SQUARE_PICTURE) ? "sq" :
1779              ((p_pic->i_aspect_ratio == AR_3_4_PICTURE) ? "4:3" :
1780               ((p_pic->i_aspect_ratio == AR_16_9_PICTURE) ? "16:9" :
1781                ((p_pic->i_aspect_ratio == AR_221_1_PICTURE) ? "2.21:1" : "ukn-ar" ))),
1782              p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_width,
1783              p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_height,
1784              p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_x,
1785              p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_y );
1786     Print( p_vout, 0, 0, RIGHT_RALIGN, BOTTOM_RALIGN, psz_buffer );
1787 #endif
1788 }
1789
1790 /*****************************************************************************
1791  * RenderSplash: render splash picture
1792  *****************************************************************************
1793  * This function will print something on the screen. It will return 0 if
1794  * nothing has been rendered, or 1 if something has been changed on the screen.
1795  * Note that if you absolutely want something to be printed, you will have
1796  * to force it by setting the last idle date to 0.
1797  * Unlike other rendering functions, this one calls the SetBufferPicture
1798  * function when needed.
1799  *****************************************************************************/
1800 int RenderSplash( vout_thread_t *p_vout )
1801 {
1802     int         i_x = 0, i_y = 0;                           /* text position */
1803     int         i_width, i_height;                              /* text size */
1804     char *psz_text =    "VideoLAN Client (" VERSION ")";  /* text to display */
1805
1806     memset( p_vout->p_buffer[ p_vout->i_buffer_index ].p_data,
1807                   p_vout->i_bytes_per_line * p_vout->i_height, 12);
1808
1809  //   SetBufferPicture( p_vout, NULL );
1810     vout_TextSize( p_vout->p_large_font, WIDE_TEXT | OUTLINED_TEXT, psz_text,
1811                    &i_width, &i_height );
1812     if( !Align( p_vout, &i_x, &i_y, i_width, i_height, CENTER_RALIGN, CENTER_RALIGN ) )
1813     {
1814         vout_Print( p_vout->p_large_font,
1815                     p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1816                     i_x * p_vout->i_bytes_per_pixel + (i_y - 16 ) * p_vout->i_bytes_per_line,
1817                     p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1818                     p_vout->i_white_pixel, p_vout->i_gray_pixel, 0,
1819                     WIDE_TEXT | OUTLINED_TEXT, psz_text, 100);
1820         SetBufferArea( p_vout, i_x, i_y, i_width, i_height);
1821     }
1822     return( 1 );
1823 }
1824
1825
1826 /*****************************************************************************
1827  * RenderIdle: render idle picture
1828  *****************************************************************************
1829  * This function will print something on the screen. It will return 0 if
1830  * nothing has been rendered, or 1 if something has been changed on the screen.
1831  * Note that if you absolutely want something to be printed, you will have
1832  * to force it by setting the last idle date to 0.
1833  * Unlike other rendering functions, this one calls the SetBufferPicture
1834  * function when needed.
1835  *****************************************************************************/
1836 int RenderIdle( vout_thread_t *p_vout )
1837 {
1838     int         i_x = 0, i_y = 0;                           /* text position */
1839     int         i_width, i_height;                              /* text size */
1840     mtime_t     current_date;                                /* current date */
1841     int         i_amount = 0;                             /*  amount to draw */
1842     char *psz_text =    "Waiting for stream";            /* text to display */
1843     char *psz_wtext =   "[................]";
1844
1845
1846     memset( p_vout->p_buffer[ p_vout->i_buffer_index ].p_data,
1847                     p_vout->i_bytes_per_line * p_vout->i_height, 12);
1848
1849
1850     current_date = mdate();
1851     if( (current_date - p_vout->last_display_date) > VOUT_IDLE_DELAY
1852 //            && (current_date - p_vout->last_idle_date) > VOUT_IDLE_DELAY
1853     )
1854     {
1855         SetBufferPicture( p_vout, NULL );
1856         vout_TextSize( p_vout->p_large_font, WIDE_TEXT | OUTLINED_TEXT, psz_text,
1857                        &i_width, &i_height );
1858         if( !Align( p_vout, &i_x, &i_y, i_width, i_height * 2, CENTER_RALIGN, CENTER_RALIGN ) )
1859         {
1860             i_amount = (int) ((current_date - p_vout->last_display_date ) / 5000LL);
1861             vout_Print( p_vout->p_large_font,
1862                         p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1863                         i_x * p_vout->i_bytes_per_pixel + i_y * p_vout->i_bytes_per_line,
1864                         p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1865                         p_vout->i_white_pixel, p_vout->i_gray_pixel, 0,
1866                         WIDE_TEXT | OUTLINED_TEXT, psz_text,  (i_amount / 3 ) %110);
1867
1868             vout_Print( p_vout->p_large_font,
1869                     p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1870                     i_x * p_vout->i_bytes_per_pixel + (i_y + 16) * p_vout->i_bytes_per_line,
1871                     p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1872                     p_vout->i_white_pixel, p_vout->i_gray_pixel, 0,
1873                     WIDE_TEXT | OUTLINED_TEXT, psz_wtext,  (i_amount/5)%110 );
1874
1875
1876             SetBufferArea( p_vout, i_x, i_y, i_width, i_height * 2 );
1877         }
1878         return( 1 );
1879     }
1880     return( 0 );
1881 }
1882
1883 /*****************************************************************************
1884  * RenderInfo: render additionnal information
1885  *****************************************************************************
1886  * This function renders information which do not depend on the current
1887  * picture rendered.
1888  *****************************************************************************/
1889 static void RenderInfo( vout_thread_t *p_vout )
1890 {
1891 #ifdef DEBUG
1892     char        psz_buffer[256];                            /* string buffer */
1893     int         i_ready_pic = 0;                           /* ready pictures */
1894     int         i_reserved_pic = 0;                     /* reserved pictures */
1895     int         i_picture;                                  /* picture index */
1896 #endif
1897
1898 #ifdef DEBUG
1899     /*
1900      * Print thread state in lower left corner
1901      */
1902     for( i_picture = 0; i_picture < VOUT_MAX_PICTURES; i_picture++ )
1903     {
1904         switch( p_vout->p_picture[i_picture].i_status )
1905         {
1906         case RESERVED_PICTURE:
1907         case RESERVED_DATED_PICTURE:
1908         case RESERVED_DISP_PICTURE:
1909             i_reserved_pic++;
1910             break;
1911         case READY_PICTURE:
1912             i_ready_pic++;
1913             break;
1914         }
1915     }
1916     sprintf( psz_buffer, "pic: %d (%d/%d)/%d",
1917              p_vout->i_pictures, i_reserved_pic, i_ready_pic, VOUT_MAX_PICTURES );
1918     Print( p_vout, 0, 0, LEFT_RALIGN, BOTTOM_RALIGN, psz_buffer );
1919 #endif
1920 }
1921
1922 /*****************************************************************************
1923  * RenderSubPicture: render a subpicture
1924  *****************************************************************************
1925  * This function renders a sub picture unit.
1926  *****************************************************************************/
1927 static void RenderSubPicture( vout_thread_t *p_vout, subpicture_t *p_subpic )
1928 {
1929     p_vout_font_t       p_font;                                 /* text font */
1930     int                 i_width, i_height;          /* subpicture dimensions */
1931
1932     while( p_subpic != NULL )
1933     {
1934         switch( p_subpic->i_type )
1935         {
1936         case DVD_SUBPICTURE:                          /* DVD subpicture unit */
1937             /* test if the picture really has to be displayed */
1938             if( mdate() < p_subpic->begin_date )
1939             {
1940                 /* not yet, see you later */
1941                 break;
1942             }
1943             if( mdate() > p_subpic->end_date )
1944             {
1945                 /* too late, destroying the subpic */
1946                 vout_DestroySubPicture( p_vout, p_subpic );
1947                 break;
1948             }
1949             vout_RenderSPU( &p_vout->p_buffer[ p_vout->i_buffer_index ],
1950                             p_subpic, p_vout->i_bytes_per_pixel,
1951                             p_vout->i_bytes_per_line );
1952             break;
1953         case TEXT_SUBPICTURE:                            /* single line text */
1954             /* Select default font if not specified */
1955             p_font = p_subpic->type.text.p_font;
1956             if( p_font == NULL )
1957             {
1958                 p_font = p_vout->p_default_font;
1959             }
1960
1961             /* Compute text size (width and height fields are ignored)
1962              * and print it */
1963             vout_TextSize( p_font, p_subpic->type.text.i_style,
1964                            p_subpic->p_data, &i_width, &i_height );
1965             if( !Align( p_vout, &p_subpic->i_x, &p_subpic->i_y,
1966                         i_width, i_height, p_subpic->i_horizontal_align,
1967                         p_subpic->i_vertical_align ) )
1968             {
1969                 vout_Print( p_font,
1970                             p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
1971                             p_subpic->i_x * p_vout->i_bytes_per_pixel +
1972                             p_subpic->i_y * p_vout->i_bytes_per_line,
1973                             p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
1974                             p_subpic->type.text.i_char_color,
1975                             p_subpic->type.text.i_border_color,
1976                             p_subpic->type.text.i_bg_color,
1977                             p_subpic->type.text.i_style, p_subpic->p_data, 100 );
1978                 SetBufferArea( p_vout, p_subpic->i_x, p_subpic->i_y,
1979                                i_width, i_height );
1980             }
1981             break;
1982
1983 #ifdef DEBUG
1984         default:
1985             intf_DbgMsg( "error: unknown subpicture %p type %d",
1986                          p_subpic, p_subpic->i_type );
1987 #endif
1988         }
1989
1990         p_subpic = p_subpic->p_next;
1991     }
1992 }
1993
1994 /*****************************************************************************
1995  * RenderInterface: render the interface
1996  *****************************************************************************
1997  * This function renders the interface, if any.
1998  *****************************************************************************/
1999 static void RenderInterface( vout_thread_t *p_vout )
2000 {
2001     int         i_height, i_text_height;            /* total and text height */
2002     int         i_width_1, i_width_2;                          /* text width */
2003     int         i_byte;                                        /* byte index */
2004     const char *psz_text_1 = "[1-9] Channel   [i]nfo   [c]olor     [g/G]amma";
2005     const char *psz_text_2 = "[+/-] Volume    [m]ute   [s]caling   [Q]uit";
2006
2007     /* Get text size */
2008     vout_TextSize( p_vout->p_large_font, OUTLINED_TEXT, psz_text_1, &i_width_1, &i_height );
2009     vout_TextSize( p_vout->p_large_font, OUTLINED_TEXT, psz_text_2, &i_width_2, &i_text_height );
2010     i_height += i_text_height;
2011
2012     /* Render background */
2013     for( i_byte = (p_vout->i_height - i_height) * p_vout->i_bytes_per_line;
2014          i_byte < p_vout->i_height * p_vout->i_bytes_per_line;
2015          i_byte++ )
2016     {
2017         /* XXX?? noooo ! */
2018         p_vout->p_buffer[ p_vout->i_buffer_index ].p_data[ i_byte ] = p_vout->i_blue_pixel;
2019     }
2020
2021     /* Render text, if not larger than screen */
2022     if( i_width_1 < p_vout->i_width )
2023     {
2024         vout_Print( p_vout->p_large_font, p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
2025                     (p_vout->i_height - i_height) * p_vout->i_bytes_per_line,
2026                     p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
2027                     p_vout->i_white_pixel, p_vout->i_black_pixel, 0,
2028                     OUTLINED_TEXT, psz_text_1, 100 );
2029     }
2030     if( i_width_2 < p_vout->i_width )
2031     {
2032         vout_Print( p_vout->p_large_font, p_vout->p_buffer[ p_vout->i_buffer_index ].p_data +
2033                     (p_vout->i_height - i_height + i_text_height) * p_vout->i_bytes_per_line,
2034                     p_vout->i_bytes_per_pixel, p_vout->i_bytes_per_line,
2035                     p_vout->i_white_pixel, p_vout->i_black_pixel, 0,
2036                     OUTLINED_TEXT, psz_text_2, 100 );
2037     }
2038
2039     /* Activate modified area */
2040     SetBufferArea( p_vout, 0, p_vout->i_height - i_height, p_vout->i_width, i_height );
2041 }
2042
2043 /*****************************************************************************
2044  * Manage: manage thread
2045  *****************************************************************************
2046  * This function will handle changes in thread configuration.
2047  *****************************************************************************/
2048 static int Manage( vout_thread_t *p_vout )
2049 {
2050 #ifdef DEBUG_VOUT
2051     if( p_vout->i_changes )
2052     {
2053         intf_DbgMsg("changes: 0x%x (no display: 0x%x)", p_vout->i_changes,
2054                     0 /* p_vout->i_changes & VOUT_NODISPLAY_CHANGE */ );
2055     }
2056 #endif
2057
2058     /* On gamma or grayscale change, rebuild tables */
2059     if( p_vout->i_changes & (VOUT_GAMMA_CHANGE | VOUT_GRAYSCALE_CHANGE |
2060                              VOUT_YUV_CHANGE) )
2061     {
2062         if( vout_ResetYUV( p_vout ) )
2063         {
2064             intf_ErrMsg( "vout error: can't rebuild conversion tables" );
2065             return( 1 );
2066         }
2067     }
2068
2069     /* Clear changes flags which does not need management or have been
2070      * handled */
2071     p_vout->i_changes &= ~(VOUT_GAMMA_CHANGE | VOUT_GRAYSCALE_CHANGE |
2072                            VOUT_YUV_CHANGE   | VOUT_INFO_CHANGE |
2073                            VOUT_INTF_CHANGE  | VOUT_SCALE_CHANGE );
2074
2075     /* Detect unauthorized changes */
2076     if( p_vout->i_changes )
2077     {
2078         /* Some changes were not acknowledged by p_vout->p_sys_manage or this
2079          * function, it means they should not be authorized */
2080         intf_ErrMsg( "vout error: unauthorized changes in the vout thread" );
2081         return( 1 );
2082     }
2083
2084     return( 0 );
2085 }
2086
2087 /*****************************************************************************
2088  * Align: align a subpicture in the screen
2089  *****************************************************************************
2090  * This function is used for rendering text or subpictures. It returns non 0
2091  * it the final aera is not fully included in display area. Return coordinates
2092  * are absolute.
2093  *****************************************************************************/
2094 static int Align( vout_thread_t *p_vout, int *pi_x, int *pi_y,
2095                    int i_width, int i_height, int i_h_align, int i_v_align )
2096 {
2097     /* Align horizontally */
2098     switch( i_h_align )
2099     {
2100     case CENTER_ALIGN:
2101         *pi_x -= i_width / 2;
2102         break;
2103     case CENTER_RALIGN:
2104         *pi_x += (p_vout->i_width - i_width) / 2;
2105         break;
2106     case RIGHT_ALIGN:
2107         *pi_x -= i_width;
2108         break;
2109     case RIGHT_RALIGN:
2110         *pi_x += p_vout->i_width - i_width;
2111         break;
2112     }
2113
2114     /* Align vertically */
2115     switch( i_v_align )
2116     {
2117     case CENTER_ALIGN:
2118         *pi_y -= i_height / 2;
2119         break;
2120     case CENTER_RALIGN:
2121         *pi_y += (p_vout->i_height - i_height) / 2;
2122         break;
2123     case BOTTOM_ALIGN:
2124         *pi_y -= i_height;
2125         break;
2126     case BOTTOM_RALIGN:
2127         *pi_y += p_vout->i_height - i_height;
2128         break;
2129     case SUBTITLE_RALIGN:
2130         *pi_y += (p_vout->i_height + p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_y +
2131                   p_vout->p_buffer[ p_vout->i_buffer_index ].i_pic_height - i_height) / 2;
2132         break;
2133     }
2134
2135     /* Return non 0 if clipping failed */
2136     return( (*pi_x < 0) || (*pi_y < 0) ||
2137             (*pi_x + i_width > p_vout->i_width) || (*pi_y + i_height > p_vout->i_height) );
2138 }
2139
2140 /*****************************************************************************
2141  * SetPalette: sets an 8 bpp palette
2142  *****************************************************************************
2143  * This function is just a prototype that does nothing. Architectures that
2144  * support palette allocation should override it.
2145  *****************************************************************************/
2146 static void     SetPalette        ( p_vout_thread_t p_vout, u16 *red,
2147                                     u16 *green, u16 *blue, u16 *transp )
2148 {
2149     intf_ErrMsg( "vout error: method does not support palette changing" );
2150 }
2151