Savvy Position Label 4 User Guide

Savvy Position Label

version 4.5.0

User Guide

Created by Joshua Benghiat

Joshua Benghiat Lighting Design


Introduction

Requirements | Installation | Support

Getting Started

Adding to your Workspace | Registration | Overview

In Detail

Placing in the Drawing

Linking to a Position

Object Parameters

Known Issues

Frequently Asked Questions


Introduction

The Savvy Position Label is a plug-in object for labeling lighting positions and providing automatically updated notes about the position. The Savvy Position Label links to all Rigging Object types and as well as Truss Systems and Truss Lines and schematic views of those objects.

Savvy Configuration

Choose from numerous configuration options, allowing the Label to confirm to your personal drafting standard. The Savvy Position Label supports text styles and classes for granular control of its presentation.

Savvy Placement

The label is a separate object from the Lighting Position Object, so you can nudge or duplicate independently from the position. You can, optionally, have the label move with the position.

Savvy Label Text

Because you don’t always display the same position name on the plot that you use in the paperwork, the Savvy Position Label lets you display the first word, last word, just number, or custom text, with a prefix or suffix. Pipe A displays as A. #2 Electric becomes 2E, etc, while still automatically linking to the position name.

Savvy Note

An optional note lets you add tokens to automatically display US DS and SL SR coordinates, location, trim height, pipe length, and weight, which always stay up to date. You can also show summaries of attached objects to and component parts of the position.

PL 3 Notes Data
Position labels with note text

Requirements

Vectorworks® Spotlight 2020 and above.

Installation

If you haven’t already, download the Savvy Position Label.

  1. The installer will have a .vwlibrary file extension for use with the Plug-in Manager. Do not manually install this file
  2. In Vectorworks, select Tools > Plug-ins > Plug-in Manager
  3. Select the Third-party plug-ins tab
  4. Click the Install… button
  5. Navigate to and select the saved installer file
  6. Read and confirm the EULA
  7. Vectorworks should notify you that installation is complete and to restart Vectorworks

If you experience trouble with the install script, please see the following FAQ on where plug-ins install. In the Plug-in Manager, you will see Savvy Position Label in the Built-in Plug-ins section.

Support

Please visit http://BenghiatLighting.com/software/support for support options and to report bugs.

You may also email software(at)BenghiatLighting.com.


Getting Started

Adding to your workspace

  1. Select Tools>Workspaces>Edit Current Workspace.
  2. Click the disclosure triangle next to JBLD in the list of Menus categories on the left hand side.
  3. Drag the Add Savvy Position Labels… and Update Position Label Notes menu command to the menu tree on the right side.
  4. Select the Tools tab.
  5. Click the disclosure triangle next to JBLD in the list of Tools categories on the left hand side.
  6. Drag Savvy Position Label to a tool palette on the right.
  7. Click OK.

Registration

The first time you use the Savvy Position Label, Vectorworks will ask you for a registration number or demo code. You can also access the registration dialog through the “About” button in the object’s Object Info palette. The Savvy Savvy Position Label will not draw without a valid code, however if you remove the Savvy Position Label plug-in from your user folder, you will still see all lineset objects but in a locked state. The Savvy Position Label is also part of the Savvy Subscription Series.

Overview

Insert the Savvy Position Label via the object tool or the included menu command. Labels can link to a Hanging Position for the label text and data displayed in the Label’s note, or you can enter custom text. A variety of display options are available in Object Info.


Placing in the drawing

The Savvy Position Label insertion tool

  1. Select the Savvy Position Label insertion tool SPLIcon

    Mode Bar
  2. If you want to immediately link the label to a Hanging Position or set an unlinked position location, make sure the Link Button LinkIcon is enabled in the mode bar.
  3. Optionally, select the Alignment parameter for the label in the mode bar. See Parameters.
  4. Optionally, set the insertion alignment of the label. The origin of the label is the first character for Left Alignment, last character for Right, and center for Center.
  5. Click in the drawing to insert the label and set the rotation.
  6. If you selected the Link mode, you will see a line connecting the label to a place-link cursor. Click on a Hanging Position to set the link. You will see the Position Object highlighted and the cursor change as you hover over it with your mouse.

    PL2 Linking

  7. If you do not select a position while in Link mode, the point on which you click determines the position’s location, which appears in the label’s note and to which the label’s leader line points. This can be useful when identifying a boom location in plan view, for example.

The Add Savvy Position Labels menu command

  1. Select Hanging Positions to which you want to add labels.
  2. Select the Add Savvy Position Labels… menu command.
  3. Select options in the dialog:

    The position option sets the position of the label around the Hanging Position, as well as Alignment and Arrow Angle parameters so that the arrow points towards the Position.


    The offset specifies the distance from the edge of the position to the insertion point of the label. A positive value measures away from the position in any direction.


    Show options will raise the Label’s default parameters dialog before placing labels.

    alt

Linking to a Position

Linking Labels to Positions synchronizes the Label with the Position name and moves the label when you move or duplicate the position. Linked labels can also automatically display various data about the position and attached items in the Label’s note.

Inserting Position Labels using the above methods link the Label to a Position.

Linking Existing Labels to Positions

To associate an existing Label with a Position, you can use the control point grip in the drawing to the Link to Position dialog.

Using Drawing Grips

Savvy Position Label indicates the link to the position with a chain link icon. When you hover over this icon, the cursor changes to a hand. You can click to pick up the link and drop it on another position.

PL2 Linking

Using the Link to Position Dialog

Cclick the Set Link button in Object Info, or right-click on the label and choose Set Link…

In the resulting dialog, select from a list of positions in the drawing, identified by name, or choose Click on drawing to select to exit the dialog and use your cursor to select a Hanging Position in the drawing.

alt

Unlinking a Label from a Position

To unlink a label from a position, use this dialog, or right-click on a label and select Unlink.

Linking to Truss Systems and Lines

When linking to a Truss object, you can link the label to a single truss piece, or the entire Truss System or Truss Line. This affects both the label displayed and the data displayed in the note.

In the Label section of Object Info, select Truss Piece, Truss System, and Truss Line. If the Label is linked to an object other than Truss, this option has no effect.

Linking to Rigging Objects in Viewports

Savvy Position Label objects can link to objects inside viewports, including section viewports, updating data and tracking the location of the position. Due to a limitation in Vectorworks, you can only set the link to the position via the list in the Link to Position menu.

Object Parameters

As with all Plug-In Objects, the first time you place a Savvy Position Label object in a document, Vectorworks will ask you for default parameters. You can set the default object parameters for the document by selecting the object’s tool, then clicking on the parameters button Plug_In_Pref_Button in the mode bar.

Mode_Bar
ParameterDescription
Text StylePick a text style for the label. To set a default text style, use class options to set the text style by class.
StyleUse this menu to apply, create, or modify a Style definition for the label. Label styles appear as “red” symbols in the Resource Manager, and specifies whether parameters reference the style definition. For more information, see Concept: Plug-in Object Styles in Vectorworks help.
Hide Style ParametersEnable this option to hide any parameters linked to a style definition.
Linked to

Read only field displaying the name of the position to which the label is linked. When you select a Position Label, you will also see a link icon in the drawing indicating the link.

Set Link

Raises a dialog where you can select a Hanging Position to link to the label. You can also opt to click on a position object or unlink the label from a position.

Link To Position 2x

Edit Position NameUse this button to edit the name of the position. If the Label links to a Truss System, you can use this to edit the name of the System.
Alignment

Left / Center / Right: Determines the text alignment and arrow position for the label.

Move with positionEnable this to move the label as you move the position, as though they are grouped. Moving the label, however, does not move the position.
3D RotationEnter a value for rotating the 3D component of the label around its horizontal axis.
3D OnlyBy default, the Savvy Position Label is hybrid, with the label appearing both in plan view and at the z height of the position. The 3D component of the symbol can only rotate along its horizontal axis, so a typical label would then face forwards with a 90 degree 3D Rotation. Setting the label to 3D only allows the planar label to rotate to any 3D plane. In this mode, you do not see a 2D version of the label in Top / Plan.
Label
Label DisplayDetermines how the position name displays in the label.
Full: The full name.
First word: The first word, before a space. E.g. “1 Electric” would be “1.”
Last word: The last word, after a space. E.g. “A Pipe” would be “A.”
Only Number: Extracts a number from the name. e.g. #4 Elec would be “4.”
Custom: Ignores the position name and uses the text field below. If you do not link a label to a position, the object sets this option as default.
Cust. LabelUse with the Custom label display option to completely override the position’s name.
PrefixAdds a prefix before the label text.
SuffixAdds a suffix after the label text.
Truss IdentityWhen the Label is linked to a Truss object, you can link to a single truss piece, a truss line, or the entire truss system. This option affects both the Label text as well as any data in the Note.
Shape
Container

Circle / Rectangle / Rounded rectangle / Diamond / None: Choose a container for surrounding the label. The circle and diamond containers will surround the first or last character in left or right modes.

AutoFitFit the container to the label text.
WidthIf AutoFit is disabled, specify the size of the container, in page units.
PaddingAdd an additional amount of white space between the text and container, in page units.
Draw shadow

Add a drop shadow to the container.

PL3 Drop Shadows

Use Class OptionsUse the shadow options assigned to the class for the container.
Shadow Settings…Set the shadow options for the Container drop shadow. This uses the same interface as in the Attributes palette.
Arrow type

Triangle / Arrow / None / Symbol: Choose an arrow that points from the label to the position.

You can also select no arrow and a custom symbol for the arrow.

SymbolIf you select the Symbol option above, specify the symbol here. This is a text field for ease of copy and paste. Use the button below to select a symbol resource.
Select symbolSelect from available symbols.
Arrow Angle

90 / 0 / –90 / Custom: Sets the arrow straight, up, or down, depending on orientation. Select Custom to set an angle via the field below.

Cust. AngleEnter a custom arrow if chosen above.
Arrow scale

Scale the arrow to refine the look of the label. A scale of 1 equals 100%.

Mirror Arrow

 Enable this option to display an arrow on both sides of the label.

Note
Show noteEnable this to show a note below the label.
Text StyleOptionally, set a separate text style for the note.
Alignment

Choose to align the note consistently with the label or specify its own Left, Center, or Right alignment.

Wrap noteEnable this to wrap the note to the length of the container.
Fit container to note

With this option enabled, the container grows to include the note text.

PL2 Note Options

NoteThe note text. This field is for easy access and copy / paste.
Edit note

Presents a dialog for editing the note. The note can be multiple lines and can insert tokens that will update with data about the position and attached items.

After selecting one of the options in the lower section of the dialog, click Insert to insert placeholder text at the cursor point.

Special Fields:

X Measurement, Y Measurement, and L/R Measurement take their data from the Label’s Position control point, which defaults to the Hanging Position’s insertion point. Move the control point or set the data fields below to specify any point in the drawing.

SL/SR Indicator will display “SL” or “SR” depending on which side of x=0 the location control point lies.

Location takes its data from the Position’s Location field, which can store a lineset number or other location data.

Pipe Length gets its data from the length of Lighting Pipe, Straight Truss, or Line geometry used for the Hanging Position.

Trim gets its data from the Hanging Position’s z height. A setting can specify an offset for the display trim if trims are not measured to the stage floor.

Weight calculates the total hung weight of the Rigging Object and any attached items.

Truss Height/Width will display the dimensions of the cross section of truss.

DMX Footprint will total the number of DMX addresses needed for a position. This will only include Moving Lights, Accessories, Devices, and SFX.

Summary of attached items or component parts:

Use these options to include a summary of objects attached to the position (Lighting Devices, Speakers, Softgoods, etc.) or component parts of a Truss System, Truss Line, or Hanging Position.

Count – Totals the unique types of data for the specified parameter of the specified object. Set the parameter to to count objects of that type.

For example, Count of Lighting Device Channel will tell you how many unique channels are in that position. Count of Truss will give you the total number of truss sticks in a system.

Sum – Totals numerical data in the specified parameter for attached objects.

For example, Sum of Soft Goods AdjustableLength will calculate the total linear feet of drape attached to the position.

Max / Min – Displays the largest or smallest value of the chosen parameter. 

For example, Min/Max of Lighting Device Circuit Name will tell, respectively, you the first and last circuit names in that position when sorted alphabetically.

List – Lists all the values for the selected field and the total quantity for each value.

For example, List of Lighting Device Instrument Type will display the quantity of each instrument type used in the position.

Rigging Object Field:

Displays any parameter for the attached Rigging Object or data field of a record attached to the rigging object.

RoundingRound the coordinate data by this value.
Adtl. Trim OffsetEnter a value to offset the reported trim from the position’s z height. Useful for trimming above rakes and platforms.
Auto position noteEnable this to automatically position the note below the label.
Leader Line
Position X, Y

The coordinate of the position that displays in the note. This also corresponds to a control point in the drawing.

If the label is linked to a position and set to move with the position, this coordinate will adjust as you move the position.

Reset LeaderResets the Position X / Y coordinates to the insertion point of the position.
Flip LeaderReflects the Position X / Y coordinates across the midpoint of the position.
Draw leader to positionDraws a leader line from the label to the position coordinate.
Leader type

Straight / Bezier / Shoulder: Choose the type of leader line.

Draw symbol at endpoint

Add a symbol to mark the position location, for example a boom marker or rigging point.

Symbol NameThe name of the symbol. This field is provided for ease of copy / paste.
Symbol RotRotation of the position marker symbol.
Select symbolChoose an available symbol resource for the position marker.
Classes
Auto-ClassEnable this to class each component with default class names. The prefix for subclasses can be determined in settings.
Container ClassClass for the container geometry.
Arrow ClassClass for the arrow. If no by-class options exist for the arrow, it will fill solid black.
Shadow ClassClass for the container drop shadow.
Leader ClassClass for the leader line.
Note ClassClass for the note text.
 
UpdateAny changes to the Hanging Position that affect the Savvy Position Label text, placement, or note should automatically update the Label, but this button will force an update to catch any unreflected changes.
 
Settings…

Set settings that affect all Savvy Position Label Objects

Default insertion class: Choose a class for new Label objects. You can also opt to insert labels in the active class.

Component class prefix: Enter a base class name that the Auto-Class option will use to build class names.

Trim offset: Enter an offset for the trim display, for example to display trims above a show deck height, with this value subtracted the Hanging Position’s Z height. Note, the trim starts at the layer’s elevation.

Make default for all new documents: Select this option for these settings to be default values for all future new Vectorworks documents.

AboutSee version and registration information