Fixed input bookmark thread safety, support and event.

[vlc] / include / vlc_input.h

diff --git a/include/vlc_input.h b/include/vlc_input.h
index 55f39d79e1bad55d882b6cf44e65e237e168ac7d..f241d7df7ebf27d5075a286219bbf429cdcbc11b 100644 (file)
--- a/include/vlc_input.h
+++ b/include/vlc_input.h
@@ -435,35 +435,33 @@ struct input_thread_t
  * TODO complete the documentation.
  * The read only variables are:
  *  - "length"
- *  - "bookmarks"
- *  - "seekable (if you can seek, it doesn't say if 'bar display' has be shown FIXME rename can-seek
+ *  - "can-seek" (if you can seek, it doesn't say if 'bar display' has be shown
  *    or not, for that check position != 0.0)
  *  - "can-pause"
+ *  - "can-rate"
  *  - "can-rewind"
  *  - "can-record" (if a stream can be recorded while playing)
- *  - "teletext-es" to get the index of spu track that is teletext --1 if no teletext)
+ *  - "teletext-es" to get the index of spu track that is teletext -1 if no teletext)
+ *  - "signal-quality"
+ *  - "signal-strength"
  *
  * The read-write variables are:
  *  - state (\see input_state_e)
  *  - rate, rate-slower, rate-faster
  *  - position, position-offset
  *  - time, time-offset
- *  - title,title-next,title-prev
- *  - chapter,chapter-next, chapter-prev
+ *  - title, next-title, prev-title
+ *  - chapter, next-chapter, next-chapter-prev
  *  - program, audio-es, video-es, spu-es
  *  - audio-delay, spu-delay
- *  - bookmark
- *  - TODO add special titles variables
+ *  - bookmark (bookmark list)
+ *  - record
+ *  - frame-next
+ *  - navigation (list of "title %2i")
+ *  - "title %2i"
  *
  * The variable used for event is
  *  - intf-event (\see input_event_type_e)
- *
- * The legacy variable used for event are
- *  - intf-change
- *  - intf-change-vout
- *  - rate-change
- *  - stats-change
- * You are advised to change to intf-event as soon as possible.
  */
 
 /**
@@ -535,12 +533,13 @@ typedef enum input_event_type_e
     INPUT_EVENT_PROGRAM,
     /* A ES has been added or removed or selected */
     INPUT_EVENT_ES,
+    /* "teletext-es" has changed */
+    INPUT_EVENT_TELETEXT,
 
     /* "record" has changed */
     INPUT_EVENT_RECORD,
 
-    /* A vout has been created/deleted by *the input*
-     * FIXME some event are not detected yet (audio visualisation) */
+    /* A vout has been created/deleted by *the input* */
     INPUT_EVENT_VOUT,
 
     /* input_item_t media has changed */
@@ -560,6 +559,9 @@ typedef enum input_event_type_e
     /* "spu-delay" has changed */
     INPUT_EVENT_SUBTITLE_DELAY,
 
+    /* "bookmark" has changed */
+    INPUT_EVENT_BOOKMARK,
+
 } input_event_type_e;
 
 /** @}*/
@@ -617,11 +619,10 @@ enum input_query_e
     INPUT_ADD_OPTION,      /* arg1= char * arg2= char *  res=can fail*/
 
     /* Input properties */
-    INPUT_GET_BYTE_POSITION,     /* arg1= int64_t *       res=    */
-    INPUT_SET_BYTE_SIZE,         /* arg1= int64_t *       res=    */
     INPUT_GET_VIDEO_FPS,         /* arg1= double *        res=can fail */
 
     /* bookmarks */
+    INPUT_GET_BOOKMARK,    /* arg1= seekpoint_t *               res=can fail */
     INPUT_GET_BOOKMARKS,   /* arg1= seekpoint_t *** arg2= int * res=can fail */
     INPUT_CLEAR_BOOKMARKS, /* res=can fail */
     INPUT_ADD_BOOKMARK,    /* arg1= seekpoint_t *  res=can fail   */