HelperGUI

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> jm >> gui >> [ helper overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

jm.gui.helper
Class HelperGUI

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  jm.gui.helper.HelperGUI

All Implemented Interfaces:: javax.accessibility.Accessible, java.awt.event.ActionListener, java.awt.event.AdjustmentListener, jm.constants.Alignments, jm.constants.DrumMap, jm.constants.Durations, jm.constants.Dynamics, java.util.EventListener, jm.constants.Frequencies, java.awt.image.ImageObserver, jm.JMC, java.awt.MenuContainer, jm.constants.Noises, jm.constants.Panning, jm.constants.Pitches, jm.constants.ProgramChanges, jm.constants.RhythmValues, jm.constants.Scales, java.io.Serializable, jm.constants.Tunings, jm.constants.Volumes, jm.constants.Waveforms

public class HelperGUI
extends java.awt.Frame
implements jm.JMC, java.awt.event.ActionListener, java.awt.event.AdjustmentListener

This jMusic utility is designed to be extended by user classes. It will provide a simple graphical interface that speeds up the cycle of composing-auditioning-recomposing by minimising the need for recompiling simple changes. It is especially useful for novice Java programmers. To use the HelperGUI class write a standard jMusic class that extends this class. It shopuld have a main() method and a constructor. Make a super() call in the constructor. Overwrite the compose() method [which returns a Score object] and include the compositional logic in that method. To render a score as an audio file, an Instrument array needs to be declared and assigned to the Instrument array varianble 'insts' - which is already declared in the HelperGUI class. As in this example code fragment: Instrument sine = new SineInst(44100); Instrument[] instArray = {sine}; insts = instArray; There are five variables each with a slider that can be accessed to change values in the composition. Each variable, named 'variableA' to 'variableE', returns an integer values between 0 and 127.

Field Summary
`private java.awt.TextField`	`audioName`
`private java.awt.Button`	`audioPlayBtn`
`private java.awt.Button`	`audioStopBtn`
`private java.awt.Button`	`audioViewBtn`
`private java.awt.Label`	`commentLabA`
`private java.awt.Label`	`commentLabB`
`private java.awt.Label`	`commentLabC`
`private java.awt.Label`	`commentLabD`
`private java.awt.Label`	`commentLabE`
`private java.awt.Button`	`composeBtn`
`private java.awt.Button`	`histogramBtn`
`protected jm.audio.Instrument[]`	`insts`
`private java.awt.Label`	`labelA`
`private java.awt.Label`	`labelB`
`private java.awt.Label`	`labelC`
`private java.awt.Label`	`labelD`
`private java.awt.Label`	`labelE`
`private java.awt.TextField`	`midiName`
`private jm.midi.MidiSynth`	`ms`
`private java.awt.Button`	`notateBtn`
`private java.awt.Button`	`playBtn`
`private boolean`	`playing`
`private java.awt.Button`	`printBtn`
`private java.awt.Button`	`renderBtn`
`private java.awt.Button`	`saveBtn`
`protected jm.music.data.Score`	`score`
`private java.awt.Button`	`showBtn`
`private java.awt.Button`	`sketchBtn`
`private java.awt.Scrollbar`	`sliderA`
`private java.awt.Scrollbar`	`sliderB`
`private java.awt.Scrollbar`	`sliderC`
`private java.awt.Scrollbar`	`sliderD`
`private java.awt.Scrollbar`	`sliderE`
`private java.awt.Button`	`stopBtn`
`protected int`	`variableA`
`protected int`	`variableB`
`protected int`	`variableC`
`protected int`	`variableD`
`protected int`	`variableE`
`private java.awt.Button`	`xmlOpenBtn`
`private java.awt.Button`	`xmlSaveBtn`

Method Summary
`void`	`actionPerformed(java.awt.event.ActionEvent e)` Handle the button clicks in the GUI
`void`	`adjustmentValueChanged(java.awt.event.AdjustmentEvent ae)` This method is called when an adjustable value changes.
`protected jm.music.data.Score`	`compose()` This method should be overridden by classes that extend the HelperGUI class.
`private void`	`composeScore()`
`private void`	`histogramScore()` Display a score in the histogram viewer
`private void`	`makeBtnsVisible()`
`private void`	`notateScore()` Display a score with the notation viewer
`private void`	`playAudio()` Playback the audio file using jMusic real time audio
`private void`	`playScore()` Start MIDI playback
`private void`	`printScore()` print score data to the CLI
`private void`	`renderScore()` Save the score as an audio file
`private void`	`saveScore()` Save score as a standard MIDI file
`void`	`setVariableA(int value)` Specify the value for vaiable A
`void`	`setVariableA(int value, java.lang.String comment)` Specify the value and comment for vaiable A
`void`	`setVariableB(int value)` Specify the value for vaiable B
`void`	`setVariableB(int value, java.lang.String comment)` Specify the value and comment for vaiable B
`void`	`setVariableC(int value)` Specify the value for vaiable C
`void`	`setVariableC(int value, java.lang.String comment)` Specify the value and string for vaiable C
`void`	`setVariableD(int value)` Specify the value for vaiable D
`void`	`setVariableD(int value, java.lang.String comment)` Specify the value and string for vaiable D
`void`	`setVariableE(int value)` Specify the value for vaiable E
`void`	`setVariableE(int value, java.lang.String comment)` Specify the value and string for vaiable E
`private void`	`showScore()` Display a score with the show score viewer
`private void`	`sketchScore()` Display a score with the sketch score viewer
`private void`	`stopAudio()` Stop playback of the audio file
`private void`	`stopScore()` halt MIDI playback
`private void`	`viewAudio()` Show the saved audio file in the wave viewer
`private void`	`xmlOpen()`
`private void`	`xmlSave()`

Constructor Summary
`HelperGUI()`

jm.gui.helper Class HelperGUI

jm.gui.helper
Class HelperGUI