BASILICA

Basilica is a new software for developping great custom organs for Hauptwerk-4 virtual organs system (of Milan Digital Audio).
Basilica is very fast and very easy to use. Much faster and easier than MYCO and no need to create any code or any file.

The main screen (CONSOLE) of organs realized with Basilica is graphically poor, but  is extremely functional because it includes on a single page all the necessary elements to test an organ: stops, couplers, trémulants, keyboards and expression pedals. 

FEATURES
Basilica allows you to design organs        :
�	with up to 5 manuals + 1 pedalboard
�	up to 96 stops
�	dry or wet
�	with left and right jambs screen
Basilica has its own sampleset, optimised for allowing organists to build 50 stops organs working with the free or basic edition of Hauptwerk-4.

SETUP SCREEN
This page allows you to set the following parameters        :

�	the Haptwerk folder where your CODF (custom organ definition file) will be stored
�	the name and unique ID of the organ
�	the number of manuals
�	the numbers of keys of the manuals and pedalboard
�	the swell boxes
�	the style of the knobs
�	the font for the text in the knobs of the jambs
�	the reverb (dry or wet)
�	the wind flow
�	the tremulant speed
�	the optionnal standard pages

This page is also used to enter your login and password if you purchase Basilica.
Login & password will remain available for all future versions of Basilica.

MAIN SCREEN
The main screen shows up to 96 knobs (buttons) , 3 lists and DEMO buttons
�	one list for the manuals stops
�	one list for the pedal stops
�	one list for the couplers and tremulants.
There are always 16 knobs for the pedals and a minimum of 16 knobs for each keyboard.
When your organ is a 5 manuals, each manual has 16 knobs
When less than 5 manuals, lowest manuals may have 24 to 56 knobs.
Each DEMO button allows you to load a preset model of organ to quickly start a project.

THE KNOBS
What are the knobs for        ? Each knob is a switch for a stop, a coupler or a tremulant.
For example if a manual has 16 knobs, they can be        :
16 stops, or 15 stops + 1 coupler, or 14 stops + 2 couplers or 13 stops + 2 couplers + 1 tremulant …

When a knob is a tremulant, all stops on the same line can be tremulated.
You can choose the font name and the size for  the text inside the knobs, but not the style bold/italic/underlined. This is only for the page CONSOLE. The font for the knobs in the jambs  can be set in the SETUP tab.

Unregistered version limitation       : you can use how many knobs you want, but only 12 stops.
With the unregistered version, the DEMO buttons 1 to 3 let you create organs with more than 12 stops, but you will not be authorized to edit these organs.

THE LISTS
The 3 lists allow you to assign a function to a knob       : stop, coupler or tremulant.
Normally, for the manuals you should use the list manual stops, but there will be no problem if you assign a pedal stop to a keyboard or vice-versa       .

ENCLOSURES
You can have a swell box for each manual (not for the pedals). When set, the whoole manual will be  enclosed.

COUPLERS
You have a large choice of couplers, but you must take care not to use a coupler for a manual you have not. Basilica do not check it. If you do such thing Hauptwerk will not load your organ.

RANDOM FILL & RANDOM FILL ½
These function are tools to quickly test Basilica. But they can also  be used  to start creating a new organ if you miss ideas. They are basically random, so you may get twice the same stop in the same manual, They only use the manuals stops list, even for the pedals. No couplers or tremulants, but you can edit the random filling and remove or add all that you want.
When 32 is displayed, random fill selects randomly for 32 knobs a maximum of 32 stops in the manual stops list.
When 32 is displayed, random fill 1/2 selects randomly for the same 32 knobs a maximum of 16 stops in the manual stops list.

TREMULANTS
Tremulants can be set on each manual, but only once. 2 tremulants set on the same manuals will fail Hauptwerk running.
You have two options   :
The tremulant is only for the stops placed on the same horizontal row.
The tremulant is for the entire manual.
All the manuals will have the same setting.

ADVANCED

ADDING YOUR OWN STOPS
You can add new stops to the pedals or manuals list,
If the samples of the new stops are not in the folder 001512, you must use a copy of the stop and place it in 001512 subfolder «   pedal   » or «   manuals   ».
If the samples are not tuned perfectly to 440 Hz diapason, it belongs to you to tune them with a wav editor. Same thing for the volume if the stop is too soft or too loud.

You have to create a text file «   pedalsNewStops.txt   » and/or «   ManualsNewStops.txt   »
These text files must be in the same directory than Basilica.exe and follow some rules.

THE RULES
 •	A line starting with ";" is a comment.
 •	All added stop must be in the folder 001512, use a copy if the stop belongs to an other sampleset.
 •	The names of the stops in this text file must contain only a...z, A...Z, 1....9, space and underscore. For mutations, the name can end with 2-2/3, 1-3/5 ... but in 001512 - and / must be removed and replaced by 223, 135 ...
 •	The name in the folder 001512 must be the same but  a space must be replaced by underscore.
 •	The name must be unique, must not exist in the pedal/manuals list.
 •	For distingishing new stops you can add a # at the begining of the name. The # will not be displayed in Hauptwerk.

HOW TO START

FIRST
Go to the SETUP page
Fill the text box to tell Basilica where your custom organ should be stored. Usually it is       :
 C or D :/HAUPTWERK/HauptwerkUserData/CustomOrganDefinitions
Select the numbers of manuals you want.
It is not necessary to change anything else unless you do not want swell boxes for example or if you prefer 56 keys manuals.

SECOND
Go to the tab STOPS & COUPLERS
Select a knob and assign it a function by clicking in one of the 3 lists
Do the same with other knobs.

THIRD
Go to the CODF page.
Click on Create CODF. Wait a little until «       CODF COMPLETED       »
Click on Save CODF to write it in the CustomOrganDefinitions folder of Hauptwerk.

AND NOW ….
Run Hauptwerk and load your organ via the menu TOOLS.

It's all. Enjoy       !