Mercurial > hg > xmms-sid

comparison INSTALL @ 987:bafb3f102e91

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update some of the installation information.
author Matti Hamalainen <ccr@tnsp.org>
date Mon, 29 Jul 2013 09:31:39 +0300
parents 2531396c2718
children cfc879a562c3
comparison
equal deleted inserted replaced
986:ea3889c40011 987:bafb3f102e91
31 - libSIDPlay v1: This is the old and original emulation library. Its 31 - libSIDPlay v1: This is the old and original emulation library. Its
32 emulation is "frame-based" and not very accurate. The waveforms 32 emulation is "frame-based" and not very accurate. The waveforms
33 produced are harsher and emulation of SID filter is far from 33 produced are harsher and emulation of SID filter is far from
34 accurate. 34 accurate.
35 35
36 libSIDPlay v1 requires very little CPU power, it is faster and 36 libSIDPlay v1 requires very little CPU power, it will work even
37 may have fewer bugs due to being more mature software. Many 37 on very slow devices. Many OS distributions have pre-built packages
38 OS distributions have pre-built packages of it, not something that 38 of it, not something that can be said of libSIDPlay v2, even less
39 can be said of libSIDPlay v2. Some people may even like the 39 libSIDPlay-FP. Some people may even like theharsher sound produced
40 harsher sound produced by libSIDPlay v1. 40 by libSIDPlay v1.
41 41
42 Drawbacks are: worse emulation, eventually weakening compability 42 Drawbacks are: worse emulation, eventually weakening compability
43 as new SID-tunes/files are ripped into "RSID"-format which 43 as new SID-tunes/files are ripped into "RSID"-format which
44 libSIDPlay v1 does NOT support. 44 libSIDPlay v1 does NOT support.
45 45
52 52
53 - libSIDPlay-FP: Fork of libSIDPlay2. New, next generation modular 53 - libSIDPlay-FP: Fork of libSIDPlay2. New, next generation modular
54 SID-emulation framework. Along with reSID-library it produces 54 SID-emulation framework. Along with reSID-library it produces
55 probably most accurate software-emulated representation of 55 probably most accurate software-emulated representation of
56 SID-chip available. This, however, comes at high cost: 56 SID-chip available. This, however, comes at high cost:
57 libSIDPlay2/FP tends to eat CPU like popcorn. 57 libSIDPlay-FP tends to eat CPU like popcorn.
58 58
59 It is also less spread, not packaged in distributions (that I know of, 59 It is also less spread, not packaged in distributions (that I know of,
60 at the time of writing of this), so you may have to roll your own. 60 at the time of writing of this), so you may have to roll your own.
61 61
62 Also the API-stability of libSIDPlay2/FP is not yet 100%, there may 62 Also the API-stability of libSIDPlay-FP is not yet 100%, there may
63 be changes. Bugs are evident, though many of them will be fixed 63 be changes. Bugs are evident, though many of them will be fixed
64 eventually. 64 eventually.
65 65
66 66
67 Conclusion thus is as follows: If you are using a VERY old system with not 67 Conclusion thus is as follows: If you are using a VERY old system with not
68 much spare CPU-power, choose libSIDPlay v1. On a relatively "recent" 68 much spare CPU-power, choose libSIDPlay v1. On a relatively "recent"
69 system (Pentium-M, Pentium4 1GHz+) you may wish to choose libSIDPlay v2. 69 system (Pentium-M, Pentium4 1GHz+) you may wish to choose libSIDPlay v2.
70 70
71 On a Intel Core2 or Intel Core i5/7 level system you could choose 71 On a Intel Core2 or Intel Core i5/7 level system you could choose
72 libSIDPlay-FP, if you have ~20% CPU to spare. 72 libSIDPlay-FP, if you have approximately ~20% CPU to spare for
73 playing the tunes.
73 74
74 75
75 Where to get XMMS? 76 Where to get XMMS?
76 ================== 77 ==================
77 Latest version of XMMS should be available from: 78 Latest version of XMMS should be available from:
119 120
120 Or head to: 121 Or head to:
121 122
122 http://sourceforge.net/projects/sidplay-residfp/ 123 http://sourceforge.net/projects/sidplay-residfp/
123 124
124 Version 0.3.7 should be compatible. Earlier and later ones might not, 125 Versions 0.3.7 and 1.0.1 should be compatible with XMMS-SID.
125 as the API seems to be in flux at the moment. 126 Earlier and later ones might not, as the API seems to be in
127 flux at the moment.
126 128
127 129
128 Building a Mercurial-version 130 Building a Mercurial-version
129 ============================ 131 ============================
130 To build a version of XMMS-SID from Mercurial repository, 132 To build a version of XMMS-SID from Mercurial repository,