User Guide  for  Hauptwerk
About Hauptwerk
Welcome
What is it?
What is it used for?
Licensing
Installation
Prerequisites
Background
Installing
Upgrading
Backups
Quick start
Stand-alone
MIDI sequencing
VSTi plug-in
Background
Tour of a pipe organ
Using Hauptwerk
The virtual console
Settings screens
Menus
The File menu
Loading sample sets
Combination files
The registration sequencer
Temperaments
Audio routing and multi-channel audio
Activation and reset
Capture mode
Recording audio
Master tuning
The transposer
MIDI input
MIDI output
Re-directable inputs
Component installer
Importing v1 organs
MIDI organ consoles
MIDI sequencing
Organ design tools
Performance tuning
General options
Sample set options
Voicing
Reference
MIDI implementation
Troubleshooting
Creating sample sets

The settings screens


The settings menus

Almost all of Hauptwerk's settings can be found under the General settings and Organ settings menus:

General settings menu


Organ settings menu


Important: It is essential to understand the distinction between the General settings and the Organ settings menus: the screens and their settings found under the General settings menu are mainly used to define your MIDI and audio hardware and apply to all sample sets. For example you would use the General settings | Keyboard MIDI inputs screen to list the MIDI keyboards you have attached to the computer. The default settings are just defaults; update or rename them to reflect your own hardware (or software) with which Hauptwerk will be used. The Organ settings menu instead stores settings that are specific to whichever sample set is currently loaded. Changing a setting on one of its screens only affects that sample set. The Organ settings menu is mainly used to map the virtual organ's controls to your hardware. For example, the Organ settings | Connect keyboard MIDI inputs to organ keyboards screen allows you to select which of your MIDI keyboards (that you defined on the General settings | Keyboard MIDI inputs screen) you want to map/connect to which of the virtual organ keyboards provided by the sample set. Thus configuring Hauptwerk is a two-stage process: first list/configure your MIDI hardware via the General settings menu, then load each sample set and use the screens on the Organ settings menu to map your hardware to the corresponding virtual organ objects.

If a sample set is loaded, or its MIDI system is activated, whenever you open a screen from either of these two menus Hauptwerk's audio and MIDI systems will automatically deactivate and re-activate when you close the screen. The Organ settings menu is only available when a sample set is loaded.

A very small number of settings (which affect the way that Hauptwerk stores samples in memory) require any currently-loaded sample set to be re-loaded into memory. Hauptwerk will automatically detect and act upon setting changes that require the sample to re-load. However, the vast majority of settings take effect almost instantaneously. Settings which can cause the sample set to re-load are clearly identified on the screens and in subsequent sections.


The screens

All of the settings screens have the same basic layout and are navigated in the same way. As an example, select General settings | MIDI input paths from the menu:

MIDI input paths


Apart from the General settings | General options and Organ settings | General options screens, all of the screens allow multiple objects to be browsed. An object is an instance of the type of item whose properties the screen specifies. For example, each object on the General settings | Keyboard MIDI inputs screen is a logical representation of one of your MIDI keyboards, and describes its properties so that Hauptwerk knows how to communicate with it.

The left-hand pane is a browse list of the objects currently available. Many screens allow you to create new objects and delete existing ones using the Insert and Delete buttons underneath the browse list.

Most screens require you to give each new object a unique name, so that it can be identified uniquely in the browse list, and so that you can refer to it from other screens. You should always use meaningful names.

However, bear in mind that the names have no other functional effect. For example, although the object shown above is named 'Keyboards: div 2 (Great)', there is no reason that you should use that MIDI input path for, or only for, MIDI from the Great keys; it is simply a user-friendly name for the combination of MIDI port and channel, which you are completely free to change.

The right-hand pane of each settings screen specifies the properties of the object currently selected in the object browse list. For example, in the screenshot of the Configure MIDI Input Paths screen above, the 'Keyboards: div 2 (Great)' path object is selected in the left-hand pane, and the properties of that path are shown on the right, where you may view or adjust them.

Some screens have multiple tabs for their right-hand panes.

Whenever you move to a different object in the browse list, or click on OK, Hauptwerk will check that the settings are valid for the object that you are leaving, and give an error, whilst preventing you moving to the new object if not. For example, Name settings are always mandatory (must be entered), so you would receive an error if you inserted a new object and did not give it a name before attempting to select a different object.

When you click OK on a screen, the uniqueness of object properties is validated where necessary. For example, the Name settings must always be unique, so an error would be given if you had two objects with the same name, and you would not be able to OK the screen until you had changed one of them. On some screens several settings must be unique as a combination. For example, on the Configure MIDI Input Paths screen pictured above, no two objects can have the same MIDI input port and MIDI channel as a combination.

Some screens have settings which refer to objects from other screens. For example, the Input path setting on the General settings | Keyboard MIDI inputs screen refers to the General settings | MIDI input paths screen:

Keyboard MIDI inputs


If you attempt to delete an object which is referenced from another screen, Hauptwerk will give an error and prevent the object being deleted. If you wish to delete the referenced object (MIDI input path in this case), you must first delete the referring object (keyboard MIDI input), or change the value of its referring setting (select a different input path for that keyboard MIDI input).

Note that some settings are enabled and disabled (greyed out) depending on your selections for other settings, or are always disabled if they are for information only.

You can always click Cancel to discard the changes made since you opened the screen, regardless of whether the data on the screen are valid.


Getting help on screens and settings: Just to the left of the OK button on each screen is a pointer/question-mark icon:

Question-mark help


Click on that icon. The appearance of the mouse pointer will then change to a pointer/question-mark or hand. Now click on a blank part of the settings screen. The mouse pointer will change back to its normal appearance but detailed help for the screen will pop up. You can also get detailed help on any specific setting by using the same procedure to click on the setting in question. We do not describe all of the settings in this guide, and merely give an overview of functional areas and screens; you must use the question-mark help in conjunction with this guide since this guide does not contain detailed help for the settings screens.

A brief pop-up hint is also displayed for some settings when your hover over them with the mouse.


Visit Crumhorn Labs on the Internet
© Crumhorn Labs Ltd 2001-2008

Hauptwerk, Hauptwerk virtual pipe organ, Crumhorn Labs and the Crumhorn Labs and Hauptwerk logos are trademarks of Crumhorn Labs Ltd.