git.sesse.net Git - vlc/blob - src/interface/dialog.c

   1 /*****************************************************************************
   2  * dialog.c: User dialog functions
   3  *****************************************************************************
   4  * Copyright © 2009 Rémi Denis-Courmont
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  19  *****************************************************************************/
  20
  21 /**
  22  * \file dialog.c
  23  * User dialogs core
  24  */
  25
  26 #ifdef HAVE_CONFIG_H
  27 # include "config.h"
  28 #endif
  29
  30 #include <stdarg.h>
  31
  32 #include <vlc_common.h>
  33 #include <vlc_dialog.h>
  34 #include <assert.h>
  35 #include "libvlc.h"
  36
  37 static vlc_mutex_t provider_lock = VLC_STATIC_MUTEX;
  38
  39 #undef dialog_Register
  40 /**
  41  * Registers an object as the dialog provider.
  42  * It is assumed that the appropriate variable callbacks are already
  43  * registered.
  44  */
  45 int dialog_Register (vlc_object_t *obj)
  46 {
  47     libvlc_priv_t *priv = libvlc_priv (obj->p_libvlc);
  48     int ret = VLC_EGENERIC;
  49
  50     vlc_mutex_lock (&provider_lock);
  51     if (priv->p_dialog_provider == NULL)
  52     {   /* Since the object is responsible for unregistering itself before
  53          * it terminates, at reference is not needed. */
  54         priv->p_dialog_provider = obj;
  55         ret = VLC_SUCCESS;
  56     }
  57     vlc_mutex_unlock (&provider_lock);
  58     return ret;
  59 }
  60
  61 #undef dialog_Unregister
  62 /**
  63  * Unregisters the dialog provider.
  64  * Note that unless you have unregistered the callbacks already, the provider
  65  * might still be in use by other threads. Also, you need to cancel all
  66  * pending dialogs yourself.
  67  */
  68 int dialog_Unregister (vlc_object_t *obj)
  69 {
  70     libvlc_priv_t *priv = libvlc_priv (obj->p_libvlc);
  71     int ret = VLC_EGENERIC;
  72
  73     vlc_mutex_lock (&provider_lock);
  74     if (priv->p_dialog_provider == obj)
  75     {
  76         priv->p_dialog_provider = NULL;
  77         ret = VLC_SUCCESS;
  78     }
  79     vlc_mutex_unlock (&provider_lock);
  80     return ret;
  81 }
  82
  83 static vlc_object_t *dialog_GetProvider (vlc_object_t *obj)
  84 {
  85     libvlc_priv_t *priv = libvlc_priv (obj->p_libvlc);
  86     vlc_object_t *provider;
  87
  88     vlc_mutex_lock (&provider_lock);
  89     if ((provider = priv->p_dialog_provider) != NULL)
  90         vlc_object_hold (provider);
  91     vlc_mutex_unlock (&provider_lock);
  92     return provider;
  93 }
  94
  95 static
  96 void dialog_FatalVa (vlc_object_t *obj, const char *title,
  97                      const char *fmt, va_list ap)
  98 {
  99     char *text;
 100
 101     vlc_object_t *provider = dialog_GetProvider (obj);
 102     if (provider == NULL)
 103     {
 104         msg_Err (obj, "%s", title);
 105         msg_GenericVa (obj, VLC_MSG_ERR, MODULE_STRING, fmt, ap);
 106         return;
 107     }
 108
 109     if (vasprintf (&text, fmt, ap) == -1)
 110         return;
 111
 112     dialog_fatal_t dialog = { title, text, };
 113     var_SetAddress (provider, "dialog-fatal", &dialog);
 114     free (text);
 115 }
 116
 117 #undef dialog_Fatal
 118 /**
 119  * Notify the user of some fatal error.
 120  * This is a fire and forget function.
 121  */
 122 void dialog_Fatal (vlc_object_t *obj, const char *title, const char *fmt, ...)
 123 {
 124     va_list ap;
 125
 126     va_start (ap, fmt);
 127     dialog_FatalVa (obj, title, fmt, ap);
 128     va_end (ap);
 129 }