HauptwerkTM Version 2.01 Release Notice

February 2006

© Crumhorn Labs Ltd 2006


The most current source of information about Hauptwerk, known bugs etc., is the Crumhorn Labs website, which should also be consulted when required.


Overview

Hauptwerk version 2 supersedes version 1, and is now owned and developed by Crumhorn Labs Ltd., under the direction of Martin Dyde.

Version 2 has been rewritten from scratch, and includes many, many major new features aimed at provided the most realistic and best-performing model of an organ possible on current computer hardware, and to provide a solid foundation for future development for years to come.

Version 2.01 is a patch to version 2.00 which only includes bug fixes and work-arounds for problems found with version 2.00. We recommended that you upgrade to version 2.01 as soon as possible if you have already installed version 2.00.


Compatibility

This release includes only the full edition of Hauptwerk version 2. An edition with reduced funtionality is planned for an early post-2.00 version, in order to ensure that a simple and low-cost edition of Hauptwerk, with lesser computer hardwdare requirements, continues to be available for those who do not wish to invest in the full quality of Hauptwerk version 2, whilst maintaining full compatibility with its sample sets.

Hauptwerk version 1 is no longer being developed, but, for a period of time, version 1 is installed with version 2, and a licence for version 1 is included with a purchase of a version 2 licence to provide backwards compatibility with older sample sets. Hauptwerk version 1 will continue to be sold until the reduced edition of Hauptwerk version 2 is available.

Hauptwerk version 1 licences are not valid for version 2. A licence upgrade is available for purchase from the Crumhorn Labs on-line shop.

Hauptwerk version 1 sample sets are not compatible with Hauptwerk version 2. Please contact the authors of any Hauptwerk version 1 sample sets that you may have for information about upgrading sample sets to version 2 format.

Licences for all previous Hauptwerk 2 versions remain valid with this Hauptwerk 2 version, so no licence upgrade fee applies to existing registered users of Hauptwerk version 2. However, if you wish to upgrade to this version from a previous Hauptwerk 2 version and require the updated software on CD, then it can be purchased from the on-line shop for a small charge to cover the media, handling and postage.


Installation

We very strongly recommend that you read the User Guide for Hauptwerk, which includes important prerequisites and installation instructions, and is included on the Hauptwerk CD and on-line on the Crumhorn Labs website before attempting to install Hauptwerk.

In particular, please ensure that you have Microsoft Direct-X version 9.0 or above installed (included on the CD), and at least 1 GB of memory, otherwise Hauptwerk's installer may not function correctly. Please also note that, depending on the speed of your CD/DVD drive, it may take several minutes for the installer to open after double-clicking on it, or for the installer file to appear in Windows Explorer, due to its size. During this time the drive activity light will remain lit.

If you have received this version on CD and wish to upgrade an existing Hauptwerk version 2 installation, simply insert the new CD and follow the instructions in the installer. The installer should detect your existing installation and upgrade it automatically as necessary.

If you have received this version as a download 'hot-fix' patch, then please instead follow the instructions included with the download. A moderate level of computer proficiency may be required to apply such patches, and we recommend instead ordering the update on CD if you have any doubts about the process.


Testing

This release has primarily been developed and tested on the following systems: Additional beta testing has been carried out for version 2.00 by third parties on many other systems, old and new.


Changes to Hauptwerk

Please note that enhancement and bug numbers refer to the corresponding pages on the website.


Changes in version 2.01

Version 2.01 includes only bug-fixes and work-arounds for problems found with version 2.00. The following are included:


BUG HW2-000006: [Sample set developers only] Windows Notepad could corrupt Hauptwerk XML files, which crashed Hauptwerk.

If Windows Notepad is used to edit XML files, it can write two-byte 'byte order marker (BOM) codes' to the start of the files, which strictly renders them invalid as XML files. Although not themselves a bug in Hauptwerk, such invalid codes could cause Hauptwerk to crash, so Hauptwerk has been changed simply to ignore such codes.


BUG HW2-000010: Component installer packages needed to be copied to hard-drive for installation.

In version 2.00 the component installer would abort incorrectly with error code 1161 (no read privileges) if installing a component package (e.g. sample set) from non-writeable media, such as CD or DVD. The work-around was to copy the files to a hard-drive prior to installing them.


BUG HW2-000011: [Documentation] Incorrect link in user guide.

In version 1.00 of the user guide, on the 'MIDI Implementation' page, the 'MIDI organ consoles section' link on the 5th line pointed to the wrong page.


BUG HW2-000013: [Sample set developers only] first column in diagnostic log files had no comma.

Diagnostic logging is possible for various internal virtual organ objects to aid sample set developers. The first column in these log files should be terminated with a comma, but was not.


BUG HW2-000015: Original organ tuning option only worked when sample set loaded with 'Organ | Load organ, adjusting rank audio output routing'.

If a sample set has been loaded two or more times consecutively using the 'Organ | Load organ' or stand-by/recent options, its samples are read from a special fast sample cache rather than the original files. In such cases the 'Temperament | Original organ tuning' option could cause no audio output or a crash. The work-around was always to load a sample set with 'Organ | Load organ, adjusting rank audio output routing' if the original organ tuning option was to be used.


BUG HW2-000016: Could not insert/update with 'General settings | Audio output groups' screen.

Clicking OK on the 'General settings | Audio output groups' screen gave error 0813.


BUG HW2-000018: If an organ was left active for a long period of time, the audio may crash (usually only with DirectSound drivers).

In such circumstances the audio output could become silent or make a buzzing noise, and Hauptwerk would not close or deactivate properly. The problem was extremely unlikely to occur with ASIO drivers.


BUG HW2-000019: Shutting the computer down without first closing Hauptwerk could prevent settings changes being saved.

If the computer was shut down from the Windows Start menu or by pressing the computer's power-off button, Hauptwerk may not have closed cleanly, and any changes to its settings may not have been be saved. This problem did not affect the 'File | Shut computer down' or 'File | Re-start computer' menu items in Hauptwerk, which shut Hauptwerk down correctly before shutting the computer down. The work-arounds were to ensure that you used one of these options, or quit Hauptwerk before shutting the computer down.


BUG HW2-000020: [Sample set developers only] Samples larger than about 8 MB in 32-bit resolution could crash Hauptwerk.

If a sample was loaded in 32-bit resolution, and its size exceeded 8 MB after conversion to that resolution, then Hauptwerk could crash. 8 MB equates to a stereo 32-bit sample at 48 kHz of about 21 seconds in length, hence samples should not exceed that length. This is an intentional limit, and is only listed as a bug because Hauptwerk crashed in such circumstances, rather than reporting the error properly.


ENHANCEMENT HW2-000032: Allow St. Anne's organ sample set to be used with Creative Audigy ASIO driver.

The sample rate of the Creative Audigy ASIO driver is fixed at 48 kHz. Since the St. Anne's, Moseley organ sample set is recorded at 44.1 kHz, the main St. Anne's organ definition file cannot be used with the Audigy ASIO driver because it requires 44.1 kHz output. As a work-around, we have created a special version of the St. Anne's organ definition file which produces audio output at 48 kHz for compatibility with drivers whose sample rates are locked at 48 kHz, such as the Creative Audigy ASIO driver. Please note that audio quality is not increased as a result, since the samples used remain at 44.1 kHz, thus this special organ definition file should only be used with audio interfaces with sample rates locked at 48 kHz.


BUG HW2-000033: [Sample set developers only] tuning scheme deviation in definition file should always allow zero.

When creating a sample set, the organ definition file should allow zero to be specified for the Pipe_SoundEngine01.Pitch_Tempered_BaseTuningDeviation if the Pitch_Tempered_BaseTuningSchemeCode is an increment type.


BUG HW2-000035: [Documentation] Incorrect reference to organ ID range in CODM User Guide.

In version 1.00 of the Custom Organ Design Module User's Guide, page 13, fourth paragraph the range should read 800000 to 899999.


BUG HW2-000039: Occassionally hung during deactivation or when closing Hauptwerk.

We found a circumstance which could cause Hauptwerk to hang occassionally during deactivation of the audio system, such as when closing the program with a sample set loaded. Because the settings are saved on exit, this could prevent changes to the settings being saved.


BUG HW2-000040: Computer keyboard key codes greater than 255 could not be used for switch (MIDI) inputs.

The 'General settings | Switch (MIDI) inputs' screen allowed maximum values of 255 to be entered for the engaging and disengaging event numbers for 'Computer keyboard key pressed/released' event types. Special keys (function keys, etc.) have higher key codes and so the limit needed to be raised accordingly.


BUG HW2-000041: [Documentation] Computer keyboard key codes for switch (MIDI) inputs were not listed in the user guide.

Key codes needed to be listed in the user guide for 'Computer keyboard key pressed/released' event types for the 'General settings | Switch (MIDI) inputs' screen.



Changes in version 2.00

Changes between Hauptwerk version 1 and version 2 are not listed in this release notice, since they are so extensive. Hauptwerk version 2 is considered to be a completely new product which supersedes version 1. Please consult the list of features on the Crumhorn Labs website for information about new features in version 2.