CADP2 Version 1.25 Revision List  (8-15-95)
==================================


User Support for CADP2
========================

Support help for CADP2 owners comes in two forms:
   
Telephone Application Assistance (8 AM to 5 PM PST)
      209-787-3044  or  818-894-8850

JBL Professional Online (24 hour)

      The CADP2 BBS is now included as part of the JBL Online BBS
      using a new FirstClass operating system and US Robotics 28.8 modems.
      The changes will result in a single online source for all JBL, Urei,
      AKG, Soundcraft, BSS information and support.

      Locate the CADP2 Users Area in the JBL\Engineered Systems
      folder. The CADP2 is the fastest way to get information at any hour 
      pertaining to system design and CADP2 usage and developments;
      Such as:

       News Bulletins   - News about audio events and products
       Technical Notes  - Usage of CADP2 and usage with other programs
       Tutorial Files   - Tutorial documents combined with JOB files
                           for further training
       New Device Files - Newly measured device files from JBL
                           and from other manufacturers when authorized
       Utility Programs - Freeware and Shareware especially useful
                           with Windows and CADP2

      E-Mail messages can be left for CADP2 staff and other BBS participants
      and is encouraged. The new BBS system uses FirstClass Client as the 
      preferred terminal program. Use your own favorite terminal program or
      MS Terminal supplied with windows to access the BBS and download the
      free Client program. Or contact your rep. for a free client disk.

      NOTE: The BBS number is  209-787-2955  [8N1 / 28.8 kB]



CADP2 Version 1.25
====================

Version 1.25 update. Resets a minor bug, corrects a compile error,
resets the software timeout clock.


CADP2 Version 1.23
====================

Version 1.23 is an update release to repair the following bugs:

 "Insufficient Memory" to paint on high resolution screens.
  It was found that when painting computations from a single view
  on high resolution screens ( >800x600) that the "insufficient
  memory" message would be displayed. This memory allocation conflict
  was repaired with a completely new memory handling scheme.

 "ID 146 Error" after deleting a LTP layer. The program could be
  made to lock and give an ID 146 error if several LTP layers are
  created, then deleted... lower layer numbers first... with the
  echogram and summary windows still open.

 "ID 132 Error" when attempting to merge a point created after
  a 'divide edge' of an edge common to both planes into a point
  not common to both planes.

 The program would lock after sequentially performing a LTP calculation
  then a Reflection calc. The program would stop responding to Windows
  commands by performing a LTP calculation, cleaning up the setup
  windows, and then performing a Reflection calculation. Upon clicking
  'Compute' on the Reflection setup window, the program stops responding
  and must be exited by using the "ctrl-alt-del" escape mechanism.

 Other small repairs were made to follow changes in the Windows OS
        

-------- Revision History -------------------------------------------------

CADP2 Version 1.22
====================

All programming emphasis has now been shifted to the coding of CADP2 v2.0
This new program will contain many of the owner requested features and
advanced calculations including the use of high definition device files.

In the meantime this updated version of CADP2 contains repairs, some 
minor revisions to the program, and resets the license window.
Included changes are:


 Repaired inable to save newly entered materials to CADP2ABS.DAT

 Corrected inable to save the visibility status of the layers.

 Modified list windows (such as the planes list window) that would jump
  back to the first value whenever the window is sized, moved, or covered.
  This problem made it difficult to pick a line without the row moving.

 Enlarged graphics memory capability for paint with 1024 x 768 monitors.

 Improved validity checking for entered device levels to prevent
  calculation overflows.

 Corrected inability to calculate Dir:Revb, %ALCons using a half-sphere
  device.

 Algorithm correction in the calculation of air absorption for use with 
  the Sabins table and path loss. Environment parameter changes now
  correctly affect air absorption values.

 Repaired a GPF error caused when a plane is deleted that is a lower number
  than that of an open 'points' window.

 Repaired several GPF and random lockup errors associated with plane
  manipulation initiated from the planes list window.



CADP2 Version 1.2 
===================

DXF Import
==============

1. Rooms drawn in other 3D CAD programs can be imported into CADP2
   if the planes have been built using "3D Faces" and saved to a 
   single layer named "ROOM". All other entities in the DXF file
   will be ignored by CADP2.

2. Once Imported, the room planes can be cleaned up and enhanced.
   Acoustical attributes can then be added to the imported planes.

3. The CAD program can be used to build a 3D drawing from supplied 2D
   room plans. The 3D section can be drawn as a separate CAD layer and
   then be exported as a DXF file.

4. The designer can decide, based on efficiency, what portion of the
   drawing should be done in the CAD drafting program and what should
   be done in CADP2.


DXF Export
==============

1. The CADP2 DXF Export function now includes the room layer
   information in the export file. The room drawing is saved as a
   separate DXF layer titled "ROOM."

2. The room planes are exported as "3D Faces". Since "3D Faces" are
   limited to four vertices - the planes in CADP2 with more than four
   boundary points are divided into smaller planes so that all
   exported planes meet the "3D Face requirement. The edges of all
   of the newly created planes are ASSIGNED AN INVISIBLE ATTRIBUTE
   so that the room when viewed in the CAD program will appear
   exactly the same as it did in CADP2.

3. All devices associated with the JOB are exported and each device is
   assigned its own DXF Layer. Devices in CADP2 that do not have a 
   associated Mechanical Drawing will be exported with a generic horn
   symbol. A warning message will alert the user whenever the generic
   symbol is being used.

What's New in CADP2 Version 1.1  (12/2/92)
===============================


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

This updated version of CADP2 contains a number of revisions and 
new features. This document summarizes the major changes from 
earlier versions. Please study the installation instructions 
carefully prior to installing the revised software, because the 
installation procedure has changed.


Hardware
========

Because of the serious performance limitations imposed by 
computers with insufficient memory, a minimum of 4 MB of memory is 
now listed as a requirement for satisfactory operation. However, 
CADP2 will continue to function on computers with as little as 1 
MB of memory.


Software
========

CADP2 has incorporated some internal program code features from 
Windows 3.1 for improved efficiency, and it will not operate under 
earlier versions of Windows. Consequently, Windows 3.0x users must 
upgrade to Windows 3.1 prior to installing CADP2 V1.1. Contact 
Microsoft or local software suppliers for information on Windows 
3.1 upgrade availability.


CADP2 Installation
==================

1. Disk Free Space
------------------

Be sure that there is room on the hard disk for at least 1.5 
megabytes of CADP2 files. Additional space will be required to 
store jobs as they are designed.


2. Backup
---------

Prior to installing CADP2, write protect the 3.5" distribution 
diskette by sliding the plastic tab in the corner so that the hole 
is open (note that high density 3.5" diskettes such as the CADP2 
disk have holes in both upper corners), and make a backup copy of 
this disk onto another fioppy disk. Store the original diskette in 
a safe place, and perform the remainder of the installation steps 
using the copy. While replacement distribution diskettes are 
available for a nominal fee in case the original is damaged, there 
will be an unavoidable delay while the new diskette is duplicated 
and shipped.


3. File Transfer
----------------

Note: For safety, make certain that backups of all .JOB files are 
kept. If old distributions are to be kept on the hard disk, rename 
the existing CADP2 subdirectory before installing the new version.

Place the backup copy of the distribution diskette into the 
appropriate 3.5" drive.

Log onto the backup diskette, and run the installation batch file, 
giving it the name of the disk where CADP2 is to be installed. For 
example:

	C:\>A: [return]

	A:\>INSTALL C: [return]

Depending upon the computer's floppy diskette and hard disk 
configuration, substitute the appropriate drive letters in the 
above example. Note, however, that if the selected hard disk is 
not Drive C:, the CADP2.INI file should be modified so that CADP2 
will find job and device file locations on that hard disk. See the 
instructions below in Part 4: CADP2.INI Customization for 
instructions.

INSTALL will create a \CADP2 subdirectory on the specified drive 
if it does not already exist.  INSTALL renames two existing files: 
CADP2ABS.DAT becomes CADP2ABS.OLD, and CADP2.INI becomes 
CADP2INI.OLD. INSTALL then unpacks the distribution from the 
diskette. INSTALL will replace any file in the \CADP2 subdirectory 
whose name is identical to a file in the distribution, thus 
insuring that all files are the most recent versions.


4. CADP2.INI Customization
--------------------------

If CADP2 has been installed or re-installed on a hard disk other 
than Drive C:, three default settings in the CADP2.INI file should 
be changed so the program will find and save jobs, devices and 
arrays on the proper drive. These changes are not necessary if 
CADP2 is installed on Drive C:.

To change the CADP2.INI file:

o	Assuming that Windows 3.1 is running, double-click on the 
	Accessories group icon in the Program Manager if the 
	Accessories window is not open.

o	Double-click on the Notepad icon in the Accessories window 
	to open this application. Do not use the Write application.

Caution: Be certain that you have selected the Notepad 
application. Do not use Write or another word processor to make 
these modifications, because CADP2 will not be able to read the 
resulting file.

o	Select the Open command from the File menu: File|Open 
	(alt, f, o). 

o	In the resulting dialog box, the contents of the File Name 
	window will be highlighted and will read: *.txt.

o	Type the following into the File Name window:

		drive:\CADP2\CADP2.INI

	where drive: is the drive on which CADP2 was installed. 

	For instance, if CADP2 was installed on the D: drive, type:

		D:\CADP2\CADP2.INI

	and click OK (return). The CADP2.INI file should open. If 
	you get an error message, check to be certain that you have 
	typed the path correctly, using the backslash key instead of 
	the slash key.

o	Find the seventh, eighth and ninth lines from the beginning 
	of the file. If these lines have not previously been 
	modified, they will read:

		DeviceDirectory=c:\cadp2\devices

		DataDirectory=c:\cadp2

		Job-Path=c:\cadp2

o	In all three lines, change the C: to drive:, where drive: is 
	the drive on which CADP2 was installed. For example, if 
	CADP2 was installed on the D: drive, change the lines to 
	read:

		DeviceDirectory=d:\cadp2\devices

		DataDirectory=d:\cadp2

		Job-Path=d:\cadp2

o	Select File|Save (alt, f, s). The modified file will now be 
	saved.
	
o	Choose File|Exit (alt, f, x). Notepad will close.

Installation is now complete.


Changes from Earlier Releases
=============================

The accelerator keys used for zooming in and out have been 
reversed. F3 now reduces the view and F4 now increases it.

The bounding boxes around devices default to the no display 
condition. This default can be changed in the CADP2.INI file by 
changing the following line in the Preferences Group from FALSE to 
TRUE: 

	DefaultBoundingBoxes=TRUE.

The DXF mechanism has been corrected to export correctly in 
English (Inches) and Metric (Meters). The DXF file produced will 
have all arrays positioned in reference to the room origin.

A solid triangle in each active text window points to the item in 
that window which can be changed by keyboard action. See Keyboard 
Navigation below.

The maximum number of painted planes in a job will depend on the 
total number of planes, the number of edges in the planes and the 
orientation of the planes with respect to the arrays. The upper 
limit is estimated to be in the vicinity of 150 painted planes for 
most jobs, which should rarely, if ever, be a problem in practice.

The Colors palette window has been renamed as the Scale window.

Numerous anomalies and bugs have been corrected, and some dialog 
boxes have been redesigned to take advantage of new Windows 3.1 
features.


Additions to V1.1
=================

Export/Import Arrays
--------------------

With this feature, it is now possible to construct simple or 
elaborate systems and save the exact configuration to a data file. 
The .ARY file can be called up in the same job for placement of 
additional clusters in the room or called up in some other job 
with similar requirements. Once imported, the array can be 
repositioned, re-aimed, and any of its contents modified.

This new mechanism has a distinct advantage when utilized with 
multi-way speaker products such as the Architectural Series. 
Instead of the product being measured and stored as a single 
entity, the components of a multi-way, when saved as an array, can 
now be manipulated separately for adjustments to their drive 
levels and frequency band selection. Yet the array can be 
positioned, aimed, and controlled as a single unit.

To export an array:

o	Open the Arrays and Devices window or subsidiary window.

o	Select the Cluster or Group whose contents you wish to 
	store.

o	Select File|Export ARY.

o	Enter a brief description in the Title box at the bottom.

o	Enter a DOS name in the File Name box.

o	When in the appropriate directory and drive, click OK 
	[return] to save the array.

To import an array:

o	Open the Arrays and Devices window or subsidiary window 
	where the array is to be placed.

o	Select File|Import ARY.

o	Locate an .ARY file and click once on it to display the 
	description in the status bar at the bottom.

o	Click OK (return) to complete the Import

Note: It is generally best to keep user defined arrays in their 
own directory. If the user created arrays are to be shown in the 
Device Type window accessed from Array|New Device (alt, a, n), the 
arrays must be stored in the directory defined by the 
DeviceDirectory statement in the CADP2.INI file. See  below for 
additional information on this topic.


Arrays as New Devices
---------------------

It is now possible to place a new array on an Arrays and Devices 
table by simply adding it as a new device. Many of the 
Architectural Series products have been added as arrays and are 
included with this version.

To place an array as a new device:

o	Open the Arrays and Devices window or subsidiary window 
	where the array is to be placed.

o	Select Array|New Device (alt, a, n). Remember that this menu 
	appears only when the Arrays and Devices or subsidiary 
	window is open and in the foreground.

o	Pick Saved Array and select an array from the list. The list 
	shows the saved array description, not the DOS file name.

o	Click OK.

The new array will be added to the forward array window.

Note: The arrays shown in this window are the ones contained in 
the DeviceDirectory defined in CADP2.INI, which defaults to 
C:\CADP2\DEVICES. If it is desired to have user-defined arrays 
visible in the New Device window, they must be in this directory 
in order for the New Device window to access them. Additionally, 
since CADP2 reads in the devices at the time it is opened, it will 
not see any arrays or devices which are added to this directory 
after a particular CADP2 session is started. To add a newly 
defined array or any array not contained in the DeviceDirectory, 
use File|Import ARY.


Plane Materials
---------------

Each newly created plane can now have an absorption material 
assigned by default. The default material can be specified by the 
user in the Drawing Options window and saved to the CADP2.INI file 
as the program startup default by clicking Save. Besides the 
obvious convenience, this method prevents planes from having no 
material assigned to them.

When V1.1 finds any planes from older jobs without an assigned 
absorption material while it is calculating, it issues a warning 
message that indicates the offending planes.


Open Room Condition
-------------------

All plane edges must be connected to adjacent edges in order to 
perform valid calculations involving reverberation. A new Warn 
indicator has been added to the Planes Database window which 
highlights (turns black) if that plane has any unconnected edges. 
This condition is detected only when reverberation calculations 
are made, and warnings are issued if  any plane edges are found to 
be unconnected, thus invalidating the calculation results.


Reports
-------

Reports that contain graphics can now be printed on Hewlett-
Packard and other printers. Previously they could only be 
correctly printed on PostScript printers.

Text reports can now be saved to a data file and are correct for 
the choice of Metric or English dimensions.


Job Directory
-------------

As shipped, the default job directory (the first place CADP2 shows 
as a job storage location) is C:\CADP2, the same one in which the 
CADP2.EXE program resides by default, although jobs may be stored 
in any available disk storage. Each time a job file is opened or 
saved, the CADP2.INI file is automatically modified so that the 
next time a job is stored or retrieved, that directory becomes the 
default job directory. 

Note: A separate default job storage subdirectory may be manually 
defined by modifying a line in the CADP2.INI file. Change 
Job-Path=drive:\directory in the [CADP2] section, where 
drive:\directory are the desired items. Be sure that the new drive 
and directory actually exist. Remember, however, that this line 
will be changed when a job is stored or retrieved at a different 
location during CADP2 operation.

Note: Deleting the Job-Path=drive:\directory line from the 
CADP2.INI file disables these options, and the default directory 
will then always be the one which contains the CADP2.EXE program 
file. It will still be possible to store a job in any directory on 
any drive, but the default directory will not change.


Keyboard Navigation
-------------------

Keyboard navigation of the text windows has been implemented. 
Navigation is now possible either by mouse or, within the windows, 
by use of the Home, End, PgUp, PgDown, Right and Left Arrow keys. 
Window selection, opening and closing may be done by use of the 
Tab, Space and Enter keys according to standard Windows SAA user 
interface specifications. 

A triangle will point to the active item in the window whether 
navigation is performed by keyboard or mouse.

See the Appendix of the manual for further information.


Level-Time Export
-----------------

This is an ASCII text export of the information contained in the 
LTP Echogram that can be used with third party programs to produce 
an auralization file.

To export the echogram:

o	Click on the Export button in the LTP Summary window.

