Landru Audio ToolSet 2 User manual
The
Audio ToolSet 2
Suite
build 3.0
manual
A u d i o T o o l S e t 3 . 0
Nashville, TN, USA
www.landrudesign.com
Audio ToolSet 2 is a trio of Vectorworks® Plug-In Objects that enable you to insert simple Hybrid (2D and 3D) models
of loudspeakers and flown line arrays. While they are not meant to replace (or even approach the complexity of)
manufacturers’ or 3 -party high-end sonic analysis software, these flexible tools give Vectorworks® users considerable
rd
power...: to perform basic audio coverage analysis, to create audio system layout drawings, to check general space
requirements, and to visualize audio components for projects.
Notable features of Audio ToolSet 2:
For all three of the tools...
• Because the objects generated are not based on fixed Symbols, loudspeaker and bumper geometry can easily be
changed on-the-fly based on specifications users enter.
• Regularly-used configurations can be saved in a Library for later retrieval. NEW in Audio ToolSet 2.5, loudspeaker
and bumper types have user-assignable names. (For example, a loudspeaker’s Brand and Model might be "Landru
Design" and "LD6000" but a user can store the Type as "Mid/High.") Bumper and loudspeaker specifications are
stored independently of each-other and can now be deleted without users' having to edit the external Library file
manually.
• The tools help to track relevant information, like brands and models, weights, locations, purposes, drive lines, trim
heights, and tilt angles. Most of this information can be displayed directly on drawings as text blocks.
• NEW in Audio ToolSet 2.5,stock loudspeaker and bumper information can be imported from appropriately-
configured Vectorworks® files. These files can also be easily shared with other users.
• NEW in Audio ToolSet 2.56,loudspeakers can be easily turned “side-ways” using the “Flip Orientation” toggle.
• NEW in Audio ToolSet 2.61, the “Weight” fields now recognize kilograms and U.S. pounds. The given units are
stored in the Library alongside the previous “unitless” weights.
• The different parts of each audio object can be assigned to different Classes and, NEW in version 3, users can
choose which parts are assigned to Classes and can define custom Class names.
p a g e 2 o f 1 9
A u d i o T o o l S e t 3 . 0
AudioBox 2...
• Allows the display of variable horizontal and vertical dispersion areas (in both 2D and 3D). The dispersion lines
compensate for the project “floor” (the drawing Ground Plane) and a user-defined listening height. NEW in
AudioBox 2, three independently-definable Dispersion Ranges can be defined so users can visualize loudspeaker
performance for different frequency ranges, key frequencies, or crossover points. Each range can be independently
Classed and is color-coded. NEW in version 3, horizontal dispersions can be asymmetrical.
• Will track different support options (flown, stacked, tripod, etc.). NEW in AudioBox 2: While the other "Support"
options remain reference-only, if "Tripod" is chosen, a floor stand will be created with adjustable height. NEW in
AudioBox 3 is the “Yoked” “Support option, which creates a yoke and clamp for the loudspeaker.
• NEW in version 3, ceiling speakers can be created, in addition to the standard “cabinet” loudspeakers possible in
previous versions.
• NEW in version 3, speaker wattages (Minimum, RMS, and Peak) can be tracked.
AudioArray 2...
• Will insert up to 42 loudpeakers and/or additional bumpers in a given array and, NEW in AudioArray 2, of up to
three different AudioBox 2 types in each - for things like subs, underhangs, etc. Geometry and data for each
loudspeaker type is totally independent of the others.
• NEW in AudioArray 2, element-to-element angles are independent for each loudspeaker in the array.
• Uses a NEW AudioArray 2 user-friendly “"Array Detail and Configuration” dialog. This dialog includes
automatically-updated preview windows so users can instantly see what they’re creating - bumpers, loudspeakers -
and/or changes to the over-all array.
• NEW in version 2.5, loudspeakers can be inserted for multiple arrays at the same time.
• NEW in version 2.55, arrays can be ground-stacked in addition to being flown.
• NEW in version 2.55, trapezoidal or chamfered bumpers can be created.
• NEW in version 2.55, bumperless arrays can be created.
• NEW in version 2.56, tripod-mounted arrays can be created.
• NEW in version 2.55, speakers can be shifted backward and forward relative to their bumpers.
• NEW in version 2.61, the “Update” button now fixes misarranged arrays.
• NEW in version 2.61, AudioBumper 2 has been added, allowing multiple bumpers (pull-back and transitional) to be
inserted.
• NEW in version 2.61, extension bars can now be created and stored with defined bumpers in the Library.
p a g e 3 o f 1 9
A u d i o T o o l S e t 3 . 0
• NEW in version 2.61, rigging guides can now be shown, marking potential insertion points for hoist Symbols and
Plug-In Objects.
• NEW in version 3, speaker Rack and Drive Line data can be entered in the “Array Detail and Configuration” dialog.
p a g e 4 o f 1 9
A u d i o T o o l S e t 3 . 0
Table of Contents
System Requirements and License . . . . . . . . . . 6
Installation . . . . . . . . . . 7
General Introduction . . . . . . . . . . 8
AudioBox 2 . . . . . . . . . . 9-10
AudioArray 2 . . . . . . . . . . 11-15
AudioBumper 2 . . . . . . . . . . 16
Text Options . . . . . . . . . . 17
Parts Classes . . . . . . . . . . 17
Library File Notes . . . . . . . . . . 18-19
p a g e 5 o f 1 9
A u d i o T o o l S e t 3 . 0
Starting with version 3, Audio ToolSet 2 requires
Vectorworks® and Renderworks® 2014 or newer.
License
By downloading and using this (or any) version of any of Audio ToolSet 2, you agree to the following:
1) You agree that you are using Audio ToolSet 2 under a license granted by Landru Design.
2) You agree that all title, ownership, rights, intellectual property rights in and to Audio ToolSet 2 and all copies
thereof, regardless of form (including, but not limited to, computer or source code and any related
documentation), are owned or expressly licensed by Landru Design. Such rights extend to all updates of
Audio ToolSet 2 and any related derivative works.
3) You agree not sell, rent, lend, loan, lease or otherwise transfer or distribute the Audio ToolSet 2 software.
Furthermore, you agree not to modify, dissemble, decompile, or reverse-engineer the Audio ToolSet 2
software.
4) You agree that a download/license of Audio ToolSet 2 is intended for a single, individual user. Please contact
Landru Design for multi-user/site licensing.
5) You agree that this license may be terminated by Landru Design if you fail to comply with its terms and
conditions. You agree that, upon such termination, you will destroy (or permanently erase) all copies of
Audio ToolSet 2.
6) You agree that Audio ToolSet 2 is provided "as is" and is provided without warranty of any kind, either
express, implied, or statutory, including but not limited to, any implied warranties of merchantability or
fitness for a particular purpose. You agree not to hold Landru Design or any of its owners, personnel,
subsidiaries, or affiliates responsible for any damages of any kind resulting from the use of this software,
including but not limited to, inaccuracies, loss of data, loss of goodwill, work stoppage, computer or software
failure or malfunction - and all other direct, indirect, incidental, special, exemplary or consequential damage
and losses. In the event that Landru Design is found liable to you, you agree that such liability shall not
exceed the amount of fees paid by you for the use of Audio ToolSet 2.
7) You understand and agree that the calculations and any suggested weights provided by these tools are
intended as estimates only and that Landru Design makes absolutely no representations, guarantees, or
warranties regarding their accuracy. You acknowledge that you are STRONGLY advised to perform your
own calculations and to confirm all weights. You agree to assume all liability arising from using these tools
and agree to hold harmless and indemnify Landru Design in the event that miscalculations and/or inaccurate
data cause or allow loss or damage of any kind.
p a g e 6 o f 1 9
A u d i o T o o l S e t 3 . 0
Installation
Audio ToolSet 2 consists of four files:
• AudioBox 2.vso
• AudioArray 2.vso
• AudioBumper 2.vso
• LandruStrings.vwr (or, for Vectorworks 2014®, LandruStrings.xml)
Copy all four files to the Plug-Ins folder of your Vectorworks® folder (or, your User folder).
Vectorworks® should not be running during the file copying process.
Next, start Vectorworks® and add the tools to your favorite Workspace. If you've never done that before
and are not near your Vectorworks® manual:
1) Click...[Tools]...[Workspaces]...[Workspace Editor]. Make sure "Edit current workspace" is
selected and click "OK."
2) In the resulting dialog, click the "Tools" tab.
3) Scroll down the available tool section (the left side) until you see the "Landru" section. Click the
"+."
4) Drag the AudioBox 2 and AudioArray 2 icons to an existing palette or create a new palette (or
Tool Set) and drag the icons there. (Do NOT add AudioBumper 2 to your Workspace.)
5) Click "OK."
p a g e 7 o f 1 9
A u d i o T o o l S e t 3 . 0
Using Audio ToolSet 2
Choose the Audio ToolSet 2 icon for the particular tool you wish to use (AudioBox 2 or Audio Array 2) from
the Tool Set to which you added it earlier. A ghost image of the object’s default geometry will appear in
your drawing window. Click in your drawing to place the AudioBox 2 or Audio Array 2 object. Rotate the
object to the desired angle and click again (like placing Vectorworks® symbols).
With the newly-placed object selected, use the Object Info Palette to make adjustments. If the Shape tab is
not in the forefront of the Object Info Palette, click it to make it so.
AudioBox 2’s tools’ different parameter settings are detailed in the next 2 pages. AudioArray 2 has
additional steps in its use. See pages 11-16 for more information.
If you are transitioning to this version - either from a build older than 2.61 or from the audio tools included
with Vectorworks Spotlight® - expect the tools to ask you from time-to-time what weight units (lb or kg)
were intended when working with Plug-In Object instances or Library items created with those versions.
See pages 18-19 for more information.
Please forgive any discrepancies between this manual, its illustrations, and reality. It is often easier
to make software fixes and/or additions than it is to keep a manual current.
p a g e 8 o f 1 9
A u d i o T o o l S e t 3 . 0
AudioBox 2 parameters
Class, Layer, X, Y, Z, and Rotation: Settings similar to other Vectorworks® symbols and objects. (“Z” is the distance
from the drawing’s ground plane to the bottom front center of the loudspeaker or to the bottom of the floor stand if
“Tripod” is chosen under “Support”).
Type: A list of predefined loudspeakers. The only option is “<Generic>” unless you have saved custom loudspeaker types
to the Library using the Save to Library button (see below). If so, your additions will be listed here, as-well.
Selecting a stored type will populate many of the parameters below. Choosing the “Import...” option will cause the
“Import Speaker Type” dialog to open, which will allow loudspeaker data to be imported from appropriately-
configured Symbols in Vectorworks® files found in the “...Libraries/Defaults/Audio Tools/Speakers” folder.
Ceiling Speaker: Causes ceiling speakers to be created, as opposed to in addition to the standard "cabinet” type.
Brand and Model: Places for entering the loudspeaker brand and model.
Front Width and Front Height: The width and height of the front face of the loudspeaker. (Only available if “Ceiling
Speaker” is NOT selected.)
Back Width and Back Height: The width and height of the back face of the loudspeaker. (Only available if “Ceiling
Speaker” is NOT selected. Back Width and Back Height cannot be larger dimensions than the Front Width and
Front Height.)
Depth: The depth of the loudspeaker. (Only available if “Ceiling Speaker” is NOT selected.)
Grill Diameter: The diameter of a ceiling speaker’s front grill. (Only available if “Ceiling Speaker” is selected.)
Cutout Diameter: A ceiling speakers cutout or “can” diameter. (Only available if “Ceiling Speaker” is selected.)
Height: A ceiling speaker’s height (or, depth). (Only available if “Ceiling Speaker” is selected.)
Flip Orientation: Flips the loudspeaker to a “side-ways” orientation. (Only available if “Ceiling Speaker” is NOT
selected.)
Tilt Reference: The reference that AudioArray 2 uses when setting the tilts of each box in an array - either the front or back
face of the loudspeaker. (Only available if “Ceiling Speaker” is NOT selected.)
Weight (lb) or Weight (kg): The loudspeaker’s weight. If the drawing units are Imperial, this should be entered in U.S.
pounds. If the drawing units are Metric, this should be entered in kilograms. When the weight is entered in a given
unit, the other is automatically calculated and stored.
Self-Powered: A toggle for noting whether the loudspeaker uses an internal or remote amplifier.
Minimum Wattage,RMS Wattage, and Peak Wattage: Places for entering wattage data.
Asymmetrical Horizontal Dispersion(s): A toggle to enable asymmetrical horizontal dispersions.
Expand Dispersion Features: A toggle for enabling Range notes and Dispersion area information beyond a simple
“Overall”.
Range 1, Range 2, and Range 3: Places for entering notes for the three Dispersion Ranges (for example, a frequency range,
key frequency, or crossover point). (These parameters are only enabled if Expand Dispersion Features is toggled
on.)
Horiz. Dispersion Full, Horiz. Dispersion Left, Horiz. Dispersion Right: Horizontal dispersion angles. “Full” is the
sum of “Left” and “Right.” “Left” and “Right” are relative to a loudspeaker facing “down-screen.” (The “full”
angles can be between 0° and 180°. The Dispersion parameters for Range 2 and Range 3 are only enabled if
Expand Dispersion Features is toggled on.)
Vert. Dispersion: Horizontal and vertical dispersion angles. (These angles can be between 0° and 180°. The Dispersion
parameters for Range 2 and Range 3 are only enabled if Expand Dispersion Features is toggled on.)
Throw Distance: The throw distance reference for the dispersion lines. (The Throw Distances for Range 2 and Range 3
are only enabled if Expand Dispersion Features is toggled on.)
Save to Library (button): Saves key loudspeaker information to an external data file for later use. (See Type, above.)
When this button is clicked, a dialog opens, allowing the assignment of a custom Type name. Though the default
name is [Brand]-[Model], a new name can be entered. (For example, the Brand and Model in this OIP are “Landru
Sound” and “LS5000" but the Type could be“Fill,” “Full-Range,” “Sub,” etc. - “LS5000" used in the example OIP.)
This Type name is what appears in the Type pop-up. (See pages 18-19 for more information on the Audio ToolSet 2
Library system.)
Delete From Library (button): Deletes a selected loudspeaker Type from the external data file. (Only enabled if a non-
Generic Type from the Library is selected. See Type, above.)
p a g e 9 o f 1 9
A u d i o T o o l S e t 3 . 0
AudioBox 2 parameters, continued...
Listening Height: The listening height reference for the dispersion lines. (Listening Height cannot be higher than a given
AudioBox 2 model’s “Z” value.)
Override Vert. Dispersion(s) with Array Angles: Will use Angle Relative... angle instead of stated Vertical Dispersion
angles when drawing Dispersion lines. (See Tilt Difference below and Angle Relative... on page15 for more
information. Only enabled if the AudioBox 2 instance has been placed by AudioArray 2.)
Show Dispersion Range 1, Show Dispersion Range 1, and Show Dispersion Range 1 : Draws top, bottom, left, and
right dispersion lines, and a center reference for each of the three Dispersion ranges. Also, an outline and hatch
representing the listening area coverage “shadow” will be drawn if the Vertical Dispersion angle, Throw Distance,
and Tilt Angle allow the loudspeaker to cover the Listening Height or below. (The toggles for Range 2 and Range 3
are only enabled if Expand Dispersion Features is toggled on.)
Show Dispersion Hatch: Adds a hatch pattern to represent the listening area coverage “shadow” if the Vertical Dispersion
angle, Throw Distance, and Tilt Angle of any of the enabled ranges allow the loudspeaker to cover the Listening
Height or below, in addition to the “shadow’s” outline. (Only enabled if one of the Dispersion Ranges is shown.
See Show Dispersion Range 1, Show Dispersion Range 2, and Show Dispersion Range 3, above.)
Support: A pop-up menu of support options. While the other options are reference-only, if “Tripod” is selected, AudioBox
2will create a tripod floor stand. (Only available if “Ceiling Speaker” is NOT selected.)
Stand Height: The height of the floor stand. (Only enabled if “Ceiling Speaker” is NOT selected and only if the “Tripod”
“Support” is selected.)
Tilt Difference: The tilt difference between the selected loudspeaker and the bumper or loudspeaker above it, once the
Arrange Column button has been clicked - or as determined by the AudioBox 2 object’s being placed by AudioArray
2. (Only available if “Ceiling Speaker” is NOT selected.)
Actual Tilt Angle: The actual tilt of the loudspeaker. (Only available if “Ceiling Speaker” is NOT selected. Negative
numbers tilt the cabinet down; positive, up. AudioBox 2 will not allow the loudspeaker to tilt more than 90° or less
than -90°.)
Location: A place for entering the loudspeaker location (such as Downstage Right).
Purpose: A place for entering the loudspeaker purpose (such as Center Fill).
Rack: A place for entering information about the rack driving the loudspeaker.
Drive Line: A place for entering information about the drive line feeding signal to the loudspeaker.
Column ID: The name for the column (if any) in which the AudioBox 2 object is placed. This is also the name for the
AudioArray 2 “parent”/“master’ bumper and the “child”/“slave” loudspeaker. This is how the Plug-In Object knows
which loudspeaker or additional models to control - either via the Arrange Column button (see below) or the
AudioArray 2 PIO. (Only available if “Ceiling Speaker” is NOT selected.)
Position in Column: The loudspeaker’s position in its column, once the Arrange Column button has been clicked or the
AudioBox 2 object has been placed or updated by an AudioArray 2 object.. (Only available if “Ceiling Speaker” is
NOT selected. “1" is the top loudspeaker.)
Arrange Column (button): If multiple AudioBox 2 objects are selected, each with different “Z” values - but with matching
Column IDs, clicking this button will adjust the stacking order so that 2D “overlaps” are correct, calculate Tilt
Differences, and assign Position in Column numbers. (Only available if “Ceiling Speaker” is NOT selected.)
Note: A place for entering miscellaneous notes, such as rental source or stock number.
Text Options...: A button to open the “Text Options” dialog, in which text elements are shown, hidden, and/or modified.
(See page 17 for more information).
Default Text Position: A button to return text to its default location. (Only enabled if text has been inserted.)
Parts Classes...: A button to open the “Parts Classes” dialog, used to assign the different elements comprising the
AudioBox 2 model to different Classes.. (See page 17 for more information.)
Update (button): Click this button to regenerate the AudioBox 2 object. You might need to click this if you’re making
changes regarding using Class Attribute settings.
AudioBox 2 Build: The build number of the AudioBox 2 Plug-In Object code.
p a g e 1 0 o f 1 9
A u d i o T o o l S e t 3 . 0
AudioArray 2 (introduction)
AudioArray 2 works a little differently than AudioBox 2. Whereas AudioBox 2 inserts a single
loudspeaker cabinet in a single step, AudioArray 2 is actually used to insert a bumper and a
vertical array of loudspeakers and/or additional bumpers in separate steps.
If you’re transitioning from a previous version of Audio ToolSet, note that, as described below, the
approach for using this new version is a little different...
To use AudioArray 2:
1) Click the AudioArray 2 icon in the tool palette to which you added it earlier. A ghost image
of the tool’s default bumper will appear in your drawing. Click in your drawing to place the
bumper. Rotate the bumper to the desired angle and click again to set the angle (like placing
Vectorworks® symbols). If an initial settings dialog box appears, make adjustments and click
“OK” in that box.
2) With the AudioArray 2 object selected, use the Object Info Palette to make basic adjustments
(such as bumper trim height) and to enter general array data. On Audio Array 2' s Object Info
Palette, click the “Configure Array...” button to bring up the “Array Detail and
Configuration” dialog, allowing you to specify array details, loudspeaker counts, or to make
adjustments (such as bumper and loudspeaker dimensions, loudspeaker counts, and hanging
angles). Double-clicking the Audio Array 2 object will also bring up the dialog.
3) Click the "Populate Array" button toward the bottom of the AudioArray 2 Object Info Palette.
AudioArray 2 will place independent “child”/“slave” AudioBox 2 loudspeakers and/or
AudioBumper 2 bumpers that are "connected" to the “parent”/“master” bumper. The
AudioBox 2 and AudioBumper 2 instances are built using dimensions designated in the
AudioArray 2 “Array Detail and Configuration” dialog - and display their own info in the
Object Info Palette. All of the additional bumpers’ settings and the majority of the
loudspeakers’ settings are “fed” by the AudioArray 2 “parent”/“master” object. Once
loudspeakers and/or additional bumpers have been inserted by a given AudioArray 2 object,
changes made in its “Array Detail and Configuration” dialog will automatically rebuild the
array.
AudioArray 2’s parameter settings are detailed on the next pages...
p a g e 1 1 o f 1 9
A u d i o T o o l S e t 3 . 0
AudioArray 2 parameters
Class, Layer, X, Y, Z, and Rotation: Settings similar to other Vectorworks® symbols and objects. (“Z” is the distance
from the drawing’s ground plane to the bottom front center of the bumper.)
Array Details:
Column ID: The name for the inserted “parent”/“master” bumper and the “child”/“slave” loudspeakers and/or additional
bumpers. Because this is how the Plug-In Object knows which AudioBox 2 and AudioBumper 2 models to control,
each Column ID MUST be unique.
Location: A place for entering the array location (such as DSL).
Purpose: A place for entering the array purpose (such as Stereo Right).
Rack: A place for entering information about the rack driving the loudspeakers.
Drive Line: A place for entering information about the drive line feeding signal to the loudspeakers.
Note: A place for entering miscellaneous notes, such as rental source or stock number.
Configure Array... (button): Opens the “Array Detail and Configuration” dialog. This dialog is where you specify
bumper/support and loudspeaker details and configure the array (tilt angles, loudspeaker and/or bumper counts, and
loudspeaker and/or bumper positions in the array). (See pages 13-15 for more information.)
Current Types:
Bumper: The bumper type defined in the “Array Detail and Configuration” dialog, along with the quantity.
Extension Bar(s): The layout (center or sides) of Extension Bars (if defined).
A, B, or C: The types and quantities of the loudspeakers defined in the “Array Detail and Configuration” dialog.
Weight (lb) or Weight (kg) : After the Populate Array button has been clicked, the estimated total loudspeaker and
bumper weight of the array. If the drawing units are Imperial, this will be shown in U.S. pounds. If the drawing units
are Metric, this will be shown in kilograms. (Remember, THIS IS AN ESTIMATE ONLY. YOU ARE STRONGLY
ADVISED TO CONFIRM ALL CALCULATIONS.)
Support: How the array is supported, as defined in the “Array Detail and Configuration” dialog.
Bottom Element Trim: After the Populate Array button has been clicked, the trim of the bottom loudspeaker or bumper.
Listening Height: The listening height reference for the loudspeakers’ dispersion lines.
Override “A” Vert. Disp. with Array Angles, Override “B” Vert. Disp. with Array Angles , and Override “C” Vert.
Disp. with Array Angles: Will force inserted AudioBox 2 objects to use Angle Relative... angles for each of the three
loudspeaker types instead of stated Vertical Dispersion angles when drawing Dispersion lines. (Only potential
dispersions for loudspeaker definitions actually in the array will be enabled. See Tilt Difference on page 10 and
Angle Relative to Preceding on page 15 for more information.)
Show Dispersion Range 1, Show Dispersion Range 1, and Show Dispersion Range 1 : Causes the AudioBox 2 models
do draw top, bottom, left, and right dispersion lines, and a center reference for each of the three Dispersion ranges for
each of the AudioBox 2 models in the array. (Only ranges allowed by loudspeaker definitions actually in the array
will be enabled. See the AudioBox 2 section in preceding pages and the “Array Detail and Configuration” dialog
section on pages 13-15 for more information.)
Show Dispersion Hatch: Adds a hatch pattern to represent the listening area coverage “shadows” for each of the AudioBox
2models in the array. (See the AudioBox 2 section in preceding pages for more information.)
Show Rigging Guides: Toggle to mark potential insertion points for hoist Symbols and Plug-In Objects.
Populate Array (button): Inserts AudioBox 2 and/or AudioBumper 2 models or replaces array models if you’ve made
adjustments in the “Array Detail and Configuration” dialog. (Only enabled if at least one loudspeaker or additional
bumper has been added in the “Array Detail and Configuration” dialog. See the “Array Detail and Configuration”
dialog section on pages 13-15 for more information.)
Text Options...: A button to open the “Text Options” dialog, in which text elements are shown, hidden, and/or modified.
(See page 17 for more information.)
Default Text Position (button): Returns text to its default location. . (Only enabled if text has been inserted.)
Parts Classes...: A button to open the “Parts Classes” dialog, used to assign the different elements comprising the
AudioArray 2 model to different Classes.. (See page 17 for more information.)
Update (button): Click this button to regenerate the AudioArray 2 object. You might need to click this if you’re making
changes regarding using Class Attribute settings. This button will also cause the array to be rebuilt or “repaired” using
current settings.
AudioArray 2 Build: The build number of the AudioArray 2 Plug-In Object code.
p a g e 1 2 o f 1 9
A u d i o T o o l S e t 3 . 0
Array Detail and Configuration dialog
Each of the first four tabs (Bumper, Speaker A, Speaker B, and Speaker C) in this dialog is used to define elements that are used in the fifth tab (Array) to create
the array.
Bumper:
Type: A list of predefined bumpers. The only option is “<Generic>” unless you have saved custom
bumper types to the Library using the Save to Library button. If so, your additions will be listed here,
as-well. Selecting a stored type will populate many of the parameters to the right. Choosing the
“Import...” option will cause the “Import Bumper Type” dialog to open, which will allow bumper data to
be imported from appropriately-configured Symbols in Vectorworks® files found in the
“...Libraries/Defaults/Audio Tools/Bumpers” folder. Choosing the “None” option will replace bumper
geometry with Locus points
Brand and Model: Places for entering the bumper brand and model.
Save to Library (button): Saves key bumper information to an external data file for later use. (See Type,
above.) When this button is clicked, a dialog opens, allowing the assignment of a custom Type name.
Though the default name is [Brand]-[Model], a new name can be entered. (For example, the Brand and
Model in this dialog tab are “Landru Design” and “LD-RF 1" but the Type is “RF-1.”) This Type
name is what appears in the Type pop-up. (See pages 18-19 for more information on the Audio ToolSet
2 Library system.)
Delete From Library (button): Deletes a selected bumper Type from the external data file. (Only enabled
if a non-Generic Type from the Library is selected. See Type, above.)
Total Width, Total Depth, and Thickness: The overall width, depth, and thickness of the bumper.
Rear Width: The width of the rear face the bumper.
Side Depth: The measurement of the side face of the bumper, as measured from the front face.
If “Rear Width” and “Side Depth” are less than “Total Width” and “Total Depth” but “Side Depth” is
greater than 0, a “chamfered” bumper will be created. If “Rear Width” is less than “Total Width” and
“Side Depth” is 0, a trapezoidal bumper will be created. Otherwise, a rectangular bumper will be
created.
Hardware Width: The width of the hardware members comprising the bumper.
Any changes made to these dimensions will automatically update the “Array Configuration” tab - and
then the model itself once you click “OK.”
Weight (lb) or Weight (kg): The bumper’s weight. If the drawing units are Imperial, this should be
entered in U.S. pounds. If the drawing units are Metric, this should be entered in kilograms. When the
weight is entered in a given unit, the other is automatically calculated and stored.
Extension Bar(s): A list of options for creating Extension Bars (“None,” “Sides,” and “Center”).
The next 5 parameters are only enabled if an Extension Bar(s) option other than “None” is chosen.
Length, Height, and Width: The dimensions of the Extension Bars.
Weight (lb) or Weight (kg): An individual Extension Bar’s weight. If the drawing units are Imperial,
this should be entered in U.S. pounds. If the drawing units are Metric, this should be entered in
kilograms. When the weight is entered in a given unit, the other is automatically calculated and
stored.
Front Shift: The distance the Extension Bar(s) will shift forward or backward on the bumper.
Side Inset: The distance the Extension Bar(s) will shift in from the bumper sides. (Only enabled if the
Extension Bar(s) option “Sides” is chosen.)
Show Rigging Guides: A toggle for marking potential insertion points for hoist Symbols and Plug-In
Objects.
The next 3 parameters are only enabled if “Show Rigging Guides” is toggled on.
Front Inset: The distance “in” from the front of the bumper for the front guide(s).
Side Inset: The distance “in” from bumper sides. (Disabled if an Extension Bar(s) option other than
“None” is chosen. In those “non-None” cases, the guides “track” with the Extension Bar layout.)
Rear Offset: The distance “back” from the front guide(s) for the rear guide(s).
p a g e 1 3 o f 1 9
A u d i o T o o l S e t 3 . 0
Array Detail and Configuration dialog, continued...
Speaker A, Speaker B, and Speaker C:
(Much of this information is similar to that for AudioBox 2. See pages 9-10 for more information.)
Type: The default for Speaker A is “<Generic>.” For Speakers B and C, the default is “None.” If you
have saved custom or stock speaker types to the Library using the Save to Library button (see
below), they will be listed here, as-well. The only other option is “<Generic>” unless you have saved
custom loudspeaker types to the Library using the Save to Library button (see below). If so, your
additions will be listed here, as-well. Selecting a stored type will populate many of the parameters to
the right. Selecting “None” will mark any already-added loudspeakers for deletion. Choosing the
“Import...” option will cause the “Import Speaker Type” dialog to open, which will allow loudspeaker
data to be imported from appropriately-configured Symbols in Vectorworks® files found in the
“...Libraries/Defaults/Audio Tools/Speakers” folder.
(For Speakers B and C, the rest of the tab is only enabled if you choose a Type other than “None.”.)
Brand and Model: Places for entering the loudspeaker brand and model.
Save to Library (button): Saves key loudspeaker information to an external data file for later use. (See
Type, above.) When this button is clicked, a dialog opens, allowing the assignment of a custom Type
name. Though the default name is [Brand]-[Model], a new name can be entered. (For example, the
Brand and Model in this dialog tab are “Landru Design” and “SB 5000" but the Type is “Sub”)
This Type name is what appears in the Type pop-up. (See pages 18-19 for more information on the
Audio ToolSet 2 Library system.)
Delete From Library (button): Deletes a selected loudspeaker Type from the external data file. (Only
enabled if a non-Generic Type from the Library is selected. See Type, above.)
Front Width, Front Height,Back Width,Back Height, and Depth: Basic dimensions of the
loudspeaker. (All of these dimensions are subject to the same limitations as AudioBox 2. See page 8-
9 for more information. Any changes made to these dimensions will automatically update the “Array
Configuration” tab - and then the model itself once you click “OK.”)
Flip Orientation: Flips the loudspeaker to a "side-ways" orientation.
Tilt Reference: The reference used when setting the tilts of each box in an array - either the front or back
face of the loudspeaker.
Weight (lb) or Weight (kg): The loudspeaker’s weight. If the drawing units are Imperial, this should be
entered in U.S. pounds. If the drawing units are Metric, this should be entered in kilograms. When
the weight is entered in a given unit, the other is automatically calculated and stored.
Self-Powered: A toggle for noting whether the loudspeaker uses an internal or remote amplifier.
Minimum Wattage,RMS Wattage, and Peak Wattage: Places for entering wattage data.
Override Vertical Dispersion(s) with Array Angles: Will force inserted AudioBox 2 objects to use
Angle Relative... angles for each of the three loudspeaker types instead of stated Vertical Dispersion
angles when drawing Dispersion lines. (See Tilt Difference on page 10 and Angle Relative... on
page 15 for more information.)
Asymmetrical Horizontal Dispersion(s): A toggle to enable asymmetrical horizontal dispersions.
Expand Dispersion Features: A toggle for enabling Range notes and Dispersion area information
beyond a simple “Overall”.
Range 1, Range 2, and Range 3: A place for entering notes for each of the 3 Dispersion Ranges (for
example, a frequency range or cross-over point). (These parameters are only enabled if Expand
Dispersion Features is toggled on.)
Horiz. Dispersion Full, Horiz. Dispersion Left, Horiz. Dispersion Right: Horizontal dispersion angles.
“Full” is the sum of “Left” and “Right.” “Left” and “Right” are relative to a loudspeaker facing
“down-screen.” (The “Full” angles can be between 0° and 180°. The Dispersion parameters for
Range 2 and Range 3 are only enabled if Expand Dispersion Features is toggled on.)
Vert. Dispersion: Vertical dispersion angles. (These angles can be between 0° and 180°. The
Dispersion parameters for Range 2 and Range 3 are only enabled if Expand Dispersion Features is
toggled on.)
Throw Distance: The throw distance reference for the dispersion lines. (The Throw Distances for Range
2 and Range 3 are only enabled if Expand Dispersion Features is toggled on.)
p a g e 1 4 o f 1 9
A u d i o T o o l S e t 3 . 0
Array Detail and Configuration dialog, continued...
Array Configuration:
Array Support: How the array is to be supported. If “Ground-Stacked” or “Tripod” is chosen, a bumper
or a tripod will become the base for the array and the speakers will “stack” on it. Otherwise, the
speakers “hang” from a bumper.
Bumper Type: The Bumper defined in the “Bumper” tab. If no Type, Brand, or Model information has
been entered, the Bumper Type will be “Generic.”
Bumper Angle: The tilt of the bumper. (Negative values will tilt the bumper and loudspeaker array
down. Positive values will tilt the bumper and loudspeaker array up. Only enabled if an Array
Support option other than “Tripod” is chosen.)
First Speaker Shift: The distance the first speaker (and, as a result, all of the elements) will shift forward
or backward relative to the “parent”/”master” bumper.
Tripod Height: The height from the tripod’s insertion point to the bottom speaker. (Only enabled if the
“Tripod” Array Support is chosen.)
Bumper and Speaker Types to Add: The bumper and speaker(s) defined on the Bumper, Speaker A,
Speaker B, and Speaker C tabs. Only Speaker Types other than “None” are listed. As with the
Bumper Type, if no Type, Brand, or Model information has been entered, the definition’s Type will
be “Generic.”
Add/Swap Bumper(s) or Speaker(s) button: A button to add or swap bumpers or loudspeakers to or into
the array. Bumpers and loudspeakers will be added to (or, swapped into) the Definition list to the left.
(Only enabled if one of the element definitions in the Bumper and Speaker Types to Add list is
selected. Up to 42 elements may be added to a single array.)
Bumper and Speaker Counts: Current totals for each of the bumper and loudspeaker definitions.
Delete Speakers button: A button to delete bumpers and loudspeakers from the array. (Only enabled if
one or more of the bumpers and/or loudspeakers in the Definition list is selected.)
Angle Relative to Preceding: The angle for a selected bumper or loudspeaker relative to the element
(loudspeaker or bumper) immediately above it. For each of the bumpers and/or loudspeakers in the list,
the Definition list will note this relative angle and the actual tilt angle. (Only enabled if the bumper or
one of the loudspeakers in the Definition list is selected. Note: Audio Array 2 will only allow bumpers
and/or loudspeakers to be tilted less than 90° or more than -90°.)
Rack: A place for entering information about the rack driving the selected loudspeaker.
Drive Line: A place for entering information about the drive line feeding signal to the selected
loudspeaker.
Clicking the Add/Swap Bumper(s) or Speaker(s) button when no bumpers or loudspeakers are selected in
the Definition list to the left will ADD the currently-selected bumper or loudspeaker Type to the array.
Clicking this button when one or more bumpers or loudspeakers are selected in the Definition list to the left
will REPLACE the currently-selected element in the array with the Type selected in the Bumper and
Speaker Types to Add list.
For any of the elements contained in the Definition list, the bumper or loudspeaker in position #1 is closest to
the “parent”/”master” bumper and ascending numbered elements count up or down away from that bumper.
For any of the bumpers or loudspeakers contained in the Definition list, their positions can be changed by
dragging their numbers to other locations in the list.
Any changes made in the Definition list or to the Angle Relative to Preceding value will automatically
update the Preview window.
If AudioArray 2 has already inserted AudioBox 2 or AudioBumper 2 models, clicking “OK” on any of the
“Array Detail and Configuration” dialog tabs will cause the array to be rebuilt automatically.
p a g e 1 5 o f 1 9
A u d i o T o o l S e t 3 . 0
AudioBumper 2 parameters
Class, Layer, X, Y, Z, and Rotation: Settings similar to other Vectorworks® symbols and objects. (“Z” is the distance
from the drawing’s ground plane to the bottom front center of the bumper).
Type: The type of the bumper inserted.
Brand and Model: The bumper brand and model.
Overall Width, Overall Depth, and Thickness: The overall width, depth, and thickness of the bumper.
Rear Width: The width of the rear face the bumper.
Side Depth: The measurement of the side face of the bumper, as measured from the front face.
Hardware Width: The width of the hardware members comprising the bumper.
Weight (lb) or Weight (kg): The bumper weight. If the drawing units are Imperial, this will be shown in U.S. pounds. If
the drawing units are Metric, this will be shown in kilograms.
Tilt Difference: The tilt difference between the selected bumper and the bumper or loudspeaker above it, as determined by
the “parent”/”master” AudioArray 2 object.
Actual Tilt Angle: The actual tilt of the selected bumper.
Trim: The “Z” height of the selected bumper, as measured from the Ground Plane to the bottom front center (the Insertion
Point) of the selected bumper.
Column ID: The name for the column (if any) in which the AudioBumper 2 object is placed. This is also the name for the
AudioArray 2 “parent”/“master’ bumper and the “child”/“slave” bumper.
Position in Column: The bumper’s position in its column, once the AudioBumper 2 object has been inserted or updated by
an AudioArray 2 object.. (“1" is the top loudspeaker or additional bumper.)
Support: The support option for the array to which the bumper belongs.
Location: The bumper location (such as Downstage Left).
Purpose: A place for entering the bumper’s purpose (such as Pull-Back).
Note: A place for entering miscellaneous notes, such as rental source or stock number.
Text Options...: A button to open the “Text Options” dialog, in which text elements are shown, hidden, and/or modified.
(See page 10 for more information).
Default Text Position: A button to return text to its default location. (Only enabled if text has been inserted)
Update (button): Click this button to regenerate the AudioBumper 2 object. You might need to click this if you’re making
changes regarding using Class Attribute settings.
AudioBumper 2 Build: The build number of the AudioBumper 2 Plug-In Object code.
p a g e 1 6 o f 1 9
A u d i o T o o l S e t 3 . 0
Text Options dialog (AudioBox 2 shown)
Elements to Show:
A list of potential text elements that can be shown as part of each AudioBox 2, AudioArray 2, or AudioBumper 2
instance - "Type," "Brand," "Model," "Power Source," etc. Check the boxes of the elements to be included in the text
block placed on the drawing. Only items appropriate for a given object and/or elements actually containing
information will be enabled.
Show Element Labels: Check the box to include labels for each of the text elements. (“Brand,” “Model,” “Weight,” etc.
Only enabled if any of the “Elements to Show” are checked.)
Text Attributes (only enabled if at least one text element is selected to be shown):
Keep Text Horizontal: Toggle on to keep text horizontal, regardless of the Audio ToolSet 2 object’s rotation angle.
Fill Text Background: Toggle to cause the text block to have an opaque background.
Size: The size of the text element, in points.
Color: A pop-up to let you pick the color of the text element using the Vectorworks® Color Picker.
Horizontal and Vertical Alignment: Pop-ups to let you select text alignment and justification.
The AudioArray 2 and Audio Bumper 2 Text Options dialogs contain different elements to show, but are identical in
functionality.
Parts Classes dialog (AudioBox 2 shown)
Class Prefix: The prefix that will be applied to each suggested Class generated if the “Use Standard Classes”
button is clicked.
Use Standard Classes: A button to populate each of the Class Pop-Ups with suggested Class names, each
(except for “Loci”) with the prefix as entered in the “Class Prefix” box.
Cabinets,Grills, Stands, etc.: Class Pop-Ups specifying the Class to which the given part is assigned. Existing
Classes can be chosen or new Classes can be created on-the-fly. “<AudioBox 2 Class>” signifies the
individual part simply using the given object’s overall Class. By-default, “Loci” are assigned to the
“NonPlot-Loci” Class and all other parts are assigned to the object’s overall Class (the rough equivalent of
leaving the previous Audio ToolSet 2 versions’ “Class Parts...” box un-ticked ).
In the example to the left...
Cabinets and Grills are using the AudioBox 2 object’s overall Class.
Stands, Yokes, Dispersion Area 1, Dispersion Area 2, Dispersion Area 3, and Loci are all assigning the
given parts to Classes generated by clicking the “Use Standard Classes” button.
Text is assigning object text to a custom Class.
The AudioArray 2 Parts Class dialog is identical in functionality.
p a g e 1 7 o f 1 9
A u d i o T o o l S e t 3 . 0
Library Notes
Because questions about the Audio ToolSet 2 Library system are the most-asked of all of the inquiries we receive
regarding any of our tools, here are a few “under-the-hood” notes:
The File and Location
The tools simply store information (dimensions, weight, dispersions, etc.) about your speakers and bumpers - not the
model geometry. All of this Library information is stored in a file called "AudioToolSetData.xml." That file is
found in the "…\Libraries\Defaults\Audio Tools" folder - either in your Vectorworks® application folder or in your
User folder structure.
If your installation of Vectorworks® includes the "Speaker" and "Speaker Array" tools, a sample version of that file
might be found in the "...\Libraries\Defaults\Audio Tools" folder, found in your main Application folder. If your
installation does not include those tools, that file in that location does not exist.
The User Folder
If you've not set up a custom User Folder structure, you can find out which folder Vectorworks® is using to store
your Audio ToolSet 2 Library by going to the "User Folders" tab in the [Tools][Options][Vectorworks Preferences…]
dialog. The folder shown, there, will be where the "Libraries" folder structure is stored - which, in-turn holds the
“Audio Tools” folder.
On a Mac, “Libraries” folder is generally hidden unless you press the Option key when choosing the “Go” menu in
the Finder application.
Functionality Prior To Version 3.0
Prior to version 3.0 of these tools, if the sample file existed, the tools automatically created a “User” copy in the
“Audio Tools” folder in your User folder structure the first time one of the tools was used. Then on out, this is the
location where the tools accessed and stored your Library of speakers and bumpers. The sample file was never
checked again. If the sample file did not exist, the tools didn't do anything until you stored your first speaker or
bumper - which created the XML file from-scratch in the User folder. Every time either an AudioBox 2 instance was
touched or inserted or Audio Array 2's “Configure Array...” dialog was opened, the "User" Library file was read and
re-written - in addition to being re-written when you added or deleted a speaker or bumper to or from your library .
p a g e 1 8 o f 1 9
A u d i o T o o l S e t 3 . 0
Functionality in Version 3.0 and Beyond
Starting with version 3.0, every time either an AudioBox 2 instance is touched or inserted or Audio Array 2's
“Configuration Array...” dialog is opened, the Library file is read and checked using the following hierarchy:
First: "User" Library in the “User” folder
Second: "Sample" Library in the Application folder
Third: "Old” (version 1) Library
The tools will stop looking with the “highest-priority” Library. In addition to adding or deleting speakers or
bumpers, the Library file is only re-written (or, copied) if certain errors are found and need to be fixed. Any Library
“writing” is done to the “User” folder. Assuming no elements are being added or deleted and the “sample” Library
doesn't contain the checked-for errors and it is the highest-priority Library found, the "User" file is never written.
The one exception to this error checking and fixing has to do with weight. When the Library is simply read (to
populate the various Pop-Up menus), weight units are not considered. When different speakers or bumpers are
selected, though, this these units ARE checked. If weight unit information is missing, you are asked what unit was
intended when the selected element was initially added to the Library and the Library file is written (or, created for
the first time) to your “User” folder. If the correct lb/kg weight system is found for the selected element, no Library
writing is done.
Sharing Library Files
To copy your Audio ToolSet 2 Library from one computer to another, simply find "AudioToolSetData.xml" on the
“source” computer and copy the file to the same place on the “destination” computer (more-than-likely, the “User”
folder).
Two warnings to heed:
1) If there is ANY question about truly wanting to over-write any Library information on the “destination
computer, make sure you save a copy of that file in a safe place.
2) While all versions of the Audio ToolSet 2 tools will be able to read any version of "AudioToolSetData.xml,"
older versions don't recognize the much of the current data and if you “round-trip” the file, that information will
be lost.
p a g e 1 9 o f 1 9
Table of contents
