Updated TODO.
[ahxm.git] / RELEASE_NOTES
bloba4ad036593709b937e2c0e9e1c6e63a62952d99d
1 Ann Hell Ex Machina Release Notes
2 =================================
4 1.0.11
5 ------
7  * Uses `ffmpeg' as a fallback converter in case all others fail.
9 1.0.10
10 ------
12  * The volume (`v') command can now have two arguments; next volumes will
13    be set as a random value from that range.
14  * New softsynth directive `attack', to set the attack time for notes,
15    analogous to `sustain' (this directive was introduced in 1.0.9, but
16    was left undocumented here).
17  * The `wav' command now accepts a file name starting with a pipe
18    symbol (|), interpreting the string as a command to be executed, that
19    will end up creating the .wav file that will be used as a sound source.
20    The command must include a %s where the command wants the output file
21    (it will be filled with a unique, temporary name).
23 1.0.9
24 -----
26  * The wobble effect now accepts a 'gain' argument, to control the amount
27    of effect applied to the signal. If not set, it uses a default of 0.8
28    (previous versions acted as if a 1.0 value was set).
29  * The way of ending a softsynth song has changed; instead of waiting for
30    the end of events and then abruptly ending (which led to adding fake
31    silences and notes until all sound is off), now the instruments are
32    monitored and only exits when no more sound is generated.
33  * Three new distortion effects, `atan', `distort' and `overdrive' have
34    been added.
35  * A new special mark is supported, START, that can be defined anywhere
36    and used as the starting point for the following new tracks.
37  * A new special mark is support, END, that will be automatically set
38    to the longest time seen on a track. So, combining the START and END
39    marks, it's possible to mix different songs to play one after the other,
40    as in
42         /* first song */
43         `song1.ahs`
44         
45         /* move to the furthest point */
46         @END
47         
48         /* set start of new tracks there */
49         ^START
50         
51         \
52         /* second song */
53         `song2.ahs`
55 1.0.8
56 -----
58  * Big rename; main executable has been changed from 'annhell' to 'ahxm',
59    the personal sample library changed from $HOME/annhell to $HOME/ahxmlib,
60    and the temporary cache moved to /tmp/ahxm-$PID.
61  * Paged wave loading now include an adaptive algorithm that sequentially
62    increases the memory block assigned to that wave if it pages frequently.
63    This way it's much less possible to be bitten by bug #1108.
64  * New command 'A' to set the key signature as a list of alterations
65    to natural notes.
66  * New effect 'half_wobble'; same as 'wobble', but letting pass only the
67    first pass of a period.
68  * New directive 'portamento', allowing notes to slide up or down.
69  * New distortion effect 'foldback'.
71 1.0.7
72 -----
74  * Number of channels no longer default to 2, but to all the channels used
75    in the song (this way, WAV files are automatically generated with all the
76    defined channels and not clipped to 2). Other output devices are still
77    silently clipped to 2 and the rest of channels dropped.
78  * The arpeggiator subcommand @ (track) has been changed to /, as it was
79    confusing the parser. Also, the track is relative instead of absolute
80    (now it means a track offset), so it can be reused.
81  * Midiin has been fixed, as it was severely broken (no initializations).
82  * OSS's fragment changed so that real-time applications (as midiin) work
83    again. This seems to be necessary when using ALSA's OSS emulation.
84  * A new midi2ahs.pl script, to crudely convert MIDI files to .ahs scripts.
86 1.0.6
87 -----
89  * Minor internal changes.
90  * First public version.
92 1.0.5
93 -----
95  * Channel spreading of wave files into instruments can now be partially
96    controlled with the optional "first channel" and "skip channels"
97    parameters. This allow using samples where the left and right channel
98    are in different wave files.
99  * New randomized blocks.
101 1.0.4
102 -----
104  * A new directive, 'song_info', to add author and name metadata to a song.
105  * A new command line option, -C, to generate a .cue file.
106  * Fixed a critical bug when loading .wav files directly (instead of
107    converted from other formats as .flac).
109 1.0.3
110 -----
112  * This release allows working with huge wave files, as they are
113    loaded page by page instead of full in memory (but beware of
114    bug #1108).
116 1.0.2b
117 ------
119  * This release includes no new features, but just some internal
120    refactoring (towards supporting paged instruments).
122 1.0.2
123 -----
125  * Tempo changes has been fixed.
126  * New '-P' command line switch to show time progress.
128 1.0.1
129 -----
131  * The performance of the 'skip seconds' option has been dramatically
132    improved; but take note that output will sound differently, as notes
133    that started playing before the time boundary will no longer sound
134    (this will also happen with a real MIDI synthesizer, where note on
135    events will never be sent).
137 1.0.0
138 -----
140  * First stable version.