Mercurial > audlegacy
comparison Plugins/Input/console/notes.txt @ 493:c04dff121e1d trunk
[svn] hostile merge, phase 2: reimport based on new plugin code
author | nenolod |
---|---|
date | Tue, 24 Jan 2006 20:19:01 -0800 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
492:ccb68bad47b2 | 493:c04dff121e1d |
---|---|
1 Audacious Console Game Music Driver | |
2 ----------------------------------- | |
3 Contact: Shay Green <hotpop.com@blargg> | |
4 | |
5 Notes | |
6 ----- | |
7 - This is a fairly rough version. I'm sending it so we can decide more | |
8 concretely on the desired features. I don't have Unix (or even Mac OS X) | |
9 so I've only tested this lightly with a quick framework I wrote to | |
10 simulate the Audacious environment (as best as I could determine based | |
11 on the limited documentation). | |
12 | |
13 - The most significant missing feature is a way to select the track | |
14 number of multi-track formats (NSF, NSFE, GBS). I've implemented | |
15 internal support for this and marked the places where the track number | |
16 is needed from an external source. | |
17 | |
18 - Seeking should be tested carefully. It might be too slow for some | |
19 formats. | |
20 | |
21 - Currently text fields are treated as they are already in UTF-8 format | |
22 (which they aren't), but they should probably be converted from Windows | |
23 charset to UTF-8. VGM files have 16-bit chars in an unknown encoding, | |
24 currently just truncated to 8-bits. | |
25 | |
26 - Errors in Audacious_Driver.cpp are checked and generally result in | |
27 exit of the current operation and no overall effect. Information about | |
28 the cause of the error is consistently lost, so it would be difficult to | |
29 switch over to a model of actually reporting the error so the user can | |
30 know about it and take useful action. | |
31 | |
32 - Each track may contain any of the following: preferred play length, | |
33 intro length, loop length. If play length is present, it is used as the | |
34 track time. If not present, the default play length from the config file | |
35 is used. A more sophisticated algorithm could be used that takes into | |
36 account the loop length. | |
37 | |
38 - File opening and reading has been significantly minimized. Bytes read | |
39 for file identification are preserved for when the rest of header is | |
40 read. When playing a track, file information is obtained using | |
41 already-loaded data in the emulator, eliminating extra reading. | |
42 | |
43 | |
44 Change Log | |
45 ---------- | |
46 - Marked things to be addressed with "// to do:" comments | |
47 | |
48 - Updated to Game_Music_Emu 0.3.0 and eliminated unnecessary source | |
49 files | |
50 | |
51 - Eliminated Audacious_Driver.h since it served no purpose | |
52 | |
53 - Added support for NSFE files | |
54 | |
55 - Added Vfs_File, a wrapper for the vfs_* file functions. This allows | |
56 all the emulators to access files in this manner. | |
57 | |
58 - Updated Makefile.am but didn't add line to link with zlib | |
59 | |
60 - Added fading at end of tracks | |
61 | |
62 - Added end-of-track silence detection for tracks without timing | |
63 information. Stops track when 6 seconds of silence have passed, but | |
64 looks ahead so that the user only experiences about 1 second of silence | |
65 before the track ends. | |
66 | |
67 - Added beginning-of-track silence removal, as some tracks have many | |
68 seconds of silence (Zelda Link's Awakening.gbs track 61 has 20 seconds | |
69 of silence, making you think it's not a music track without this | |
70 feature). | |
71 | |
72 | |
73 To Do | |
74 ----- | |
75 - Separate track info handling from Audacious_Driver.cpp, since the | |
76 current complexity is a good source of bugs | |
77 |