From: Michael Andreen Date: Mon, 19 May 2003 14:06:39 +0000 (+0000) Subject: *** empty log message *** X-Git-Url: https://ruin.nu/git/?p=moosique.git;a=commitdiff_plain;h=17d535e703a8ba178ad816d0a0cf4fa1ac787e5b *** empty log message *** --- diff --git a/Manual.txt b/Manual.txt index 940963f..9e6f30f 100644 --- a/Manual.txt +++ b/Manual.txt @@ -1,70 +1,50 @@ -============================================= - M o o s i q u e - version 1.0 +Annex B: User Manual - User Manual +INTRODUCTION +Moosique is a MIDI composer's tool for Java. The main purpose of the application is to play and compose music. While being intended for novices, some expert functions are provided. - © 2003 Roland Andersson, Mikael Andreen, - Björn Lanneskog & Einar Pehrson -============================================= -CONTENTS - 1. Introduction - 2. Getting Started - 3. Using Moosique - 3.1 Creating A MIDI Song - 3.2 Editing - 3.3 Saving and Loading Files - 3.4 Preferences - 3.5 Interface Guide - 3.6 Command-Line Syntax - 4. Troubleshooting - 5. Glossary -============================================= -1. INTRODUCTION - Moosique is a MIDI composer’s tool for Java. While being intended for novices, - some expert functions are provided. +GETTING STARTED +Since Moosique is an application bundled as a JAR file, it is run by executing the following command: java -jar moosique.jar. -2. GETTING STARTED - Since Moosique is an application bundled as a JAR file, it is run by executing - the following command: java –jar moosique.jar. When +USING MOOSIQUE +References to the red numbers in this overview picture is marked [ no. ] e.g. [ 3 ] in the manual. -3. USING MOOSIQUE -3.1 CREATING A MIDI SONG - Upon execution, the program will automatically create a MIDI sequence containing - three tracks – unless a MIDI file is given as a command-line argument. (See - section 3.6). At any time a new MIDI sequence can be created by selecting New - from the File menu. - -3.2 EDITING - Rolle? - -3.3 SAVING AND LOADING FILES - A file created or edited in Moosique can be saved to the standard MIDI file format - by using the Save and Save As options from the File menu. In order to load files, - choose Open from the File menu or give the filename as a command-line parameter - upon execution (See section 3.6). - -3.4 PREFERENCES - ??? - -3.5 INTERFACE GUIDE - Text - [Screenshot?] - -3.6 COMMAND-LINE SYNTAX - java -jar moosique.jar [-N] [filename] - - -N Starts playback of the given MIDI file without creating with user interface. - Ignored if a filename is not given. +CREATING A MIDI SONG +Upon execution, the program will automatically create a MIDI sequence containing three tracks - unless a MIDI file is given as a command-line argument. (See section "COMMAND-LINE SYNTAX"). At any time a new MIDI sequence can be created by selecting New from the File menu. + +EDITING +There are different properties that can be edited by the user. For every track in an combo box the tracks instrument [ 1 ] and channel [ 2 ] can easily be changed.. The output status of a track can be modified by clicking on the mute button [ 3 ] (the specific track is not played) or the solo button [ 4 ] (the specific track is the only track played). -4. TROUBLESHOOTING - Problem: Text - Solution: Text - - Problem: Text - Solution: Text - -5. GLOSSARY - Text -============================================= \ No newline at end of file +SAVING AND LOADING FILES +A file created or edited in Moosique can be saved to the standard MIDI file format by using the Save and Save As options from the File menu [ 5 ]. In order to load files, choose Open from the File menu or give the filename as a command-line parameter upon execution (see section "COMMAND-LINE SYNTAX"). + +If the current sequence has not yet been saved, a dialog will be displayed prompting the user to save or discard the sequence before creating or opening a new one. + +PLAY A MIDI SONG +By selecting the Playback menu [ 6 ] or clicking on one of the playback buttons [ 7 ] the MIDI song who is loaded can be played, stopped or paused. +PREFERENCES +By default, the application will use the Java standard synthesizer and sequencer. The MIDI device setup can be accessed by selecting Preferences from the Edit menu. + +COMMAND-LINE SYNTAX (FOR EXPERTS) +java -jar moosique.jar [-N] [filename] +-N Starts playback of the given MIDI file without creating with user interface. If no filenamne is given -N is ignored. + +SYSTEM REQUIREMENTS +For Moosique to run properly, the Java Runtime Machine installed on the computer must be version 1.3 or later. To play music it is needed to have a soundcard that supports MIDI installed (see your soundcard manual for information). + +TROUBLESHOOTING +Problem: The required MIDI devices cannot be allocated. +Solution: Call Moosique Support at +46-70-6017917 or +46-31-298879. + +GLOSSARY +Channel - In ordinary language, a channel is a path for passing data. In MIDI, channels are used to separate different sections of a song that are going to play together. Each channel is +assigned to a single instrument in any particular instant of time. One channel is usually reserved for a percussion voice. +Pitch - The property of a musical tone, determined by frequency. +Sequencer - So called because such a program arranges melodic and harmonic patterns in successive positions. Strictly speaking, one should define a sequencer has something that stores note-on and note-off events in memory, then plays them back. +Synthesizer - A device driven by a microprocessor, which contains a programmable chip. Examples of instruments that can control synthesizers: Guitar, keyboard, wind, string, drum controllers. The keyboard itself does not produce musical sound. A synthesizer circuit, built into the keyboard, accomplishes this function. Originally, a synthesizer was so called because it synthesized acoustic instruments. Nowdays, the term refers to the sound- +generating circuitry of any MIDI gear. Another term is sound module. +Time Signature - In traditional musical notations, this is expressed as a fractional sign, like 3/4. The denominator indicates the unit for the beat; the numerator shows the number of notes per measure. +Track - In MIDI, the term "track" designates a location where one records or plays back a musical message usually a portion of the total arrangement. To illustrate, one might record an oboe melody line on Track Two, then record a bowed bass line on Track Three. When +played, the sounds can be simultaneous. Most MIDI software now accommodates 64 tracks of music, enough for a rich orchestral sound. Important: Tracks are purely for convenience; channels are required. +Transpose - To perform a musical composition in a different key. Both synthesizers and sequencers can carry out this function. Velocity The MIDI way of determining how hard a note is pressed on the keyboard controller. diff --git a/MooDialog.java b/MooDialog.java index e4f3b0f..7038c90 100644 --- a/MooDialog.java +++ b/MooDialog.java @@ -470,26 +470,23 @@ public class MooDialog extends JDialog { */ public MooDialog(MooNote mn) { super(Moosique.getGUI(), "Note properties", false); + JPanel panel = new JPanel(); + panel.setLayout(new GridLayout(3,2)); note = mn; pitch = new JTextField(new Integer(note.getPitch()).toString(),3); - JPanel pitchpanel = new JPanel(); - pitchpanel.add(new Label("Pitch: ")); - pitchpanel.add(pitch); + panel.add(new Label("Pitch: ")); + panel.add(pitch); velocity = new JTextField(new Integer(note.getVelocity()).toString(),3); - JPanel velocitypanel = new JPanel(); - velocitypanel.add(new Label("Velocity: ")); - velocitypanel.add(velocity); + panel.add(new Label("Velocity: ")); + panel.add(velocity); length = new JTextField(new Integer(note.getDuration()).toString(),5); - JPanel lengthpanel = new JPanel(); - lengthpanel.add(new Label("Length: ")); - lengthpanel.add(length); + panel.add(new Label("Length: ")); + panel.add(length); Object[] array = {"Set the note properties", - pitchpanel, - velocitypanel, - lengthpanel}; + panel}; final String btnString1 = "Apply changes"; final String btnString2 = "Cancel";