git.sesse.net Git - vlc/blob - src/control/video.c

   1 /*****************************************************************************
   2  * video.c: libvlc new API video functions
   3  *****************************************************************************
   4  * Copyright (C) 2005 the VideoLAN team
   5  *
   6  * $Id$
   7  *
   8  * Authors: Cl�ent Stenac <zorglub@videolan.org>
   9  *          Filippo Carone <littlejohn@videolan.org>
  10  *          Jean-Paul Saman <jpsaman _at_ m2x _dot_ nl>
  11  *          Damien Fouilleul <damienf a_t videolan dot org>
  12  *
  13  * This program is free software; you can redistribute it and/or modify
  14  * it under the terms of the GNU General Public License as published by
  15  * the Free Software Foundation; either version 2 of the License, or
  16  * (at your option) any later version.
  17  *
  18  * This program is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU General Public License for more details.
  22  *
  23  * You should have received a copy of the GNU General Public License
  24  * along with this program; if not, write to the Free Software
  25  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  26  *****************************************************************************/
  27
  28 #include "libvlc_internal.h"
  29
  30 #include <vlc/libvlc.h>
  31 #include <vlc_input.h>
  32 #include <vlc_vout.h>
  33
  34 /*
  35  * Remember to release the returned vout_thread_t.
  36  */
  37 static vout_thread_t *GetVout( libvlc_media_player_t *p_mi,
  38                                libvlc_exception_t *p_exception )
  39 {
  40     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_exception );
  41     vout_thread_t *p_vout = NULL;
  42
  43     if( p_input_thread )
  44     {
  45         p_vout = vlc_object_find( p_input_thread, VLC_OBJECT_VOUT, FIND_CHILD );
  46         if( !p_vout )
  47         {
  48             libvlc_exception_raise( p_exception, "No active video output" );
  49         }
  50         vlc_object_release( p_input_thread );
  51     }
  52     return p_vout;
  53 }
  54
  55 /**********************************************************************
  56  * Exported functions
  57  **********************************************************************/
  58
  59 void libvlc_set_fullscreen( libvlc_media_player_t *p_mi, int b_fullscreen,
  60                             libvlc_exception_t *p_e )
  61 {
  62     /* We only work on the first vout */
  63     vout_thread_t *p_vout = GetVout( p_mi, p_e );
  64
  65     /* GetVout will raise the exception for us */
  66     if( !p_vout ) return;
  67
  68     var_SetBool( p_vout, "fullscreen", b_fullscreen );
  69
  70     vlc_object_release( p_vout );
  71 }
  72
  73 int libvlc_get_fullscreen( libvlc_media_player_t *p_mi,
  74                             libvlc_exception_t *p_e )
  75 {
  76     /* We only work on the first vout */
  77     vout_thread_t *p_vout = GetVout( p_mi, p_e );
  78     int i_ret;
  79
  80     /* GetVout will raise the exception for us */
  81     if( !p_vout )
  82         return 0;
  83
  84     i_ret = var_GetBool( p_vout, "fullscreen" );
  85
  86     vlc_object_release( p_vout );
  87
  88     return i_ret;
  89 }
  90
  91 void libvlc_toggle_fullscreen( libvlc_media_player_t *p_mi,
  92                                libvlc_exception_t *p_e )
  93 {
  94     /* We only work on the first vout */
  95     vout_thread_t *p_vout = GetVout( p_mi, p_e );
  96     bool ret;
  97
  98     /* GetVout will raise the exception for us */
  99     if( !p_vout ) return;
 100
 101     ret = var_GetBool( p_vout, "fullscreen" );
 102     var_SetBool( p_vout, "fullscreen", !ret );
 103
 104     vlc_object_release( p_vout );
 105 }
 106
 107 void
 108 libvlc_video_take_snapshot( libvlc_media_player_t *p_mi, char *psz_filepath,
 109         unsigned int i_width, unsigned int i_height, libvlc_exception_t *p_e )
 110 {
 111     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 112     input_thread_t *p_input_thread;
 113
 114     /* GetVout will raise the exception for us */
 115     if( !p_vout )
 116     {
 117         return;
 118     }
 119
 120     if( !psz_filepath )
 121     {
 122         libvlc_exception_raise( p_e, "filepath is null" );
 123         return;
 124     }
 125
 126     var_SetInteger( p_vout, "snapshot-width", i_width );
 127     var_SetInteger( p_vout, "snapshot-height", i_height );
 128
 129     p_input_thread = p_mi->p_input_thread;
 130     if( !p_mi->p_input_thread )
 131     {
 132         libvlc_exception_raise( p_e, "Input does not exist" );
 133         return;
 134     }
 135
 136     var_SetString( p_vout, "snapshot-path", psz_filepath );
 137     var_SetString( p_vout, "snapshot-format", "png" );
 138
 139     vout_Control( p_vout, VOUT_SNAPSHOT );
 140     vlc_object_release( p_vout );
 141 }
 142
 143 int libvlc_video_get_height( libvlc_media_player_t *p_mi,
 144                              libvlc_exception_t *p_e )
 145 {
 146     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 147     if( !p_vout )
 148         return 0;
 149
 150     vlc_object_release( p_vout );
 151
 152     return p_vout->i_window_height;
 153 }
 154
 155 int libvlc_video_get_width( libvlc_media_player_t *p_mi,
 156                             libvlc_exception_t *p_e )
 157 {
 158     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 159     if( !p_vout )
 160         return 0;
 161
 162     vlc_object_release( p_vout );
 163
 164     return p_vout->i_window_width;
 165 }
 166
 167 int libvlc_media_player_has_vout( libvlc_media_player_t *p_mi,
 168                                      libvlc_exception_t *p_e )
 169 {
 170     input_thread_t *p_input_thread = libvlc_get_input_thread(p_mi, p_e);
 171     bool has_vout = false;
 172
 173     if( p_input_thread )
 174     {
 175         vout_thread_t *p_vout;
 176
 177         p_vout = vlc_object_find( p_input_thread, VLC_OBJECT_VOUT, FIND_CHILD );
 178         if( p_vout )
 179         {
 180             has_vout = true;
 181             vlc_object_release( p_vout );
 182         }
 183         vlc_object_release( p_input_thread );
 184     }
 185     return has_vout;
 186 }
 187
 188 int libvlc_video_reparent( libvlc_media_player_t *p_mi, libvlc_drawable_t d,
 189                            libvlc_exception_t *p_e )
 190 {
 191     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 192
 193     if( p_vout )
 194     {
 195         vout_Control( p_vout , VOUT_REPARENT, d);
 196         vlc_object_release( p_vout );
 197     }
 198     return 0;
 199 }
 200
 201 void libvlc_video_resize( libvlc_media_player_t *p_mi, int width, int height, libvlc_exception_t *p_e )
 202 {
 203     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 204     if( p_vout )
 205     {
 206         vout_Control( p_vout, VOUT_SET_SIZE, width, height );
 207         vlc_object_release( p_vout );
 208     }
 209 }
 210
 211 void libvlc_video_redraw_rectangle( libvlc_media_player_t *p_mi,
 212                            const libvlc_rectangle_t *area,
 213                            libvlc_exception_t *p_e )
 214 {
 215     if( (NULL != area)
 216      && ((area->bottom - area->top) > 0)
 217      && ((area->right - area->left) > 0) )
 218     {
 219         vout_thread_t *p_vout = GetVout( p_mi, p_e );
 220         if( p_vout )
 221         {
 222             /* tell running vout to redraw area */
 223             vout_Control( p_vout , VOUT_REDRAW_RECT,
 224                                area->top, area->left, area->bottom, area->right );
 225             vlc_object_release( p_vout );
 226         }
 227     }
 228 }
 229
 230 /* global video settings */
 231
 232 void libvlc_video_set_parent( libvlc_instance_t *p_instance, libvlc_drawable_t d,
 233                               libvlc_exception_t *p_e )
 234 {
 235     /* set as default for future vout instances */
 236     var_SetInteger(p_instance->p_libvlc_int, "drawable", (int)d);
 237
 238     if( libvlc_playlist_isplaying(p_instance, p_e) )
 239     {
 240         libvlc_media_player_t *p_mi = libvlc_playlist_get_media_player(p_instance, p_e);
 241         if( p_mi )
 242         {
 243             vout_thread_t *p_vout = GetVout( p_mi, p_e );
 244             if( p_vout )
 245             {
 246                 /* tell running vout to re-parent */
 247                 vout_Control( p_vout , VOUT_REPARENT, d);
 248                 vlc_object_release( p_vout );
 249             }
 250             libvlc_media_player_release(p_mi);
 251         }
 252     }
 253 }
 254
 255 libvlc_drawable_t libvlc_video_get_parent( libvlc_instance_t *p_instance, libvlc_exception_t *p_e )
 256 {
 257     VLC_UNUSED(p_e);
 258
 259     libvlc_drawable_t result;
 260
 261     result = var_GetInteger( p_instance->p_libvlc_int, "drawable" );
 262
 263     return result;
 264 }
 265
 266
 267 void libvlc_video_set_size( libvlc_instance_t *p_instance, int width, int height,
 268                            libvlc_exception_t *p_e )
 269 {
 270     /* set as default for future vout instances */
 271     config_PutInt(p_instance->p_libvlc_int, "width", width);
 272     config_PutInt(p_instance->p_libvlc_int, "height", height);
 273
 274     if( libvlc_playlist_isplaying(p_instance, p_e) )
 275     {
 276         libvlc_media_player_t *p_mi = libvlc_playlist_get_media_player(p_instance, p_e);
 277         if( p_mi )
 278         {
 279             vout_thread_t *p_vout = GetVout( p_mi, p_e );
 280             if( p_vout )
 281             {
 282                 /* tell running vout to re-size */
 283                 vout_Control( p_vout , VOUT_SET_SIZE, width, height);
 284                 vlc_object_release( p_vout );
 285             }
 286             libvlc_media_player_release(p_mi);
 287         }
 288     }
 289 }
 290
 291 void libvlc_video_set_viewport( libvlc_instance_t *p_instance,
 292                             const libvlc_rectangle_t *view, const libvlc_rectangle_t *clip,
 293                            libvlc_exception_t *p_e )
 294 {
 295     if( !view )
 296     {
 297         libvlc_exception_raise( p_e, "viewport is NULL" );
 298         return;
 299     }
 300
 301     /* if clip is NULL, then use view rectangle as clip */
 302     if( !clip )
 303         clip = view;
 304
 305     /* set as default for future vout instances */
 306     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-top", view->top );
 307     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-left", view->left );
 308     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-bottom", view->bottom );
 309     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-right", view->right );
 310     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-top", clip->top );
 311     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-left", clip->left );
 312     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-bottom", clip->bottom );
 313     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-right", clip->right );
 314
 315     if( libvlc_playlist_isplaying(p_instance, p_e) )
 316     {
 317         libvlc_media_player_t *p_mi = libvlc_playlist_get_media_player(p_instance, p_e);
 318         if( p_mi )
 319         {
 320             vout_thread_t *p_vout = GetVout( p_mi, p_e );
 321             if( p_vout )
 322             {
 323                 /* change viewport for running vout */
 324                 vout_Control( p_vout , VOUT_SET_VIEWPORT,
 325                                    view->top, view->left, view->bottom, view->right,
 326                                    clip->top, clip->left, clip->bottom, clip->right );
 327                 vlc_object_release( p_vout );
 328             }
 329             libvlc_media_player_release(p_mi);
 330         }
 331     }
 332 }
 333
 334 char *libvlc_video_get_aspect_ratio( libvlc_media_player_t *p_mi,
 335                                      libvlc_exception_t *p_e )
 336 {
 337     char *psz_aspect = 0;
 338     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 339
 340     if( !p_vout ) return 0;
 341
 342     psz_aspect = var_GetNonEmptyString( p_vout, "aspect-ratio" );
 343     vlc_object_release( p_vout );
 344     return psz_aspect ? psz_aspect : strdup("");
 345 }
 346
 347 void libvlc_video_set_aspect_ratio( libvlc_media_player_t *p_mi,
 348                                     char *psz_aspect, libvlc_exception_t *p_e )
 349 {
 350     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 351     int i_ret = -1;
 352
 353     if( !p_vout ) return;
 354
 355     i_ret = var_SetString( p_vout, "aspect-ratio", psz_aspect );
 356     if( i_ret )
 357         libvlc_exception_raise( p_e,
 358                         "Unexpected error while setting aspect-ratio value" );
 359
 360     vlc_object_release( p_vout );
 361 }
 362
 363 int libvlc_video_get_spu( libvlc_media_player_t *p_mi,
 364                           libvlc_exception_t *p_e )
 365 {
 366     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
 367     vlc_value_t val_list;
 368     vlc_value_t val;
 369     int i_spu = -1;
 370     int i_ret = -1;
 371     int i;
 372
 373     if( !p_input_thread ) return -1;
 374
 375     i_ret = var_Get( p_input_thread, "spu-es", &val );
 376     if( i_ret < 0 )
 377     {
 378         libvlc_exception_raise( p_e, "Getting subtitle information failed" );
 379         vlc_object_release( p_input_thread );
 380         return i_ret;
 381     }
 382
 383     var_Change( p_input_thread, "spu-es", VLC_VAR_GETCHOICES, &val_list, NULL );
 384     for( i = 0; i < val_list.p_list->i_count; i++ )
 385     {
 386         vlc_value_t spu_val = val_list.p_list->p_values[i];
 387         if( val.i_int == spu_val.i_int )
 388         {
 389             i_spu = i;
 390             break;
 391         }
 392     }
 393     vlc_object_release( p_input_thread );
 394     return i_spu;
 395 }
 396
 397 void libvlc_video_set_spu( libvlc_media_player_t *p_mi, int i_spu,
 398                            libvlc_exception_t *p_e )
 399 {
 400     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
 401     vlc_value_t val_list;
 402     int i_ret = -1;
 403     int i;
 404
 405     if( !p_input_thread ) return;
 406
 407     var_Change( p_input_thread, "spu-es", VLC_VAR_GETCHOICES, &val_list, NULL );
 408     for( i = 0; i < val_list.p_list->i_count; i++ )
 409     {
 410         vlc_value_t val = val_list.p_list->p_values[i];
 411         if( i_spu == i )
 412         {
 413             vlc_value_t new_val;
 414
 415             new_val.i_int = val.i_int;
 416             i_ret = var_Set( p_input_thread, "spu-es", new_val );
 417             if( i_ret < 0 )
 418             {
 419                 libvlc_exception_raise( p_e, "Setting subtitle value failed" );
 420             }
 421             vlc_object_release( p_input_thread );
 422             return;
 423         }
 424     }
 425     libvlc_exception_raise( p_e, "Subtitle value out of range" );
 426     vlc_object_release( p_input_thread );
 427 }
 428
 429 int libvlc_video_set_subtitle_file( libvlc_media_player_t *p_mi,
 430                                     char *psz_subtitle,
 431                                     libvlc_exception_t *p_e )
 432 {
 433     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 434     bool b_ret = false;
 435
 436     if( p_input_thread )
 437     {
 438         if( input_AddSubtitles( p_input_thread, psz_subtitle, true ) )
 439             b_ret = true;
 440         vlc_object_release( p_input_thread );
 441     }
 442     return b_ret;
 443 }
 444
 445 char *libvlc_video_get_crop_geometry( libvlc_media_player_t *p_mi,
 446                                    libvlc_exception_t *p_e )
 447 {
 448     char *psz_geometry = 0;
 449     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 450
 451     if( !p_vout ) return 0;
 452
 453     psz_geometry = var_GetNonEmptyString( p_vout, "crop" );
 454     vlc_object_release( p_vout );
 455     return psz_geometry ? psz_geometry : strdup("");
 456 }
 457
 458 void libvlc_video_set_crop_geometry( libvlc_media_player_t *p_mi,
 459                                     char *psz_geometry, libvlc_exception_t *p_e )
 460 {
 461     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 462     int i_ret = -1;
 463
 464     if( !p_vout ) return;
 465
 466     i_ret = var_SetString( p_vout, "crop", psz_geometry );
 467     if( i_ret )
 468         libvlc_exception_raise( p_e,
 469                         "Unexpected error while setting crop geometry" );
 470
 471     vlc_object_release( p_vout );
 472 }
 473
 474 int libvlc_video_get_teletext( libvlc_media_player_t *p_mi,
 475                                libvlc_exception_t *p_e )
 476 {
 477     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 478     vlc_object_t *p_vbi;
 479     int i_ret = -1;
 480
 481     if( !p_vout ) return i_ret;
 482
 483     p_vbi = (vlc_object_t *) vlc_object_find_name( p_vout, "zvbi",
 484                                                    FIND_ANYWHERE );
 485     if( p_vbi )
 486     {
 487         i_ret = var_GetInteger( p_vbi, "vbi-page" );
 488         vlc_object_release( p_vbi );
 489     }
 490
 491     vlc_object_release( p_vout );
 492     return i_ret;
 493 }
 494
 495 void libvlc_video_set_teletext( libvlc_media_player_t *p_mi, int i_page,
 496                                 libvlc_exception_t *p_e )
 497 {
 498     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 499     vlc_object_t *p_vbi;
 500     int i_ret = -1;
 501
 502     if( !p_vout ) return;
 503
 504     p_vbi = (vlc_object_t *) vlc_object_find_name( p_vout, "zvbi",
 505                                                    FIND_ANYWHERE );
 506     if( p_vbi )
 507     {
 508         i_ret = var_SetInteger( p_vbi, "vbi-page", i_page );
 509         vlc_object_release( p_vbi );
 510     }
 511     if( i_ret )
 512         libvlc_exception_raise( p_e,
 513                         "Unexpected error while setting teletext page" );
 514     vlc_object_release( p_vout );
 515 }
 516
 517 void libvlc_toggle_teletext( libvlc_media_player_t *p_mi,
 518                              libvlc_exception_t *p_e )
 519 {
 520     /* We only work on the first vout */
 521     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 522     bool opaque; int i_ret;
 523
 524     /* GetVout will raise the exception for us */
 525     if( !p_vout ) return;
 526
 527     opaque = var_GetBool( p_vout, "vbi-opaque" );
 528     i_ret = var_SetBool( p_vout, "vbi-opaque", !opaque );
 529     if( i_ret )
 530         libvlc_exception_raise( p_e,
 531                         "Unexpected error while setting teletext value" );
 532
 533     vlc_object_release( p_vout );
 534 }
 535
 536 int libvlc_video_destroy( libvlc_media_player_t *p_mi,
 537                           libvlc_exception_t *p_e )
 538 {
 539     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 540     vlc_object_detach( p_vout );
 541     vlc_object_release( p_vout );
 542     vlc_object_release( p_vout );
 543
 544     return 0;
 545 }