git.sesse.net Git - vlc/blob - include/vlc/libvlc_events.h

   1 /*****************************************************************************
   2  * libvlc_events.h:  libvlc_events external API structure
   3  *****************************************************************************
   4  * Copyright (C) 1998-2010 the VideoLAN team
   5  * $Id $
   6  *
   7  * Authors: Filippo Carone <littlejohn@videolan.org>
   8  *          Pierre d'Herbemont <pdherbemont@videolan.org>
   9  *
  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.
  14  *
  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.
  19  *
  20  * You should have received a copy of the GNU General Public License along
  21  * with this program; if not, write to the Free Software Foundation, Inc.,
  22  * 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 #ifndef LIBVLC_EVENTS_H
  26 #define LIBVLC_EVENTS_H 1
  27
  28 /**
  29  * \file
  30  * This file defines libvlc_event external API
  31  */
  32
  33 # ifdef __cplusplus
  34 extern "C" {
  35 # endif
  36
  37 /*****************************************************************************
  38  * Events handling
  39  *****************************************************************************/
  40
  41 /** \defgroup libvlc_event libvlc_event
  42  * \ingroup libvlc_core
  43  * LibVLC Available Events
  44  * @{
  45  */
  46
  47     /* Append new event types at the end. Do not remove, insert or
  48      * re-order any entry. The cpp will prepend libvlc_ to the symbols. */
  49 #define DEFINE_LIBVLC_EVENT_TYPES \
  50     DEF( MediaMetaChanged ), \
  51     DEF( MediaSubItemAdded ), \
  52     DEF( MediaDurationChanged ), \
  53     DEF( MediaPreparsedChanged ), \
  54     DEF( MediaFreed ), \
  55     DEF( MediaStateChanged ), \
  56     \
  57     DEF( MediaPlayerNothingSpecial ), \
  58     DEF( MediaPlayerOpening ), \
  59     DEF( MediaPlayerBuffering ), \
  60     DEF( MediaPlayerPlaying ), \
  61     DEF( MediaPlayerPaused ), \
  62     DEF( MediaPlayerStopped ), \
  63     DEF( MediaPlayerForward ), \
  64     DEF( MediaPlayerBackward ), \
  65     DEF( MediaPlayerEndReached ), \
  66     DEF( MediaPlayerEncounteredError ), \
  67     DEF( MediaPlayerTimeChanged ), \
  68     DEF( MediaPlayerPositionChanged ), \
  69     DEF( MediaPlayerSeekableChanged ), \
  70     DEF( MediaPlayerPausableChanged ), \
  71     \
  72     DEF( MediaListItemAdded ), \
  73     DEF( MediaListWillAddItem ), \
  74     DEF( MediaListItemDeleted ), \
  75     DEF( MediaListWillDeleteItem ), \
  76     \
  77     DEF( MediaListViewItemAdded ), \
  78     DEF( MediaListViewWillAddItem ), \
  79     DEF( MediaListViewItemDeleted ), \
  80     DEF( MediaListViewWillDeleteItem ), \
  81     \
  82     DEF( MediaListPlayerPlayed ), \
  83     DEF( MediaListPlayerNextItemSet ), \
  84     DEF( MediaListPlayerStopped ), \
  85     \
  86     DEF( MediaDiscovererStarted ), \
  87     DEF( MediaDiscovererEnded ), \
  88     \
  89     DEF( MediaPlayerTitleChanged ), \
  90     DEF( MediaPlayerSnapshotTaken ), \
  91     DEF( MediaPlayerLengthChanged ), \
  92     \
  93     DEF( VlmMediaAdded ), \
  94     DEF( VlmMediaRemoved ), \
  95     DEF( VlmMediaChanged ), \
  96     DEF( VlmMediaInstanceStarted ), \
  97     DEF( VlmMediaInstanceStopped ), \
  98     DEF( VlmMediaInstanceStatusInit ), \
  99     DEF( VlmMediaInstanceStatusOpening ), \
 100     DEF( VlmMediaInstanceStatusPlaying ), \
 101     DEF( VlmMediaInstanceStatusPause ), \
 102     DEF( VlmMediaInstanceStatusEnd ), \
 103     DEF( VlmMediaInstanceStatusError ), \
 104     \
 105     DEF( MediaPlayerMediaChanged ), \
 106 /* New event types HERE */
 107
 108 #ifdef __cplusplus
 109 enum libvlc_event_type_e {
 110 #else
 111 enum libvlc_event_type_t {
 112 #endif
 113 #define DEF(a) libvlc_##a
 114     DEFINE_LIBVLC_EVENT_TYPES
 115     libvlc_num_event_types
 116 #undef  DEF
 117 };
 118
 119 /* Implementing libvlc_event_type_name() needs the definition too. */
 120 #ifndef LIBVLC_EVENT_TYPES_KEEP_DEFINE
 121 #undef  DEFINE_LIBVLC_EVENT_TYPES
 122 #endif
 123
 124 /**
 125  * An Event
 126  * \param type the even type
 127  * \param p_obj the sender object
 128  * \param u Event dependent content
 129  */
 130
 131 struct libvlc_event_t
 132 {
 133     libvlc_event_type_t type;
 134     void * p_obj;
 135     union event_type_specific
 136     {
 137         /* media descriptor */
 138         struct
 139         {
 140             libvlc_meta_t meta_type;
 141         } media_meta_changed;
 142         struct
 143         {
 144             libvlc_media_t * new_child;
 145         } media_subitem_added;
 146         struct
 147         {
 148             int64_t new_duration;
 149         } media_duration_changed;
 150         struct
 151         {
 152             int new_status;
 153         } media_preparsed_changed;
 154         struct
 155         {
 156             libvlc_media_t * md;
 157         } media_freed;
 158         struct
 159         {
 160             libvlc_state_t new_state;
 161         } media_state_changed;
 162
 163         /* media instance */
 164         struct
 165         {
 166             float new_position;
 167         } media_player_position_changed;
 168         struct
 169         {
 170             libvlc_time_t new_time;
 171         } media_player_time_changed;
 172         struct
 173         {
 174             int new_title;
 175         } media_player_title_changed;
 176         struct
 177         {
 178             int new_seekable;
 179         } media_player_seekable_changed;
 180         struct
 181         {
 182             int new_pausable;
 183         } media_player_pausable_changed;
 184
 185         /* media list */
 186         struct
 187         {
 188             libvlc_media_t * item;
 189             int index;
 190         } media_list_item_added;
 191         struct
 192         {
 193             libvlc_media_t * item;
 194             int index;
 195         } media_list_will_add_item;
 196         struct
 197         {
 198             libvlc_media_t * item;
 199             int index;
 200         } media_list_item_deleted;
 201         struct
 202         {
 203             libvlc_media_t * item;
 204             int index;
 205         } media_list_will_delete_item;
 206
 207         /* media list player */
 208         struct
 209         {
 210             libvlc_media_t * item;
 211         } media_list_player_next_item_set;
 212
 213         /* snapshot taken */
 214         struct
 215         {
 216              char* psz_filename ;
 217         } media_player_snapshot_taken ;
 218
 219         /* Length changed */
 220         struct
 221         {
 222             libvlc_time_t   new_length;
 223         } media_player_length_changed;
 224
 225         /* VLM media */
 226         struct
 227         {
 228             const char * psz_media_name;
 229             const char * psz_instance_name;
 230         } vlm_media_event;
 231
 232         /* Extra MediaPlayer */
 233         struct
 234         {
 235             libvlc_media_t * new_media;
 236         } media_player_media_changed;
 237     } u;
 238 };
 239
 240
 241 /**@} */
 242
 243 # ifdef __cplusplus
 244 }
 245 # endif
 246
 247 #endif /* _LIBVLC_EVENTS_H */