mikowitz-webern

= Webern

http://github.com/mikowitz/webern

== DESCRIPTION:

Taking a 12-tone row generated from user input (see SYNOPSIS below), Webern will create the full matrix based upon this row, and then output all 48 possible rows created by that matrix out to a .pdf file using the LilyPond notational language.

Rake Tasks Provided:

• clear_ly_files - Removes rows.ly, rows.ps, and rows.pdf
• update_lib - Updates your lib/project_name.rb file to include all files in your lib/project_name/ folder
• update_manifest - Updates the gems Manifest.txt file to include any added files

== FEATURES/PROBLEMS:

• Not yet packaged as an installable gem. Coming soon, though. In the meantime, see the INSTALL section below.

== SYNOPSIS:

Webern can accept three different types of input.

• A full 12 tone row: $ webern 9 1 4 7 8 2 0 10 5 6 11 3

• An incomplete row, in which case the missing numbers will be added sequentially following what you have provided. See Webern::Webern.finish_partial_row: $ webern 0 6 10 9 4 7 (1 2 3 5 8 11 will be added by Webern)

• A string, which will be converted to a 12-tone row. See Webern::Webern.make_row_from_string: $ webern michael berkowitz

== REQUIREMENTS:

• No other gems, but you do need lilypond (http://lilypond.org/web/) to generate the .pdf file.

== INSTALL:

• Not packaged as a gem yet. Run rake install_gem from project root to install as a gem on your computer.

== LICENSE:

(The MIT License)

Copyright (c) 2008 FIX

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.