1 /*****************************************************************************
2 * qt4.cpp : QT4 interface
3 ****************************************************************************
4 * Copyright © 2006-2009 the VideoLAN team
7 * Authors: Clément Stenac <zorglub@videolan.org>
8 * Jean-Baptiste Kempf <jb@videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
29 #include <QApplication>
35 #include "input_manager.hpp" /* THEMIM creation */
36 #include "dialogs_provider.hpp" /* THEDP creation */
37 #include "main_interface.hpp" /* MainInterface creation */
38 #include "dialogs/help.hpp" /* Launch Update */
39 #include "recents.hpp" /* Recents Item destruction */
40 #include "util/qvlcapp.hpp" /* QVLCApplication definition */
46 #include "../../../share/icons/32x32/vlc.xpm"
47 #include "../../../share/icons/32x32/vlc-xmas.xpm"
48 #include <vlc_plugin.h>
50 #ifdef WIN32 /* For static builds */
52 Q_IMPORT_PLUGIN(qjpeg)
53 Q_IMPORT_PLUGIN(qtaccessiblewidgets)
56 /*****************************************************************************
58 *****************************************************************************/
59 static int OpenIntf ( vlc_object_t * );
60 static int OpenDialogs ( vlc_object_t * );
61 static int Open ( vlc_object_t *, bool );
62 static void Close ( vlc_object_t * );
63 static int WindowOpen ( vlc_object_t * );
64 static void WindowClose ( vlc_object_t * );
65 static void *Thread ( void * );
66 static void ShowDialog ( intf_thread_t *, int, int, intf_dialog_args_t * );
68 /*****************************************************************************
70 *****************************************************************************/
71 #define ADVANCED_PREFS_TEXT N_( "Show advanced preferences over simple ones" )
72 #define ADVANCED_PREFS_LONGTEXT N_( "Show advanced preferences and not simple "\
73 "preferences when opening the preferences "\
76 #define SYSTRAY_TEXT N_( "Systray icon" )
77 #define SYSTRAY_LONGTEXT N_( "Show an icon in the systray " \
78 "allowing you to control VLC media player " \
79 "for basic actions." )
81 #define MINIMIZED_TEXT N_( "Start VLC with only a systray icon" )
82 #define MINIMIZED_LONGTEXT N_( "VLC will start with just an icon in " \
85 #define KEEPSIZE_TEXT N_( "Resize interface to the native video size" )
86 #define KEEPSIZE_LONGTEXT N_( "You have two choices:\n" \
87 " - The interface will resize to the native video size\n" \
88 " - The video will fit to the interface size\n " \
89 "By default, interface resize to the native video size." )
91 #define TITLE_TEXT N_( "Show playing item name in window title" )
92 #define TITLE_LONGTEXT N_( "Show the name of the song or video in the " \
93 "controler window title." )
95 #define NOTIFICATION_TEXT N_( "Show notification popup on track change" )
96 #define NOTIFICATION_LONGTEXT N_( \
97 "Show a notification popup with the artist and track name when " \
98 "the current playlist item changes, when VLC is minimized or hidden." )
100 #define ADVANCED_OPTIONS_TEXT N_( "Advanced options" )
101 #define ADVANCED_OPTIONS_LONGTEXT N_( "Show all the advanced options " \
104 #define OPACITY_TEXT N_( "Windows opacity between 0.1 and 1" )
105 #define OPACITY_LONGTEXT N_( "Sets the windows opacity between 0.1 and 1 " \
106 "for main interface, playlist and extended panel."\
107 " This option only works with Windows and " \
108 "X11 with composite extensions." )
110 #define OPACITY_FS_TEXT N_( "Fullscreen controller opacity between 0.1 and 1" )
111 #define OPACITY_FS_LONGTEXT N_( "Sets the fullscreen controller opacity between 0.1 and 1 " \
112 "for main interface, playlist and extended panel."\
113 " This option only works with Windows and " \
114 "X11 with composite extensions." )
117 #define ERROR_TEXT N_( "Show unimportant error and warnings dialogs" )
119 #define UPDATER_TEXT N_( "Activate the updates availability notification" )
120 #define UPDATER_LONGTEXT N_( "Activate the automatic notification of new " \
121 "versions of the software. It runs once every " \
123 #define UPDATER_DAYS_TEXT N_("Number of days between two update checks")
125 #define COMPLETEVOL_TEXT N_( "Allow the volume to be set to 400%" )
126 #define COMPLETEVOL_LONGTEXT N_( "Allow the volume to have range from 0% to " \
127 "400%, instead of 0% to 200%. This option " \
128 "can distort the audio, since it uses " \
129 "software amplification." )
131 #define SAVEVOL_TEXT N_( "Automatically save the volume on exit" )
132 #define STARTVOL_TEXT N_( "Default start volume" )
134 #define PRIVACY_TEXT N_( "Ask for network policy at start" )
136 #define RECENTPLAY_TEXT N_( "Save the recently played items in the menu" )
138 #define RECENTPLAY_FILTER_TEXT N_( "List of words separated by | to filter" )
139 #define RECENTPLAY_FILTER_LONGTEXT N_( "Regular expression used to filter " \
140 "the recent items played in the player" )
142 #define SLIDERCOL_TEXT N_( "Define the colors of the volume slider " )
143 #define SLIDERCOL_LONGTEXT N_( "Define the colors of the volume slider\n" \
144 "By specifying the 12 numbers separated by a ';'\n" \
145 "Default is '255;255;255;20;226;20;255;176;15;235;30;20'\n" \
146 "An alternative can be '30;30;50;40;40;100;50;50;160;150;150;255' ")
148 #define QT_MODE_TEXT N_( "Selection of the starting mode and look " )
149 #define QT_MODE_LONGTEXT N_( "Start VLC with:\n" \
151 " - a zone always present to show information " \
152 "as lyrics, album arts...\n" \
153 " - minimal mode with limited controls" )
155 #define QT_FULLSCREEN_TEXT N_( "Show a controller in fullscreen mode" )
156 #define QT_NATIVEOPEN_TEXT N_( "Embed the file browser in open dialog" )
158 #define FULLSCREEN_NUMBER_TEXT N_( "Define which screen fullscreen goes" )
159 #define FULLSCREEN_NUMBER_LONGTEXT N_( "Screennumber of fullscreen, instead of" \
160 "same screen where interface is" )
162 #define QT_AUTOLOAD_EXTENSIONS_TEXT N_( "Load extensions on startup" )
163 #define QT_AUTOLOAD_EXTENSIONS_LONGTEXT N_( "Automatically load the "\
164 "extensions module on startup" )
166 #define QT_MINIMAL_MODE_TEXT N_("Start in minimal view (without menus)" )
168 #define QT_BGCONE_TEXT N_( "Display background cone or art" )
169 #define QT_BGCONE_LONGTEXT N_( "Display background cone or current album art " \
170 "when not playing." \
171 "Can be disabled to prevent burning screen." )
172 #define QT_BGCONE_EXPANDS_TEXT N_( "Expanding background cone or art." )
173 #define QT_BGCONE_EXPANDS_LONGTEXT N_( "Background art fits window's size" )
175 #define QT_DISABLE_VOLUME_KEYS_TEXT N_( "Ignore keyboard volume buttons." )
176 #define QT_DISABLE_VOLUME_KEYS_LONGTEXT N_( \
177 "With this option checked, the volume up, volume down and mute buttons on your " \
178 "keyboard will always change your system volume. With this option unchecked, the " \
179 "volume buttons will change VLC's volume when VLC is selected and change the " \
180 "system volume when VLC is not selected." )
182 #define QT_PAUSE_MINIMIZED_TEXT N_( "Pause the video playback when minimized" )
183 #define QT_PAUSE_MINIMIZED_LONGTEXT N_( \
184 "With this option enabled, the playback will be automatically paused when minimizing the window." )
186 #define ICONCHANGE_TEXT N_( "Allow automatic icon changes")
187 #define ICONCHANGE_LONGTEXT N_( \
188 "This option allows the interface to change its icon on various occasions.")
190 /**********************************************************************/
192 set_shortname( "Qt" )
193 set_description( N_("Qt interface") )
194 set_category( CAT_INTERFACE )
195 set_subcategory( SUBCAT_INTERFACE_MAIN )
196 set_capability( "interface", 151 )
197 set_callbacks( OpenIntf, Close )
201 add_bool( "qt-minimal-view", false, QT_MINIMAL_MODE_TEXT,
202 QT_MINIMAL_MODE_TEXT, false );
204 add_bool( "qt-notification", true, NOTIFICATION_TEXT,
205 NOTIFICATION_LONGTEXT, false )
207 add_float_with_range( "qt-opacity", 1., 0.1, 1., NULL, OPACITY_TEXT,
208 OPACITY_LONGTEXT, false )
209 add_float_with_range( "qt-fs-opacity", 0.8, 0.1, 1., NULL, OPACITY_FS_TEXT,
210 OPACITY_FS_LONGTEXT, false )
212 add_bool( "qt-system-tray", true, SYSTRAY_TEXT,
213 SYSTRAY_LONGTEXT, false)
214 add_bool( "qt-start-minimized", false, MINIMIZED_TEXT,
215 MINIMIZED_LONGTEXT, true)
216 add_bool( "qt-video-autoresize", true, KEEPSIZE_TEXT,
217 KEEPSIZE_LONGTEXT, false )
218 add_bool( "qt-name-in-title", true, TITLE_TEXT,
219 TITLE_LONGTEXT, false )
220 add_bool( "qt-fs-controller", true, QT_FULLSCREEN_TEXT,
221 QT_FULLSCREEN_TEXT, false )
223 add_bool( "qt-volume-complete", false, COMPLETEVOL_TEXT,
224 COMPLETEVOL_LONGTEXT, true )
225 add_bool( "qt-autosave-volume", false, SAVEVOL_TEXT,
227 add_integer_with_range( "qt-startvolume", QT_VOLUME_DEFAULT, 0,
228 QT_VOLUME_MAX, NULL, STARTVOL_TEXT, STARTVOL_TEXT, true )
230 add_bool( "qt-embedded-open", false, QT_NATIVEOPEN_TEXT,
231 QT_NATIVEOPEN_TEXT, false )
232 add_bool( "qt-recentplay", true, RECENTPLAY_TEXT,
233 RECENTPLAY_TEXT, false )
234 add_string( "qt-recentplay-filter", "",
235 RECENTPLAY_FILTER_TEXT, RECENTPLAY_FILTER_LONGTEXT, false )
237 add_bool( "qt-adv-options", false, ADVANCED_OPTIONS_TEXT,
238 ADVANCED_OPTIONS_LONGTEXT, true )
239 add_bool( "qt-advanced-pref", false, ADVANCED_PREFS_TEXT,
240 ADVANCED_PREFS_LONGTEXT, false )
241 add_bool( "qt-error-dialogs", true, ERROR_TEXT,
244 add_bool( "qt-updates-notif", true, UPDATER_TEXT,
245 UPDATER_LONGTEXT, false )
246 add_integer( "qt-updates-days", 7, UPDATER_DAYS_TEXT,
247 UPDATER_DAYS_TEXT, false )
249 add_string( "qt-slider-colours", "255;255;255;20;210;20;255;199;15;245;39;29",
250 SLIDERCOL_TEXT, SLIDERCOL_LONGTEXT, false )
252 add_bool( "qt-privacy-ask", true, PRIVACY_TEXT, PRIVACY_TEXT,
256 add_integer( "qt-fullscreen-screennumber", -1, FULLSCREEN_NUMBER_TEXT,
257 FULLSCREEN_NUMBER_LONGTEXT, false );
259 add_bool( "qt-autoload-extensions", true,
260 QT_AUTOLOAD_EXTENSIONS_TEXT, QT_AUTOLOAD_EXTENSIONS_LONGTEXT,
263 add_bool( "qt-bgcone", true, QT_BGCONE_TEXT, QT_BGCONE_LONGTEXT, true )
264 add_bool( "qt-bgcone-expands", false, QT_BGCONE_EXPANDS_TEXT,
265 QT_BGCONE_EXPANDS_LONGTEXT, true )
268 add_bool( "qt-disable-volume-keys" /* name */,
269 false /* default value */,
270 QT_DISABLE_VOLUME_KEYS_TEXT /* text */,
271 QT_DISABLE_VOLUME_KEYS_LONGTEXT /* longtext */,
272 false /* advanced mode only */)
275 add_bool( "qt-pause-minimized", true, QT_PAUSE_MINIMIZED_TEXT,
276 QT_PAUSE_MINIMIZED_LONGTEXT, false )
278 add_obsolete_bool( "qt-blingbling" ) /* Suppressed since 1.0.0 */
279 add_obsolete_integer( "qt-display-mode" ) /* Suppressed since 1.1.0 */
281 add_bool( "qt-icon-change", true, ICONCHANGE_TEXT, ICONCHANGE_LONGTEXT, true )
284 cannot_unload_broken_library()
288 set_description( "Dialogs provider" )
289 set_capability( "dialogs provider", 51 )
291 set_callbacks( OpenDialogs, Close )
293 #if defined(Q_WS_X11) || defined(Q_WS_WIN) || defined(Q_WS_MAC)
295 #if defined(Q_WS_X11)
296 set_capability( "vout window xid", 0 )
297 #elif defined(Q_WS_WIN)
298 set_capability( "vout window hwnd", 0 )
299 #elif defined(Q_WS_MAC)
300 set_capability( "vout window nsobject", 0 )
302 set_callbacks( WindowOpen, WindowClose )
307 /*****************************************/
309 /* Ugly, but the Qt4 interface assumes single instance anyway */
310 static vlc_sem_t ready;
312 static char *x11_display = NULL;
315 static bool busy = false;
316 static bool active = false;
318 /*****************************************************************************
320 *****************************************************************************/
323 /* Used to abort the app.exec() on OSX after libvlc_Quit is called */
324 #include "../../../src/control/libvlc_internal.h" /* libvlc_SetExitHandler */
325 static void Abort( void *obj )
327 QVLCApp::triggerQuit();
331 static void RegisterIntf( vlc_object_t *p_this )
333 playlist_t *pl = pl_Get(p_this);
334 var_Create (pl, "qt4-iface", VLC_VAR_ADDRESS);
335 var_SetAddress (pl, "qt4-iface", p_this);
336 var_Create (pl, "window", VLC_VAR_STRING);
337 var_SetString (pl, "window", "qt4,any");
341 static int Open( vlc_object_t *p_this, bool isDialogProvider )
343 intf_thread_t *p_intf = (intf_thread_t *)p_this;
346 if( !vlc_xlib_init( p_this ) )
349 char *display = var_CreateGetNonEmptyString( p_intf, "x11-display" );
350 Display *p_display = XOpenDisplay( x11_display );
353 msg_Err( p_intf, "Could not connect to X server" );
357 XCloseDisplay( p_display );
359 char *display = NULL;
362 QMutexLocker locker (&lock);
365 msg_Err (p_this, "cannot start Qt4 multiple times");
370 /* Allocations of p_sys */
371 intf_sys_t *p_sys = p_intf->p_sys = new intf_sys_t;
372 p_intf->p_sys->b_isDialogProvider = isDialogProvider;
377 x11_display = display;
379 vlc_sem_init (&ready, 0);
381 /* Run mainloop on the main thread as Cocoa requires */
382 libvlc_SetExitHandler( p_intf->p_libvlc, Abort, p_intf );
383 Thread( (void *)p_intf );
385 if( vlc_clone( &p_sys->thread, Thread, p_intf, VLC_THREAD_PRIORITY_LOW ) )
393 /* Wait for the interface to be ready. This prevents the main
394 * LibVLC thread from starting video playback before we can create
395 * an embedded video window. */
396 vlc_sem_wait (&ready);
397 vlc_sem_destroy (&ready);
398 busy = active = true;
401 if( !isDialogProvider )
403 RegisterIntf( p_this );
410 /* Open qt4 interface */
411 static int OpenIntf( vlc_object_t *p_this )
413 return Open( p_this, false );
416 /* Open Dialog Provider */
417 static int OpenDialogs( vlc_object_t *p_this )
419 return Open( p_this, true );
422 static void Close( vlc_object_t *p_this )
424 intf_thread_t *p_intf = (intf_thread_t *)p_this;
425 intf_sys_t *p_sys = p_intf->p_sys;
427 if( !p_sys->b_isDialogProvider )
429 var_Destroy (pl_Get(p_this), "window");
430 var_Destroy (pl_Get(p_this), "qt4-iface");
434 msg_Dbg( p_this, "requesting exit..." );
435 QVLCApp::triggerQuit();
437 msg_Dbg( p_this, "waiting for UI thread..." );
439 vlc_join (p_sys->thread, NULL);
447 QMutexLocker locker (&lock);
452 static void *Thread( void *obj )
454 intf_thread_t *p_intf = (intf_thread_t *)obj;
456 char dummy[] = "vlc"; /* for WM_CLASS */
457 char *argv[4] = { dummy, NULL, };
460 Q_INIT_RESOURCE( vlc );
462 /* Start the QApplication here */
464 if( x11_display != NULL )
466 argv[argc++] = const_cast<char *>("-display");
467 argv[argc++] = x11_display;
472 QVLCApp app( argc, argv );
474 p_intf->p_sys->p_app = &app;
477 /* All the settings are in the .conf/.ini style */
478 p_intf->p_sys->mainSettings = new QSettings(
480 QSettings::IniFormat,
482 QSettings::NativeFormat,
484 QSettings::UserScope, "vlc", "vlc-qt-interface" );
486 /* Icon setting, Mac uses icon from .icns */
488 if( QDate::currentDate().dayOfYear() >= QT_XMAS_JOKE_DAY && var_InheritBool( p_intf, "qt-icon-change" ) )
489 app.setWindowIcon( QIcon(vlc_xmas_xpm) );
491 app.setWindowIcon( QIcon(vlc_xpm) );
494 /* Initialize timers and the Dialog Provider */
495 DialogsProvider::getInstance( p_intf );
497 /* Detect screensize for small screens like TV or Netbooks */
498 p_intf->p_sys->i_screenHeight =
499 app.QApplication::desktop()->availableGeometry().height();
502 /* Checking for VLC updates */
503 if( var_InheritBool( p_intf, "qt-updates-notif" ) &&
504 !var_InheritBool( p_intf, "qt-privacy-ask" ) )
506 int interval = var_InheritInteger( p_intf, "qt-updates-days" );
507 if( QDate::currentDate() >
508 getSettings()->value( "updatedate" ).toDate().addDays( interval ) )
510 /* The constructor of the update Dialog will do the 1st request */
511 UpdateDialog::getInstance( p_intf );
512 getSettings()->setValue( "updatedate", QDate::currentDate() );
517 /* Create the normal interface in non-DP mode */
518 if( !p_intf->p_sys->b_isDialogProvider )
520 p_mi = new MainInterface( p_intf );
521 p_intf->p_sys->p_mi = p_mi;
526 /* Explain how to show a dialog :D */
527 p_intf->pf_show_dialog = ShowDialog;
529 /* Tell the main LibVLC thread we are ready */
530 vlc_sem_post (&ready);
533 /* We took over main thread, register and start here */
534 if( !p_intf->p_sys->b_isDialogProvider )
536 RegisterIntf( (vlc_object_t *)p_intf );
537 playlist_Play( THEPL );
542 if( p_intf->p_sys->b_isDialogProvider )
543 app.setQuitOnLastWindowClosed( false );
545 app.setQuitOnLastWindowClosed( true );
547 /* Retrieve last known path used in file browsing */
548 p_intf->p_sys->filepath =
549 getSettings()->value( "filedialog-path", QVLCUserDir( VLC_HOME_DIR ) ).toString();
551 /* Loads and tries to apply the preferred QStyle */
552 QString s_style = getSettings()->value( "MainWindow/QtStyle", "" ).toString();
553 if( s_style.compare("") != 0 )
554 QApplication::setStyle( s_style );
559 msg_Dbg( p_intf, "QApp exec() finished" );
562 QMutexLocker locker (&lock);
565 p_intf->p_sys->p_mi = NULL;
566 /* Destroy first the main interface because it is connected to some
567 slots in the MainInputManager */
571 /* Destroy all remaining windows,
572 because some are connected to some slots
573 in the MainInputManager
574 Settings must be destroyed after that.
576 DialogsProvider::killInstance();
578 /* Delete the recentsMRL object before the configuration */
579 RecentsMRL::killInstance();
582 getSettings()->setValue( "filedialog-path", p_intf->p_sys->filepath );
584 /* Delete the configuration. Application has to be deleted after that. */
585 delete p_intf->p_sys->mainSettings;
587 /* Destroy the MainInputManager */
588 MainInputManager::killInstance();
590 /* Delete the application automatically */
594 /*****************************************************************************
595 * Callback to show a dialog
596 *****************************************************************************/
597 static void ShowDialog( intf_thread_t *p_intf, int i_dialog_event, int i_arg,
598 intf_dialog_args_t *p_arg )
600 VLC_UNUSED( p_intf );
601 DialogEvent *event = new DialogEvent( i_dialog_event, i_arg, p_arg );
602 QApplication::postEvent( THEDP, event );
606 * Video output window provider
608 * TODO move it out of here ?
610 #include <vlc_vout_window.h>
612 static int WindowControl( vout_window_t *, int i_query, va_list );
614 static int WindowOpen( vlc_object_t *p_obj )
616 vout_window_t *p_wnd = (vout_window_t*)p_obj;
619 if( p_wnd->cfg->is_standalone )
621 #if defined (Q_WS_X11)
622 if( var_InheritBool( p_obj, "video-wallpaper" ) )
627 if( var_Inherit( p_obj, "qt4-iface", VLC_VAR_ADDRESS, &val ) )
628 val.p_address = NULL;
630 intf_thread_t *p_intf = (intf_thread_t *)val.p_address;
633 { /* If another interface is used, this plugin cannot work */
634 msg_Dbg( p_obj, "Qt4 interface not found" );
638 QMutexLocker locker (&lock);
639 if (unlikely(!active))
642 MainInterface *p_mi = p_intf->p_sys->p_mi;
643 msg_Dbg( p_obj, "requesting video..." );
645 int i_x = p_wnd->cfg->x;
646 int i_y = p_wnd->cfg->y;
647 unsigned i_width = p_wnd->cfg->width;
648 unsigned i_height = p_wnd->cfg->height;
650 #if defined (Q_WS_X11)
651 p_wnd->handle.xid = p_mi->getVideo( &i_x, &i_y, &i_width, &i_height );
652 if( !p_wnd->handle.xid )
654 p_wnd->display.x11 = x11_display;
656 #elif defined (Q_WS_WIN)
657 p_wnd->handle.hwnd = p_mi->getVideo( &i_x, &i_y, &i_width, &i_height );
658 if( !p_wnd->handle.hwnd )
661 #elif defined (Q_WS_MAC)
662 p_wnd->handle.nsobject = (void *)p_mi->getVideo( &i_x, &i_y, &i_width, &i_height );
663 if( !p_wnd->handle.nsobject )
669 p_wnd->control = WindowControl;
670 p_wnd->sys = (vout_window_sys_t*)p_mi;
674 static int WindowControl( vout_window_t *p_wnd, int i_query, va_list args )
676 MainInterface *p_mi = (MainInterface *)p_wnd->sys;
677 QMutexLocker locker (&lock);
679 if (unlikely(!active))
681 msg_Warn (p_wnd, "video already released before control");
684 return p_mi->controlVideo( i_query, args );
687 static void WindowClose( vlc_object_t *p_obj )
689 vout_window_t *p_wnd = (vout_window_t*)p_obj;
690 MainInterface *p_mi = (MainInterface *)p_wnd->sys;
691 QMutexLocker locker (&lock);
693 /* Normally, the interface terminates after the video. In the contrary, the
694 * Qt4 main loop is gone, so we cannot send any event to the user interface
695 * widgets. Ideally, we would keep the Qt4 main loop running until after
696 * the video window is released. But it is far simpler to just have the Qt4
697 * thread destroy the window early, and to turn this function into a stub.
699 * That assumes the video output will behave sanely if it window is
700 * destroyed asynchronously.
701 * XCB and Xlib-XCB are fine with that. Plain Xlib wouldn't, */
702 if (unlikely(!active))
704 msg_Warn (p_obj, "video already released");
707 msg_Dbg (p_obj, "releasing video...");
708 p_mi->releaseVideo();