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 ) return 0;
  82
  83     i_ret = var_GetBool( p_vout, "fullscreen" );
  84
  85     vlc_object_release( p_vout );
  86
  87     return i_ret;
  88 }
  89
  90 void libvlc_toggle_fullscreen( libvlc_media_player_t *p_mi,
  91                                libvlc_exception_t *p_e )
  92 {
  93     /* We only work on the first vout */
  94     vout_thread_t *p_vout = GetVout( p_mi, p_e );
  95     bool ret;
  96
  97     /* GetVout will raise the exception for us */
  98     if( !p_vout ) return;
  99
 100     ret = var_GetBool( p_vout, "fullscreen" );
 101     var_SetBool( p_vout, "fullscreen", !ret );
 102
 103     vlc_object_release( p_vout );
 104 }
 105
 106 void
 107 libvlc_video_take_snapshot( libvlc_media_player_t *p_mi, char *psz_filepath,
 108         unsigned int i_width, unsigned int i_height, libvlc_exception_t *p_e )
 109 {
 110     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 111     input_thread_t *p_input_thread;
 112
 113     /* GetVout will raise the exception for us */
 114     if( !p_vout ) return;
 115
 116     if( !psz_filepath )
 117     {
 118         libvlc_exception_raise( p_e, "filepath is null" );
 119         return;
 120     }
 121
 122     var_SetInteger( p_vout, "snapshot-width", i_width );
 123     var_SetInteger( p_vout, "snapshot-height", i_height );
 124
 125     p_input_thread = p_mi->p_input_thread;
 126     if( !p_mi->p_input_thread )
 127     {
 128         libvlc_exception_raise( p_e, "Input does not exist" );
 129         return;
 130     }
 131
 132     var_SetString( p_vout, "snapshot-path", psz_filepath );
 133     var_SetString( p_vout, "snapshot-format", "png" );
 134
 135     vout_Control( p_vout, VOUT_SNAPSHOT );
 136     vlc_object_release( p_vout );
 137 }
 138
 139 int libvlc_video_get_height( libvlc_media_player_t *p_mi,
 140                              libvlc_exception_t *p_e )
 141 {
 142     int height;
 143
 144     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 145     if( !p_vout ) return 0;
 146
 147     height = p_vout->i_window_height;
 148
 149     vlc_object_release( p_vout );
 150
 151     return height;
 152 }
 153
 154 int libvlc_video_get_width( libvlc_media_player_t *p_mi,
 155                             libvlc_exception_t *p_e )
 156 {
 157     int width;
 158
 159     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 160     if( !p_vout ) return 0;
 161
 162     width = p_vout->i_window_width;
 163
 164     vlc_object_release( p_vout );
 165
 166     return width;
 167 }
 168
 169 int libvlc_media_player_has_vout( libvlc_media_player_t *p_mi,
 170                                      libvlc_exception_t *p_e )
 171 {
 172     input_thread_t *p_input_thread = libvlc_get_input_thread(p_mi, p_e);
 173     bool has_vout = false;
 174
 175     if( p_input_thread )
 176     {
 177         vout_thread_t *p_vout;
 178
 179         p_vout = vlc_object_find( p_input_thread, VLC_OBJECT_VOUT, FIND_CHILD );
 180         if( p_vout )
 181         {
 182             has_vout = true;
 183             vlc_object_release( p_vout );
 184         }
 185         vlc_object_release( p_input_thread );
 186     }
 187     return has_vout;
 188 }
 189
 190 int libvlc_video_reparent( libvlc_media_player_t *p_mi, libvlc_drawable_t d,
 191                            libvlc_exception_t *p_e )
 192 {
 193     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 194
 195     if( p_vout )
 196     {
 197         vout_Control( p_vout , VOUT_REPARENT, d);
 198         vlc_object_release( p_vout );
 199     }
 200     return 0;
 201 }
 202
 203 void libvlc_video_resize( libvlc_media_player_t *p_mi, int width, int height, libvlc_exception_t *p_e )
 204 {
 205     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 206     if( p_vout )
 207     {
 208         vout_Control( p_vout, VOUT_SET_SIZE, width, height );
 209         vlc_object_release( p_vout );
 210     }
 211 }
 212
 213 void libvlc_video_redraw_rectangle( libvlc_media_player_t *p_mi,
 214                            const libvlc_rectangle_t *area,
 215                            libvlc_exception_t *p_e )
 216 {
 217     if( (NULL != area)
 218      && ((area->bottom - area->top) > 0)
 219      && ((area->right - area->left) > 0) )
 220     {
 221         vout_thread_t *p_vout = GetVout( p_mi, p_e );
 222         if( p_vout )
 223         {
 224             /* tell running vout to redraw area */
 225             vout_Control( p_vout , VOUT_REDRAW_RECT,
 226                                area->top, area->left, area->bottom, area->right );
 227             vlc_object_release( p_vout );
 228         }
 229     }
 230 }
 231
 232 /* global video settings */
 233
 234 void libvlc_video_set_parent( libvlc_instance_t *p_instance, libvlc_drawable_t d,
 235                               libvlc_exception_t *p_e )
 236 {
 237     /* set as default for future vout instances */
 238     var_SetInteger(p_instance->p_libvlc_int, "drawable", (int)d);
 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 libvlc_drawable_t libvlc_video_get_parent( libvlc_instance_t *p_instance, libvlc_exception_t *p_e )
 255 {
 256     VLC_UNUSED(p_e);
 257
 258     libvlc_drawable_t result;
 259
 260     result = var_GetInteger( p_instance->p_libvlc_int, "drawable" );
 261
 262     return result;
 263 }
 264
 265
 266 void libvlc_video_set_size( libvlc_instance_t *p_instance, int width, int height,
 267                            libvlc_exception_t *p_e )
 268 {
 269     /* set as default for future vout instances */
 270     config_PutInt(p_instance->p_libvlc_int, "width", width);
 271     config_PutInt(p_instance->p_libvlc_int, "height", height);
 272
 273     libvlc_media_player_t *p_mi = libvlc_playlist_get_media_player(p_instance, p_e);
 274     if( p_mi )
 275     {
 276         vout_thread_t *p_vout = GetVout( p_mi, p_e );
 277         if( p_vout )
 278         {
 279             /* tell running vout to re-size */
 280             vout_Control( p_vout , VOUT_SET_SIZE, width, height);
 281             vlc_object_release( p_vout );
 282         }
 283         libvlc_media_player_release(p_mi);
 284     }
 285 }
 286
 287 void libvlc_video_set_viewport( libvlc_instance_t *p_instance,
 288                             const libvlc_rectangle_t *view, const libvlc_rectangle_t *clip,
 289                            libvlc_exception_t *p_e )
 290 {
 291     if( !view )
 292     {
 293         libvlc_exception_raise( p_e, "viewport is NULL" );
 294         return;
 295     }
 296
 297     /* if clip is NULL, then use view rectangle as clip */
 298     if( !clip )
 299         clip = view;
 300
 301     /* set as default for future vout instances */
 302     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-top", view->top );
 303     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-left", view->left );
 304     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-bottom", view->bottom );
 305     var_SetInteger( p_instance->p_libvlc_int, "drawable-view-right", view->right );
 306     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-top", clip->top );
 307     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-left", clip->left );
 308     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-bottom", clip->bottom );
 309     var_SetInteger( p_instance->p_libvlc_int, "drawable-clip-right", clip->right );
 310
 311     libvlc_media_player_t *p_mi = libvlc_playlist_get_media_player(p_instance, p_e);
 312     if( p_mi )
 313     {
 314         vout_thread_t *p_vout = GetVout( p_mi, p_e );
 315         if( p_vout )
 316         {
 317             /* change viewport for running vout */
 318             vout_Control( p_vout , VOUT_SET_VIEWPORT,
 319                                view->top, view->left, view->bottom, view->right,
 320                                clip->top, clip->left, clip->bottom, clip->right );
 321             vlc_object_release( p_vout );
 322         }
 323         libvlc_media_player_release(p_mi);
 324     }
 325 }
 326
 327 char *libvlc_video_get_aspect_ratio( libvlc_media_player_t *p_mi,
 328                                      libvlc_exception_t *p_e )
 329 {
 330     char *psz_aspect = 0;
 331     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 332
 333     if( !p_vout ) return 0;
 334
 335     psz_aspect = var_GetNonEmptyString( p_vout, "aspect-ratio" );
 336     vlc_object_release( p_vout );
 337     return psz_aspect ? psz_aspect : strdup("");
 338 }
 339
 340 void libvlc_video_set_aspect_ratio( libvlc_media_player_t *p_mi,
 341                                     char *psz_aspect, libvlc_exception_t *p_e )
 342 {
 343     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 344     int i_ret = -1;
 345
 346     if( !p_vout ) return;
 347
 348     i_ret = var_SetString( p_vout, "aspect-ratio", psz_aspect );
 349     if( i_ret )
 350         libvlc_exception_raise( p_e,
 351                         "Unexpected error while setting aspect-ratio value" );
 352
 353     vlc_object_release( p_vout );
 354 }
 355
 356 int libvlc_video_get_spu( libvlc_media_player_t *p_mi,
 357                           libvlc_exception_t *p_e )
 358 {
 359     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
 360     vlc_value_t val_list;
 361     vlc_value_t val;
 362     int i_spu = -1;
 363     int i_ret = -1;
 364     int i;
 365
 366     if( !p_input_thread ) return -1;
 367
 368     i_ret = var_Get( p_input_thread, "spu-es", &val );
 369     if( i_ret < 0 )
 370     {
 371         libvlc_exception_raise( p_e, "Getting subtitle information failed" );
 372         vlc_object_release( p_input_thread );
 373         return i_ret;
 374     }
 375
 376     var_Change( p_input_thread, "spu-es", VLC_VAR_GETCHOICES, &val_list, NULL );
 377     for( i = 0; i < val_list.p_list->i_count; i++ )
 378     {
 379         vlc_value_t spu_val = val_list.p_list->p_values[i];
 380         if( val.i_int == spu_val.i_int )
 381         {
 382             i_spu = i;
 383             break;
 384         }
 385     }
 386     vlc_object_release( p_input_thread );
 387     return i_spu;
 388 }
 389
 390 void libvlc_video_set_spu( libvlc_media_player_t *p_mi, int i_spu,
 391                            libvlc_exception_t *p_e )
 392 {
 393     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
 394     vlc_value_t val_list;
 395     int i_ret = -1;
 396     int i;
 397
 398     if( !p_input_thread ) return;
 399
 400     var_Change( p_input_thread, "spu-es", VLC_VAR_GETCHOICES, &val_list, NULL );
 401     for( i = 0; i < val_list.p_list->i_count; i++ )
 402     {
 403         vlc_value_t val = val_list.p_list->p_values[i];
 404         if( i_spu == i )
 405         {
 406             vlc_value_t new_val;
 407
 408             new_val.i_int = val.i_int;
 409             i_ret = var_Set( p_input_thread, "spu-es", new_val );
 410             if( i_ret < 0 )
 411             {
 412                 libvlc_exception_raise( p_e, "Setting subtitle value failed" );
 413             }
 414             vlc_object_release( p_input_thread );
 415             return;
 416         }
 417     }
 418     libvlc_exception_raise( p_e, "Subtitle value out of range" );
 419     vlc_object_release( p_input_thread );
 420 }
 421
 422 int libvlc_video_set_subtitle_file( libvlc_media_player_t *p_mi,
 423                                     char *psz_subtitle,
 424                                     libvlc_exception_t *p_e )
 425 {
 426     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 427     bool b_ret = false;
 428
 429     if( p_input_thread )
 430     {
 431         if( input_AddSubtitles( p_input_thread, psz_subtitle, true ) )
 432             b_ret = true;
 433         vlc_object_release( p_input_thread );
 434     }
 435     return b_ret;
 436 }
 437
 438 char *libvlc_video_get_crop_geometry( libvlc_media_player_t *p_mi,
 439                                    libvlc_exception_t *p_e )
 440 {
 441     char *psz_geometry = 0;
 442     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 443
 444     if( !p_vout ) return 0;
 445
 446     psz_geometry = var_GetNonEmptyString( p_vout, "crop" );
 447     vlc_object_release( p_vout );
 448     return psz_geometry ? psz_geometry : strdup("");
 449 }
 450
 451 void libvlc_video_set_crop_geometry( libvlc_media_player_t *p_mi,
 452                                     char *psz_geometry, libvlc_exception_t *p_e )
 453 {
 454     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 455     int i_ret = -1;
 456
 457     if( !p_vout ) return;
 458
 459     i_ret = var_SetString( p_vout, "crop", psz_geometry );
 460     if( i_ret )
 461         libvlc_exception_raise( p_e,
 462                         "Unexpected error while setting crop geometry" );
 463
 464     vlc_object_release( p_vout );
 465 }
 466
 467 int libvlc_video_get_teletext( libvlc_media_player_t *p_mi,
 468                                libvlc_exception_t *p_e )
 469 {
 470     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 471     vlc_object_t *p_vbi;
 472     int i_ret = -1;
 473
 474     if( !p_vout ) return i_ret;
 475
 476     p_vbi = (vlc_object_t *) vlc_object_find_name( p_vout, "zvbi",
 477                                                    FIND_ANYWHERE );
 478     if( p_vbi )
 479     {
 480         i_ret = var_GetInteger( p_vbi, "vbi-page" );
 481         vlc_object_release( p_vbi );
 482     }
 483
 484     vlc_object_release( p_vout );
 485     return i_ret;
 486 }
 487
 488 void libvlc_video_set_teletext( libvlc_media_player_t *p_mi, int i_page,
 489                                 libvlc_exception_t *p_e )
 490 {
 491     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 492     vlc_object_t *p_vbi;
 493     int i_ret = -1;
 494
 495     if( !p_vout ) return;
 496
 497     p_vbi = (vlc_object_t *) vlc_object_find_name( p_vout, "zvbi",
 498                                                    FIND_ANYWHERE );
 499     if( p_vbi )
 500     {
 501         i_ret = var_SetInteger( p_vbi, "vbi-page", i_page );
 502         vlc_object_release( p_vbi );
 503     }
 504     if( i_ret )
 505         libvlc_exception_raise( p_e,
 506                         "Unexpected error while setting teletext page" );
 507     vlc_object_release( p_vout );
 508 }
 509
 510 void libvlc_toggle_teletext( libvlc_media_player_t *p_mi,
 511                              libvlc_exception_t *p_e )
 512 {
 513     /* We only work on the first vout */
 514     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 515     bool opaque; int i_ret;
 516
 517     /* GetVout will raise the exception for us */
 518     if( !p_vout ) return;
 519
 520     opaque = var_GetBool( p_vout, "vbi-opaque" );
 521     i_ret = var_SetBool( p_vout, "vbi-opaque", !opaque );
 522     if( i_ret )
 523         libvlc_exception_raise( p_e,
 524                         "Unexpected error while setting teletext value" );
 525
 526     vlc_object_release( p_vout );
 527 }
 528
 529 int libvlc_video_destroy( libvlc_media_player_t *p_mi,
 530                           libvlc_exception_t *p_e )
 531 {
 532     vout_thread_t *p_vout = GetVout( p_mi, p_e );
 533     vlc_object_detach( p_vout );
 534     vlc_object_release( p_vout );
 535     vlc_object_release( p_vout );
 536
 537     return 0;
 538 }