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