Package eu.bandm.music.applications.tiTuning

Class TITuning

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

eu.bandm.tools.installer.DocumentedDistribution2<Options,GeneratedGui>

eu.bandm.music.applications.tiTuning.TITuning

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

@ResourceDependency({"data-dir/Farewell.midi","data-dir/Heyr.midi","data-dir/MansRoad.midi","data-dir/LimerickSuiteMulti.midi","data-dir/Sklaven.midi","data-dir/HerzliebsterWein.midi","data-dir/Dido.midi"})
public class TITuning
extends DocumentedDistribution2<Options,GeneratedGui>

Demonstration application of "transposition invariant tuning".

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class eu.bandm.tools.installer.DocumentedDistribution2

DocumentedDistribution2.Configuration<MM extends Model,GG extends Gui>

Nested classes/interfaces inherited from class javax.swing.JFrame

JFrame.AccessibleJFrame

Nested classes/interfaces inherited from class java.awt.Frame

Frame.AccessibleAWTFrame

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final TwelveToneFunctionalRepresentation	commonMinor
(package private) final JSequencerPanel	jSequencerPanel
(package private) final Map<String,FunctionalPitchModOctave>	piece2root
(package private) final Map<String,TwelveToneFunctionalRepresentation>	piece2scale
(package private) final TuningFilter	tuner

Fields inherited from class eu.bandm.tools.installer.DocumentedDistribution2

anyTabbedPane2textKey, anyTabbedPane2tooltip, button2textKey, buttonPanel, cmdLineDefinesTask, cmdLineIsEmpty, codePosition, completed_user_language_icons, configuration, DEnS_cs, DEnS_dir, emptyArgs, errorMsgField, exampleMenuItems, executeButton, firstSignerName, generationComment, guiPopulated, interactiveIsRequested, isInitialCall, isMuLi, jarRunning, jTabbedPane, KEY_about_additional_text, KEY_PATH_local_userdocumentation, KEY_ultra_short_description, KEY_URL_web_userdocumentation, label2textKey, languageButtons, languagePrefs, menu_lang, menu_languages_name, menu_languages_short, metatools_doc_url, msg, msgCounter, msgPrinter, msgStore, msgTee, msgTranslator, msgXML, optionsGui, optionsModel, PK_DEnS_digest, PK_DEnS_local_dir, PK_optionsLanguage, PK_optionsLastRun, programJavaClassName, resetToDefaultsButton, translatedAndFormatted

Fields inherited from class javax.swing.JFrame

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TITuning()	Calls the super constructor DocumentedDistribution2(Configuration) with all program specific configuration information in its argument.

Method Summary

Modifier and Type	Method	Description
protected void	addUserMenuItems()	No extensions necessary.
protected void	addUserPagesToTabbedPane()	No extensions necessary.
protected void	completeGuiPopulation()	Modify the standard look.
protected void	completeInfrastructure()	Called by the superclass before GUI or CLI are executed.
protected void	executeBatchOperation()	Do the real work, after all parameters have been parsed, edited, checked, etc.
(package private) void	loadTuner(TwelveToneFunctionalRepresentation interpretation, FunctionalPitchModOctave transpositionBase)	Load the tuner with the matrix which represents the interpreations of the MIDI keys (mod octave) "c", "c#", ..
static void	main(String[] args)	Main entry point, called from command line or by "clicking" a jar file icon, etc.
(package private) void	switchSong(String songname)

Methods inherited from class eu.bandm.tools.installer.DocumentedDistribution2

addMenu, addMuli_jTabbedPane, addMuli_jTabbedPane, addMuli_jTabbedPane, clearErrorMsg, closeDialogLink, compareLanguageSets, compareLanguageSets2, complete_icon_list, currentLanguage, dumpPreferences, dumpPreferences, executeBatchOperation_caught, getCriticalCount, getFirstSignerName, getRunningCodeSource, guiConfirmExit, insitu, insitu, insitu, INSITU, isInitialCall, isTampered, makeAboutDialog, makeCreditsText, makeMuli, makeMuli_anyTabbedPane, makeMuli_JLabel, makeStatusText, non_static_main, persistAllCmdLineArgs, persistentClear, persistentGetByteArray, persistentGetString, persistentPutByteArray, persistentPutString, populate, POSIX_print_help, POSIX_print_version, requestInteraction, selectExampleOptions, setErrorMsg, setMessageTableSeparatorKey, showPreferencesInDialogWindow, stripHtml, switchLanguage, switchLanguage_internal, switchToTab, terminateApplicationDueToSevereErrors, terminateApplicationDueToSevereErrors, terminateApplicationDueToSevereErrors_usage, translate, translate, translateAndExtractShortcut, translateNonRobust, updateLanguage_anyTabbedPane, updateStatusInformation, user_requests_documentation

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Details

tuner

final TuningFilter tuner

jSequencerPanel

final JSequencerPanel jSequencerPanel

piece2scale

final Map<String,TwelveToneFunctionalRepresentation> piece2scale

piece2root

final Map<String,FunctionalPitchModOctave> piece2root

commonMinor

final TwelveToneFunctionalRepresentation commonMinor

Constructor Details

TITuning

protected TITuning()

Calls the super constructor DocumentedDistribution2(Configuration) with all program specific configuration information in its argument. Additionally set the icon images of the created GUI window.

Method Details

switchSong

void switchSong(String songname)

addUserMenuItems

protected void addUserMenuItems()

No extensions necessary.

Specified by:

addUserMenuItems in class DocumentedDistribution2<Options,GeneratedGui>

addUserPagesToTabbedPane

protected void addUserPagesToTabbedPane()

No extensions necessary.

Specified by:

addUserPagesToTabbedPane in class DocumentedDistribution2<Options,GeneratedGui>

completeInfrastructure

protected void completeInfrastructure()

Called by the superclass before GUI or CLI are executed. Is executed in the main thread.

Overrides:

completeInfrastructure in class DocumentedDistribution2<Options,GeneratedGui>

completeGuiPopulation

protected void completeGuiPopulation()

Modify the standard look. Is executed in the Swing thread.

Specified by:

completeGuiPopulation in class DocumentedDistribution2<Options,GeneratedGui>

executeBatchOperation

protected void executeBatchOperation()

Do the real work, after all parameters have been parsed, edited, checked, etc. These can come either from the command line or from GUI interaction, are realized by DocumentedDistribution2.optionsModel and completely define the task to be executed.

Specified by:

executeBatchOperation in class DocumentedDistribution2<Options,GeneratedGui>

loadTuner

void loadTuner(TwelveToneFunctionalRepresentation interpretation,
 FunctionalPitchModOctave transpositionBase)

Load the tuner with the matrix which represents the interpreations of the MIDI keys (mod octave) "c", "c#", .. "b" = 0, 1, .. 11. For calculating the TI-coordinates (k, m) from FunctionalIntervals (d, h), the formulas are

     (k, m)      (d, h) 

                  d=k+m
                      h=2k+m
  k=h-d
                  m=d-k
                  m=d-(h-d)
  m=2d-h
 

main

public static void main(String[] args)

Main entry point, called from command line or by "clicking" a jar file icon, etc. Simply creates an instance and calls DocumentedDistribution2.non_static_main(String[]). This in turn is defined in the super class and handles all the different calling situations, including GUI control. Finally the parameters in DocumentedDistribution2.optionsModel will be set accordingly and executeBatchOperation() will be called to do the payload work.