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