vlc_config_cat.h
上传用户:kjfoods
上传日期:2020-07-06
资源大小:29949k
文件大小:12k
源码类别:

midi

开发平台:

Unix_Linux

  1. /*****************************************************************************
  2.  * vlc_config_cat.h : Definition of configuration categories
  3.  *****************************************************************************
  4.  * Copyright (C) 2003 the VideoLAN team
  5.  * $Id: f8686f8bc9f0bbc6bcb617a4b608bc08920adfda $
  6.  *
  7.  * Authors: Clément Stenac <zorglub@videolan.org>
  8.  *          Anil Daoud <anil@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
  21.  * along with this program; if not, write to the Free Software
  22.  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23.  *****************************************************************************/
  24. #ifndef VLC_HELP_H
  25. #define VLC_HELP_H 1
  26. /*
  27.  *  First, we need help strings for the General Settings and for the
  28.  *  Plugins screen
  29.  */
  30. #define MAIN_TITLE N_( "VLC preferences" )
  31. #define MAIN_HELP N_( 
  32.     "Select "Advanced Options" to see all options." )
  33. /* Interface */
  34. #define INTF_TITLE N_("Interface")
  35. #define INTF_HELP  N_( "Settings for VLC's interfaces" )
  36. #define INTF_GENERAL_HELP N_( "Main interfaces settings" )
  37. #define INTF_MAIN_TITLE  N_( "Main interfaces" )
  38. #define INTF_MAIN_HELP N_( "Settings for the main interface" )
  39. #define INTF_CONTROL_TITLE N_( "Control interfaces" )
  40. #define INTF_CONTROL_HELP N_( "Settings for VLC's control interfaces" )
  41. #define INTF_HOTKEYS_TITLE N_( "Hotkeys settings" )
  42. #define INTF_HOTKEYS_HELP N_( "Hotkeys settings" )
  43. /* Audio */
  44. #define AUDIO_TITLE N_( "Audio" )
  45. #define AUDIO_HELP N_( "Audio settings" )
  46. #define AUDIO_GENERAL_HELP N_("General audio settings")
  47. #define AFILTER_TITLE N_("Filters")
  48. #define AFILTER_HELP N_( "Audio filters are used to process the audio stream." )
  49. #define AVISUAL_TITLE N_("Visualizations")
  50. #define AVISUAL_HELP N_( "Audio visualizations" )
  51. #define AOUT_TITLE N_( "Output modules" )
  52. #define AOUT_HELP N_("General settings for audio output modules.")
  53. #define AMISC_TITLE N_("Miscellaneous")
  54. #define AMISC_HELP N_( "Miscellaneous audio settings and modules." )
  55. /* Video */
  56. #define VIDEO_TITLE N_("Video")
  57. #define VIDEO_HELP N_("Video settings")
  58. #define VIDEO_GENERAL_HELP N_( "General video settings" )
  59. #define _VOUT_TITLE N_("Output modules" )
  60. #define VOUT_HELP N_( 
  61.     "Choose your preferred video output and configure it here." )
  62. #define VFILTER_TITLE N_("Filters" )
  63. #define VFILTER_HELP N_( 
  64.     "Video filters are used to process the video stream." )
  65. #define SUBPIC_TITLE N_( "Subtitles/OSD")
  66. #define SUBPIC_HELP N_( "Settings related to On-Screen-Display,"
  67.         " subtitles and "overlay subpictures"")
  68. /*
  69. #define TEXT_TITLE N_("Text rendering")
  70. #define TEXT_HELP N_( 
  71.     "Use the settings of the "freetype" module to choose the font you " 
  72.     "want VLC to use for text rendering (to display subtitles for example).")
  73. */
  74. /* Input */
  75. #define INPUT_TITLE N_( "Input / Codecs" )
  76. #define INPUT_HELP N_( "Settings for input, demultiplexing, " 
  77.          "decoding and encoding")
  78. #define ACCESS_TITLE N_( "Access modules" )
  79. #define ACCESS_HELP N_( 
  80.     "Settings related to the various access methods. " 
  81.     "Common settings you may want to alter are HTTP proxy or " 
  82.     "caching settings." )
  83. #define STREAM_FILTER_TITLE N_( "Stream filters" )
  84. #define STREAM_FILTER_HELP N_( 
  85.     "Stream filters are special modules that allow advanced operations on " 
  86.     "the input side of VLC. Use with care..." )
  87. #define DEMUX_TITLE N_("Demuxers")
  88. #define DEMUX_HELP N_( "Demuxers are used to separate audio and video streams." )
  89. #define VDEC_TITLE  N_( "Video codecs" )
  90. #define VDEC_HELP N_( "Settings for the video-only decoders and encoders." )
  91. #define ADEC_TITLE  N_( "Audio codecs" )
  92. #define ADEC_HELP N_( "Settings for the audio-only decoders and encoders." )
  93. #define SDEC_TITLE N_( "Other codecs")
  94. #define SDEC_HELP N_( "Settings for audio+video and miscellaneous decoders and encoders." )
  95. #define ADVANCED_TITLE N_("General Input" )
  96. #define ADVANCED_HELP N_( "General input settings. Use with care..." )
  97. /* Sout */
  98. #define SOUT_TITLE N_( "Stream output" )
  99. #define SOUT_HELP N_( 
  100.       "Stream output settings are used when acting as a streaming server " 
  101.       "or when saving incoming streams.n" 
  102.       "Streams are first muxed and then sent through an "access output" "
  103.       "module that can either save the stream to a file, or stream " 
  104.       "it (UDP, HTTP, RTP/RTSP).n" 
  105.       "Sout streams modules allow advanced stream processing (transcoding, "
  106.       "duplicating...).")
  107. #define SOUT_GENERAL_HELP N_( "General stream output settings")
  108. #define SOUT_MUX_TITLE N_( "Muxers" )
  109. #define SOUT_MUX_HELP N_( 
  110.        "Muxers create the encapsulation formats that are used to " 
  111.        "put all the elementary streams (video, audio, ...) " 
  112.        "together. This setting allows you to always force a specific muxer. " 
  113.        "You should probably not do that.n" 
  114.        "You can also set default parameters for each muxer." )
  115. #define SOUT_ACO_TITLE N_( "Access output" )
  116. #define SOUT_ACO_HELP N_( 
  117.    "Access output modules control the ways the muxed streams are sent. " 
  118.    "This setting allows you to always force a specific access output method. " 
  119.    "You should probably not do that.n" 
  120.    "You can also set default parameters for each access output.")
  121. #define SOUT_PACKET_TITLE N_( "Packetizers" )
  122. #define SOUT_PACKET_HELP N_( 
  123.         "Packetizers are used to "preprocess" the elementary "
  124.         "streams before muxing. " 
  125.         "This setting allows you to always force a packetizer. " 
  126.         "You should probably not do that.n" 
  127.         "You can also set default parameters for each packetizer." )
  128. #define SOUT_STREAM_TITLE N_("Sout stream")
  129. #define SOUT_STREAM_HELP N_( "Sout stream modules allow to build a sout " 
  130.                 "processing chain. Please refer to the Streaming Howto for " 
  131.                 "more information. You can configure default options for " 
  132.                 "each sout stream module here.")
  133. #define SOUT_SAP_TITLE N_( "SAP" )
  134. #define SOUT_SAP_HELP N_( 
  135.                  "SAP is a way to publically announce streams that are being "
  136.                  "sent using multicast UDP or RTP." )
  137. #define SOUT_VOD_TITLE N_( "VOD" )
  138. #define SOUT_VOD_HELP N_( "VLC's implementation of Video On Demand" )
  139. /* Playlist */
  140. #define PLAYLIST_TITLE N_( "Playlist" )
  141. #define PLAYLIST_HELP N_( "Settings related to playlist behaviour " 
  142.         "(e.g. playback mode) and to modules that automatically add "
  143.         "items to the playlist ("service discovery" modules).")
  144. #define PGENERAL_HELP N_( "General playlist behaviour")
  145. #define SD_TITLE N_("Services discovery")
  146. #define SD_HELP N_("Services discovery modules are facilities "
  147.         "that automatically add items to playlist.")
  148. /* Advanced */
  149. #define AADVANCED_TITLE N_( "Advanced" )
  150. #define AADVANCED_HELP N_( "Advanced settings. Use with care...")
  151. #define CPU_TITLE N_( "CPU features" )
  152. #define CPU_HELP N_( "You can choose to disable some CPU accelerations " 
  153.         "here. Use with extreme care!" )
  154. #define MISC_TITLE N_( "Advanced settings" )
  155. /* OLD */
  156. #if 0
  157. #define NETWORK_TITLE N_( "Network" )
  158. #define NETWORK_HELP N_( "These modules provide network functions to all " 
  159.                 "other parts of VLC." )
  160. #define CHROMA_TITLE N_("Chroma modules settings")
  161. #define CHROMA_HELP N_("These settings affect chroma transformation modules.")
  162. #define PACKETIZER_TITLE  N_("Packetizer modules settings" )
  163. #define PACKETIZER_HELP "These are general settings for the "
  164.         "packetizers used in VLC's stream output subsystem."
  165. #define ENCODER_TITLE N_("Encoders settings")
  166. #define ENCODER_HELP N_( 
  167.     "These are general settings for video/audio/subtitles encoding modules.")
  168. #define DIALOGS_TITLE N_("Dialog providers settings")
  169. #define DIALOGS_HELP  N_( 
  170.     "Dialog providers can be configured here.")
  171. #define SUBTITLE_DEMUX_TITLE N_("Subtitle demuxer settings")
  172. #define SUBTITLE_DEMUX_HELP N_( 
  173.     "In this section you can force the behavior of the subtitle demuxer, " 
  174.     "for example by setting the subtitles type or file name.")
  175. /*
  176.  *  A little help for modules with unknown capabilities
  177.  */
  178. #define UNKNOWN_TITLE N_("No help available" )
  179. #define UNKNOWN_HELP N_("There is no help available for these modules.")
  180. #endif
  181. /* This function is deprecated and is kept only for compatibility */
  182. static const struct config_category_t categories_array[] =
  183. {
  184.     /* Interface */
  185.     { CAT_INTERFACE, INTF_TITLE, INTF_HELP },
  186.     { SUBCAT_INTERFACE_GENERAL, INTF_TITLE, INTF_GENERAL_HELP },
  187.     { SUBCAT_INTERFACE_MAIN, INTF_MAIN_TITLE, INTF_MAIN_HELP },
  188.     { SUBCAT_INTERFACE_CONTROL, INTF_CONTROL_TITLE, INTF_CONTROL_HELP },
  189.     { SUBCAT_INTERFACE_HOTKEYS, INTF_HOTKEYS_TITLE, INTF_HOTKEYS_HELP },
  190.     { CAT_AUDIO, AUDIO_TITLE, AUDIO_HELP },
  191.     { SUBCAT_AUDIO_GENERAL, AUDIO_TITLE, AUDIO_GENERAL_HELP },
  192.     { SUBCAT_AUDIO_AOUT, AOUT_TITLE, AOUT_HELP },
  193.     { SUBCAT_AUDIO_AFILTER, AFILTER_TITLE, AFILTER_HELP },
  194.     { SUBCAT_AUDIO_VISUAL, AVISUAL_TITLE, AVISUAL_HELP },
  195.     { SUBCAT_AUDIO_MISC, AMISC_TITLE, AMISC_HELP },
  196.     { CAT_VIDEO, VIDEO_TITLE, VIDEO_HELP },
  197.     { SUBCAT_VIDEO_GENERAL, VIDEO_TITLE, VIDEO_GENERAL_HELP },
  198.     { SUBCAT_VIDEO_VOUT, _VOUT_TITLE, VOUT_HELP },
  199.     { SUBCAT_VIDEO_VFILTER, VFILTER_TITLE, VFILTER_HELP },
  200.     { SUBCAT_VIDEO_SUBPIC, SUBPIC_TITLE, SUBPIC_HELP },
  201.     { CAT_INPUT, INPUT_TITLE, INPUT_HELP },
  202.     { SUBCAT_INPUT_GENERAL, INPUT_TITLE, INPUT_HELP },
  203.     { SUBCAT_INPUT_ACCESS, ACCESS_TITLE, ACCESS_HELP },
  204.     { SUBCAT_INPUT_DEMUX, DEMUX_TITLE, DEMUX_HELP },
  205.     { SUBCAT_INPUT_VCODEC, VDEC_TITLE, VDEC_HELP },
  206.     { SUBCAT_INPUT_ACODEC, ADEC_TITLE, ADEC_HELP },
  207.     { SUBCAT_INPUT_SCODEC, SDEC_TITLE, SDEC_HELP },
  208.     { SUBCAT_INPUT_STREAM_FILTER, STREAM_FILTER_TITLE, STREAM_FILTER_HELP },
  209.     { CAT_SOUT, SOUT_TITLE, SOUT_HELP },
  210.     { SUBCAT_SOUT_GENERAL, SOUT_TITLE, SOUT_GENERAL_HELP },
  211.     { SUBCAT_SOUT_STREAM, SOUT_STREAM_TITLE, SOUT_STREAM_HELP },
  212.     { SUBCAT_SOUT_MUX, SOUT_MUX_TITLE, SOUT_MUX_HELP },
  213.     { SUBCAT_SOUT_ACO, SOUT_ACO_TITLE, SOUT_ACO_HELP },
  214.     { SUBCAT_SOUT_PACKETIZER, SOUT_PACKET_TITLE, SOUT_PACKET_HELP },
  215.     { SUBCAT_SOUT_SAP, SOUT_SAP_TITLE, SOUT_SAP_HELP },
  216.     { SUBCAT_SOUT_VOD, SOUT_VOD_TITLE, SOUT_VOD_HELP },
  217.     { CAT_PLAYLIST, PLAYLIST_TITLE , PLAYLIST_HELP },
  218.     { SUBCAT_PLAYLIST_GENERAL, PLAYLIST_TITLE, PGENERAL_HELP },
  219.     { SUBCAT_PLAYLIST_SD, SD_TITLE, SD_HELP },
  220.     { CAT_ADVANCED, AADVANCED_TITLE, AADVANCED_HELP },
  221.     { SUBCAT_ADVANCED_CPU, CPU_TITLE, CPU_HELP },
  222.     { SUBCAT_ADVANCED_MISC, MISC_TITLE, AADVANCED_HELP },
  223.     { -1, NULL, NULL }
  224. };
  225. LIBVLC_USED
  226. static inline const char *config_CategoryNameGet( int i_value )
  227. {
  228.     int i = 0 ;
  229.     while( categories_array[i].psz_name != NULL )
  230.     {
  231.         if( categories_array[i].i_id == i_value )
  232.         {
  233.             return vlc_gettext(categories_array[i].psz_name);
  234.         }
  235.         i++;
  236.     }
  237.     return NULL;
  238. }
  239. LIBVLC_USED
  240. static inline const char *config_CategoryHelpGet( int i_value )
  241. {
  242.     int i = 0 ;
  243.     while( categories_array[i].psz_help != NULL )
  244.     {
  245.         if( categories_array[i].i_id == i_value )
  246.         {
  247.             return vlc_gettext(categories_array[i].psz_help);
  248.         }
  249.         i++;
  250.     }
  251.     return NULL;
  252. }
  253. #endif /* VLC_HELP_H */