annotate README @ 228:fc04fd860d7f v0.4

v0.4
author Chris Cannam
date Tue, 11 Mar 2014 09:34:46 +0000
parents a9491d167efa
children 2dccb28a421f
rev   line source
Chris@103 1
Chris@103 2 Tony
Chris@103 3 ====
Chris@103 4
Chris@103 5 Tony is a program for computer-aided melody annotation. It has a
Chris@103 6 graphical interface based on the Sonic Visualiser libraries, and uses
Chris@103 7 the pYIN Vamp plugin to extract pitch track and notes from monophonic
Chris@103 8 audio.
Chris@103 9
Chris@103 10
Chris@103 11 Features
Chris@103 12 ========
Chris@103 13
Chris@103 14 * robust monophonic pitch track extraction
Chris@103 15 * note track extraction
Chris@103 16 * facility to adjust the note track
Chris@103 17 * note pitch adjusts to pitch track when notes are split
Chris@103 18 * import/export of pitch track and note track
Chris@103 19
Chris@103 20
Chris@103 21 Warning
Chris@103 22 =======
Chris@103 23
Chris@103 24 This program is still a prototype, which may change, and which
Chris@103 25 generally may not have the functionality you'd expect.
Chris@103 26
Chris@103 27
Chris@103 28 Note Editing
Chris@103 29 ============
Chris@103 30
Chris@103 31 A particular problem (see Warning, above) is the opaque editing
Chris@103 32 procedure. In order to edit notes, enter the multi-tool mode by
Chris@103 33 selecting the move button in the toolbar. There are four ways in which
Chris@103 34 you can change a note:
Chris@103 35
Chris@103 36 1. by clicking on the upper half of a note and dragging you can move
Chris@103 37 the note
Chris@103 38 2. by clicking on the beginning or end of a note and dragging you can
Chris@103 39 change the onset or offset time
Chris@103 40 3. by clicking into the bottom part of a note you can split the note
Chris@103 41 (this will recalculate the pitch of the resulting new notes)
Chris@103 42 4. by shift-clicking into the bottom part of a note you can delete
Chris@103 43 the note
Chris@103 44
Chris@103 45 By double-clicking into an empty part of the timeline you can create a
Chris@103 46 new note.
Chris@103 47
Chris@103 48
Chris@103 49 Authors, Citation, License and Use
Chris@103 50 ==================================
Chris@103 51
Chris@103 52 Tony was developed at the Centre for Digital Music, Queen Mary,
Chris@103 53 University of London. Authors include Chris Cannam, George Fazekas,
Chris@103 54 Matthias Mauch, Simon Dixon and others.
Chris@103 55
Chris@103 56 Code copyright 2005-2007 Chris Cannam and copyright 2006-2013 Queen
Chris@103 57 Mary, University of London, except where indicated in the individual
Chris@103 58 source files.
Chris@103 59
Chris@103 60 If you make use of this software for any public or commercial purpose,
Chris@103 61 we ask you to kindly mention the authors and Queen Mary, University of
Chris@103 62 London in your user-visible documentation. We're very happy to see
Chris@103 63 this sort of use but would much appreciate being credited, separately
Chris@103 64 from the requirements of the software license itself (see below).
Chris@103 65
Chris@103 66 If you make use of this software for academic purposes, please cite
Chris@103 67 one of the publications indicated on the Publications page:
Chris@103 68 https://code.soundsoftware.ac.uk/publications?project_id=tony
Chris@103 69
Chris@103 70 This program is free software: you can redistribute it and/or modify
Chris@103 71 it under the terms of the GNU General Public License as published by
Chris@103 72 the Free Software Foundation, either version 2 of the License, or (at
Chris@103 73 your option) any later version.
Chris@103 74
Chris@103 75 This program is distributed in the hope that it will be useful, but
Chris@103 76 WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@103 77 MERCHANTABILITY or FITNESS FOR A ARTICULAR PURPOSE. See the GNU
Chris@103 78 General Public License for more details. You should have received a
Chris@103 79 copy of the GNU General Public License along with this program. If
Chris@103 80 not, see http://www.gnu.org/licenses/.
Chris@103 81