Added support for the extended commands 'midi_channel' and 'midi_program'

[ahxm.git] / TODO

Ann Hell Ex Machina TODO / Bug List
===================================

Release Critical Bugs
---------------------

 * 1017: mp_doccer documentation is severely outdated.
 * 1022: Add file name to compiler errors.
 * 1030: Refactorize the output system to always use a forked process.
 * 1032: Refactorize input, ss_gen and ss_ins to always use pointers to
   struct ss_wave instead of copies of them.
 * 1040: Get rid of all _ prefixed symbols.
 * 1041: Consider the possibility to avoid having #define CHANNELS at all
   and always use it as dynamic structures or buffers.

Open Bugs
---------

 * 1034: tempo_from_wave() will never work; when the wave is loaded, it's
   too late for the tempo to be set, as the ss_song stream has no tempo
   information. The only solution is to just print the optimal tempo, for
   the ahxm programmer to change it manually.

Pending Enhancements
--------------------

 * 1002: Build an audio filtering tool to test effects.
 * 1003: There should exist 'some kind' of effect for note volumes
   to add a random variation, to add 'humanity'. This cannot
   be a standard digital effect as it should be different
   for each note.
 * 1005: Vibrato should be variable (from 'no-vibrato' to 'some-vibrato'
   in the same note).
 * 1006: A 'choose' option, to take randomly one block or another
   (blocks seem appropriate, but further study is necessary). A random
   seed script command is also necessary.
 * 1007: Support for 'tonalities'; fixed transpositions for each note of
   the octave so that, for example, a 'f' is always a 'f#'.
 * 1008: Support for 'keyboard splits': ranges of notes that a track will
   ignore. This should allow to have multiple tracks playing the same
   notes but with different channel maps and, for example, having a
   guitar glissando pan from left to right.
 * 1010: Loop stretching ('stretch wave without pitch change to last
   exactly N time units').
 * 1011: Loop matching ('change wave pitch to last exactly N time units').
 * 1020: When a source file includes multiple songs, there should exist a
   way to mark song / track changes. This should be used to include text
   messages as ID3 tags or even to generate .cue / .toc files.

Closed
------

 * 1000: Convert current event queue to two event queues. The first
   stage queue should store notes and the second note on / note off
   events (Tue, 17 Aug 2004 12:00:00 +0200).
 * 1004: Vibrato for generators (Fri, 13 Aug 2004 11:05:00 +0200).
 * 1009: Set tempo from a sample loop ('set tempo so that this wave
   will match exactly one/N measures') (Fri, 16 Aug 2004 18:08:00 +0200).
 * 1013: Volume should be a command ('v', for example) and not be
   inherited from previous notes. There should also be settable as
   relative inc/decrements (as octaves) (Mon, 30 Aug 2004 14:37:59 +0200).
 * 1014: doc/language.txt is severely outdated
   (Mon, 30 Aug 2004 15:13:00 +0200)
 * 1015: Upgrade build system (new config.sh, makefile.in, etc.).
   (Thu, 09 Sep 2004 18:56:29 +0200).
 * 1016: Integrate the new compiler (Sun, 12 Sep 2004 16:13:11 +0200).
 * 1001: Generator should use queues of active / free generators.
   (Sun, 17 Oct 2004 12:50:10 +0200).
 * 1012: Portamento should not have a 'time', only a frequency
   inc/decrement per time unit (Sun, 17 Oct 2004 13:18:04 +0200).
 * 1018: The 'default' driver should not be bound to the first usable
   one, but be a sequential try of all available drivers
   (Thu, 11 Nov 2004 12:18:12 +0100).
 * 1019: Add libartsc support (Thu, 11 Nov 2004 12:30:02 +0100).
 * 1023: The SS_FRAMES lex/yacc token should be SS_MSECS, that is,
   the compiler should not use frames but milliseconds
   (Tue, 19 Apr 2005 20:05:46 +0200).
 * 1024: The 'event1' and 'event2' stuff is ugly. It should be called,
   respectively, 'note stream' (as it's, more or less, device independent)
   and 'ss stream', which depends of softsynth, frames and such. In the
   future, there could exist a 'midi stream' if MIDI output is supported
   (Closed by #1025; Wed, 20 Apr 2005 17:30:31 +0200).
 * 1033: SONG_EV_SS_NOTE won't work, because freq can't be calculated
   on compilation time; instead, it should be a generic message
   (Sat, 23 Apr 2005 10:52:35 +0200).
 * 1026: Get rid of event.c and event.h (Sat, 23 Apr 2005 12:28:47 +0200).
 * 1027: Get rid of effect.c and effect.h (Sat, 23 Apr 2005 12:28:51 +0200).
 * 1031: Add lex/yacc code for processing absolute notes (A1, C#4, F&3)
   (Sat, 23 Apr 2005 16:14:21 +0200).
 * 1036: Unify song event types; ss_song should use the same event types
   (Sun, 24 Apr 2005 10:29:22 +0200).
 * 1035: The number of compiled tracks should be available somewhere
   (Sun, 24 Apr 2005 10:35:19 +0200).
 * 1037: ss_ins_frame() is flawed; as it directly mixes into frame[],
   each intrument's ss effects affect the previous ones
   (Mon, 25 Apr 2005 16:42:28 +0200).
 * 1025: 'event1' has been moved to song.c (generic song event stream)
   and 'event2' has been moved to ss_song.c (softsynth song event stream),
   but due to almost all of ss_song.c being private, there is no way to
   order the instruments and the effects to do anything until a way of
   storing them is decided. So, project state is really critical now as
   nothing works (last working version was 'cvs update -D 20050419').
   (Mon, 25 Apr 2005 18:16:48 +0200).
 * 1039: Volumes can't be set as integer numbers (0 and 1 should be valid)
   (Mon, 25 Apr 2005 18:26:06 +0200).
 * 1038: Comments can't be written inside extended commands
   (Mon, 25 Apr 2005 18:31:55 +0200).
 * 1021: Add line number to compiler errors (Mon, 25 Apr 2005 19:11:01 +0200).
 * 1028: input.c should be ss_input.c (Wed, 27 Apr 2005 08:08:49 +0200).
 * 1029: output.c should be ss_output.c (Wed, 27 Apr 2005 16:59:34 +0200).

Email bugs to angel@triptico.com