Programming Manual for H8000, H7600, Orville and the DSP7000 families of ® Harmonizer Brand Effects Processors. ( covering H8000/H8000A/H8000FW, H7600, Orville™, DSP7000/7500™ and DSP4000B+™ ) Part No: 141035 Manual Release 1.3 ©1999-2008 Eventide Inc., One Alsan Way, Little Ferry, NJ, 07643 USA 19 August, 2008 Harmonizer is a registered trademark of Eventide Inc. for its audio special effects devices incorporating pitch shift.
This page intentionally left blank
The Harmonizer® Programmer’s Manual Table of Contents GENERAL PRINCIPLES ____________________________________________________________________________ 4 OVERVIEW ................................................................................................................................................................................... 4 Different Kinds of Signals 6 HOW A PROGRAM INTERFACES WITH THE PARAMETER AREA ..........................................................................................
The Harmonizer® Programmer’s Manual Simple “Parameter Adjusters” Menupages and Parameter Placement 40 45 TUTORIAL 2 -PRETTY IN DEPTH..................................................................................................................................................48 INTER-DSP COMMUNICATION FOR H8000,ORVILLE ..................................................................................................................56 SUPERMODULES..........................................................
The Harmonizer® Programmer’s Manual This manual covers H8000TM family, H7600TM, OrvilleTM as well as the DSP7000TM family of Harmonizer® Brand Effects Processors, as well as the DSP4000B+TM. In the following text these will, for convenience, be referred to as 'Harmonizers'. Much of its contents also apply to the older 4000 series, but the reader is not advised to view this publication as an exhaustive reference for these models.
The Harmonizer® Programmer’s Manual GENERAL PRINCIPLES OVERVIEW This section will describe in general terms just what goes into constructing a program. Return to this section if you ever feel like you’re being mired down in details later on. First, the primary “stuff” of program construction is the “module." Modules are small, functional “chunks." Some modules may have names that will be familiar to you, such as delay, reverb, filter, pitchshifter, and eq.
The Harmonizer® Programmer’s Manual Much complication will now be heaped upon the above three cornerstones, but all of the complication is introduced in order to achieve the goals set out in the three cornerstones! Don’t lose sight of these three cornerstones, as they motivate everything that follows! To gain a greater appreciation for what we are doing when we construct an the Harmonizer program, consider the following analogy: Computer programs basically compute things.
The Harmonizer® Programmer’s Manual Different Kinds of Signals To achieve the goals set out by the three cornerstones, we must employ four signal types. Signals connect modules together. The four signal types are: Audio Signals Used to pass full bandwidth audio between modules in accordance with cornerstone one. Audio signals are represented numerically by a value between 1 and +1. Control Signals Typically used to pass parameter values between modules in accordance with cornerstone two.
The Harmonizer® Programmer’s Manual HOW A PROGRAM INTERFACES WITH THE PARAMETER AREA Simple Interface Because you really shouldn’t be reading this manual if you haven’t already read the User Guide, we’ll assume you’ve seen menu pages in the PARAMETER area. A menu page, with an associated SOFT KEY, is created by connecting a module’s userobject output to a userobject input on something called the “head” module. Every program has one (and only one) head module.
The Harmonizer® Programmer’s Manual Custom Interface There is one very special module that is used to create custom menu pages. It’s called (appropriately) the menupage module. It has any number of userobject inputs (the example shown to the right has only one) and a single userobject output. The menupage module will create a menu page out of the userobject outputs that are connected to it. The menupage module is typically used with a special group of modules called the “interface” group.
The Harmonizer® Programmer’s Manual The menu pages found in the factory presets were almost exclusively made with interface modules and menupage modules. Now that you have some understanding of audio signals, control signals, and userobject signals coupled with an understanding of how they all play a role in making a program both functional and accessible from the PARAMETER area, we can discuss modules in a little more depth. © 1999-2008 Eventide, Inc. Page 9 of 97 Release 1.
The Harmonizer® Programmer’s Manual MODULES Modules are the magic that make the Harmonizer shine. They are signal processing “nuggets” that are interconnected (via the signals discussed above). Before we discuss aspects of the typical modules like the delay module, the filter module, the pitch shifter module, etc., we need to look at the more specialized IN and OUT “modules." The IN and OUT “Modules” Orville, H8000 Orville’s programs are loaded and run one at a time on a given DSP.
The Harmonizer® Programmer’s Manual The Characteristics of Modules There are several characteristics associated with any module. All modules have: • a module type • a module name Modules use memory and processing resources that can be divided into the following groups: • audio memory • signal processing • user interface and control signal memory • control processing Different types of modules use different amounts of these resources.
The Harmonizer® Programmer’s Manual RESOURCES A resource is something that is needed for the operation of a Harmonizer program -there are several different kinds of resources. A program cannot run if it needs more of a particular resource than is available. Audio memory Modules that store audio for brief periods of time use audio memory. Modules that use audio memory include modules in the delay, filter, pitch shift, and reverb groups.
The Harmonizer® Programmer’s Manual Specifiers have the following features: • they are extremely efficient in terms of resources. (A module with a specifier for a given characteristic is more efficient than a module with a control input for that characteristic.) • they can change the amount of resources that a module needs. • they can change the number of audio, mod, and control inputs and outputs, or even the number of other specifiers (!) for a module. • they can be numerical, multiple choice, or text.
The Harmonizer® Programmer’s Manual MOD OUTPUTS A mod output is used to pass a high performance modulation signal from a module. A mod output may be connected to any number of audio or mod inputs. Mod outputs are always found on the right side of a module. See the comments made immediately above concerning the “low-fi” status of mod signals. USEROBJECT OUTPUTS Most modules have a userobject output.
The Harmonizer® Programmer’s Manual WRAP UP OK, so that completes our birds-eye view of the program construction process. Recall that all of our constructing is done to satisfy the three so-called “cornerstones”: 1. We must connect appropriate modules to achieve a desired, overall audio effect. This is achieved by connecting audio-manipulating modules via audio signals. The “heart” of the program lies in its audio construction. 2.
The Harmonizer® Programmer’s Manual VSIGFILE System Requirements and Background Knowledge Required To run Vsigfile, you will need a PC-compatible running Microsoft Windows 95, 98, XP or Vista. Macintosh users have had some success running Vsigfile under the "Virtual PC" Windows emulator, but Eventide is unable to assist in replicating this operation.
The Harmonizer® Programmer’s Manual On the Harmonizer, ensure that MIDI is enabled and system exclusive is on. You will find these parameters on the [midi] menu page in the SETUP area. If you find that your PC is “unhappy” about the speed of transmission (as in “it’s too fast!”), lower the sysex speed parameter on the “second” [midi] menu page in the SETUP area. This will dumb down the Harmonizer’s transmission speed.
The Harmonizer® Programmer’s Manual BASIC FUNCTIONS All right, so now you have Vsigfile communicating with the Harmonizer (you do, don’t you?). Now we can take a look at how we actually add, connect, and manipulate modules in Vsigfile. Before we look at anything, verify that the View menu is “checked” as shown to the right. That way, the structures we describe will be visible to you. In Vsigfile, signals are color coded: • audio and mod inputs, outputs, and signals are coded green.
The Harmonizer® Programmer’s Manual Connecting Modules To connect an input to an output simply click on the input or output you want to start with, drag to the output or input you want to connect to, and release. Go ahead and connect the IIR module to the other stuff as shown to the right. Also note that when you “hover” the pointer over an input or output for a second, a “bubble” appears that describes what that input or output is.
The Harmonizer® Programmer’s Manual DISPLAY FUNCTIONS Now that you can add modules, we can discuss a few of the display-related features of VSigfile. These functions don’t have anything to do with the actual construction of a program; they simply make it easier to view and manipulate the display. Selecting Modules A single module can be selected by clicking on it.
The Harmonizer® Programmer’s Manual Aligning Modules You can align a group of modules either along their top edge or their left edge. First, select the modules you would like to align. Then select either Top or Left from the Align menu. The add and bound modules have been selected to the right. The result of Top aligning them is shown below. Nice, eh? Zooming You’ll find that as a patch gets very large it’s hard to see the names or input/outputs of individual modules when the whole patch is in view.
The Harmonizer® Programmer’s Manual EDITING One of the benefits of using Vsigfile over the Patch Editor area is that Editing patches in Vsigfile is considerably easier than editing patches in the Patch Editor area (despite its name!). Select All This command selects every module in a program. This is the same as clicking and dragging over all the modules in a program, only easier. Cut, Copy, and Paste Vsigfile makes use of the standard “clipboard” associated with the Windows operating system.
The Harmonizer® Programmer’s Manual Context Dependent Menus By right clicking the mouse, a “context dependent menu” will appear as shown to the right. The available commands will depend on what’s going on in the “vicinity” of the right click. Once you get more familiar with Vsigfile, using context dependent menus will save you time. Shortcut Keys There are several “shortcut” keys that perform menu commands. They are listed next to their command in the various menus.
The Harmonizer® Programmer’s Manual SENDING PROGRAMS TO THE HARMONIZER Once you’ve constructed a program in Vsigfile, you’ll want to send it to the Harmonizer so that it can be run. This is accomplished by selecting the Send command under the Midi menu.
The Harmonizer® Programmer’s Manual After adding both modules, the screen should look similar to the one at the right. The modules are overlapping and nothing is yet connected. Move (by clicking and dragging) the modfilter module to the right so that both modules are clearly in view. Note that the DSP outputs and the head module input “move out of the way." The screen should now look similar to the small one at the immediate right.
The Harmonizer® Programmer’s Manual First click on the head module’s userobject input 1 (the pink square below the DSP outputs). Then select the Add Repeating Field command from the Edit menu. A second userobject input should appear. Connect the modfilter’s userobject output to the head module’s userobject input 1 and the LFO’s userobject output to the head module’s userobject input 2. The screen should look similar to the one on the right.
The Harmonizer® Programmer’s Manual ADVANCED FEATURES The Specifier Display Some mention was made in the General Principles Chapter of “Specifiers." The astute reader will note that no mention has been made of these creatures since! Well, now’s the time. Go ahead and add a delay module from the “Delay” group. Once it’s added, doubleclick on it. You will call up the “Vsigfile Specifier Display” shown to the right. We’ve entered the “guts” of the module. Here we have access to all kinds of cool stuff.
The Harmonizer® Programmer’s Manual Additionally, you can change the name of a module from the normal Vsigfile display by double clicking on the name. If you plan to use multiple copies of a particular module type, it’s wise to tack a “1” onto the end of the first instance and then Copy and Paste that instance. The subsequent copies will be numbered sequentially, as shown to the right. Specifiers The third row contains a “specifier” for the delay module.
The Harmonizer® Programmer’s Manual • Here we see the four specifiers for the meter module. The meter module monitors a control signal output and displays its value in what looks like an old-school VU meter. • The minimum specifier sets the lowest value that will be displayed, while the maximum specifier sets the highest. The name specifier sets the description of the meter, and the tag specifier sets the description on its SOFT KEY (if it has one).
The Harmonizer® Programmer’s Manual If you double click on the MODULE column, you’ll call up the Editing Control input window. Here you can select among all of the possible control outputs in your patch. The output you select will be connected to the input you double clicked on to call up the Editing Control input window. If connecting things this way works for you, great, but most folks find it easier to click and drag in the normal Vsigfile display.
The Harmonizer® Programmer’s Manual Repeating Fields The term “repeating fields” is easier to define by example than to explain in mere words, so here are a few examples of repeating fields: • A diatonicshift module can have one, two, three, or four pitchshifting voices. The parameters associated with each pitchshifting voice are repeating fields. • A menupage module can have any number of userobject inputs. Each input is a repeating field. • A quadmixer module can have as many as fifty audio inputs.
The Harmonizer® Programmer’s Manual Clicking on the button will add a repeating field to the module as shown to the right. A new button appears that will allow you to similarly decrease the number of repeating fields. If you exit the Vsigfile Specifier Display you’ll see that the module now has two audio inputs and two control inputs. If you wanted more than two inputs, you would follow the same procedure: • Double click on the module to open the Vsigfile Specifier Display window.
The Harmonizer® Programmer’s Manual Editing “Special” Modules A select few modules require a non-standard editing environment. To enter this “special” environment, click on the special module and then select the second to last command under the Edit menu. The exact phrasing of this command will change depending on what module you have selected.
The Harmonizer® Programmer’s Manual Getting Programs from the Harmonizer In addition to creating programs from scratch in Vsigfile, you can alter programs that exist in the Harmonizer. First, the program in the Harmonizer. Orville users: make sure the DSP running the program is referred to in the upper left corner of Orville’s display. Then select the Get command under the Midi menu in Vsigfile.
The Harmonizer® Programmer’s Manual Creating the User Interface In our first tutorial in this chapter, we used an LFO module and a modfilter module. To allow the user to control the parameters of these modules in the PARAMETER area, we simply connected their userobject outputs to the head module. You can create a wealth of programs this way. In the PARAMETER area, parameters will automatically be grouped by module and SOFT KEYS will appear one per module.
The Harmonizer® Programmer’s Manual Note that these equate to the title and SOFT KEY when the menu page is viewed in the PARAMETER area. The obj rows indicate which userobject outputs are connected to this menupage module’s userobject inputs. In this case, the userobjects of the module named “delay knob." the module named “delay mon." and the module named “info” are all connected to this menupage module’s userobject inputs. To the right is a close-up of what’s actually going on.
The Harmonizer® Programmer’s Manual Parameter Adjusters “Parameter adjuster” modules have a single control output and a userobject output. If connected to a menupage module, a “parameter adjuster” will show up on the menu page in the PARAMETER area as a parameter. For example, in the program Patch Instruct (a section of which is shown to the right), the module named “delay knob” is a “parameter adjuster." It’s userobject output is connected to a menupage module which is in turn connected to the head module.
The Harmonizer® Programmer’s Manual Double clicking on the knob module in the Patch Instruct program reveals this window as shown above (you may have to download the program by using the Get command if you haven’t already done so). • The module name specifier is set to “delay knob." • The menu statement specifier is set to “Each Delay:%2.0fms.
The Harmonizer® Programmer’s Manual Refer to the separate User’s Manual on entering text for a list of the characters included in the text insert menus. The formats shown here can be created using the % character, numbers, a small f, and a period(.). As an wee exercise, Get the Patch Instruct program from the Harmonizer (it’s found in the “Programming” bank”), and double click on the knob module. Then change the menu statement to “Each Delay:%2.3fms” as shown above.
The Harmonizer® Programmer’s Manual Simple “Parameter Adjusters” There are seven simple “parameter adjusters” modules: • A knob module for simple numeric values. • An rfader module for “rotary” graphical display instead of numeric values. • An hfader module for “horizontal” graphical display instead of numeric values. • A vfader module for “vertical” graphical display instead of numeric values. • A textknob module for “text-valued” parameters. • A tapknob module for “tapered” (or non-linear) values.
The Harmonizer® Programmer’s Manual Knob module The knob module is the most popular interface module (in factory programs). It generates a 20-character text string, including a very versatile numerical display from the menu statement. Eight of these can fit on a single menu page. The 8 char name is used only if this module’s userobject output is connected directly to the head module. Normally its userobject will be connected a menupage module. Refer to the Modules Section for complete information.
The Harmonizer® Programmer’s Manual Rfader Module The rfader module creates a graphic on the PARAMETER screen. The graphic, including title, takes up four lines of the screen and one quarter of the width of the screen. Up to four of these modules can fit on one menu page. Nine characters of the menu statement are displayed above the graphic as a title. Refer to the Modules Section for complete information. Vfader Module The vfader module creates a graphic on the PARAMETER screen.
The Harmonizer® Programmer’s Manual Textknob Module The textknob module creates a multiple choice selection in a single line by half screen width area of a PARAMETER area menu page. The choices appear in place of the %s in the menu statement. The 8 char name is only used if the module’s userobject is connected to the head module. The control output reflects which selection is made. If the 1st selection is made the output will equal 0. If the 3rd selection is made, the output value will equal 2.
The Harmonizer® Programmer’s Manual All three graphical monitors will indicate when the control input’s value falls above or below the range set by the minimum and maximum specifiers. (The screen to the right was made by changing the max value to 11 on the “knob for mons” module in the Interface Modules program.) The vmonitor module creates a graphic that is one sixth of a screen width and four lines high. The hmonitor module creates a graphic that is one half of a screen width and one line high.
The Harmonizer® Programmer’s Manual Menupages and Parameter Placement The use of menupage modules to create menu pages in the PARAMETER area is crucial for creating easy to use programs. This section discusses many of the fine points of menu creation. There are several important points regarding PARAMETER area menu pages and their construction in Vsigfile: • Unconnected userobject inputs have no effect on the way things look in the PARAMETER area.
The Harmonizer® Programmer’s Manual • A userobject output may be connected to multiple userobject inputs. This means a single module’s userobject output can show up in several menu pages in the PARAMETER area. Note: If a module’s PARAMETER area graphic is shown more than once on a single menu page, the second instance might not be updated when the first instance’s value changes and vice versa. Parameter Placement on a Menu Page Menu page design may be highly individualized.
The Harmonizer® Programmer’s Manual If the userobject outputs are connected in a different order, the menu page items might not only look bad but might not all fit on the same menu page. For instance, connecting the userobject outputs in this order: 1. main fader-obj 2. left low knob-obj 3. left high knob-obj 4. meter-obj 5. right low knob-obj 6.
The Harmonizer® Programmer’s Manual TUTORIAL 2 -PRETTY IN DEPTH OK, now you’ve got just about all the tricks at hand. It’s time to build a serious program, complete with custom menu pages. We’ll build a dual flanger with a changeable rate, depth, feedback, and waveform. Flangers work by modulating a short delay and then recombining that signal with the original signal. The interference that results from the recombination produces that classic “whooshing” effect.
The Harmonizer® Programmer’s Manual To keep things straight, let’s rename these modules. Remember to tack a “1” on at the end of each name. That way their names will Copy appropriately when we Copy these modules for the second channel. Now double click on the “modulator 1” module and change the max delay specifier to 50 milliseconds. A 50ms modulation is more than sufficient for a flanger. Also, set its delayamt control input to “0.1.
The Harmonizer® Programmer’s Manual • Finally, we’ll want (though we don’t need) a “Sweep” monitor that monitors the output of the LFO module. We’ll hook each one of these up and then use the Vsigfile Specifier Display window to set all of the various specifiers correctly. Strength The first “parameter adjuster” we’ll want to add is a knob module (from the “Interface” group). Go ahead and add it, and connect it to the microdelay module as shown.
The Harmonizer® Programmer’s Manual Feedback Add a percentknob module and connect its control output to amp2 on the mix module. Then double click on it. Change the specifiers as shown to the right. • The mix module’s control inputs accept a value from -1 to +1 (negative values invert the phase of the applied signal). Recall that the percentknob module’s output will be 1/100th that of its displayed value.
The Harmonizer® Programmer’s Manual Wave Add a textknob module and connect its control output to freq on the LFO module. Then double click on it to alter its specifiers to match those shown to the right. Remember to add the correct number of repeating fields by first clicking on the cell under the “TEXTKNOB” column associated with the “value1 name." button appears, permitting you to add The repeating fields with abandon. • The “value” row sets which value the module will default to.
The Harmonizer® Programmer’s Manual Double click on the hmonitor monitor and change the specifiers as shown to the right. • Audio and mod signals range from -1 to +1. In this case, the LFO’s output is only varying from zero to +1 and so we set the minimum and maximum on the monitor accordingly. Constructing the Menu Page OK, the hard stuff is over. All of the elements are there, we just need to place them on a menu page. To the right is a sneak peak at what we will end up with.
The Harmonizer® Programmer’s Manual Select the Send command under the Midi menu to upload the program to the Harmonizer. You should see a screen like that to the right. If you’ve made any errors (a VERY common occurrence) go back and fix things up. Notice that our “three parameters on the left side and four parameters on the right side” idea has been shot! This is because the menupage module “robotically” places “parameter adjusters” in the order they are connected.
The Harmonizer® Programmer’s Manual Connect: • DSP input 2 to inputs 1 on both the second mix module and the second mixer module. • The output of the second mixer module to DSP output 2. • The userobject output of “ch2 menu” to userobject input 2 on the head module (adding a repeating field if necessary). As a final touch, select Set title,author under the Edit menu and name this program! Upload the program to the Harmonizer and flange away. . .
The Harmonizer® Programmer’s Manual INTER-DSP COMMUNICATION FOR H8000,ORVILLE H7600 users should move ahead - this is for H8000 and Orville only. Control signals can be sent from one DSP to the other in Orville! The c_bridge module accepts four control signal inputs. Control signal outputs that are connected to these inputs appear at the other DSP’s “global control outputs” and at the control outputs of a c_bridge module in the other DSP.
The Harmonizer® Programmer’s Manual SUPERMODULES A “Supermodule” is a module which is itself made up of other modules (possibly including supermodules) that is able to leap tall buildings in a single bound. It is a way of making complex functions, and then reusing them without being bothered by their tedious inner details.
The Harmonizer® Programmer’s Manual Cool. Now we need to be able to control our compressor. We need some interface modules. If we open the Vsigfile Specifier Display window of our ducker module we see that we have the option of up to five controls. In this case we will connect “parameter adjusters” to all five. Also found here are the limits of these control inputs. We’ll need this information along with the “units” involved (e.g.
The Harmonizer® Programmer’s Manual Next, add a menupage module and connect the userobject outputs of the five knob modules to its userobject inputs (adding repeating fields as necessary) as shown to the right. Connect the menupage module’s userobject output to the head module. Finally, double click on the menupage module and change its specifiers as shown to the right. Be sure to include the “ ^1” prior to the description and 8 char name.
The Harmonizer® Programmer’s Manual Now we’ll create a Supermodule! Select all the modules (by clicking and dragging over all of them) and then choose the Combine Modules command under the SuperMod menu. The Enter the name for the new SuperModule window should pop up. Type in the name “monocomp." In the String Substitution fields, type a blank space in the Replacement column for “ ^1." A check mark will appear next to “ ^1” when you do.
The Harmonizer® Programmer’s Manual Now we will create a two channel version of our compressor. If you did in fact add the monocomp Supermodule to the “Library” module group, then you may simply add a second instance of the Supermodule as you would a normal module (by selecting the “Add Module” command under the Edit menu). Alternatively, you may highlight the monocomp Supermodule, Copy, and Paste.
The Harmonizer® Programmer’s Manual FILE FUNCTIONS As you’d expect, you can save and load the programs you create (or Get) to and from your computer. In this context, the programs are called “files." You can also print out a picture of your program. All of these functions are accessed under the File menu. • The New command creates an “empty” file. Use this command to start creating a new program or just before you Get a program from the Harmonizer. The • button does the same thing.
The Harmonizer® Programmer’s Manual • The Print command prints opens the dialog box shown to the right. The top section allows you to scale the size of the image to fit on a given number of pages. If more than one page is selected, you can overlap their edges by a given amount. The bottom section allows you to “hide” audio (Signals), control, or userobject (Misc) connections, inputs, and outputs. Once you’re satisfied with these settings, press the Print button to print or the Cancel button to abort.
The Harmonizer® Programmer’s Manual PATCH EDITOR GET COMFORTABLE BY DOING Let’s make a patch, OK? That way you’ll get a feel for how the Patch editor works, and you’ll have a much better understanding of things when you read about the details later. The patch we're going to make will be an audio compressor. A compressor reduces the audio gain when louder signals are input. The compressor we will build is constructed from a single “ducker” module.
The Harmonizer® Programmer’s Manual scrolling through groups first. To do the latter, press the LEFT CURSOR key so that the group name is highlighted, and then turn the KNOB until you see the “Dynamic” group. Press the RIGHT CURSOR key twice to highlight the ducker and press the SELECT key. A ducker will appear in your program. It's the little box marked dck. Note that the IN and OUT modules are still connected to each other, just as they were.
The Harmonizer® Programmer’s Manual The display to the right shows the ducker highlighted, with its output selected and its sidechain input ready to be selected. Press the SELECT key. There you have it. There’s a wire connecting the ducker’s output to its sidechain input. Now let’s connect the ducker’s main input to the IN module. Press the SOFT KEY and then the LEFT CURSOR key twice. The ducker’s main input should be highlighted as shown to the right.
The Harmonizer® Programmer’s Manual The IN and OUT “Modules” H8000 family and Orville H8000 and Orville programs are loaded and run one at a time on a given DSP. The DSP running the program provides the program with four or eight channels of input audio (where that input audio comes from is a function of the routing configuration, see the Harmonizer’s User Manual).
The Harmonizer® Programmer’s Manual THE PATCH EDITOR AREA DISPLAY When the PARAMETER key is pressed and held, the Harmonizer presents a Patch Editor area display of the current program along with a selection of SOFT KEYS. This is the default Patch Editor area screen. Unlike the other areas in the Harmonizer, the top line of the screen is used for “special purposes." The left half of the top line is used as a question field when the or SOFT KEY is used.
The Harmonizer® Programmer’s Manual Front Panel Controls There are several controls used to manipulate the Patch display. Knob In many programs, the patch diagram will be larger than the screen. In such a case, the screen will display only part of the program. The KNOB may be used to shift the screen. A complicated program will move more slowly across the screen as the KNOB is rotated. This is due to the processing required for the Harmonizer to draw the picture of the program.
The Harmonizer® Programmer’s Manual The Patch Editor Area SOFT KEY Functions In the Patch Editor area, there are seven SOFT KEY functions. and add and remove modules from a program. and add, remove, or change a signal connection. changes the direction that the KNOB moves the display. changes the display mode to show audio and control lines instead of just audio lines or to show menupage modules.
The Harmonizer® Programmer’s Manual The right-most SOFT KEY provides display mode control. When this key is pressed, the display mode will change to the next mode in this order: aud only, aud+ctrl, ctrlonly, misc, aud only, aud+ctrl, etc. The right-most SOFT KEY’s label will change to indicate the current mode. Upon entering the Patch Editor area, the right-most SOFT KEY is in the aud only mode, and only the audio path is visible.
The Harmonizer® Programmer’s Manual If you press the SOFT KEY to go to the aud+ctrl display mode, you'll see the knobs and monitor that make the Each delay and Delay Amount parameters shown in the PARAMETER area work. Notice the mul module. That's a c_multiply module. It is multiplying the control signal from the knob (knb) module by a constant amount (in this case 2 -but you can’t see it in this display) and feeding the result to the monitor (mon) module.
The Harmonizer® Programmer’s Manual As this is an audio output, the screen mode will automatically change to aud only mode. Because you have selected an output, the screen will now prompt you for an input to connect to. The Patch Editor will automatically choose a valid audio input for you to connect to as shown to the right. Note that the Patch Editor’s choice may not be your choice! Use the LEFT and RIGHT CURSOR keys and the KNOB to experiment with what exactly can be selected.
The Harmonizer® Programmer’s Manual Example: To break the connection between the two delay modules in the program Patch Instruct from the “Programming” bank, first load the program. Then press and hold the PARAMETER key to enter the Patch Editor area. After the display updates, briefly press the PARAMETER key again to reveal the alternative set of SOFT KEYS. Press the SOFT KEY Use the LEFT CURSOR key to select the input for the second delay module. Press the SELECT key. That’s it.
The Harmonizer® Programmer’s Manual Most modules will create a menu page in the PARAMETER area when they are inserted in the Patch Editor area. To demonstrate this, first load the program Long Mono Delay from Bank 2. Then press and hold the PARAMETER key to enter the Patch Editor area. Insert an eq module by pressing the SOFT KEY, scrolling to the Filter group, and selecting eq. Press the SELECT key to actually insert the eq module. Press and hold the PARAMETER key to return to the PARAMETER area.
The Harmonizer® Programmer’s Manual THE SOFT KEY The SOFT KEY gives you the ability to directly change the “internals” of a module. This is necessary to create complex, highly customized programs.
The Harmonizer® Programmer’s Manual KNOB Mode If the KNOB mode reads (select), spinning the KNOB will scroll through the menu. If the KNOB mode reads (adjust), spinning the KNOB will adjust the data on the current line (the line with the little triangle next to it!). Module Name The name of the module we are ing! Module Type The type of module we are ing! Edit Module Name This is the current name of the selected module.
The Harmonizer® Programmer’s Manual “Fine,” you say, “but it seems simpler to do stuff like that with the SOFT KEY.” A wise pupil are you. . . Mode of 'Delayamt' Control Input Every control input has two possible modes, “patched” and “autoknob." If patched is selected (as in the example to the right) the next line of the menu will show the module and output connected to this input (delay knob-out in the example to the right). More on this below under “Output Connected to ‘delayamt’ Control Input.
The Harmonizer® Programmer’s Manual Modifying Complex Modules Some modules have specifiers that change the number of remaining specifiers in the module or the number of some other type of input or output on the module. Consider these two composite screen images: The major difference between these two examples of the c_switch module is that the module on the left has its number inputs: specifier set to 1 whereas the module on the right has its number inputs: specifier set to 4.
The Harmonizer® Programmer’s Manual INTER-DSP COMMUNICATION FOR H8000 AND ORVILLE Control signals can be sent from one DSP to the other in Orville. 7600 family users should note that they only have a single DSP, so will probably want to skip this section. The c_bridge module accepts four control signal inputs. Control signal outputs that are connected to these inputs appear at the other DSP’s “global control outputs” and at the control outputs of a c_bridge module in the other DSP.
The Harmonizer® Programmer’s Manual CREATING THE USER INTERFACE The Patch Editor automatically creates PARAMETER area menu pages for most modules when they are inserted by connecting their userobjects to the head module. You can create a wealth of programs this way. In the PARAMETER area, parameters will automatically be grouped by module and SOFT KEYS will appear -one per module. A program created this way will be fully functional and have all of the audio characteristics of a factory preset.
The Harmonizer® Programmer’s Manual To the right is a composite of the menu data that would be seen by rotating the KNOB. The obj data lines indicate which userobject outputs are connected to this menupage module’s userobject inputs. In this case, the userobjects of the module named “delay knob." the module named “delay mon." and the module named “info” are all connected to this menupage module’s userobject inputs. are included userobjects. The diagram at the right shows what’s actually going on.
The Harmonizer® Programmer’s Manual Interface Modules Control inputs are used to send a parameter value into a module. The parameter value is generated by another module, perhaps a knob module. One common use for this capability is the creation of custom “parameter adjusters” to adjust the parameters for the modules in a program. The custom “parameter adjusters” are special purpose modules from the “interface” module group.
The Harmonizer® Programmer’s Manual The actual text used for a parameter and the way changes made to a parameter’s value in the PARAMETER area translate to control output changes in the Patch Editor area are set up by ing the “parameter adjuster’s” module in the Patch Editor area.. This screen shown to the right is a composite picture of the menu for the knob module in the Patch Instruct program. • The module name specifier is set to “delay knob.
The Harmonizer® Programmer’s Manual would be displayed on a menu page in the PARAMETER area. “~” represents a space that will be inserted. format for 1.2345 for 23456.0013 for .1234 for 1 for -55.234 %1.2f %4.2f %5.2f %5.0f %7.1f %9.4f %2f 1.23 1.23 ~1.23 ~~~~1 ~~~~1.2 ~~~1.2345 1.234497 23456.00 23456.00 23456.00 23456 23456.0 23456.2345 23456.001300 0.12 0.12 ~0.12 ~~~~0 ~~~~0.1 ~~~0.1234 0.123398 1.00 1.00 ~1.00 ~~~~1 ~~~~1.0 ~~~1.0000 1.000000 -55.23 -55.23 -55.23 -55.23 ~-55.23 ~-55.2300 -55.
The Harmonizer® Programmer’s Manual Resolution The resolution specifier controls what minimum change in a parameter value can be achieved by turning the KNOB or by using the INC or DEC key on the numeric keypad. The resolution parameter also controls the “rate of change” as the KNOB is spun. If the resolution is very fine, the parameter value will increment in “baby steps” as the KNOB is spun. If the resolution is very course, the parameter value will increment in “great leaps” as the KNOB is spun.
The Harmonizer® Programmer’s Manual Simple “Parameter Adjusters” There are a number of simple “parameter adjuster” modules: • A knob module for simple numeric values. • An rfader module for “rotary” graphical display instead of numeric values. • An hfader module for “horizontal” graphical display instead of numeric values. • A vfader module for “vertical” graphical display instead of numeric values. • A textknob module for “text-valued” parameters. • A tapknob module for “tapered” (or non-linear) values.
The Harmonizer® Programmer’s Manual The 8 char name is used only if this module’s userobject is connected directly to the head module. Normally its userobject will be connected a menupage module. Refer to the Modules Section for complete information. Percentknob Module The percentknob module is very similar to the knob module. The only difference is that the control output value is divided by 100. Refer to the Modules Section for complete information.
The Harmonizer® Programmer’s Manual Vfader Module The vfader module creates a graphic on the PARAMETER screen. The graphic, including title, takes up four lines of the screen and one sixth of the width of the screen. Up to six of these modules can fit on one menu page. Six characters of the 8 char name are displayed in the graphic as a title. Refer to the Modules Section for complete information.
• • • The Harmonizer® Programmer’s Manual For vmonitor and hmon, the tag specifier is used to generate the text for the monitor. For meter, the name specifier is used to generate the text for the monitor. The text fields of the monitors may include %f format numeric displays (to convey numerical as well as graphical information). All three graphical monitors will indicate when the control input’s value falls above or below the range set by the minimum and maximum specifiers.
The Harmonizer® Programmer’s Manual MENUPAGES AND PARAMETER PLACEMENT The use of menupage modules to create menu pages in the PARAMETER area is crucial for creating easy to use programs. This section discusses many of the fine points of menu creation and the care and feeding of userobjects. There are several important points regarding PARAMETER area menu pages and their construction in the Patch Editor area: • Null userobjects are invisible. They do not take space on a menu page in the PARAMETER area.
• The Harmonizer® Programmer’s Manual When a module with a userobject output from the “delay." “detector." “dynamic." “external." “filter." “mixer." “oscillator." “pitchshift." or “reverb.” module groups is inserted using the SOFT KEY, its ‘userobject” output is automatically connected to the head module. PARAMETER AREA MENU PAGE PLACEMENT This section goes through a tutorial to show: • Certain modules that have userobject outputs are automatically connected to the head module upon ion.
• The Harmonizer® Programmer’s Manual Go back to the basic Patch Editor area by pressing the SOFT KEY. Now an easytaps module. • Return to the PARAMETER area and observe that there is now a second SOFT KEY. This SOFT KEY is stacked because the easytaps’ parameters take up more than one menu page. • Go back to the Patch Editor and use the SOFT KEY on the head module.
The Harmonizer® Programmer’s Manual • So that we can differentiate this menupage module from the next one we insert, use the SOFT KEY on it and change its name to “1menupage." Do this by selecting the name specifier, pressing the SELECT key, turning the KNOB right until the highlighted line reads “1menupage." and pressing the SELECT key. After you’ve changed the name, press the SOFT KEY and note that the module name is displayed in the upper right corner of the screen.
The Harmonizer® Programmer’s Manual • Return to the PARAMETER area and observe the menu page. Note that it shows two meter module monitors (these are in fact two pictures of the same meter module). Notice that the SOFT KEY is not stacked. • Go back to the Patch Editor area, misc display mode and another menupage module. Edit its module name using the SOFT KEY such that it reads “2menupage.
The Harmonizer® Programmer’s Manual PARAMETER PLACEMENT ON A MENU PAGE Menu page design may be highly individualized. The “look and feel” of a menu page is important if a program is complex or if there are displayed reactions to adjustments that must be viewed and understood quickly.
The Harmonizer® Programmer’s Manual If the userobject outputs are connected in a different order, the menu page items might not only look bad but might not all fit on the same menu page. For instance, connecting the userobject outputs in this order: 1. 2. 3. 4. 5. 6.
