CLASSIC TRANSPOSITION DIALOG

The following documentation describes the 8 areas of the Classic Transposition dialog. The subsidiary dialogs are described later in this article. Experienced users should only have to read the section for the Set Fixed Pitch Transposition Dialog.

You can skip the Classic Transposition dialog and apply the transposition settings previously set when selecting it from the Plug-In Menu by holding down the Shift key.

If you are using Finale 2001 or later, clicking in the horizontal zoom box will toggle the dialog size between full size and pint size.

There are 8 functional groups plus an area for the 'Apply', 'Done', and 'Play' buttons in the main dialog.

The 'Type' Group:

Diatonic/Chromatic

Choose between the standard transposition types: diatonic or chromatic.

The 'Interval' Group:

Unison/Second/Third/Fourth/Fifth/Sixth/Seventh/Octave

For diatonic or chromatic transpositions, choose the interval for the current transposition operation.

The buttons in this group will be dimmed if one of the custom transpositions in the 'More Types' area has been selected.

The 'Direction' Group:

Up/Down

Determines which direction will be applied to the current transposition setting. Note that this item is mitigated by the choice in the 'Octave Offset' area. For example, if the choice is Diatonic/Up/Fifth, and the octave offset is -1, the net transposition is downwards a diatonic fourth.

The direction setting does not affect the 'Fixed Pitch' type of transposition and is dimmed for that operation.

The 'Alteration' Group:

Doubly Augmented/Augmented/Perfect|Major/Diminished|Minor/Doubly Diminished|Diminished

Select the alteration for a chromatic transposition. Proper nomenclature appears according to the type of interval selected. For example, choosing a fourth from the interval group will supply the middle button in the 'Alteration' group with the label "Perfect". Choosing "Third" from the 'Interval' group will give the middle button in the 'Alteration' group the label "Major".

If the interval type is changed while the 'Alteration' group is active, the current alteration relative to the interval is maintained.

The items in this area are dimmed when any transposition setting other than Chromatic is selected.

The 'Octave Offset' Group:

TextBox/Arrows

Offsets the current transposition by the selected amount of octaves. The current limit is plus or minus 7 octaves. The arrows are a convenience for users who prefer to use a mouse.

The 'Settings' Group:

Transposition/Features

  Transposition Popup Menu:

The Transposition Menu provides a means to choose which score items in a selection region will be affected by a transposition.

• Transpose Notes/Transpose Chords/Transpose Alternate Bass

  When a black diamond mark appears to the left of any of these items, it will be affected on subsequent transposition operations. You must enable at least one of these electives to be able to perform a transposition.

• Lock Note Expression Positions

  A check mark will appear to the left of this item when it is in effect. It permits transpositions which leave the position of Note-Attached Expressions (also known as Staff Expressions) relative to the staff they are on unchanged. If none of the Transposition Options listed immediately above are selected, the effect of this item is to move note-attached expressions contrary to the direction of the current transposition.

• Use Note Spelling

  A checkmark on this item means that the note spelling settings which have been selected in the Spelling Setup dialog will affect a selected region.

• Use Chord Spelling

  A checkmark on this item means that the chord spelling settings which have been selected in the Spelling Setup dialog will affect a selected region.

• Use Alternate Bass Spelling

  A checkmark on this item means that the alternate bass spelling settings which have been selected in the Spelling Setup dialog will affect a selected region.

• Spelling Setup…

  Invokes the Spelling Setup dialog (documented below). A check mark will appear to the left of this item when any spelling options are currently active. The Spelling Setup dialog provides access to separate spelling table dialogs for notes, chords, and alternate basses.

• Edit Note Spelling Table…

  Invoke the Note Spelling Table dialog. See below for what it does.

• Edit Chord Spelling Table…

  Invoke the Chord Spelling Table dialog. See below for what it does.

• Edit Alternate Bass Spelling Table…

  Invoke the Alternate Bass Spelling Table dialog. See below for what it does.

  Features Popup Menu:

Settings affecting the visual appearance and operation of the Classic Transposition dialog, and lastly, the 'Documentation…' item (which chooses this dialog).

• Show|Hide Transposition Values

  Show|Hide Transposition Values toggles the appearance of two small boxes which display the current values of the interval and alteration settings. These settings reflect the current transposition as represented in Finale's Enigma terms:

  Intervals are represented as integers which increment by one for each upward diatonic step and decrement by one for each downward diatonic step from a unison.

  Alterations (sharps or flats) are represented as integers which increment by one for each additional sharp and decrement by one for each additional flat from a natural note.

  These items can provide assistance when calculating custom transpositions.

• Synchronize Intervals

  When enabled, a check mark appears to the left of this menu item. It will synchronize the intervals between the Diatonic and Chromatic choices in the 'Type' group.

• Change Button Style

  Choose between standard radio buttons or toggle buttons for the look of the main dialog according to your preference.

• Documentation…

  Calls up this window, the operation and features of which are descibed below. In addition to the built-in menu key combination (Command - ?), you may also use the Help key on your keyboard for the same effect (while the Classic Transposition dialog is active).

The 'More Types' Group:

Custom Diatonic…/Custom Chromatic…/Fixed Pitch…

  Custom Diatonic…

Invokes the 'Set Custom Diatonic Transposition' dialog where you can assign a custom diatonic transposition.

  Custom Chromatic…

Invokes the 'Set Custom Chromatic Transposition' dialog where you can assign a custom chromatic transposition.

  Fixed Pitch…

Invokes the 'Set Fixed Pitch Transposition' dialog where you can set the transposition of notes, chords, and alternate basses in a selection region to a single (key-relative) pitch. You can also choose a single chord suffix to be applied, opt to eliminate duplicate notes, and preserve ties in the region to be affected.

Usage of these dialogs are described below in separate sections.

The 'Options' Group:

  Keep Original Notes

If checked, the transposition will be performed and then a copy of the original notes added to the entry. You should be aware however that Finale has a limit of 12 notes per entry. Classic Transposition will constrain entries to this limit when opting to keep original notes. The newly transposed notes have priority in this case.

Note that there may be some side-effects to consider if the 'Lock Note Expression Position' feature is active.

Apply/Done/Play Buttons:

  Apply

Clicking the Apply button, will transpose a selected region in the current score according to the settings in the Classic Transposition dialog. Press the <Return> or <Enter> keys when the Classic Transposition dialog is active for the same effect.

  Done

Clicking the Done button closes the Classic Transposition dialog and automatically saves its window position and all transposition settings currently in effect. The same effect is attained by clicking on the Close Box of the window, pressing the <Escape> key, or using the command key equivalents <Command + '.'> or <Command + 'w'>. Closing the Classic Transposition dialog has no effect on whether or not its documentation window (this window) remains on the screen or not.

  Play

Plays the current selection or the whole document if there is no selection. Once started, playback is stopped by clicking anywhere.

SPELLING SETUP DIALOG

Notes/Chords/Alternate Bass Checkbox Groups

  Notes

  Chords

  Alternate Bass

Use the check boxes to indicate that you wish the particular spelling option to be accounted for when transposing. These settings are reflected in the "Transposition Menu" in the main dialog by the use of checkmarks for the "Use Note Spelling",' "Use Chord Spelling, and "Use Alternate Bass Spelling" items.

• Prefer Sharps/Prefer Flats/Use Tables

  The Prefer Sharps, Prefer Flats, and Use Tables buttons may appear as either radio buttons or toggle buttons according to which type of button you have chosen to use in the Classic Transposition dialog. Each of these buttons sets the spelling mode to be used when transposing if its enclosing checkbox has been enabled.

• Edit Table…

  The Edit Table push buttons will call up the appropriate Note, Chord, or Alternate Bass Spelling Table dialog to be edited. These dialogs are described below.

  Set

Sets the spelling options for subsequent transpositions and closes the dialog. All these options are saved with the preferences for the Classic Transposition dialog.

  Cancel

Returns to the classic transposition dialog leaving the previous spelling settings unchanged. However, any changes that have been made in any of the subsidiary dialogs for altering spelling tables are saved or left untouched in those individual dialogs.

NOTE SPELLING TABLE DIALOG
CHORD SPELLING TABLE DIALOG
ALTERNATE SPELLING TABLE DIALOG

  Major Scale Steps

  Minor Scale Steps

Click on the buttons labeled either sharp or flat to toggle the spelling of the chromatic notes in the scale.

  Set

Sets the current note, chord, or alternate bass spelling table. The settings for the tables are saved with the user preferences.

  Cancel

Returns to the Spelling Setup dialog leaving the previous settings unchanged.

SET CUSTOM DIATONIC TRANSPOSITION DIALOG

Interval/Interval Text Box/Accidentals/ Accidentals Text Box/ Octave Offset Text Box

  Interval/Interval Text Box

Choose an interval category from this popup menu or enter a value in the associated text box.

  Accidentals/Accidentals Text Box

Choose an accidental category from this popup menu or enter a value in the associated text box.

  Octave Offset Text Box

Enter the octave offset for a custom diatonic transposition. Octave offsets are shared amongst all transposition categories.

  Set

Sets the values for a custom diatonic transposition which will be applied in the Classic Transposition dialog.

  Cancel

Returns to the Classic Transposition Dialog leaving the previous settings unchanged.

SET CUSTOM CHROMATIC TRANSPOSITION DIALOG

Interval/Interval Text Box/Accidentals/ Accidentals Text Box/ Octave Offset Text Box

  Interval/Interval Text Box

Choose an interval category from this popup menu or enter a value in the associated text box.

  Accidentals/Accidentals Text Box

Choose an accidental category from this popup menu or enter a value in the associated text box.

  Octave Offset Text Box

Enter the octave offset for a custom chromatic transposition. Octave offsets are shared amongst all transposition categories.

  Set

Sets the values for a custom chromatic transposition which will be applied in the Classic Transposition dialog.

  Cancel

Returns to the Classic Transposition Dialog leaving the previous settings unchanged.

SET FIXED PITCH TRANSPOSITION DIALOG

Make Single Note/Use Chord Suffix/Pitch Factors/Set/Cancel

  Make Single Note

Enabling this check box will reduce the number of notes in an entry to one for fixed pitch transpositions (over-riding the 'Keep Original Notes' checkbox in the main dialog).

• Preserve Ties

  If this check box is enabled, an entry which has a tie on any of its notes will be considered to have a tie for the purposes of reducing the entry to a single note.

  Use Chord Suffix

Determines whether or not chord suffices will be altered for a fixed pitch transposition and if so, which chord suffix will be used.

• Chord Suffix ID…

  Invokes the Chord Suffix Selection dialog box where you may choose which chord suffix to use for a fixed pitch transposition.

• Chord Suffix ID Text Box

  Enter the number of a chord suffix to use for a fixed pitch transposition. If this number is set to zero, no chord suffix will be used.

  Pitch Factors

Scale Degree/Scale Degree Text Box/Accidentals/ Accidentals Text Box/Octave Offset Text Box

• Scale Degree/Scale Degree Text Box

  Choose a scale degree from the popup menu or use the associated text entry box to select the scale degree for a fixed pitch transposition.

• Accidentals/Accidentals Text Box

  Choose the number of accidentals from the popup menu for a fixed pitch transposition or enter a number in the associated text entry box.

• Octave Offset Text Box

  Enter the octave offset for a fixed pitch transposition. Octave offsets are shared amongst all transposition categories.

  Set

Sets the values for a fixed pitch transposition which will be applied in the Classic Transposition dialog.

  Cancel

Returns to the Classic Transposition Dialog leaving the previous settings unchanged.

DOCUMENTATION WINDOW

This window's purpose is to display documentation, authorship, and copyright notices for the Classic Transposition Plug-In. It has standard key combinations to assist navigation through the text. You may re-size or zoom this window to accomodate your viewing requirements.

Three menu items are enabled. The window's menus are located above the vertical scrollbar in two small iconic representations.

  Navigation/Selection Arrow Keys

Up/Down/Left/Right	Perform standard motions though the text.
Option-Right/Left	Move through the text by a word at a time.
Option-Up/Down	Move the insertion point through the text a screenful at a time.
Option-Shift-Right/Left	Select the text by a word at a time.
Option-Shift-Up/Down	Select the text a screenful at a time.
Command-Up	Moves the insertion point and the display to the top of the document.
Command-Down	Moves the insertion point and the display to the bottom of the document.
Command-Left	Moves the insertion point to the beginning of the line it is on.
Command-Right	Moves the insertion point to the end of the line it is on.
Command-Shift-Up	Select text from the insertion point to the top of the document.
Command-Shift-Down	Select text from the insertion point to the bottom of the document.
Command-Shift-Left	Select from the insertion point to the beginning of the line it is on.
Command-Shift-Right	Select from the insertion point to the end of the line it is on.
Shift-Up/Down	Select upwards or downwards a line at a time.
Shift-Right/Left	Select right or left by a character at a time.

  Mouse with Modifier Key

• Command-Click

  Selects a word. For the purposes of extending a selection, the anchor point is marked at the beginning of a word.

• Shift-Click

  Extends the selection from the anchor point to the character nearest the mouse click.

  Menu Keys

• Command-W

  Close the window.

• Command-A

  Select all the text in the document.

• Command-C

  Copy (styled) text to the clipboard.

• Command-Q

  Is passed through to the application. Thus normal quit operations are performed.

 File Menu

• New

  Disabled in this version.

• Open

  Disabled in this version.

• Close

  Closes the window. Before closing the window you may select text and copy it to the clipboard, use its Drag&Drop feature to put the text into the window of another application, or drag it to save as a text clipping in the Finder.

• Quit Finale

  Disabled in this version. (Although the Command-Q key combination is passed through to the application.)

  Edit Menu

• Undo

  Disabled in this version.

• Cut

  Disabled in this version.

• Copy

  Copy the selected text to the clipboard

• Paste

  Disabled in this version.

• Clear

  Disabled in this version.

• Select All

  Select all the text in the window.

This window may be kept on the screen even if the Classic Transposition dialog is closed.

AUTHORSHIP

• Classic Transposition is written by Philip Aker, a composer and pianist from Vancouver BC, Canada, who thanks the many users of its previous versions for their comments and suggestions.
  
  

COPYRIGHTS

• Classic Transposition is Copyright © 1999-2000, Philip Aker All Rights Reserved.

• Copyright for "The Finale Plug-In Developer's Kit" used to interface this plug-in with Finale belongs to: Coda Music Technology . Finale® is a registered trademark of Coda Music Technology

• Copyright for the World Scriptª-Aware Text Engine (WASTE) used as the foundation for text features belongs to: Marco Piovanelli (WASTE text engine © 1993-1997 Marco Piovanelli)
  
  

Document Copyright © 1999-2000, Philip Aker All Rights Reserved.

§