CADP2 Customization
===================

Introduction
============

CADP2.INI is an initialization file used by CADP2 to store default 
values for various parameters. Some of the values stored in 
CADP2.INI are specific to certain calculations, and some control 
the appearance and behavior of all of CADP2.

These instructions describe the contents of the CADP2.INI file and 
explain how to change settings in the file.

CAUTION: Changing settings can lead to undesirable results when 
you run CADP2. Before changing any setting, read "Changing 
Settings" later in this section. 


Format
======

Windows initialization files have the following format:

	[section name]
	keyname=value

In this example, [section name] is the name of a section. Sections 
are used to break settings into logical groups. The enclosing 
brackets ([ ]) are required, and the left bracket must be in the 
leftmost column on the screen.

The keyname=value statement defines the value of each setting. A 
keyname is the name of a setting. It can consist of any 
combination of letters and digits, and must be followed 
immediately by an equal sign (=). The value can be an integer, a 
string, or a quoted string, depending on the setting.

Comments can be included in initialization files. Each comment 
line must begin with a semicolon (;).


How to Read These Listings
==========================

CADP2.INI settings are listed alphabetically within the sections 
that contain them. These sections appear in this document in the 
following order:

	[cadp2]
	[preferences]
	[compute]
	[colors]

The sections and settings do not appear alphabetically in 
CADP2.INI. To locate a setting, search for it within the 
appropriate section.

The syntax, purpose, and recommended method for changing each 
setting appear in the following format:

SettingName=<value-type>

	Default:	This is CADP2's built-in value for this setting.
	Purpose:	This paragraph briefly describes the function of 
			the setting and its default value (if 
			applicable). 
	To change:	This sentence states the recommended method for 
			changing the value of this setting.

The <value-type> indicates whether the value should be a number, a 
letter, a range of numbers, or something else.

A setting that is listed in this document but that does not appear 
in the CADP2.INI file has the default value.


Changing Settings
=================

The CADP2.INI file is created when CADP2 is installed. Initially, 
CADP2.INI will contain few or no settings, and all parameters will 
have their default values.

There are two ways to change CADP2.INI settings:

	o	Use CADP2 itself to change most settings.

	o	Use a text editor, such as Notepad (supplied with 
		Windows) to edit the CADP2.INI file directly. 

CAUTION: Do not use a formatting editor such as Write or other 
word processors; these can corrupt the CADP2.INI file.

Most settings in CADP2.INI can be changed by using CADP2. It is 
strongly recommended, when possible, to make changes from within 
CADP2 and to avoid opening CADP2.INI as a text file, where it is 
easier to make mistakes.

If CADP2.INI is directly edited with a text editor such as 
Notepad, Windows must be restarted in order to have the new 
settings take effect.

For more information on how to use Notepad, see Chapter 10, 
"Additional Accessories," in the Microsoft Windows User's Guide.

CAUTION: You should use care when making changes to your CADP2.INI 
file using a text editor. Incorrect changes to CADP2.INI can lead 
to unexpected results when you run CADP2. In addition, some 
editors can damage certain characters (those with ANSI values of 
greater than 127). It is recommended that you use Notepad as a 
text editor. The listings in this document indicate which settings 
you can change using CADP2. Use CADP2 whenever possible.

IMPORTANT: Always make a backup copy of the CADP2.INI file before 
opening it.

CADP2 searches for CADP2.INI in the directory from which it was 
run, then searches the WINDOWS directory. If no CADP2.INI file can 
be found, then CADP2 may have trouble changing the settings. If 
this occurs, use Notepad to create an empty CADP2.INI file in the 
same directory as CADP2.EXE, then restart Windows and CADP2.

Note also that if CADP2.EXE has been renamed, then CADP2.INI must 
also be renamed to match.


What Is In CADP2.INI?
=====================

The settings in the CADP2.INI file allow personalization of the 
CADP2 environment. CADP2.INI contains several sections, each of 
which consists of a group of related settings. The CADP2.INI file 
might not have all of these sections, or it might have additional 
sections, depending on the particular system's hardware and 
software requirements. The following sections can appear in 
CADP2.INI:

This section:	Does this:

[cadp2]		Affects the overall operation of CADP2. 

[preferences]	Controls default content of the various 
		preferences and settings found in the Options 
		menu.

[compute]	Controls default content of the calculation 
		setup dialog boxes invoked from the Compute 
		menu.

[colors]	Defines colors and line styles for various 
		objects drawn by CADP2.


[cadp2] Section
---------------

The [cadp2] section contains settings that affect the following 
parts of your CADP2 environment:

	o	Location of the Device files

	o	Location of data files

The [cadp2] section contains the following settings:

Cadp2Font=<font-file-name>

	Default:	The file CADP2FNT.FON in the same directory as 
			CADP2.EXE.
	Purpose:	This setting allows the CADP2 font to be stored 
			in a different directory.
	To change:	Use Notepad to edit the CADP2.INI file.


DataDirectory=<directory-name> 

	Default:	C:\CADP2
	Purpose:	This setting allows data files to be stored in a 
			separate directory from the application. The 
			only data file used by CADP2 at this time is 
			CADP2ABS.DAT, which contains the table of 
			absorption coefficients for various materials.
	To change:	Use Notepad to edit the CADP2.INI file.


DeviceDirectory=<directory-name>

	Default:	C:\CADP2\DEVICES
	Purpose:	This setting allows device files to be stored in 
			a separate directory from the application.
	To change:	Use Notepad to edit the CADP2.INI file.


Job-Path=<directory-name> 

	Default:	C:\CADP2
	Purpose:	This setting allows job files to default to a 
			separate directory from the application and is 
			automatically modified by CADP2. If this line is 
			removed, the default job file location will be 
			the same directory as the application.
	To change:	Use Notepad to edit the CADP2.INI file.


[preferences] Section
=====================

The [preferences] section contains settings that affect the 
following parts of your CADP2 environment:

	o	Preferred system of units for displays

	o	Parameters global to all calculations

	o	Preferred options for various commands

Note: Although this section contains the setting for the user's 
preferred system of units, all values stored in the CADP2.INI file 
are stored in the internal SI units.

The [preferences] Section can contain the following settings:

AutoHideCalcLayers=<Boolean>

	Default:	TRUE
	Purpose:	This setting controls whether old calculation 
			result layers are marked as not visible when a 
			new calculation is performed.
	To change:	Use the Options|Display dialog box (alt, o, d)

DarkIsLoud=<Boolean>

	Default:	FALSE
	Purpose:	When displaying a paint calculation in black and 
			white, either darker shades of gray or lighter 
			shades may be used to indicate areas of greater 
			intensity. When TRUE, this causes CADP2 to use 
			darker colors for louder or more intense areas 
			in the paint calculation; when FALSE, this 
			causes CADP2 to use lighter colors for more 
			intense areas.
	To change:	Use the Options|Paint dialog box.

DefaultBoundingBoxes=<Boolean>

	Default:	FALSE
	Purpose:	This setting controls whether the bounding boxes 
			used with devices are defaulted on or off when 
			the program is first initiated.
	To change:	Use Notepad to edit the CADP2.INI file.

DisplayStyle=<Display Style>

	Default:	DEFAULT
	Purpose:	This setting controls how CADP2 uses color when 
			rendering a calculation result. Valid styles are 
			DEFAULT (use whatever is available), GRAY (which 
			requests that the results be displayed with a 
			gray scale regardless of the presence of color), 
			or DITHER (which requests using a one bit/pixel 
			gray scale dither, useful for copying across to 
			a text editor program).
	To change:	Use the Options|Paint dialog box.
1
FlatPlaneEpsilon=<distance in meters>

	Default:	0.01
	Purpose:	This setting controls the tolerance used to find 
			planes which are not flat. After the ideal plane 
			equation has been found, the distance from each 
			individual vertex to the ideal plane is compared 
			to FlatPlaneEpsilon. If any vertices are further 
			from the ideal plane than FlatPlaneEpsilon, the 
			plane is marked as "non-flat" and displayed as 
			such.
	To change:	Use Notepad to edit the CADP2.INI file.

Humidity=<Relative Humidity>

	Default:	0.50
	Purpose:	This setting controls the relative humidity at 
			which all calculations are performed. The 
			relative humidity primarily affects the level 
			loss due to sound transmission through air.
	To change:	Use the Options|Environment dialog box 
			(alt, o, e).

ListenerPlaneHeight=<distance in meters>

	Default:	1.2192
	Purpose:	This setting controls the vertical offset added 
			to all positions when performing calculations 
			over listener planes.
	To change:	Use the Options|Display dialog box (alt, o, d)

PaintOnRequest=<Boolean> 

	Default:	TRUE
	Purpose:	This setting controls whether calculation layers 
			are repainted in the QuadView window every time 
			this window is refreshed. With this option set 
			to TRUE, paint calculation results will only be 
			displayed in response to a user-issued paint 
			command.
	To change:	Use the Options|Display dialog box (alt, o, d)

Pressure=<Pressure in Pa>

	Default:	101325.0
	Purpose:	This setting controls the static pressure at 
			which all calculations are performed. The static 
			pressure primarily affects the level loss due to 
			sound transmission through air.
	To change:	Use the Options|Environment dialog box 
			(alt, o, e).

Temperature=<Temperature in degrees K>

	Default:	293.15
	Purpose:	This setting controls the temperature at which 
			all calculations are performed. The ambient 
			temperature primarily affects the speed of 
			sound, but also affects the level loss due to 
			sound transmission through air.
	To change:	Use the Options|Environment dialog box 
			(alt, o, e).

UsedBWatts=<Boolean>

	Default:	TRUE
	Purpose:	This setting controls whether device power 
			levels are displayed as dBW ref. to 1 W or 
			linear watts.
	To change:	Use the Options|Display dialog box (alt, o, d)

UseEnglishUnits=<Boolean> 

	Default:	TRUE
	Purpose:	This setting controls whether English units or 
			Metric units (SI) are used for display and entry 
			of numbers. This does not affect the internal 
			storage of numbers.
			To change:	Use the Options|Display dialog box 
			(alt, o, d).


[compute] Section 
=================

The [compute] section contains settings that affect the various 
computation modules.

Most of these settings can be modified by opening the appropriate 
Calculation Setup window from the Compute menu.

The [compute] section can contain the following settings:

ACSSubBands=<Integer> 

	Default:	6
	Purpose:	This setting controls the number of sub-bands 
			into which each frequency band will be divided 
			to accumulate the average complex sum of the 
			direct field within a cluster. Legal values are 
			1 through 20.
	To change:	Use Notepad to edit the CADP2.INI file.

AirLoss=<Boolean> 

	Default:	TRUE
	Purpose:	This setting controls whether the level loss due 
			to sound transmission through the air is 
			included in calculations. 
	To change:	Use a dialog box from the Compute menu.

Frequency=<Center frequency in Hz> 

	Default:	2000
	Purpose:	This setting controls the frequency band in 
			which all single frequency calculations are 
			performed. Values which are not center 
			frequencies of bands recognized by CADP2 are 
			likely to produce unexpected results. The 
			band center frequencies recognized by CADP2 are: 
			125, 250, 500, 1000, 2000, 4000, and 8000 Hz.
	To change:	Use a dialog box from the Compute menu.

ImageDepth=<Integer>

	Default:	1
	Purpose:	This setting controls the maximum number of 
			reflections which will be considered by image 
			model calculations such as LTP and Reflected 
			Field. 
	To change:	Use a dialog box from the Compute menu.

Occupancy=<Occupancy coefficient> 

	Default:	0.0
	Purpose:	This setting controls the percentage of all 
			listener planes which is covered by audience in 
			place of the absorption material named for the 
			plane. Values less than 0 and greater than 1 are 
			not meaningful.
	To change:	Use a dialog box from the Compute menu.

PaintGrid=<Grid size in meters>

	Default:	1.2192
	Purpose:	This setting controls the spacing of sample 
			points used for paint calculations.
	To change:	Use a dialog box from the Compute menu.

%ALConsRTCurveIndex=<Integer> 

	Default:	0
	Purpose:	This setting controls the default RT-60 curve to 
			be used at 2 kHz as part of the %ALCons 
			calculation. Legal values are 0-4 which select 
			among the Sabine, Norris-Eyring, Fitzroy 
			(Sabine), Fitzroy (Norris-Eyring), and Target 
			Value variations.
	To change:	Use the Compute|%ALCons dialog box.

RTTarget=<time in seconds> 

	Default:	2.0
	Purpose:	This setting controls the target RT-60 value to 
			use for the %ALCons calculation if the Target 
			RT-60 Curve is selected.
	To change:	Use the Compute|%ALCons dialog box.

Posterize%ALCons=<Boolean>

	Default:	TRUE
	Purpose:	This setting controls the rendering of %ALCons 
			results. If set to TRUE, results will be rounded 
			into five distinct values ranging from 5 for 
			excellent conditions to 1 for unacceptable 
			conditions. If set to FALSE, the result will be 
			presented as a negative percentage ranging from 
			0 to -100% loss. 
	To change:	Use Notepad to edit the CADP2.INI file.

PowerSum=<Boolean>

	Default:	TRUE
	Purpose:	This setting controls whether a power sum or 
			complex sum is used to sum the contributions 
			from individual devices in calculations.
	To change:	Use a dialog box from the Compute menu.

ReverbAMFGores=<Integer>

	Default:	9
	Purpose:	This setting controls the number of gores into 
			which a sphere about each device will be divided 
			to calculate that devices contribution to the 
			Reverberant Level (considering the Architectural 
			Modification Factor). A total of Gores*Bands+2 
			patches will be used in the calculation for each 
			device. 
	To change:	Use Notepad to edit the CADP2.INI file.

ReverbAMFBands=<Integer> 

	Default:	18
	Purpose:	This setting controls the number of bands into 
			which a sphere about each device will be divided 
			to calculate that devices contribution to the 
			Reverberant Level (considering the Architectural 
			Modification Factor). A total of Gores*Bands+2 
			patches will be used in the calculation for each 
			device.
	To change:	Use Notepad to edit the CADP2.INI file.

SabinTableReverbLine=<Boolean>

	Default:	FALSE
	Purpose:	This setting controls the existence of an extra 
			line on the Sabin table which contains the AMF 
			reverb level for each frequency band. It is an 
			option because each value can take a substantial 
			amount of time to compute.
	To change:	Use Notepad to edit the CADP2.INI file.

SurfaceLoss=<Boolean> 

	Default:	TRUE
	Purpose:	This setting controls whether the level loss due 
			to reflection of sound off of a room plane is 
			included in calculations.
	To change:	Use a dialog box from the Compute menu.


[colors] Section
================

The [colors] section contains descriptions of the line colors, 
widths and styles used to draw various portions of the display in 
the QuadView window.

These settings can only be changed with Notepad or another text 
editor. Future versions of CADP2 may support a means of 
configuring color preferences within CADP2.

The [colors] section can contain the following settings:

ArrayClipRay=<RGB Color>

	Default:	0,255,255
	Purpose:	This setting controls the color used to draw the 
			portion of an aim ray that is clipped by some 
			plane.
	To change:	Use Notepad to edit the CADP2.INI file.

ArrayClipRayStyle=<Line Style> 

	Default:	PS_DOT
	Purpose:	This setting controls the style used to draw the 
			portion of an aim ray that is clipped by some 
			plane. Valid styles are one of PS_SOLID, 
			PS_DASH, PS_DOT, PS_DASHDOT, PS_DASHDOTDOT, and 
			PS_NULL. If the style is set to PS_NULL, the 
			corresponding lines will not be drawn. 
	To change:	Use Notepad to edit the CADP2.INI file.

ArrayClipRayWidth=<Integer> 

	Default:	1
	Purpose:	This setting controls the width used to draw the 
			portion of an aim ray that is clipped by some 
			plane.
	To change:	Use Notepad to edit the CADP2.INI file.

ArrayLine=<RGB Color>

	Default:	127,63,0
	Purpose:	This setting controls the color used to draw 
			most edges in the array database.
	To change:	Use Notepad to edit the CADP2.INI file.

ArrayLineStyle=<Line Style> 

	Default:	PS_SOLID
	Purpose:	This setting controls the style used to draw 
			most edges in the array database. Valid styles 
			are one of PS_SOLID, PS_DASH, PS_DOT, 
			PS_DASHDOT, PS_DASHDOTDOT, and PS_NULL. If the 
			style is set to PS_NULL, the corresponding lines 
			will not be drawn. 
	To change:	Use Notepad to edit the CADP2.INI file.

ArrayLineWidth=<Integer>

	Default:	1
	Purpose:	This setting controls the width used to draw 
			most edges in the array database.
	To change:	Use Notepad to edit the CADP2.INI file.

ArraySelect=<RGB Color>

	Default:	255,0,0
	Purpose:	This setting controls the color used to draw 
			selected objects in the array database.
	To change:	Use Notepad to edit the CADP2.INI file.

ArraySelectStyle=<Line Style> 

	Default:	PS_SOLID
	Purpose:	This setting controls the style used to draw 
			selected objects in the array database. Valid 
			styles are one of PS_SOLID, PS_DASH, PS_DOT, 
			PS_DASHDOT, PS_DASHDOTDOT, and PS_NULL. If the 
			style is set to PS_NULL, the corresponding lines 
			will not be drawn. 
	To change:	Use Notepad to edit the CADP2.INI file.

ArraySelectWidth=<Integer>

	Default:	1
	Purpose:	This setting controls the width used to draw 
			selected objects in the array database.
	To change:	Use Notepad to edit the CADP2.INI file.

NonFlatPlane=<RGB Color> 

	Default:	0,255,0
	Purpose:	This setting controls the color used to draw 
			surfaces that are not flat.
	To change:	Use Notepad to edit the CADP2.INI file.

NonFlatPlaneStyle=<Line Style>

	Default:	PS_DOT
	Purpose:	This setting controls the style used to draw 
			surfaces that are not flat. Valid styles are one 
			of PS_SOLID, PS_DASH, PS_DOT, PS_DASHDOT, 
			PS_DASHDOTDOT, and PS_NULL. If the style is set 
			to PS_NULL, the corresponding lines will not be 
			drawn.
	To change:	Use Notepad to edit the CADP2.INI file.

NonFlatPlaneWidth=<Integer>

	Default:	1
	Purpose:	This setting controls the width used to draw 
			surfaces that are not flat.
	To change:	Use Notepad to edit the CADP2.INI file.

RoomError=<RGB Color>

	Default:	255,0,0
	Purpose:	This setting controls the color used to draw raw 
			edges in the room database.
	To change:	Use Notepad to edit the CADP2.INI file.

RoomErrorStyle=<Line Style> 

	Default:	PS_DASH
	Purpose:	This setting controls the style used to draw raw 
			edges in the room database. Valid styles are one 
			of PS_SOLID, PS_DASH, PS_DOT, PS_DASHDOT, 
			PS_DASHDOTDOT, and PS_NULL. If the style is set 
			to PS_NULL, the corresponding lines will not be 
			drawn.
	To change:	Use Notepad to edit the CADP2.INI file.

RoomErrorWidth=<Integer> 

	Default:	1
	Purpose:	This setting controls the width used to draw raw 
			edges in the room database.
	To change:	Use Notepad to edit the CADP2.INI file.

RoomLine=<RGB Color>

	Default:	0,0,0
	Purpose:	This setting controls the color used to draw 
			most edges in the room database.
	To change:	Use Notepad to edit the CADP2.INI file.

RoomLineStyle=<Line Style>

	Default:	PS_SOLID
	Purpose:	This setting controls the style used to draw 
			most edges in the room database. Valid styles 
			are one of PS_SOLID, PS_DASH, PS_DOT, 
			PS_DASHDOT, PS_DASHDOTDOT, and PS_NULL. If the 
			style is set to PS_NULL, the corresponding lines 
			will not be drawn. 
	To change:	Use Notepad to edit the CADP2.INI file.

RoomLineWidth=<Integer>

	Default:	1
	Purpose:	This setting controls the width used to draw 
			most edges in the room database.
	To change:	Use Notepad to edit the CADP2.INI file.

RoomSelectWidth=<Integer> 

	Default:	1
	Purpose:	This setting controls the width used to draw 
			edges of selected planes in the room database.
	To change:	Use Notepad to edit the CADP2.INI file.

