Mercurial > hg > xmms-sid

comparison INSTALL @ 995:cfc879a562c3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
s/libSIDPlay-FP/libSIDPlayFP/g.
author Matti Hamalainen <ccr@tnsp.org>
date Fri, 01 Nov 2013 23:55:59 +0200
parents bafb3f102e91
children fe9e84de906b
comparison
equal deleted inserted replaced
994:48dd77c395b1 995:cfc879a562c3
13 any other compiler ... sorry. 13 any other compiler ... sorry.
14 14
15 - You need AT LEAST one of the following emulation libraries: 15 - You need AT LEAST one of the following emulation libraries:
16 16
17 * libSIDPlay1 17 * libSIDPlay1
18 * libSIDPlay2 or libSIDPlay-FP (mutually exclusive) 18 * libSIDPlay2 or libSIDPlayFP (mutually exclusive)
19 19
20 Only one emulator backend library is required, but all are 20 Only one emulator backend library is required, but all are
21 supported with compile & run-time configuration. You may also 21 supported with compile & run-time configuration. You may also
22 need some supplementary libraries for each emulator library. 22 need some supplementary libraries for each emulator library.
23 See below for more information. 23 See below for more information.
34 accurate. 34 accurate.
35 35
36 libSIDPlay v1 requires very little CPU power, it will work even 36 libSIDPlay v1 requires very little CPU power, it will work even
37 on very slow devices. Many OS distributions have pre-built packages 37 on very slow devices. Many OS distributions have pre-built packages
38 of it, not something that can be said of libSIDPlay v2, even less 38 of it, not something that can be said of libSIDPlay v2, even less
39 libSIDPlay-FP. Some people may even like theharsher sound produced 39 libSIDPlayFP. Some people may even like theharsher sound produced
40 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
46 46
47 - libSIDPlay2+reSID or HardSID: A much more accurate emulation 47 - libSIDPlay2+reSID or HardSID: A much more accurate emulation
48 framework. Unfortunately the original fork has mostly stalled, 48 framework. Unfortunately the original fork has mostly stalled,
49 though works. Much heavier CPU-load compared to libSIDPlay1, 49 though works. Much heavier CPU-load compared to libSIDPlay1,
50 but not as heavy as libSIDPlay-FP. 50 but not as heavy as libSIDPlayFP.
51 51
52 52
53 - libSIDPlay-FP: Fork of libSIDPlay2. New, next generation modular 53 - libSIDPlayFP: 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 libSIDPlay-FP tends to eat CPU like popcorn. 57 libSIDPlayFP 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 libSIDPlay-FP is not yet 100%, there may 62 Also the API-stability of libSIDPlayFP 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 approximately ~20% CPU to spare for 72 libSIDPlayFP, if you have approximately ~20% CPU to spare for
73 playing the tunes. 73 playing the tunes.
74 74
75 75
76 Where to get XMMS? 76 Where to get XMMS?
77 ================== 77 ==================
111 If your OS/distribution does not offer packaged libSIDPlay1, head to: 111 If your OS/distribution does not offer packaged libSIDPlay1, head to:
112 112
113 http://www.tnsp.org/?p=libsidplay2 113 http://www.tnsp.org/?p=libsidplay2
114 114
115 115
116 Where to get libSIDPlay-FP? 116 Where to get libSIDPlayFP?
117 =========================== 117 ==========================
118 118
119 $ apt-get install libsidplayfp-dev 119 $ apt-get install libsidplayfp-dev
120 120
121 Or head to: 121 Or head to:
122 122
123 http://sourceforge.net/projects/sidplay-residfp/ 123 http://sourceforge.net/projects/sidplay-residfp/
124 124
125 Versions 0.3.7 and 1.0.1 should be compatible with XMMS-SID. 125 Versions 0.3.7, 1.0.1 and 1.1.0 should be compatible with XMMS-SID.
126 Earlier and later ones might not, as the API seems to be in 126 Earlier and later ones might not, as the API seems to be in flux at
127 flux at the moment. 127 the moment.
128 128
129 129
130 Building a Mercurial-version 130 Building a Mercurial-version
131 ============================ 131 ============================
132 To build a version of XMMS-SID from Mercurial repository, 132 To build a version of XMMS-SID from Mercurial repository,