summaryrefslogtreecommitdiff
path: root/lib/rbcodec/codecs/cRSID/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'lib/rbcodec/codecs/cRSID/README.txt')
-rw-r--r--lib/rbcodec/codecs/cRSID/README.txt39
1 files changed, 39 insertions, 0 deletions
diff --git a/lib/rbcodec/codecs/cRSID/README.txt b/lib/rbcodec/codecs/cRSID/README.txt
new file mode 100644
index 0000000000..3a806b65ed
--- /dev/null
+++ b/lib/rbcodec/codecs/cRSID/README.txt
@@ -0,0 +1,39 @@
1 cRSID by Hermit (Mihaly Horvath) - Year 2022
2 --------------------------------------------
3
4This is a serious integer-only update (rewrite) to my cSID and cSID-light
5commandline SID-players, aiming for an ongoing inclusion into RockBox,
6as per a request by Ninja earlier at CSDb. He will do the integration.
7
8The name now contains the 'R' because now a RealSID-like environment-mode
9(CIA, VIC, IRQ, NMI) is supported more-or-less ('RealSIDmode' in source).
10There are still many RSID tunes that are not played properly, mainly
11the tricky ones which use DC04 or DD0C as jump-addresses or RTI placeholders,
12like for example 'Hi Fi Sky', and other modern digi tunes.
13I don't feel like debugging these complex tunes now...
14PSID-only playback has improved a lot since cSID-light-1.1,
15and now many PlaySID-digis are supported as well if that still matters.
16
17The CPU and ADSR went through serious timing improvements,
18it's now can be called cycle-exact, and hardrestarts and delaybugs are now
19simulated well, no missed notes, whatever.
20
21This release also contains shared and static library forms for better
22inclusion in other SID-playback projects (like FlexSID for example).
23I completely eliminated global variables and definitions, except a
24'cRSID_c64' instance which is for faster access of struct members.
25(Emulated C64 memory accesses are made to this for faster operation.)
26
27More info (the API for the library) is seen in the 'libcRSID.h' file.
28
29It has been tried already on a SanDisk RockBox device and tunes not
30containing digis are already played on it fine. Tunes with 2SID/3SID or
31digis however are too much for the player (38MHz..192MHz ARM) at this form.
32So maybe the code will be optimized by eliminating overheads of structs,
33pointers, optimizing function-calls, inlining, and by other possible means.
34
35Hopefully in the near future the outdated TinySID engine will be replaced
36in the RockBox source-tree...
37
38License is still WTF: Do what the fuck you want with this code, but
39 it would be nice mentioning me as the original author.