Mercurial > hg > xmms-sid

comparison README @ 256:42632e13d6b5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
More documentation about configuration.
author Matti Hamalainen <ccr@tnsp.org>
date Tue, 21 Dec 2004 21:44:00 +0000
parents d3a4d35f2a8f
children d7b7d49b52fe
comparison
equal deleted inserted replaced
255:d8f088079384 256:42632e13d6b5
64 - Memory mode: libSIDPlay supports several different memory modes 64 - Memory mode: libSIDPlay supports several different memory modes
65 for SID emulation, most of those are for compatibility, though. 65 for SID emulation, most of those are for compatibility, though.
66 For SIDPlay 2 emulation, select "Real C64" unless you know better. 66 For SIDPlay 2 emulation, select "Real C64" unless you know better.
67 For SIDPlay 1 emulation, select "Bank switching". 67 For SIDPlay 1 emulation, select "Bank switching".
68 68
69
69 Emu#2-tab 70 Emu#2-tab
70 --------- 71 ---------
71 - Clock Speed: Sets default clockspeed and can also "force" the 72 - Clock Speed: Sets default clockspeed and can also "force" the
72 emulator backend to use it. Usually the tune's clockspeed is 73 emulator backend to use it. Usually the tune's clockspeed is
73 automatically detected, so do not set "Force speed" unless you 74 automatically detected, so do not set "Force speed" unless you
87 - reSID-emulation / HardSID: Select SIDPlay 2 backend. reSID 88 - reSID-emulation / HardSID: Select SIDPlay 2 backend. reSID
88 is a software SID-chip simulation and currently the only 89 is a software SID-chip simulation and currently the only
89 option available. HardSID is backend for HardSID card, 90 option available. HardSID is backend for HardSID card,
90 but it is not supported yet by XMMS-SID. 91 but it is not supported yet by XMMS-SID.
91 92
93
92 Filters-tab 94 Filters-tab
93 ----------- 95 -----------
94 - Emulate filters: Enable filter emulation. Usually you will want 96 - Emulate filters: Enable filter emulation. Usually you will want
95 to enable this option, unless you are running on very slow CPU. 97 to enable this option, unless you are running on very slow CPU.
96 SID filters affect outcome of most tunes very much. 98 SID filters affect outcome of most tunes very much.
97 99
98 - Filter settings: Unless you are advanced user (and thus know what 100 - Filter settings: Unless you are advanced user (and thus know what
99 these are), the defaults will work very well and there is no need 101 these are), the defaults will work very well and there is no need
100 to touch filter settings. 102 to touch filter settings.
101 103
104
102 Songlength-tab 105 Songlength-tab
103 -------------- 106 --------------
104 Most of song length settings should be self-explanatory. The 107 Most of song length settings should be self-explanatory. The
105 respective "Only when song-length is unknown" options make 108 respective "Only when song-length is unknown" options make
106 maximum/minimum playtime limits work only when song length 109 maximum/minimum playtime limits work only when song length
107 110 information is not found from song-length database.
108 * XSIDPLAY-compatible song-length database is a file that contains 111
109 lengths for most songs in High Voltage SID Collection (HVSC). I 112 - Use XSIDPLAY-compatible database: If enabled, you can specify
110 highly recommend that you download the database and configure 113 song-length database file and it is used. If disabled, the
111 XMMS-SID to use it. The SLDB is available at 114 database is not used.
112 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/sldb.html 115
113 116 - DB-file: Specify path and filename, usually Songlengths.txt,
117 that contains lengths for most songs in High Voltage SID
118 Collection (HVSC) in XSIDPLAY compatible format, for example:
119 /media/Songlengths.txt
120
121 Click the "Browse" button to get a file selector dialog.
122
123 I highly recommend that you download the database and configure
124 XMMS-SID to use it. The SLDB is available at
125
126 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/sldb.html
127
128
129 Title-tab
130 ---------
131 STIL-database configuration:
132
133 - Use STIL information database: If enabled, the settings below
134 take effect and XMMS-SID can utilize additional information
135 from High Voltage SID Collection (HVSC) STIL-database. STIL
136 contains general information about the tune, plus trivia,
137 history and comments from the composers.
138
139 - STIL-file: Path and filename STIL database. Usually the STIL
140 file is under DOCUMENTS/ sub-directory of HVSC, for example:
141 /media/C64Music/DOCUMENTS/STIL.txt
142
143 - HVSC path: Path to your High Voltage SID Collection directory,
144 for example: /media/C64Music
145
146 Click the "Browse" button to get a file selector dialog.
147
148 Song name/title format:
149
150 - Override generic XMMS titles: Enable to override generic XMMS
151 titlestring setting and use XMMS-SID specific titlestring
152 format.
153
154
155 Misc-tab
156 --------
157 Sub-tune control:
158
159 - Disabled: No separate sub-tune control. The sub-tune selector
160 in XMMS-SID's fileinfo dialog will still be enabled.
161
162 - Seek back/forward changes sub-song: This method is similar to
163 the one used in "XMMS-SidPlay"
164
165 - Pop-up via seekbar (UADE-style): Similar to selector used in
166 Unix Amiga Delitracker Emulator (UADE). Any interaction with
167 XMMS's seeking capabilities pops up a sub-tune control window.
168 Mouse and arrow keys can be used to select a tune. Escape key
169 (ESC) or moving mouse out of the window closes it.
170
171 - Song-position patch: If you have a patched version of XMMS
172 (patched with song-position patch, which comes with XMMS-SID),
173 you can select this method. Then you can use XMMS's seekbar
174 to select the sub-tune. (Back in XMMS-SID v0.7 this was the
175 only option.)
176
177 Automatic sub-tune changes:
178
179 - Go through all sub-tunse in file:
180
181 - Only tunes with specified minimum length:
182
183 Miscellaneous options:
184
185 - Detect file by contents: If XMMS-SID doesn't recognize your
186 SID-tunes, try enabling this option. It is EXTREMELY slow if
187 you're reading a 10000-tune playlist, though.
114 188
115 189
116 Miscellaneous tips 190 Miscellaneous tips
117 ================== 191 ==================
118 * SIDPlay2-emulation is heavier, but more accurate. So you need to 192 * SIDPlay2-emulation is heavier, but more accurate. So you need to
122 enchange the audio quality, but you need some really powerful 196 enchange the audio quality, but you need some really powerful
123 hardware to run it smoothly. 197 hardware to run it smoothly.
124 198
125 * Filter-settings can be usually left as they are, unless you know 199 * Filter-settings can be usually left as they are, unless you know
126 what you're doing. 200 what you're doing.
127
128 * If the plugin doesn't recognize your SID-tunes, try checking the
129 'Determine filetype by contents' option in the XMMS-SID config
130 window. This is EXTREMELY slow if you're reading a 10000-tune
131 playlist, though.
132 201
133 * For those who don't know it: Autopanning and stereo are not native 202 * For those who don't know it: Autopanning and stereo are not native
134 to the original SID chip, but are extra options implemented in 203 to the original SID chip, but are extra options implemented in
135 libSIDPlay. So if you think that the tune does not sound as it 204 libSIDPlay. So if you think that the tune does not sound as it
136 sounds on real C64, use the Mono setting. 205 sounds on real C64, use the Mono setting.