git.sesse.net Git - vlc/blob - modules/access/vcdx/vcd.c

   1 /*****************************************************************************
   2  * vcd.c : VCD input module for vlc
   3  *****************************************************************************
   4  * Copyright (C) 2000, 2003, 2004, 2005 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Rocky Bernstein <rocky@panix.com>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * top-level module code - handles options, shortcuts, loads sub-modules.
  26  *****************************************************************************/
  27
  28 /*****************************************************************************
  29  * Preamble
  30  *****************************************************************************/
  31
  32 #ifdef HAVE_CONFIG_H
  33 # include "config.h"
  34 #endif
  35
  36 #include <vlc/vlc.h>
  37
  38 /*****************************************************************************
  39  * Exported prototypes
  40  *****************************************************************************/
  41 int  VCDOpen       ( vlc_object_t * );
  42 void VCDClose      ( vlc_object_t * );
  43 int  VCDOpenIntf   ( vlc_object_t * );
  44 void VCDCloseIntf  ( vlc_object_t * );
  45 int  E_(VCDInit)   ( vlc_object_t * );
  46 void E_(VCDEnd)    ( vlc_object_t * );
  47
  48 int  E_(DebugCallback) ( vlc_object_t *p_this, const char *psz_name,
  49                          vlc_value_t oldval, vlc_value_t val,
  50                          void *p_data );
  51
  52 int  E_(BlocksPerReadCallback) ( vlc_object_t *p_this, const char *psz_name,
  53                  vlc_value_t oldval, vlc_value_t val,
  54                  void *p_data );
  55
  56 /*****************************************************************************
  57  * Option help text
  58  *****************************************************************************/
  59
  60 #define DEBUG_LONGTEXT \
  61     "This integer when viewed in binary is a debugging mask\n" \
  62     "meta info         1\n" \
  63     "event info        2\n" \
  64     "MRL               4\n" \
  65     "external call     8\n" \
  66     "all calls (10)   16\n" \
  67     "LSN       (20)   32\n" \
  68     "PBC       (40)   64\n" \
  69     "libcdio   (80)  128\n" \
  70     "seek-set (100)  256\n" \
  71     "seek-cur (200)  512\n" \
  72     "still    (400) 1024\n" \
  73     "vcdinfo  (800) 2048\n"
  74
  75 #define VCD_TITLE_FMT_LONGTEXT \
  76 "Format used in the GUI Playlist Title. Similar to the Unix date \n" \
  77 "Format specifiers that start with a percent sign. Specifiers are: \n" \
  78 "   %A : The album information\n" \
  79 "   %C : The VCD volume count - the number of CDs in the collection\n" \
  80 "   %c : The VCD volume num - the number of the CD in the collection.\n" \
  81 "   %F : The VCD Format, e.g. VCD 1.0, VCD 1.1, VCD 2.0, or SVCD\n" \
  82 "   %I : The current entry/segment/playback type, e.g. ENTRY, TRACK, SEGMENT...\n" \
  83 "   %L : The playlist ID prefixed with \" LID\" if it exists\n" \
  84 "   %N : The current number of the %I - a decimal number\n" \
  85 "   %P : The publisher ID\n" \
  86 "   %p : The preparer ID\n" \
  87 "   %S : If we are in a segment (menu), the kind of segment\n" \
  88 "   %T : The MPEG track number (starts at 1)\n" \
  89 "   %V : The volume set ID\n" \
  90 "   %v : The volume ID\n" \
  91 "       A number between 1 and the volume count.\n" \
  92 "   %% : a % \n"
  93
  94 /*****************************************************************************
  95  * Module descriptor
  96  *****************************************************************************/
  97
  98 vlc_module_begin();
  99     set_shortname( _("(Super) Video CD"));
 100     set_description( _("Video CD (VCD 1.0, 1.1, 2.0, SVCD, HQVCD) input") );
 101     add_usage_hint( N_("vcdx://[device-or-file][@{P,S,T}num]") );
 102     add_shortcut( "vcdx" );
 103     set_category( CAT_INPUT );
 104     set_subcategory( SUBCAT_INPUT_ACCESS );
 105     set_capability( "access", 55 /* slightly lower than vcd */ );
 106     set_callbacks( VCDOpen, VCDClose );
 107
 108     /* Configuration options */
 109     add_integer ( MODULE_STRING "-debug", 0, NULL,
 110                   N_("If nonzero, this gives additional debug information."),
 111                   DEBUG_LONGTEXT, true );
 112
 113     add_integer ( MODULE_STRING "-blocks-per-read", 20,
 114           NULL,
 115                   N_("Number of CD blocks to get in a single read."),
 116                   N_("Number of CD blocks to get in a single read."),
 117           true );
 118
 119     add_bool( MODULE_STRING "-PBC", 0, NULL,
 120               N_("Use playback control?"),
 121               N_("If VCD is authored with playback control, use it. "
 122                  "Otherwise we play by tracks."),
 123               false );
 124
 125     add_bool( MODULE_STRING "-track-length", true,
 126           NULL,
 127               N_("Use track length as maximum unit in seek?"),
 128               N_("If set, the length of the seek bar is the track rather than "
 129          "the length of an entry."),
 130               false );
 131
 132     add_bool( MODULE_STRING "-extended-info", 0, NULL,
 133               N_("Show extended VCD info?"),
 134               N_("Show the maximum amount of information under Stream and "
 135                  "Media Info. Shows for example playback control navigation."),
 136               false );
 137
 138     add_string( MODULE_STRING "-author-format",
 139                 "%v - %F disc %c of %C",
 140                 NULL,
 141                 N_("Format to use in the playlist's \"author\" field."),
 142                 VCD_TITLE_FMT_LONGTEXT, true );
 143
 144     add_string( MODULE_STRING "-title-format",
 145                 "%I %N %L%S - %M %A %v - disc %c of %C %F",
 146                 NULL,
 147                 N_("Format to use in the playlist's \"title\" field."),
 148                 VCD_TITLE_FMT_LONGTEXT, false );
 149
 150 vlc_module_end();
 151