readme

xmms-1.2.10.tar.gz学习使用的就下吧

                          preset files.

3.4 Menu
--------

There are several menu hot spots on the XMMS window. One place is at the left
hand side of the visual window described in sections 3.1 If you click the right
mouse button in the main window, the menus will also pop up (same as clicking
the button on the top left corner).

3.5 Preferences
---------------

Use the menu to open Options / Preferences or press CTRL-P to bring the
preferences dialog up.

The first three tabs are for different types of plugins, the plugins specific
configuration and usage will be explained in the plugins section of this
manual.

3.5.1 Audio I/O Plugins
-----------------------

In the 'Audio I/O' tab you control the heart of XMMS, which would be the Input
and Output plugins.

In the 'Input plugins' part you can disable/enable and configure the available
plugins. The list box displays the name of the plugin, it's file name and
'(disabled)' if you have disabled the plugin.

The 'Output Plugin' is where you tell XMMS how it should play the audio back.
Today you can only have one 'Output Plugin' active at a time. So you can't
both listen to the music through the 'OSS Driver' and save the music to disk
with 'Disk Writer'.

3.5.2 Effect Plugins
--------------------

Effect plugins can alter the sound in different ways.

3.5.3 General Plugins
---------------------

General plugins are mostly for controling XMMS.

3.5.3 Visualization Plugins
---------------------------

The 'Visualization' tab controls which visual effects you want to see when XMMS
is playing your music. See section 3.6.5 for the plugins shipped with XMMS.


3.5.4 Options
-------------

Here you change most of XMMS's behavior and settings.

'Read info on'
   tells XMMS when to load the information from the files in your playlist.
   'Demand' will load the information when the files are visible in the
   playlist. 'Load' will load the information when you add the file to the
   playlist. Having 'Load' turned on when loading a 6000 song playlist might
   not be a good idea. If both options are turned off XMMS will only load
   the information when the song is currently playing.

'Convert %20 to space'
   This will convert "%20" to " " when the filename is displayed in the
   playlist. (%20 is what browsers use instead of space)

'Convert underscore to space'
   This will display " " instead of "_" in the playlist.

'Dim titlebar when inactive'
   Will tell XMMS to use the dimmed titlebar from the current skin when
   the window is inactive.

'Sort "jump to file" alphabetical'
   Will sort the 'Jump to file' dialog (available by pressing "j") in
   alphabetical order instead of the order it's in the playlist.

'Use realtime priority when available'
   This works only if XMMS is run as root or is setuid as root. It will allow
   XMMS to get all the CPU power it needs, and can greatly improve the playback
   on slower systems. NOTE: The 'Disk Writer' plugin will NOT work with this
   option enabled, also you need to restart XMMS in order for this to make a
   change.

'Pause between song for [ ] seconds'
   Will make a defined pause between each song.

'Show windowmanager decorations'
   Enables the windowmanager borders around XMMS.

'Mouse Wheel adjust Volume by (%)'
   If you have a mouse with a wheel, you can change how much of the volume to
   be changed when you move it up or down.

'Allow multiple instances'
  This will allow you to start more than one XMMS. You have to quit XMMS
  before this change takes effect.

'Always show clutterbar'
   Will make the OAIDV part of the main window to be displayed all the time.

'Save window positions'
   Will save the main window's position on the screen instead of letting the
   windowmanager choose location.

'Show numbers in playlist'
   Enables the display of the internal track number in the playlist.

'Equalizer doublesize linked'
   Will display the Equalizer in doublesize if you make XMMS doublesize.

'Smooth title scroll'
   Makes the title scroll go smoother.

'Snap window at [ ] pixels'
   Tells XMMS how close you can position the three windows until they dock /
   snap together with each other.

'Use "\" as a directory delimiter'
   This will come in handy if you are using playlist files from a windows
   player, so XMMS will treat \ as /.

'Use meta data in playlists'
   When enabled, all playlists will be saved with the configured 'Title'
   string for quick loading of information when you load a playlist.


3.5.5 Fonts
-----------

Here you can change the fonts XMMS use.

'Use fontsets'
   Will enable the usage of multi-byte charsets.

'Playlist'
   Let's you choose what font XMMS should use for the playlist.

'Use X font'
   Makes XMMS use a font for the scrolling title in the main window.


3.5.6 Title
-----------

The 'Title format:' box allows you to alter in which order the information
about the current song is displayed.

Example: %p - %t (%a) [%y]
will display something like "Laibach - Alle Gegen Alle (Nato) [1994]"

available fields are:

%p - Artist          (ex: Laibach)
%a - Album           (ex: Nato)
%g - Genre           (ex: Electronic)
%f - File name       (ex: laibach-allegegenalle)
%F - File path       (ex: /home/thomas/mp3)
%e - File extension  (ex: mp3)

%t - Track name      (ex: Alle Gegen Alle)
%n - Track number    (ex: 6)
%d - Date            (ex: ???)
%y - Year            (ex: 1994)
%c - Comment         (ex: Cover of D.A.F)

These fields makes use of normal printf(3) formatting codes.

Examples:
  %0.3n    Will pad the track number with 0's until it's 3 chars long.


3.6 Plugins
-----------
Plugins is what makes XMMS work, by moving most of the code out of XMMS and
into a plugin architecture it's possible to change almost everything in XMMS.
There are today 5 different types of plugins. Only a few plugins are
distributed with XMMS, you can find a lot more on http://www.xmms.org/


3.6.1 Input plugins
-------------------
The input plugins is what you use to play mp3, mod, wav and even movies with.


3.6.1.1 Cd Audio Player
-----------------------
Before I explain the usage we better have a look on the configuration
first.

Device tab
----------

Device:
	Device
		The actual device of your CD-ROM unit. On my system
		I use /dev/cdrom which is a symlink to /dev/hdc.
			
	Directory
		This is where XMMS will "hijack" the filerequester and present
		the content of the CD. On my system I have it set to
		/mnt/cdrom, but if you're using some sort of automounter or
		simmilar I suggest you change it to something like
		/mnt/audio_cd and make sure the directory exists.

Play mode:
	Analog
		Analog playback requires that you have a cable connected
		between the CD-ROM and the soundcard. Also it will not be
		passed through any effect or visualization plugins.

	Digital audio extraction
		This allows XMMS to pass the sounddata through the effect and
		visualization plugins. 

Volume control:
	This section is only active when you're using analog playback.
	
	No mixer
		You can't control the volume at all.
		
	CDROM drive
		The volume is controled directly on the CDROM, not all drives
		support this though.
	OSS mixer
		The volume is controled through the OSS mixer

Check drive:
	Makes a rudimentary check if everything is properly configured.

Remove drive:
	If you have more than 1 drives configured this will remove the current
	one.

Add drive:
	If you have more than 1 drives on your system you can add another to
	the plugin settings.


CD Info tab
-----------

CDDB:
	CDDB is used to get track information for your CD from a CDDB
	compatible database.

	You can set the enviroment variable "XMMS_CDDB_CLIENT_NAME" to change
	how XMMS presents itself to the CDDB server. Default value is
	"XMMS 1.2.8"
	
	Use CDDB:
		Enable CDDB use.
		
	Show network window:
		Will open up a window containing useful debug information when
		XMMS tries to do a CDDB lookup. 
		
	Get server list:
		Press this button to get a list of alternative servers from the
		server you've configured below.
	
	CDDB server:
		The CDDB server XMMS will use, default is 'freedb.freedb.org'
	
Track names:

	Override generic titles:
		By enabling this, the plugin will ignore the 'Title' settings
		from XMMS (section 3.5.6).
	
	Name format:
		Works as explained in section 3.5.6 but you only have 4
		available variables.

		%p = Performer/Artist   %t = Track name
		%a = Album              %n = Track number

Using the CD Audio Player plugin
--------------------------------

Now to add your CDROM tracks to the playlist. Insert an audio cd into the
CDROM drive and press the Eject button. Go to the directory which you defined
earlier ( /mnt/cdrom ) and you should see a list of tracks. They will be named
Track XX.cda, select the tracks you want to play and press OK. If you had
choosed an Internet database and the CD exists in it, XMMS will now display
the tracks you have chosen with their names according to the 'Name format'
configuration.

Now, that wasn't hard now was it?


3.6.1.2 Mikmod player
---------------------
This plugin will play a numerous older "module" formats supported by
the MikMod library (libmikmod). MikMod can be found at
http://www.ibiblio.org/pub/linux/apps/sound/libs/ and you'll need
3.1.6 or better to be able to build this plugin.

In the first configuration tab you can choose in which quality mikmod
should play the modules. If you have an older soundcard you might want to
change the defaults to match your card. If the modules are played in what
seems to be half speed change 'Resolution' to 8 bit.

In the 'Options' tab you have five options. 'Look for hidden patterns in
modules' can be used to play "patterns" which exist in the modules, but
wouldn't be called when played. (Since most module formats decide on a
pattern basis which the next pattern should be, you can "hide" smaller tunes
within a larger module.)

'Use surround mixing' will as hinted turn on some mixing that gives you an
surround effect. This is however only usable if you're playing the module
in stereo.

'Force volume fade...' will fade out the music when the modules reaches
it's end.

'Use interpolation' can enhance the sound of the samples contained in the
modules, unless you're really out for that old crispy retro feeling. :)

'Default panning separation' "The original Amiga formats had an implicit
channel allocation (because the Amiga's hardware had same), 100% left or 100%
right depending on the track number (left right right left, or right left left
right, I forget). That sounded OK when they were written because most monitors
had only a single speaker, and the flash monitors didn't separate the speakers
more than about a foot, but when you try something like that with your speakers
in opposite corners of the room it drives you to distraction. That control
lessens the annoyance for file formats that don't specify the balance."

- Simon Hosie


3.6.1.3 MPEG Layer 1/2/3 player
-------------------------------
The main reason why this player exists today is mp3 files, so what could be
better than a plugin that plays them?.

It's based off the mpg123 engine and handles MPEG Layer 1/2/3 files and
VBR (variable bit rate) MP3 files.

The first configuration tab is just like the MikMod one, and again, if you
have an older soundcard and the music is going half speed, change the
'Resolution' setting.

In the 'Options' section you can tell XMMS how to handle the files you feed it.
You can tell the plugin to dectect files by extension, content and both. The
reason why this option exists is to make XMMS less demanding when you add a lot
of MP3 files with the extension .mp3. If you use both then XMMS will first look
at the extension and then try to detect by content. This is useful if you have
CDs with music that aren't correctly named.

In the streaming tab you can choose a 'Buffer size' in kilobytes which XMMS
will keep while streaming. This ranges from 4 -> 4096kb (which should be
sufficient for most people. The 'Pre-buffer' value is how much of the buffer
XMMS should fill before starting to play the stream. (0%-90%)

I'll let Chad Armstrong describe the two following options.

"As streaming becomes more popular, there is rising demand for better
information about the current track being played. This 'Now Playing'
information (also known as 'Title Streaming') allows for more information to be
passed back to the listener. In the past, there was a method started by the
Shoutcast group, which embedded this information in the stream itself. The mp3
standard was never designed to allow for text information to be interleaved
with audio data, and it is this design which can cause errors in playback. The
Icecast Team has taken this data completely out of the mp3 data, and has
provided it in a side channel (via UDP)."

- Chad Armstrong (icemonk)

You're better off having both these options enabled. :)

In the 'Title' tab you can change the way XMMS presents the mp3 files to the
playlist.

ID3 is data stored in the mp3 file and can include Artist, Album etc. If you
uncheck 'Use ID3 tags' XMMS will display the filename instead of the ID3
information.

ID3V2 allows for a lot of extra data to be stored in the mp3 file, and don't
suffer from the limitations of ID3V1, XMMS supports the same data that are
available in ID3V1 but not the extra data. If a mp3 file contains both ID3V1
and ID3V2 tags, you might see something different that the 'file info' editor
displays. If this happens, you might want to turn on 'Disable ID3V2 tags'.

'Override generic titles' is used if you do not want to use the generic titles
defined in the preferences. See section 3.5.6.

The 'ID3 format:' box allows you to alter in which order the information about
the current song is displayed.

Example: %p - %t (%a) [%y]
will display something like "Laibach - Alle Gegen Alle (Nato) [1994]"

available fields are:

%p - Artist          (ex: Laibach)
%a - Album           (ex: Nato)
%f - File name       (ex: laibach-allegegenalle)
%F - File path       (ex: /home/thomas/mp3)
%e - File extension  (ex: mp3)

%t - Track name      (ex: Alle Gegen Alle)
%n - Track number    (ex: 6)
%y - Year            (ex: 1994)
%g - Genre           (ex: Electronic)
%c - Comment         (ex: Cover of D.A.F)


3.6.1.4 Tone Generator
----------------------
Will generate a sinus tone or a mix of several sinus tones. To use it add a
URL: tone://frequency1;frequency2;frequency3;...