Arboretum Systems Harmony User Manual

Arboretum Harmony Manual
Table of Contents
Copyright ©1999 by Arboretum Systems, Inc. This documentation may not, in whole or in part, be copied, reproduced or translated without prior written consent of
Arboretum Systems.
Arboretum Harmony Manual
Table of Contents
Getting Started
Using Arboretum Harmony
Command Reference
Link to HyperEngine Manual Appendix A: Troubleshooting
About This Manual
The documentation may be viewed or printed from any browser, such as Netscape Navigator or Microsoft Internet Explorer. If the text is too small or you wish to change the background color, go into your browser's Preferences and set them as you wish. Internet Explorer users, just hit the Larger button on your browser tool bar. Important: For better scrolling comfort use the scroll thumb, or the page up/page down keys, rather than the up and down arrows.
Manual Conventions
Throughout this manual, you will see several different symbols in sections describing step-by-step operations.
Text
following a right pointing arrow invites you to execute a command with the mouse or keyboard.
Text following a down pointing arrow describes the result produced by executing a command.
A pointing hand indicates an important note! Underlined text indicates a Hyper link; mouse-click on the link to access more information on the topic If your Browser is connected to the Internet, you can visit us by clicking the button below to get more information and the
latest available software and documentation updates.
For any questions, either reach us at the web site, call us at (650) 738-4750 or send us an email at:
harmony@arboretum.com
This documentation current to Arboretum Harmony version 1.0, last revised 2/17/99 Copyright ©1999 by Arboretum Systems, Inc. This documentation may not, in whole or in part, be copied, reproduced or translated without prior written consent of Arboretum Systems
Credits
Arboretum Harmony and HyperEngine programmed by Chris Weare Documentation by Todd Souvignier Interface design by Georges Jaroslaw Scales for Harmony by Aram Lindahl
For Arboretum Systems:
Georges Jaroslaw, CEO Chris Weare, CTO Zhi Liu, CFO Todd Souvignier, Marketing Director Richard Lee, Sales Director Trevor Paglen, Office Manager
Arboretum Systems Inc. 75 Aura Vista, Pacifica California 94044 (650) 738-4750, fax (650) 738-5699, http://www.arboretum.com
ARBORETUM SYSTEMS SOFTWARE LICENSE AGREEMENT
Arboretum Systems ("Arboretum") is willing to license the enclosed HyperEngine and Arboretum Harmony software ("Software") only upon the condition that you accept all the terms of this Agreement. If you do not agree to these terms, then Arboretum is unwilling to license the Software to you, in which event you must return immediately, and in no case later than ten (10) days from the date of purchase, the unopened diskette package (and accompanying items including manual, other documentation and container) together with your proof of purchase, to the place from which it was acquired for a refund.
LICENSE: You may use the enclosed Software on a single computer. The Software is in use when it is installed into permanent memory (such as a hard disk or other storage device) or loaded into temporary memory (RAM) of that computer. The Software is copy protected.
RESTRICTIONS: You may not transfer, modify, rent, lease, loan, resell, distribute, network, electronically transmit or merge the Software. You may also not reverse engineer, decompile or disassemble the Software, or otherwise attempt to discover the Software source code. You are not permitted to copy the Software (except to make an archival copy for back-up purposes) or any of the accompanying documentation. Any attempt to transfer any of the rights, duties or obligations hereunder except as expressly provided for in this Agreement is void.
COPYRIGHT: The Software (including audio, music, text, images and animations incorporated into the Software) and accompanying documentation are owned by Arboretum or its suppliers and are protected by United States copyright laws and international treaties. Unauthorized reproduction or distribution of the software or documentation is subject to civil and criminal penalties.
LIMITED WARRANTY: Arboretum warrants for the period of thirty (30) days from the date of delivery of the Software to you, as evidenced by a copy of your receipt, that: (1) The Software will perform substantially in accordance with the user documentation provided by Arboretum. Your sole remedy under this warranty is that Arboretum will, at its option, either repair or replace the Software which does not meet this Limited Warranty, or refund to you the money paid for the
Software. Arboretum does not warrant that the Software will meet your requirements, that operation of the Software will be uninterrupted or error-free, or that all software errors will be corrected. (2) The medium on which the Software is furnished will be free from defects in materials and workmanship under normal use. Arboretum will, at its option, either repair or replace the faulty medium at no charge to you, provided you return the faulty medium with proof of purchase to Arboretum.
This Limited Warranty is void if any failure of the Software or any damage to the medium is due to accident, disaster, abuse, misapplication, modification of the Software and/or violation of any of the terms of the License Agreement.
The above warranties are exclusive and in lieu of all other warranties, express or implied, and Arboretum expressly disclaims all other warranties, including the implied warranties of merchantability, fitness for a particular purpose and non-infringement. No oral or written information or advice given by Arboretum, its employees, dealers, resellers, distributors or agents shall increase the scope of the above warranties or create any new warranties. Some states do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. In that event, any implied warranties are limited in duration to thirty (30) days from the date of delivery of the software. This warranty gives you specific legal rights. You may have other rights, which vary from state to state.
LIMITATION OF REMEDIES: Arboretum's entire liability to you and your exclusive remedy shall be the repair or replacement of the Software, the repair or replacement of the Software medium, or the refund of your purchase price, as set forth above. In no event shall Arboretum's liability to you or any third party exceed the purchase price paid for the Software.
Regardless of whether any remedy set forth herein fails of its essential purpose, in no event will Arboretum or its authorized dealers, resellers or distributors be liable to you (1) for any damages, including any lost profits, lost data, other incidental or consequential damages, arising out of the use or inability to use the Software or any data supplied therewith, even if Arboretum has been advised of the possibility of such damages, or (2) for any claim by any other party. Some states do not allow the limitation or exclusion of liability for incidental or consequential damages so the above limitation or exclusion may not apply to you.
GENERAL: This Agreement will be governed by the laws of the State of California, except for that body of law dealing with conflicts of law. If any provision of this Agreement is held to be unenforceable, that provision will be removed and the remaining provisions will remain in full force. This Agreement is the complete and exclusive statement of the agreement between us which supersedes any proposal or prior agreement, oral or written, and any other communications between us in relation to the subject matter of this Agreement. If you have any questions concerning this Agreement, you may contact Arboretum by writing to Arboretum Systems, 75 Aura Vista, Pacifica California 94044. Arboretum Harmony and HyperEngine are trademarks of Arboretum Systems.
You acknowledge that you have read this Agreement, understand it, and agree to be bound by its terms.
[First Chapter]
Getting Started
System Requirements Arboretum Harmony requires a 200 MHz or faster Power Macintosh (or compatible) with a minimum of 20 Megabytes of
free RAM for HyperEngine, running MacOS 7.6 or later and the Sound control panel version 8.0 or later. If you're using a MacOS version earlier than v8.0 the Sound Manager system extension version 3.2.1 or later will also be required.
Arboretum Harmony requires HyperEngine 2.4.2 or later, which is included automatically in the Arboretum Harmony installation.
To use new CD audio import and foreign file import/export features QuickTime 3 is required. This can be downloaded free of charge from Apple's web site.
You should also possess a basic knowledge of the Macintosh operating system. This includes knowing how to use the mouse, windows, menus, etc. If these terms are strange to you, please consult your Macintosh documentation.
Compatibility HyperEngine and Arboretum Harmony have custom support for the Apple Macintosh built-in sound hardware, the Korg
1212 I/O and the Digidesign Audiomedia II and III cards. Other audio hardware, including Pro Tools systems, are compatible with HyperEngine and Arboretum Harmony with use of manufacturer-supplied Sound Manager drivers (such as the Digidesign Sound Drivers).
HyperEngine and Arboretum Harmony are incompatible with RAM Doubler and Virtual Memory. HyperEngine and Arboretum Harmony are fully compatible with all other known system extensions ("Inits") and control
panels. Arboretum Harmony requires HyperEngine 2.4.2 or later, which is included automatically in the Arboretum Harmony
installation. Be sure to check out Appendix A-Troubleshooting for more information on optimizing performance and eliminating
system conflicts. Also take a look at the chapter on HyperEngine and the Sound Manager for information about hardware compatibility.
HyperEngine and Arboretum Harmony support SDII and AIFF audio files and 8 and 16 bits, and a variety of sampling rates including common multiples of 44.1 and 48 kHz, as implemented by your audio hardware. HyperEngine also imports/exports a wide variety of file formats other than SDII and AIFF through QuickTime 3.
Setup Procedure
Before Beginning
When first opening your Arboretum Harmony package you will find the following ingredients:
Please fill out your registration card and mail or fax it to Arboretum Systems as soon as possible in order to:
Note that in order to receive ANY telephone support or technical assistance from Arboretum Systems, you MUST be a registered user.
Installing Arboretum Harmony and HyperEngine
HyperEngine requires no special installation and is not copy protected. Arboretum Harmony however is copy protected. Please read this section once through entirely and then follow these steps exactly!
Insert the Arboretum CD in your CD-ROM Drive.
Double click on the folder labeled "Product Installers."
Once inside the "Product Installers" folder, double-click on the "Arboretum Harmony" Installer.
Mouse-click past the Arboretum Logo display, click on Accept to accept the terms of the software license agreement, then after reading/printing the subsequent ReadMe display, click on OK to proceed to the installation.
You're now at the main installation screen:
Click on Switch Disk if you need to specify another drive for installation.
Click on the Install button.
Next you'll be asked for your name (mandatory), company (optional) and Arboretum Harmony serial number
(mandatory). We've gone ahead and entered the first several numerals for you.
Make sure you're entering an Arboretum Harmony serial number. These numbers begin in every case with the character string "1411."
Make sure you enter your serial number accurately. Double check your entry. When all fields are complete the OK button will highlight. Click on OK to proceed.
The installer will commence with copying the Arboretum Harmony plug-in and HyperEngine application to your hard drive. The software will be installed into a new folder called "Arboretum f." Assuming all the previous steps were completed successfully, you should next see the following prompt:
Since you're doing an Easy Install, there's probably little need to perform additional installation. Click on the Quit
button to proceed to the final stage of the installation.
Now the Arboretum Serializer springs into action. The Serializer automatically applies your earlier serial number
input to the Arboretum Harmony plug-in, so as to unlock the plug-in prior to first usage. You'll see the following prompt:
Click on the OK button to proceed and conclude.
Your Arboretum installation is now finished! The software will be installed into a new folder called "Arboretum f."
Problems? If any difficulty arises during the course of installation, check out the installation tips at the end of this
chapter, or the complete Troubleshooting section of this manual.
Allocating Memory to HyperEngine
As with any real-time digital audio application, HyperEngine will perform best with adequate memory. Arboretum Harmony requires that a minimum of 20 MB of RAM be allocated to HyperEngine, preferably more. To adjust the amount of memory (RAM) you are allocating to the HyperEngine, locate the HyperEngine application's icon.
The HyperEngine application's icon
Mouse-click once on this icon, so that it is highlighted (don't double click, or you'll launch the program.)
Next, type command-i or select Get Info from the MacOS File menu.
The HyperEngine's Get Info dialog. Note Memory Requirements settings, lower right hand corner
The Get Info dialog allows you to set the minimum and preferred memory amounts for the program. If you have plenty of RAM, feel free to allocate more to the HyperEngine. Ensuring that you have plenty of memory is key to smooth performance. If you're encountering repeated crashes and freezes, the most likely cause is simply running out of program memory.
Locating HyperEngine Effects
HyperEngine places its effects plug-ins (such as Arboretum Harmony) in a folder called "HyperEngine Plug-Ins." This folder must be in the same folder as the HyperEngine application.
This is the default configuration upon installation, and assuming you haven't moved these components around, you won't need to worry about it further. HyperEngine also needs to see its IO Drivers folder, read the next section for details. See the documentation on your individual plug-ins for more information on their installation and hard-disk authorization.
Installing HyperEngine Drivers
HyperEngine includes special custom drivers for the Digidesign Audiomedia II and Audiomedia III cards, plus the Korg 1212I/O card and the Apple Sound Manager. HyperEngine looks for its drivers in a folder called "HyperEngine IO
Drivers." This folder must be in the same folder, at the same directory level, as the HyperEngine application (as illustrated above.) This is the default configuration upon installation, and assuming you haven't moved these components around, you won't need to worry about it further.
If you have a supported sound card, these custom drivers eliminate the need for using special Sound Manager drivers, such as the Digidesign Sound Drivers. Select the desired driver and sound hardware in HyperEngine's Preference menu. Use the Configure Audio System dialog to set up the hardware.
Problems? If any unexpected error messages come up during the course of installation, or if the Installer fails to place the HyperEngine application, its IO Drivers and the Arboretum Harmony plug-in into your target drive's "Arboretum f" folder, immediately quit the Installer and Restart your computer while holding the shift key down, so as to temporarily disable all Extensions and eliminate any possible system conflicts. (If your CD ROM drive is not an Apple built-in model, you may have to forego turning off Extensions.)
Once restarted, go into the System folder, open the Preferences folder and drag the Hyperprism &/or Harmony Preferences file into the Trash. Deleting the Preferences files will clear out the results of a faulty serialization procedure. Then run the Installer again and follow the preceding installation steps as directed. Also make sure you're using the correct Arboretum product serial number. Arboretum Harmony, Hyperprism 2 (for HyperEngine), Ionizer, Ray Gun, Hyperprism-TDM and Hyperprism-Plug-in Pack are each sold separately, and each require their own unique serial numbers.
If Trouble Persists: Link over to the Troubleshooting chapter of this manual. Also take a look at the Support frame up on the Arboretum web site <http://www.arboretum.com> for the latest technical notes and troubleshooting tips. If all else fails
either email mactech@arboretum.com or phone our service line during our regular weekday business hours, 10 am to 6 pm Pacific: (650) 738-4750
[Table of Contents] [Next Chapter]
Using Arboretum Harmony
Overview
Arboretum Harmony was designed to provide a focused, fast-working and top-quality solution to the problems of pitch correction, harmonization and vocal arranging. The simple graphic tools allow one to adjust an inflection or design the most complex independent parts with a few quick mouse drags. Such ease and freedom has never before existed in any hardware or software pitch processing tool.
These advances in interface design come on top of Arboretum's extensive research into formant-based audio processing. A number of proprietary advances in pitch shifting, including formant preservation, make Arboretum Harmony sound more realistic compared to other pitch changing effects. Protecting singers' natural vibrato has been a special problem for earlier pitch correctors; Arboretum Harmony excels at maintaining that lifelike quality.
Arboretum Harmony and HyperEngine
Arboretum Harmony 1.0 runs within Arboretum's HyperEngine, which is a freely-distributed sound editing program. HyperEngine 2.4.2 or later is required to operate Arboretum Harmony. All basic file operations, such as opening, selecting and rendering, and all playback/record features are accessed through the HyperEngine.
We've color-coded Arboretum Harmony and HyperEngine so the components are easy to distinguish: Harmony is brown, while the HyperEngine transport controls and edit screen are blue. All menubar items (menus such as File, Edit, Plug-ins and Preference) are components of HyperEngine; Arboretum Harmony's own controls are all contained within the brown plug-in window.
Detailed HyperEngine documentation is over in the HyperEngine Guide; this document will focus on Arboretum Harmony exclusively. Important HyperEngine topics mentioned here are linked to their entries in the HyperEngine Guide.
General Usage and Organization
Arboretum Harmony will process mono (one channel) audio files; stereo files are not supported in the initial 1.0 release. The pitch detection algorithm assumes that input will be a monophonic (one voice) melody line such as a sung vocal part or instrumental solo. Polyphonic input, such as instrumental chords or a vocalist with accompaniment will confuse the pitch detector and produce unpredictable results.
Arboretum Harmony is organized around a central Note Screen where graphic editing takes place. The Mixer Window provides control over harmony voice playback; voices must be "un-muted" in the Mixer in order to be heard and edited in
the Note Screen. Arboretum Harmony will generate up to eight individual harmony parts and will render the process to a mono or stereo
SDII or AIFF files. Up to nine part arrangements can be made if you utilize the raw input voice. The number of separate voices which can be heard in real-time preview, while editing, is limited by your particular computer's clock speed.
Previewing with more Harmony voices active than your computer has processing power for may result in system
crashes. Real-time performance can be improved by running in Preview mode and eschewing formant shifting. In Preview mode a
G3 350 will do 8 voices as will an iMac. 200 MHz 604e machines can preview 6 to 7 voices. Those using slower machines can run in Preview mode, selectable in the Process window. Preview mode sacrifices some
sound quality for increased performance. In general, Normal mode requires two and a half times the processing power required for Preview mode. For example, if you can only hear 2 voices in Normal mode then you can expect to hear 4 to 5
simultaneous voices in Preview mode. Arboretum's proprietary pitch shifting technology allows Arboretum Harmony to preserve the natural formant of shifted
vocal parts for greater naturalism. One may also adjust the formant so as to create cool head-shrinker effects. A Humanize parameter is also provided for each voice to enhance the realism of vocal choirs.
Pitch Correction is an automated feature in Arboretum Harmony and several settings are provided under the Process display to guide that operation. Pitch Correction relies on the Scale which is shown in the Notes Screen. The displayed scale can be easily recalibrated. A selection of Preset Scales are provided, custom user scales can likewise be created.
Each one of Arboretum Harmony's functions are documented below. But before going any farther, take five minutes and run through the following Quick Start Tutorial.
Quick-Start Tutorial
This tutorial covers the essential steps in using Arboretum Harmony and HyperEngine. It will orient you to the HyperEngine controls and the Arboretum Harmony Note screen and Mixer display.
Launching Arboretum Harmony
Assuming you've successfully followed the Set Up procedure, the Arboretum Harmony plug-in will be installed in the HyperEngine Plug-ins Folder, which resides inside a folder named "Arboretum f."
Inside the "Arboretum f" folder, within the HyperEngine folder, you'll find the HyperEngine application, Plug-ins and Drivers.
Double-click on the HyperEngine program icon.
HyperEngine will launch. You'll see the HyperEngine transport palette appear:
Load a new sound file: Type command-n or select New File Document from the File menu. Use the resultant file dialog to locate and select the desired file for processing.
For this lesson, try one of the example files on the Arboretum CD-ROM. Locate in the Sound Examples folder the
sound file named "Aram."
Remember, Arboretum Harmony is intended for use on monophonic melodic parts, such as a solo voice or instrument. Processing polyphonic audio - such as chords, or a full band arrangement - produces unpredictable results and is beyond the scope of the intended use.
Selected audio file will appear on screen.
Mouse drag through the waveform display to select any region for processing, or type command-a to select all.
From the Plug-ins menu (at the top of the screen) select the Arboretum Harmony plug-in.
After a moment the Arboretum Harmony plug-in will launch. The Notes Screen is shown on startup by default.
Notes Display: Pitch Correction
Mouse click on the Calc button on the top of the Notes screen.
After a brief calculation period you'll see a graph representing the pitch sequence of your audio selection.This line
shows the pitch of the input melody over time, and can not be edited.
If it's not already selected, click on the Voice button labeled number 1, above the edit display. This will activate the first harmony.
Type the keyboard shortcut command-a to select the entire sequence.
The pitch sequence for Voice 1 will now be highlighted in gold in the edit display.
Click on the Tune button to snap the harmony voice into tune with the current scale.
Hit the Enter key or space bar to start playback and hear your results.
Mixer Window: Voice Control
Click on the button labeled Mixer (screen left) to go to the Mixer Window.
Your original line is on channel 0, to the left, and your pitch-corrected version is on channel 1.
Mute/Unmute the two channels as you listen to compare the difference.
Channel is muted when the Mute button is lit up in green; channel is unmuted and may be heard when the mute
button is dark.
Unmute both channels 0 and 1 so that they can both be heard.
Notes Display: Pitch Editing
Click on the Notes button to go back to the Notes screen.
If it's not already active, click on the Selection Tool (to the left of the pencil tool) so that its button lights up green.
Drag the mouse to the edit display, WITHOUT clicking or holding the mouse button.
Watch the Selection cursor change from a crosshair (+) to a pointing hand as it crosses over the gold highlighted
pitch sequence.
With the "hand" cursor active, click on any part of the yellow line and hold down the mouse button to drag the harmony voice to a new location along the scale. Place it a fifth or an octave above the original line.
Hit the space bar to start playback and hear your results.
Click and drag across any part of the pitch sequence to select a phrase or two.
The selected range will highlight in yellow.
Move the mouse cursor over the selection so that it turns to a pointing hand. Hold down the mouse button and drag the phrase to a new pitch, perhaps a fifth below the original.
Hit the enter key to start playback and hear the results.
Now click on the Pencil Tool, so that its green pilot light is on.
The mouse cursor changes into a pencil as you drag it into the edit display.
Click and drag with the mouse to draw new notes for the current voice.
Playback the results; if you don't like what you have, simply redraw.
To start again fresh, type command-a (to select all) and mouse click on the Reset button.
Using Additional Voices
To add a voice, click on the number 2 Voice button.
Go to the Mixer Window and unmute channel 2 (mute button should be dark). Now the pitch sequence for that channel will be editable.
If playback begins cutting out or slows down after adding a new voice, you've exceeded your CPU's capacity and will need to scale back the number of real-time voices. Go to the Mixer window and Mute one or more harmony voices until you're withing a stable operating range.
Once you're satisfied with your pitch arrangment, go to the Mixer window and adjust the relative channel volumes for each voice. Presumably you'll want one voice to be lead, the rest singing backup.
To create a finished audio file, select Process to New File from the HyperEngine's File menu. A name file dialog will ensue, followed by a brief wait as the harmonies are calculated into the new file.
To hear your new processed file, type command-n (New File Document) and select the audio file you've just created. The file will load into HyperEngine.
This ends the tutorial section. You now know enough to get around Harmony and begin work. Naturally there's a number of features, such as the Resize tool and the Voices and Process screen settings which we didn't cover in this brief lesson. Explanations of those functions and more details on each tool you have just encountered are contained in the following
Command Reference section.
[Previous Chapter] [Table of Contents] [Next Chapter]
Command Reference
Arboretum Harmony has four main displays, Notes, Mixer, Voices and Process, which are detailed below. Access any screen by clicking on the buttons at the left side of the window.
The Bypass switch, labeled "In," is accessible from all four screens. Toggle this button to hear the difference between the original signal and your new processed sound. This switch duplicates the function of the HyperEngine Effect Bypass switch, found in the process list beneath the HyperEngine waveform display. This button is not accessible during playback. Bypassing then reengaging results in an audible glitch.
Notes Screen
The Notes Screen is the main area of Arboretum Harmony. Here you'll analyze your input signal, manipulate the Scale and perform graphic pitch shifting, pitch correction and harmonization.
Editing Display
The editing display arranges pitch/frequency along the vertical axis and time along the horizontal axis.
At the left side of the display are calibration markings showing note name and frequency. These are completely user-configurable; click and hold on any frequency number then mouse drag up or down to adjust the note frequency in Hz. Mouse click and type directly on the note name field to rename any note. You can transpose the scale relative to an edited frequency by holding down the shift key when you hit the tab key to enter a new frequency.
To manually recalibrate any note, simply mouse-click on the dot beside the note name, and hold down the mouse while dragging the note up or down the scale. Frequency display will update to reflect the current setting.
Hold down the option key to slow down the frequency changes of the drag by a factor of 0.1 and the control key to decrease the change by a factor of 0.01. Holding down both gives a cumulative reduction of 0.001.
The central part of the display is the pitch editing area. The results of the Calc (Calculate Pitch) function are displayed here, and all pitch shifting and harmony editing takes place in this display.
New Note
Click this button to add a new note to the scale currently shown in the editing display. Mouse drag on the dot at the far left side of the note entry to position the new note.
Delete Note
Removes the currently selected note from the editing display.
Lock
Click to lock/unlock the Notes display, preventing accidental recalibration of the edit window.
Calc (Calculate Pitch)
Mouse-clicking this button activates the pitch analysis function. Arboretum Harmony calculates the pitch of the selected audio region and draws a visual representation of the audio in the editing display. You'll experience a brief wait while the analysis function performs its calculation, then the editing display will update to show the pitch sequence center-screen.
Tune
Arboretum Harmony features one-touch pitch correction. Simply click the Tune button and the currently active harmony voice is snapped to the current scale. The actions of this function are guided by the Correction Strength setting found in the
Process window.
In some cases the input may be so out of tune that Arboretum Harmony can not determine the correct scale on its own. To tell the program what note a certain input segment should be:
Select the part in question with the selection tool.
Hold down the Option key and click on the left-most circle of the scale note you wish to assign to the selected input.
This will force the segment to the note and bring it into tune.
Reset
Resets the pitch sequence for the current voice to the original line. Use this anytime you want a "fresh start" when designing a harmony part.
Undo (command-z)
Reverses your last edit. Clicking Undo again will re-do the edit. Arboretum Harmony has one level of Undo. Command-z is the shortcut.
Scales Pop-up Menu
The Arboretum Harmony edit display can be configured to support any scale or tuning, from the conventional 12-step "well-tempered" European/American standard, through the vast array of world-music and historical tunings, to the most far-out contrived tuning imaginable. Arboretum Harmony ships with a number of Scale Presets, and allows you to create or import your own.
Arboretum Harmony Scale presets are stored in groups, these groups are called Scale Files (or Preset Files) and may contain as many different scales as you wish.
The Scales pop-up menu operates much like any Presets menu, allowing you to load, customize and save as many different scales as you wish
Scales Pop-up Menu functions:
Save - Save the current scale (as displayed in the Note Screen) to the currently loaded Scale File. Results in a dialog in which you enter the new Scale preset name.
Rename - Alters the name of the currently loaded scale. Enter the new name into the resultant dialog. Delete - Deletes the current scale from the Scale File. New Scale File - Create and name a new empty Scale File. Load Scale File - Use the resultant file dialog to locate and select any Arboretum Harmony Scale Preset File. Load Default Scale File - Reverts to the original "factory" bank of scales. Custom - The "Custom" display is shown whenever a change has been made to scale calibration in the Note Screen. This
is an indicator that your new tuning is not yet saved. Once you've saved a scale the pop-up will show the new name, until the next tuning change.
Default - Note Screen reverts to its factory setting, a chromatic scale optimal for creating a wide range of user defined scales or chromatic passages.
List of Current Scales - Indicates the Scales available in the current Scale Preset File. Select any scale from this group to load in the Note Display.
Selection Tool The mouse cursor has two states when Selection Tool is active: The crosshair (+) cursor is used to create a rectangular selection area. Hold down the mouse button and drag across any
part of the Note display. Selected pitch sequences highlight in gold and become available for graphic editing. When the cursor passes over a highlighted segment it turns into a pointing hand. Use the pointing hand to move the
selection to a new pitch while preserving it's overall contour. Dragging the segment up our down adjusts the pitch in semi-tone intervals. Holding down the option key alows you to freely re-tune the segment.
Pressing the command key in Selection mode temporarially calls up the Pencil tool. Pressing the control key temporarially brings up the Zoom tool. These shortcuts are for the bonzai editors who don't like to mouse around to change tools.
The Selection edit mode is the real heart of Arboretum Harmony. As only one voice is active for editing in the notes display at any time, you can make very discrete selections and reposition them in a snap, without changing tool modes.
Command-a is the keyboard shortcut for "select all."
Pencil (Draw Tool) This edit mode allows you to draw in new pitch contours for the current voice. Mouse click and drag in the edit display to
alter the pitch sequence. Use the Pencil tool for a slight adjustment of inflection, or to create completely new harmony lines. Holding down the Option key constrains drawing to a straight horizontal line. Pressing the command key in Selection mode temporarially calls up the Pencil tool.
Resize
Rescales the selected pitch sequence around its pitch center. Use this to accentuate or limit vibrato. Can also be applied as an arranging tool for a wholescale remapping of the part's range.
Zoom (Magnifying Glass) Allows you to zoom in for closer work, or zoom out to see the overview of your pitch arrangement. When Zoom mode is
active the mouse cursor changes to a Magnifying glass. To zoom into any area of the edit display hold down the mouse key and create a rectangular selection range; the display
will resize to the selected area when the mouse button is released. To zoom out hold down the Option key and click anywhere in the edit display. Pressing the control key while in Selection mode temporarially brings up the Zoom tool.
Hand (Scroll Cursor) Hand mode allows you to scroll through the Note edit display, providing a more freeform version of the scroll control
found in the horizontal and vertical scroll bars. Move the Hand cursor to the edit display and hold down the mouse button while dragging around the screen.
Voice Selection Buttons (1 through 8)
Only one harmony voice is active at any time for editing in the notes display. Select the voice to be edited by pressing any one of the eight voice buttons. The numbers 1 through 8 on the ascii and numeric keypads are shortcuts for these switches.
Remember, a voice must be unmuted in the Mixer window in order for it to be heard.
Status Displays (Hz, ms)
Indicates the current cursor position in the edit display in milliseconds (horizontal time scale) and Hz (vertical frequency scale).
Scroll Bars
Use the vertical and horizontal scroll bars along the right hand edge and bottom of the Note Screen to navigate through the edit display. These tools duplicate the function of the Hand (scroll) cursor.
Mixer
The mixer window is dominated by nine channel strips, channel 0 being the original signal and channels 1-8 dedicated to program generated harmony voices. Use this window to control the individual volume levels of each voice.
Every strip in the mixer window has the same set of common controls:
Mute
Silences the channel. Voices must be unmuted in order to be heard. Remember, the number of voices one can hear in
real-time is dependent on the computer processor speed. Unmute all desired voices prior to Processing to New File so that all arranged parts may be heard.
Solo
Solos the channel, muting all non-soloed channels.
Formant
The formant slider shifts the formant up or down in semi-tone intervals. The formant of the voice is the "characteristic" portion of the voice that remains constant even when the pitch of the voice changes. Moving the formant upward makes the persons voice sound "smaller" while moving it down increases the apparent "size" of the speaker. Extreme shifts up or down give either the chipmunk or Darth Vader effect respectively.Calibrated in semitone (100 cent) units, from -12 to +12. Similar to the Global Formant Shift parameter in the Voices window.
Pitch
A global pitch shift setting for the voice, independent of the Note Screen sequence. Calibrated in semitone (100 cent) units, from -12 to +12. Similar to the Global Pitch Shift parameter in the Voices window.
Pan ( L - R )
Controls the right/left stereo position for the voice. Although Arboretum Harmony only accepts mono (one-channel) audio files for input, it will create stereo (two-channel) results when Processing to New File. Use the pan control to give each harmony voice its own unique position in space. Range is from -100 (all left channel) to + 100 (all right channel) with zero equaling panned center.
Volume
Controls the volume for the channel. Measured in percentage; ranges from 0% (off) through 100% which is equivalent to 0 dB, to 200% which is equivalent to + 6 dB. Use the 0 dB Reset button at the bottom of each fader throw to quickly zero the board.
Status display
Indicates the value of the Mixer parameter currently being adjusted. Reflects Volume, Pan, Pitch and Formant settings. Values update as you adjust the sliders.
0 dB Reset
Recalibrates the Volume fader to 0 dB (100%).
Output
Master control of output volume for all channels. An additional stage of gain control, before the HyperEngine output faders.
Voices Display
Each of the eight harmony voices can be fine-tuned individually in the Voices display. Parameters in this window are specific to each separate voice, allowing discrete control of the Humanize, Pitch Shift and Formant values. Use the sliders to adjust values, or type new values directly into the numeric displays.
Voice Selection Buttons (1 through 8)
Select the voice to be edited by clicking on any one of the eight voice buttons. The numbers 1 through 8 on the ascii and numeric keypads are shortcuts for these switches.
Voice Formant Shift (cents)
Duplicates the voice/channel Formant control found in the Mixer display with greater precision. Range is -1200 (down one octave) to 1200 (up one octave) calibrated in cents.
Voice Pitch Shift (cents)
Dupicates the voice/channel Pitch control found in the Mixer display with greater precision. Range is calibrated in cents from -1200 (down one octave) to 1200 (up one octave).
Humanize (%)
Humanize uses a propritary model of human vocalization to add a realistic "warble" like that found (to varying degrees) in all singers. Obviously this warble is much smaller in well trained singers. Use in small amounts to break up the metallic, comb-filtered sound that results from the harmony being too "perfect." Heavy settings make the voice sound sloppy drunk. Range is 0 to 100%
Don't Preserve Formant
When selected, an alternate pitch shifting algorithm is used which does not preserve the natural formant during pitch shifting. Although the results can be less realistic on large pitch shifts, this setting is quite useful for special effects. For pitch correction tasks that require only small amounts of shifting, the "Don't Preserve Formant" feature can actually yield better results.
Process Window
Dominated by parameter sliders, the Process window offers global controls, the settings of which affect all voices (as opposed to the voice-specific settings in the Voices display). Numeric fields in this screen accept typed value entry as well as slider adjustment.
Maximum Frequency
Minimum Frequency
The Minimum and Maximum frequencies define the range of frequencies Arboretum Harmony expects to see in the signal. In most cases Arboretum Harmony does not need to know its target frequencies for analysis, it can derive a pitch sequence from most acceptable input as the pitch is below 4k and above 55 Hz. However, some sounds or voices may confuse the pitch detection algorithm. If this is the case, try adjusting this range to narrow down the possible pitches. The range for these parameters is 55 Hz to 3998 Hz.
Pitch Variation (%)
Also known as the "maximum deviance" parameter, this setting tells the pitch detector how near subsequent pitches in a single note need to be. With this information the pitch detector can spot errant guesses and correct them even if the pitch is far from an expected value as determined by its internal tracking model. Range is 1 to 50 percent.
Pitch Sensitivity
The pitch sensitivity parameter gives a hint to the pitch detector to help it decide if a harmonic is the true pitch or if it is a super/sub harmonic. For sounds with very complex spectra, like the human voice, a value of 80 to 90 is typically sufficient. With less complex sounds a lower value might be more appropriate if Arboretum Harmony is having problems. Range is 50 to 100 percent.
Correction Strength
Correction Strength determines how strongly an out-of-tune part is brought into tune. At large values the part is snapped into tune quite sharply and variations in the part are brought very close to the proper note. At low settings the correction is more gentle. Out of tune parts are brought into proper intonation more gradually and more the singer's subtle variations and vibrato are preserved. Range is 1 to 100 percent.
Global Formant Shift (cents)
Similar to the Formant Shift control in the Mixer and Voices display, this setting applies to all harmony voices. Range is
-1200 (down one octave) to 1200 (up one octave) calibrated in cents.
Global Pitch Shift (cents)
Similar to the Pitch control in the Mixer and Voices display, this setting applies to all harmony voices. Range is calibrated in cents, from -1200 (down one octave) to 1200 (up one octave).
Process to Mono
Causes the output of Arboretum Harmony to be monophonic when creating a new audio file.
Process at Preview Quality
This uses a reduced quality Harmony engine that requires 1/2 to 1/3 times the processing power or the normal pitch shifting engine. Compromises are made in the output sonic quality to accomplish this performance gain but it is useful when you have run out of processing power with the normal engine.
We suggest having this setting enabled when arranging your parts so as to optimize real-time preview and hear the most possible voices. Disable this setting prior to creating a new file with the Process to New File command to as to render your final result at the highest possible quality.
[Previous Chapter] [Table of Contents] [Link to HyperEngine Manual]
HyperEngine
Real-Time Signal Processing Platform
What's New In HyperEngine 2.4.4:
24 bit file support
New Features in HyperEngine 2.4:
Open Transport no longer required. In fact, no system Extensions whatsoever are required under MacOS 8.0 and later!
New Features in HyperEngine 2.3:
Drag-and-Drop Waveform Editing · Freely copy audio segments from one file to another, or within the same file.
One-touch drag-and-drop editing makes HyperEngine the fast and easy way to cut sound.
Live Play-Through Processing · Process input from a DAT player or other source, in real-time, without creating
and reading hard disk files. HyperEngine lets you use Ionizer, Ray Gun and Hyperprism like regular hardware effects!
Record and Process at the same time! Capture those old vinyl recording to digital, and clean them up at the same
time with Ray Gun.
Flexible Selection Range and Viewing Tools · Simple key commands and mouse clicks allow you to navigate,
select and edit audio with speed and accuracy.
Direct Sound Card Support · HyperEngine includes special custom drivers for Apple Sound Manager, Korg 1212
I/O, Digidesign Audiomedia II and Audiomedia III cards. Take advantage of HyperEngine's 32-bit internal processing, allowing you to keep your digital signals at the highest possible resolution throughout the processing chain.
Note that the new chapter on HyperEngine Reference Documents contains a lot of material, and is a real slow-loader. The HyperEngine Command Reference chapter contains synopses of each menu function, and is heavily hyper-linked to the detailed explanations contained in the chapter on Reference Documents. You may wish to start your searches in the Command Reference chapter, then access the Reference Documents chapter when you need detailed
step-by-step instructions.
Contents
Introduction
Installing HyperEngine
Monitoring and Playback Controls
HyperEngine Reference Documents
HyperEngine Command Reference
HyperEngine and the Macintosh Sound Manager
Appendix A: Troubleshooting
Appendix B: About Digital Audio Files
About This Manual
The documentation may be viewed or printed from any browser, such as Netscape Navigator or Microsoft Internet Explorer. If the text is too small or you wish to change the background color, go into your browser's Preferences and set them as you wish. Internet Explorer users, just hit the Larger button on your browser tool bar.
Important: For better scrolling comfort use the scroll bar, or the page up/page down keys, rather than the up and down arrows.
It may also be viewed using the excellent HTML Viewer By Sassafras Software, a shareware program supplied on this CD-ROM. If the text is too small, replace the HTML Viewer Prefs file in your Systems' Preference folder by the one on this CD. You can find it by doing a "Get Info" of your HTML Viewer alias followed by a "Find Original" command.
Manual Conventions
Throughout this manual, you will see several different symbols in sections describing step-by-step operations.
Text following a right pointing arrow
invites you to execute a command with the mouse or keyboard.
Text following a down pointing arrow
describes the result produced by executing a command.
A pointing hand
indicates an important note!
Underlined Text indicates a Hyper link; mouse-click on the link to access more information on the designated topic.
Documentation current for HyperEngine version 2.4.1 last revised 11/9/98. Manual written and edited by Todd Souvignier, with past contributions from Georges Jaroslaw, Chris Weare, Curtis Roads and David (Rudy) Trubitt.
Copyright ©1997, 1998 by Arboretum Systems, Inc. This Documentation may not, in whole or in part, be copied, reproduced or translated without prior written consent of Arboretum Systems.
for Arboretum Systems, Inc.: Georges Jaroslaw, president Zhi Liu, chief financial officer Christopher Weare, chief technical officer Aram Lindahl, senior software engineer Richard Lee, sales director Todd Souvignier, marketing director
75 Aura Vista, Pacifica CA 94044 info@arboretum.com www.arboretum.com
[First Chapter]
Loading...
+ 66 hidden pages