annotate CHANGELOG @ 383:583727d0650a

Package
author Chris Cannam
date Fri, 05 Jun 2020 16:55:47 +0100
parents 3e0133aa2354
children bfd36a0105bc
rev   line source
Chris@370 1
Chris@370 2 Changes in Sonic Annotator 1.6 (5 June 2020) since the previous release 1.5:
Chris@370 3
Chris@370 4 Front-end changes:
Chris@370 5
Chris@370 6 - Add support for reading the Opus audio codec on all platforms
Chris@370 7
Chris@370 8 - Add support for reading WMA and AAC formats on 64-bit Windows. (AAC
Chris@370 9 was already supported on macOS.) Note that AAC support on Windows
Chris@370 10 is not "gapless", i.e. the decoder provides no way to identify and
Chris@370 11 remove the encoder gap at the start of the stream, so timings will
Chris@370 12 vary between Windows and Mac. For this reason, like mp3, AAC should
Chris@370 13 not be used as a file format of record
Chris@370 14
Chris@370 15 - Add warning to the help text about avoiding mp3 and AAC as file
Chris@370 16 format of record
Chris@370 17
Chris@370 18 Build changes:
Chris@370 19
Chris@370 20 - General updates to dependency libraries and build system following
Chris@370 21 changes to the rest of the Sonic Visualiser family code since v1.5
Chris@370 22 appeared
Chris@370 23
Chris@294 24
Chris@354 25 Changes in Sonic Annotator 1.5 (25 May 2017) since the previous release 1.4:
Chris@294 26
Chris@294 27 Front-end changes:
Chris@294 28
Chris@294 29 - Change mp3 file loading so as to compensate for encoder/decoder
Chris@294 30 delay and padding (using "gapless playback" logic). While this is a
Chris@294 31 real improvement, unfortunately it does mean that the initial
Chris@294 32 padding in mp3 file load has changed from previous versions, which
Chris@294 33 may change alignment of features based on mp3 files relative to
Chris@294 34 those generated by previous versions. It's not a great idea to use
Chris@294 35 mp3 as a file format of record, because of differences like this
Chris@294 36 between decoders
Chris@294 37
Chris@294 38 - Add --transform-minversion flag to test for available version of
Chris@294 39 a plugin transform
Chris@354 40
Chris@294 41 - Add quiet mode (-q)
Chris@294 42
Chris@294 43 Bug fixes:
Chris@294 44
Chris@294 45 - Fix possible crash in multiplexed file handling (--multiplex, -m)
Chris@294 46
Chris@294 47 - Fix nominal rounding error (out by 1ns) in output under some
Chris@294 48 conditions
Chris@294 49
Chris@246 50
Chris@354 51 Changes in Sonic Annotator 1.4 (18 Mar 2016) since the previous release 1.3:
Chris@246 52
Chris@246 53 Front-end changes:
Chris@246 54
Chris@246 55 - Better error reporting, especially for invalid transform files
Chris@246 56 and transform-not-found
Chris@246 57
Chris@246 58 - Avoid crashing out when a single plugin (that is not being used)
Chris@246 59 can't be loaded because of e.g. an undefined symbol
Chris@246 60
Chris@246 61 Bug fixes:
Chris@246 62
Chris@246 63 - Fix (with test) horrible crash with --multiplex option
Chris@246 64
Chris@246 65 - Fix erroneous quantization to 16 bits for coded file types of
Chris@246 66 greater bit depth
Chris@246 67
Chris@246 68 - Fix multiple outputs when requesting both summary and non-summary
Chris@246 69 for the same output
Chris@246 70
Chris@246 71
Chris@354 72 Changes in Sonic Annotator 1.3 (05 Nov 2015) since the previous release 1.2:
Chris@211 73
Chris@211 74 Back-end (feature writer) changes:
Chris@211 75
Chris@211 76 - Add the --csv-digits, --lab-digits, and --jams-digits options to
Chris@211 77 control the number of significant figures printed for feature values
Chris@211 78
Chris@211 79 - Update the JAMS writer to JAMS 0.2.0 format
Chris@211 80
Chris@211 81 - Show a more useful error message when user provides a filename
Chris@211 82 instead of a transform id to the -d option (happened to me when
Chris@211 83 cut-and-pasting command lines and I was quite baffled at first)
Chris@211 84
Chris@200 85
Chris@354 86 Changes in Sonic Annotator 1.2 (01 Sep 2015) since the previous release 1.1:
Chris@200 87
Chris@200 88 Front-end changes:
Chris@200 89
Chris@200 90 - Add the --segments-from option, providing the ability to read
Chris@200 91 segment boundaries from a file
Chris@200 92
Chris@200 93 Back-end (feature writer) changes:
Chris@200 94
Chris@200 95 - Rename the JSON feature writer to JAMS. There may be other JSON
Chris@200 96 formats supported in future
Chris@200 97
Chris@200 98 Bug fixes:
Chris@200 99
Chris@200 100 - Fix invalid JSON written by JAMS feature writer for dense
Chris@354 101 features
Chris@354 102
Chris@200 103 - Fix invalid UTF-8 output from RDF feature writer when processing
Chris@200 104 MP3 files having ID3 tags in non-ASCII, non-UTF8 encodings
Chris@200 105
Chris@127 106
Chris@354 107 Changes in Sonic Annotator 1.1 (16 Oct 2014) since the previous release 1.0:
Chris@127 108
Chris@127 109 Front-end changes:
Chris@127 110
Chris@127 111 - Add support for the start time and duration properties of a
Chris@127 112 transform, applying a plugin to only a range of the input audio
Chris@354 113
Chris@179 114 - Reduce the internal processing blocksize from 16384 to 1024 samples
Chris@179 115 to reduce extent of time rounding at end of file or range
Chris@354 116
Chris@128 117 - Add --multiplex option to compose multiple audio files into a
Chris@128 118 single multi-channel stream with one input file per channel
Chris@354 119
Chris@172 120 - Add --normalise to request each audio file be normalised to 1.0 max
Chris@354 121
Chris@172 122 - Add support for the plugin_version property of a transform, causing
Chris@172 123 Sonic Annotator to refuse to run with the wrong version of a plugin
Chris@354 124
Chris@128 125 - Add --minversion option to permit scripts to check that the
Chris@128 126 version of Sonic Annotator is as they expect
Chris@354 127
Chris@172 128 - Add new housekeeping options to list the available feature writers
Chris@172 129 and supported audio file formats
Chris@354 130
Chris@172 131 - Pull out the feature-writer-specific help text into separate help
Chris@172 132 options (-h <writertype>) as the help was getting too long
Chris@172 133
Chris@172 134 Back-end (feature writer) changes:
Chris@172 135
Chris@172 136 - Add --csv-omit-filename, --csv-end-times, and --csv-fill-ends
Chris@172 137 options to the CSV feature writer to adjust various aspects of its
Chris@172 138 output
Chris@354 139
Chris@172 140 - Add "json" feature writer, exporting to JAMS (JSON Annotated Music
Chris@181 141 Specification) format. This writer is provisional and is expected
Chris@172 142 to change in future releases to comply more effectively with the
Chris@172 143 specification
Chris@354 144
Chris@172 145 - Add "midi" feature writer, exporting to MIDI files
Chris@354 146
Chris@172 147 - Add "lab" feature writer, exporting to tab-separated label files.
Chris@172 148 (This is equivalent to using the CSV writer with a tab separator and
Chris@172 149 the new --csv-omit-filename and --csv-end-times options, but it's
Chris@172 150 simpler to use if .lab is what you want)
Chris@128 151
Chris@128 152 Bug fixes:
Chris@128 153
Chris@128 154 - Fix the former habit of forging ahead even if not all transform
Chris@128 155 files could be found or parsed (this may have been intentional
Chris@128 156 behaviour but it is confusing more than it is useful)
Chris@354 157
Chris@128 158 - Fix failure to support --summary-only flag when reading transforms
Chris@128 159 with summaries from a transform file
Chris@71 160
Chris@172 161
Chris@354 162 Changes in Sonic Annotator 1.0 (09 May 2013) since the previous release 0.7:
Chris@71 163
Chris@87 164 Bug fixes:
Chris@87 165
Chris@71 166 - Fix incorrect samplerate in reading m4a files on OS/X
Chris@354 167
Chris@73 168 - Fix incorrect handling of FixedSampleRate outputs (Vamp SDK fix)
Chris@354 169
Chris@86 170 - Add tests that use the Vamp test plugin
Chris@65 171
Chris@172 172
Chris@354 173 Changes in Sonic Annotator 0.7 (17 Jul 2012) since the previous release 0.6:
Chris@65 174
Chris@65 175 Build changes:
Chris@65 176
Chris@65 177 - Support 64-bit builds on OS/X (using CoreAudio instead of
Chris@65 178 obsolete QuickTime audio file reader)
Chris@65 179
Chris@65 180 - Simplify RDF reading and fix some bugs. Now requires Dataquay
Chris@65 181 (http://breakfastquay.com/dataquay/) rather than using Redland
Chris@65 182 directly. Release builds use Sord/Serd rather than Redland
Chris@49 183
Chris@172 184
Chris@354 185 Changes in Sonic Annotator 0.6 (28 Sep 2011) since the previous release 0.5:
Chris@49 186
Chris@49 187 Build changes:
Chris@49 188
Chris@49 189 - Switch to modular SV-libraries build using svcore library
Chris@354 190
Chris@53 191 - We now require Vamp plugin SDK v2.3
Chris@354 192
Chris@49 193 - Add autoconf configure script
Chris@49 194
Chris@49 195 Front-end changes:
Chris@49 196
Chris@49 197 - Pick up default sample rate and channel count from the first
Chris@49 198 audio file, where not specified in the transform, instead of using
Chris@49 199 hard coded defaults
Chris@354 200
Chris@53 201 - Make it possible to specify the window shape in transform
Chris@354 202
Chris@49 203 - Fix the --csv-one-file option which did not work in 0.5
Chris@354 204
Chris@49 205 - Fix --force option when using playlists
Chris@354 206
Chris@49 207 - Add -v option to print version number and exit
Chris@36 208
Chris@172 209
Chris@354 210 Changes in Sonic Annotator 0.5 (26 May 2010) since the previous release 0.4:
Chris@36 211
Chris@36 212 Build changes:
Chris@36 213
Chris@36 214 - Remove unused audioio library and avoid its dependencies
Chris@36 215
Chris@36 216 Front-end changes:
Chris@36 217
Chris@36 218 - Avoid leaking file descriptors on exceptions
Chris@354 219
Chris@36 220 - Fix embarrassing bug that caused failure to mix down to mono
Chris@36 221 properly for single-channel plugins with multi-channel input files
Chris@354 222
Chris@36 223 - Fail sooner if the output file is not writable (i.e. don't wait
Chris@36 224 until the first data is available for writing)
Chris@23 225
Chris@172 226
Chris@354 227 Changes in Sonic Annotator 0.4 (25 Sep 2009) since the previous release 0.3:
Chris@27 228
Chris@27 229 Build changes:
Chris@27 230
Chris@27 231 - Sonic Annotator now requires the Vamp plugin SDK v2.1 or newer.
Chris@27 232
Chris@27 233 Front-end changes:
Chris@27 234
Chris@28 235 - Frequency-domain plugins now use the PluginInputDomainAdapter's new
Chris@28 236 ShiftData processing method, ensuring that the first block received
Chris@28 237 by the plugin is the one centred on 0 rather than starting at 0.
Chris@28 238 Unfortunately, the old behaviour omitted a timing compensation step,
Chris@28 239 and this fix actually changes the results from some plugin processes:
Chris@28 240 the previous behaviour was not always in line with the Vamp plugin
Chris@28 241 specification.
Chris@28 242
Chris@27 243 - More useful diagnostics are now available when a plugin fails to
Chris@28 244 load or run.
Chris@27 245
Chris@27 246 CSV back-end (feature writer) changes:
Chris@27 247
Chris@27 248 - The CSV writer now closes its output files properly when it
Chris@27 249 finishes writing to each one, rather than leaving them all open
Chris@27 250 until the end and risk running out of file descriptors. This was
Chris@27 251 already the behaviour of the RDF writer, the CSV one has just been
Chris@27 252 updated to match it.
Chris@354 253
Chris@27 254 - The behaviour of the CSV writer has also been changed to match
Chris@27 255 that of the RDF writer in handling file write failures (it now
Chris@27 256 continues processing only if --force is given).
Chris@27 257
Chris@27 258
Chris@354 259 Changes in Sonic Annotator 0.3 (07 Jul 2007) since the previous release 0.2:
Chris@23 260
Chris@23 261 Front-end changes:
Chris@23 262
Chris@23 263 - A new --force front-end option (distinct from the --csv-force and
Chris@23 264 --rdf-force back-end options) has been added, which makes Sonic
Chris@23 265 Annotator continue to process subsequent audio files instead of
Chris@23 266 exiting after an error, if multiple audio files have been specified.
Chris@23 267
Chris@23 268 RDF back-end (feature writer) changes:
Chris@23 269
Chris@23 270 - The RDF writer now conforms more correctly with the Music Ontology
Chris@23 271 in the way it relates signal, track, and track metadata. Signals
Chris@23 272 that have available metadata now gain a Track resource to associate
Chris@23 273 that metadata with, instead of hanging it directly from the Signal
Chris@23 274 resource; also the audio file now encodes the signal rather than the
Chris@23 275 signal being available as the audio file (matching the domain
Chris@23 276 specification of the Music Ontology). Note that this new resource
Chris@23 277 structure will not be properly read by versions of Sonic Visualiser
Chris@23 278 prior to 1.6 (should importing the data into Sonic Visualiser be of
Chris@23 279 interest to you).
Chris@23 280
Chris@23 281 - The --rdf-signal-uri option has been removed and replaced with the
Chris@23 282 more meaningful set of options --rdf-audiofile-uri, --rdf-track-uri,
Chris@23 283 and --rdf-maker-uri.
Chris@23 284
Chris@23 285 - A new --rdf-network option is available, to cause Sonic Annotator
Chris@23 286 to try to retrieve RDF descriptions for plugins from the network
Chris@23 287 where those descriptions are not available locally. Use of this
Chris@23 288 option is recommended, but it is not the default because of the
Chris@23 289 possible performance implication (even though the results are mostly
Chris@23 290 cached, there may be some network access involved).
Chris@23 291
Chris@23 292 - The RDF writer now writes the computed_by property for signal
Chris@23 293 features.
Chris@23 294
Chris@23 295 - Plugin and output URIs in the resulting RDF are now percent-encoded.
Chris@23 296