git.sesse.net Git - vlc/blob - modules/access/vcdx/vcdplayer.h

   1 /*****************************************************************************
   2  * Copyright (C) 2003, 2004 Rocky Bernstein (for VideoLAN)
   3  * $Id$
   4  *
   5  * Authors: Rocky Bernstein <rocky@panix.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program; if not, write to the Free Software
  19  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  20  *****************************************************************************/
  21
  22 /* VCD Player header. More or less media-player independent. Or at least
  23    that is the goal. So we prefer bool to vlc_bool.
  24  */
  25
  26 #ifndef _VCDPLAYER_H_
  27 #define _VCDPLAYER_H_
  28
  29 #include <libvcd/info.h>
  30 #include "vlc_meta.h"
  31
  32 #define INPUT_DBG_META        1 /* Meta information */
  33 #define INPUT_DBG_EVENT       2 /* input (keyboard/mouse) events */
  34 #define INPUT_DBG_MRL         4 /* MRL parsing */
  35 #define INPUT_DBG_EXT         8 /* Calls from external routines */
  36 #define INPUT_DBG_CALL       16 /* routine calls */
  37 #define INPUT_DBG_LSN        32 /* LSN changes */
  38 #define INPUT_DBG_PBC        64 /* Playback control */
  39 #define INPUT_DBG_CDIO      128 /* Debugging from CDIO */
  40 #define INPUT_DBG_SEEK      256 /* Seeks to set location */
  41 #define INPUT_DBG_SEEK_CUR  512 /* Seeks to find current location */
  42 #define INPUT_DBG_STILL    1024 /* Still-frame */
  43 #define INPUT_DBG_VCDINFO  2048 /* Debugging from VCDINFO */
  44
  45 #define INPUT_DEBUG 1
  46 #if INPUT_DEBUG
  47 #define dbg_print(mask, s, args...) \
  48    if (p_vcdplayer && p_vcdplayer->i_debug & mask) \
  49      msg_Dbg(p_access, "%s: "s, __func__ , ##args)
  50 #else
  51 #define dbg_print(mask, s, args...)
  52 #endif
  53
  54 #define LOG_ERR(args...)  msg_Err( p_access, args )
  55 #define LOG_WARN(args...) msg_Warn( p_access, args )
  56
  57 /*------------------------------------------------------------------
  58   General definitions and structures.
  59 ---------------------------------------------------------------------*/
  60
  61 #define VCDPLAYER_IN_STILL  65535
  62
  63 typedef struct {
  64   lsn_t  start_LSN; /* LSN where play item starts */
  65   size_t size;      /* size in sector units of play item. */
  66 } vcdplayer_play_item_info_t;
  67
  68 /*****************************************************************************
  69  * vcdplayer_t: VCD information
  70  *****************************************************************************/
  71 typedef struct vcdplayer_input_s
  72 {
  73   vcdinfo_obj_t *vcd;                   /* CD device descriptor */
  74
  75   /*------------------------------------------------------------------
  76     User-settable options
  77    --------------------------------------------------------------*/
  78   unsigned int i_debug;                 /* Debugging mask */
  79   unsigned int i_blocks_per_read;       /* number of blocks per read */
  80
  81   /*-------------------------------------------------------------
  82      Playback control fields
  83    --------------------------------------------------------------*/
  84   bool         in_still;                /* true if in still */
  85   int          i_lid;                   /* LID that play item is in. Implies
  86                                            PBC is on. VCDPLAYER_BAD_ENTRY if
  87                                            not none or not in PBC */
  88   PsdListDescriptor_t pxd;              /* If PBC is on, the relevant
  89                                             PSD/PLD */
  90   int          pdi;                     /* current pld index of pxd. -1 if
  91                                            no index*/
  92   vcdinfo_itemid_t play_item;           /* play-item, VCDPLAYER_BAD_ENTRY
  93                                            if none */
  94   vcdinfo_itemid_t loop_item;           /* Where do we loop back to?
  95                                            Meaningful only in a selection
  96                                            list */
  97   int          i_loop;                  /* # of times play-item has been
  98                                            played. Meaningful only in a
  99                                            selection list.              */
 100   track_t      i_track;                 /* current track number */
 101
 102   /*-----------------------------------
 103      location fields
 104    ------------------------------------*/
 105   lsn_t        i_lsn;                   /* LSN of where we are right now */
 106   lsn_t        end_lsn;                 /* LSN of end of current
 107                                            entry/segment/track. This block
 108                                            can be read (and is not one after
 109                                            the "end").
 110                                         */
 111   lsn_t        origin_lsn;              /* LSN of start of seek/slider */
 112   lsn_t        track_lsn;               /* LSN of start track origin of track
 113                                            we are in. */
 114   lsn_t        track_end_lsn;           /* LSN of end of current track (if
 115                                            entry). */
 116   lsn_t *      p_entries;               /* Entry points */
 117   lsn_t *      p_segments;              /* Segments */
 118   bool         b_valid_ep;              /* Valid entry points flag */
 119   bool         b_end_of_track;          /* If the end of track was reached */
 120
 121   /*--------------------------------------------------------------
 122     (S)VCD Medium information
 123    ---------------------------------------------------------------*/
 124
 125   char        *psz_source;              /* (S)VCD drive or image filename */
 126   bool         b_svd;                   /* true if we have SVD info */
 127   vlc_meta_t  *p_meta;
 128   track_t      i_tracks;                /* # of playable MPEG tracks. This is
 129                                            generally one less than the number
 130                                            of CD tracks as the first CD track
 131                                            is an ISO-9660 track and is not
 132                                            playable.
 133                                         */
 134   unsigned int i_segments;              /* # of segments */
 135   unsigned int i_entries;               /* # of entries */
 136   unsigned int i_lids;                  /* # of List IDs */
 137
 138   /* Tracks, segment, and entry information. The number of entries for
 139      each is given by the corresponding i_* field above.  */
 140   vcdplayer_play_item_info_t *track;
 141   vcdplayer_play_item_info_t *segment;
 142   vcdplayer_play_item_info_t *entry;
 143
 144   unsigned int i_titles;                /* # of navigatable titles. */
 145
 146   /*
 147      # tracks + menu for segments + menu for LIDs
 148    */
 149   input_title_t *p_title[CDIO_CD_MAX_TRACKS+2];
 150
 151   /* Probably gets moved into another structure...*/
 152   intf_thread_t *p_intf;
 153   int            i_audio_nb;
 154   int            i_still_time;
 155   bool           b_end_of_cell;
 156   input_thread_t *p_input;
 157   demux_t        *p_demux;
 158   access_t       *p_access;
 159
 160 } vcdplayer_t;
 161
 162 /* vcdplayer_read return status */
 163 typedef enum {
 164   READ_BLOCK,
 165   READ_STILL_FRAME,
 166   READ_ERROR,
 167   READ_END,
 168 } vcdplayer_read_status_t;
 169
 170
 171 /* ----------------------------------------------------------------------
 172    Function Prototypes
 173   -----------------------------------------------------------------------*/
 174
 175 /*!
 176   Return true if playback control (PBC) is on
 177 */
 178 bool vcdplayer_pbc_is_on(const vcdplayer_t *p_vcdplayer);
 179
 180 /*!
 181   Play item assocated with the "default" selection.
 182
 183   Return false if there was some problem.
 184 */
 185 bool vcdplayer_play_default( access_t * p_access );
 186
 187 /*!
 188   Play item assocated with the "next" selection.
 189
 190   Return false if there was some problem.
 191 */
 192 bool vcdplayer_play_next( access_t * p_access );
 193
 194 /*!
 195   Play item assocated with the "prev" selection.
 196
 197   Return false if there was some problem.
 198 */
 199 bool vcdplayer_play_prev( access_t * p_access );
 200
 201 /*!
 202   Play item assocated with the "return" selection.
 203
 204   Return false if there was some problem.
 205 */
 206 bool vcdplayer_play_return( access_t * p_access );
 207
 208 /*
 209    Set's start origin and size for subsequent seeks.
 210    input: p_vcd->i_lsn, p_vcd->play_item
 211    changed: p_vcd->origin_lsn, p_vcd->end_lsn
 212 */
 213 void vcdplayer_set_origin(access_t *p_access, lsn_t i_lsn, track_t i_track,
 214                           const vcdinfo_itemid_t *p_itemid);
 215
 216 void vcdplayer_play(access_t *p_access, vcdinfo_itemid_t itemid);
 217
 218 vcdplayer_read_status_t vcdplayer_read (access_t * p_access_t, uint8_t *p_buf);
 219
 220 #endif /* _VCDPLAYER_H_ */
 221 /*
 222  * Local variables:
 223  *  c-file-style: "gnu"
 224  *  tab-width: 8
 225  *  indent-tabs-mode: nil
 226  * End:
 227  */