git.sesse.net Git - vlc/blob - src/misc/variables.h

   1 /*****************************************************************************
   2  * variables.h: object variables typedefs
   3  *****************************************************************************
   4  * Copyright (C) 1999-2012 VLC authors and VideoLAN
   5  *
   6  * Authors: Samuel Hocevar <sam@zoy.org>
   7  *
   8  * This program is free software; you can redistribute it and/or modify it
   9  * under the terms of the GNU Lesser General Public License as published by
  10  * the Free Software Foundation; either version 2.1 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16  * GNU Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public License
  19  * along with this program; if not, write to the Free Software Foundation,
  20  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  21  *****************************************************************************/
  22
  23 #ifndef LIBVLC_VARIABLES_H
  24 # define LIBVLC_VARIABLES_H 1
  25
  26 # include <vlc_atomic.h>
  27
  28 /**
  29  * Private LibVLC data for each object.
  30  */
  31 typedef struct vlc_object_internals vlc_object_internals_t;
  32
  33 struct vlc_object_internals
  34 {
  35     char           *psz_name; /* given name */
  36
  37     /* Object variables */
  38     void           *var_root;
  39     vlc_mutex_t     var_lock;
  40     vlc_cond_t      var_wait;
  41
  42     /* Objects thread synchronization */
  43     int             pipes[2];
  44
  45     /* Objects management */
  46     atomic_uint     refs;
  47     vlc_destructor_t pf_destructor;
  48
  49     /* Objects tree structure */
  50     vlc_object_internals_t *next;  /* next sibling */
  51     vlc_object_internals_t *prev;  /* previous sibling */
  52     vlc_object_internals_t *first; /* first child */
  53 };
  54
  55 # define vlc_internals( obj ) (((vlc_object_internals_t*)(VLC_OBJECT(obj)))-1)
  56 # define vlc_externals( priv ) ((vlc_object_t *)((priv) + 1))
  57
  58
  59 typedef struct callback_entry_t callback_entry_t;
  60
  61 typedef struct variable_ops_t
  62 {
  63     int  (*pf_cmp) ( vlc_value_t, vlc_value_t );
  64     void (*pf_dup) ( vlc_value_t * );
  65     void (*pf_free) ( vlc_value_t * );
  66 } variable_ops_t;
  67
  68 /**
  69  * The structure describing a variable.
  70  * \note vlc_value_t is the common union for variable values
  71  */
  72 struct variable_t
  73 {
  74     char *       psz_name; /**< The variable unique name (must be first) */
  75
  76     /** The variable's exported value */
  77     vlc_value_t  val;
  78
  79     /** The variable display name, mainly for use by the interfaces */
  80     char *       psz_text;
  81
  82     const variable_ops_t *ops;
  83
  84     int          i_type;   /**< The type of the variable */
  85     unsigned     i_usage;  /**< Reference count */
  86
  87     /** If the variable has min/max/step values */
  88     vlc_value_t  min, max, step;
  89
  90     /** Index of the default choice, if the variable is to be chosen in
  91      * a list */
  92     int          i_default;
  93     /** List of choices */
  94     vlc_list_t   choices;
  95     /** List of friendly names for the choices */
  96     vlc_list_t   choices_text;
  97
  98     /** Set to TRUE if the variable is in a callback */
  99     bool   b_incallback;
 100
 101     /** Number of registered callbacks */
 102     int                i_entries;
 103     /** Array of registered callbacks */
 104     callback_entry_t * p_entries;
 105 };
 106
 107 extern void var_DestroyAll( vlc_object_t * );
 108
 109 #endif