SpotlightEditing lighting devices

These settings are available in the following locations:

Object Info palette (editing an object; select the object and edit from the Object Info palette, or right-click the object and select Properties from the context menu)

Lighting Device dialog box (editing an object; click Edit from the Object Info palette of a selected lighting device, or right-click the object and select Edit from the context menu)

Light Source Object Info palette (editing an object; right-click the object and select Edit Light from the context menu; see Light source properties)

Once lighting devices have been inserted, many of the parameters can be changed from the Object Info palette or Lighting Device dialog box, and the color, numbering, alignment, and other options can be set. Change advanced light properties, including turning the associated light source on, by editing the light source embedded within the device; see Advanced light properties. To display the cell parameters from a multi-cell lighting device, select the desired cell in the Edit Cell field.

First, select the lighting device or devices to edit.

Selecting lighting devices

Before editing lighting devices, you need to select them. When you need to edit many lighting devices at once, use context menu commands to select devices by certain criteria. You can select all the lighting devices with the same instrument type, position, rigging object location, or focus point.

Context menu command

Description

Select Lighting Devices by Instrument Type

Right-click on a device that has the desired instrument type, and select the command. 

All lighting devices of that type are added to the current selection.

Select Lighting Devices by Position

Right-click on a device on the desired lighting position, and select the command.

All lighting devices at that position are added to the current selection.

Select Lighting Devices on Rigging Object

Right-click on the rigging object/hanging position, and select the command.

All the lighting devices on that rigging/hanging object are added to the current selection.

Select Focused Lighting Devices

Right-click on the focus point, and select the command.

All the lighting devices assigned to that focus point are selected in the drawing; all other objects are deselected.

Editing from the Object Info palette

Lighting device parameters can be viewed and edited from the Object Info palette. Select the parameters and parameter groups you want to display from the Spotlight preferences: Lighting Devices: Parameters pane. This pane also controls which parameters can be set independently for accessories and for the cells in multi-cell devices. 

If your file was created in a previous version of Vectorworks, any default lighting device parameters that were removed from the current version can still be accessed on the Spotlight preferences: Lighting Devices: Parameters pane. You can display these parameters on the Object Info palette or remove them from the file. Any customized lighting device parameters maintain their custom values but update their default values to match the current version.

To display the accessory and/or hardware parameters from the associated lighting device or cell, select the desired accessory/hardware in the Edit Accessory field. When a value other than <None> is selected, the parameters of the specified accessories/hardware are shown, instead of the lighting device parameters. The Device Type field indicates whether an accessory, hardware, or lighting device is being edited.

The parameters below are described in terms of lighting devices, but the same behavior applies to accessories and hardware unless otherwise noted.

DMX patching may change the lighting device (and accessory) parameters as conflicts are resolved; see DMX patching.

For a custom lighting device symbol without an information record attached, enter the required parameters (see Attaching the Light Info Record and EntEquipUniversal record). An entry is not required for every field.

Click to show/hide the parameters.Click to show/hide the parameters.

Parameter

Description

XYZ/IJK Location/Rotation

Changes the lighting device’s location and rotation; the labels rotate with the lighting device unless Right-Reading is selected in the Label Legend Manager (see Formatting the label legend layout). 

In a 3D view, if a lighting device is focused, the lighting device rotates automatically to point at the focus.

A lighting device and its accessories move and rotate together. For this reason, the position and orientation of an accessory relative to its associated lighting device cannot be changed from the lighting device Object Info palette. To adjust the accessory position in 2D and 3D views, use Accessory edit mode instead.

Edit

Opens the Lighting Device dialog box, to edit the parameters of one or more lighting devices; see Editing from the Lighting Device dialog box

Edit Accessories and Hardware

Opens the accessory edit mode, to edit accessories and hardware in 2D and 3D views; see Accessory edit mode

Symbol Name

Displays the name of the symbol used to create the lighting device, accessory, or hardware

Instrument Type

Displays the specific type of lighting device

Replace Lighting Device/Replace Accessory/Replace Hardware

Opens the Resource Selector; double-click a resource to select it.

Replace Accessory displays when the selected part of the lighting device displayed in the Edit Accessory list is an accessory.

Replace Hardware displays when the selected part of the lighting device displayed in the Edit Accessory list is hardware.

Select the accessories or hardware to replace from the Edit Accessory list.

If <All> accessories/hardware are selected for editing, all the accessories/hardware on the selected device(s) are replaced by the chosen resource.

If a specific accessory or hardware is selected for editing, only that accessory or hardware is replaced.

If one of the selected lighting devices is a multi-cell, you can only replace the accessories or hardware on the cell(s) specified in the Edit Cell field.

Edit Accessory

(accessories and/or hardware required)

Choose whether the Object Info palette displays the lighting device, accessory, or hardware parameters, and select which accessories/hardware display their parameters. The Device Type indicates whether lighting device, accessory, or hardware parameters are being edited.

For multi-cell lighting devices, the options depend on the Edit Cell selection. If all cells are selected, all or none of the device’s accessories/hardware can be edited. If a single cell is selected, the accessories/hardware specific to that cell can be edited.

<None>: Displays the parameters of the lighting device, not its accessories or hardware.

<All>: Displays the parameters of all the attached accessories and/or hardware. <Multiple values> displays for parameters that are not identical for all accessories and/or hardware.

<All Accessories>: Displays the parameters of the specified accessory. The accessories are listed by their index number - accessory symbol name.

<All Hardware>: Displays the parameters of the specified hardware. The hardware are listed by their index number - hardware symbol name.

Edit Cell

(multi-cell lighting devices only)

Select which cell displays its parameters, or select <All> to display the parameters of all cells in the device. <Multiple values> displays for parameters that are not identical for all cells.

The cells are listed by their index number - color - channel.

Fixture Mode

Select the fixture mode of the lighting device (or search for the mode by entering text in the search box), for export to an external program like Vision, or select None. The DMX Footprint is set automatically by the selected mode and cannot be edited; however, if a GDTF Fixture Mode is specified too, this mode will set the DMX Footprint instead.

For more information about fixture modes, see Selecting a fixture mode.

GDTF Fixture Mode

Select the GDTF fixture mode of the lighting device; search for the GDTF file by entering text in the search box. The DMX Footprint is set automatically by the file and cannot be edited.

For more information about .gdtf files, see Attaching GDTF data

GDTF Fixture

Displays the GDTF file that is associated with the lighting device

Edit GDTF Data

Opens the GDTF Fixture Builder, for editing GDTF data directly in Vectorworks; see Editing GDTF data

Use GDTF geometry

When a valid GDTF file is selected, this option replaces Vectorworks symbol geometry with the geometry specified in the GDTF resource.

This mode is enabled by default when you import a .mvr file that creates a new lighting device from a GDTF resource.

DMX Footprint

Displays the number of control channels used by the lighting device. If the lighting device has a specified Fixture Mode or GDTF Fixture Mode, the number of channels is automatically assigned.

If fixture modes are specified for both Vision and GDTF, the GDTF file sets the number of channels.

Purpose

Specifies the purpose of the lighting device

Position

Displays the name of the associated rigging object, if the lighting device is attached. 

For methods to attach loads, see Making the attachment.

Unit Number

Identifies the lighting device location on the hanging position or rigging object

Channel

Specifies the channel number, or channel "name," of the lighting device.

This name identifies the device when power patching; see Power patching the electrical system.

Universe/Address

Specifies the universe and address, separated by a front slash separator; the separator can be changed as described in Spotlight preferences: Lighting Devices: Parameters pane

Universe

Specifies the universe assigned to the lighting device; see Spotlight preferences: Universes pane

DMX Address

Specifies the DMX address assigned to the lighting device; see Spotlight preferences: Universes pane

To unpatch the lighting device, set this value to 0 (zero) to remove the universe, address, and DMX address information, or unpatch the lighting device from the Patch dialog box; see DMX patching

In files created prior to version 2020, this field may also display as User U Address to ensure compatibility.

Absolute Address

Specifies the address of the lighting device without a universe indicator; for example, universe 2/address 1 is absolute address 513.

To unpatch the lighting device, set this value to 0 (zero) to remove the universe, address, and DMX address information, or unpatch the lighting device from the Patch dialog box; see DMX patching.

In files created prior to version 2020, this field may also display as User Address to ensure compatibility.

Dimmer

Specifies the dimmer number of the lighting device

Circuit Number

Indicates the circuit number where the lighting device is plugged in

Circuit Name

Specifies the name of bundled circuit group

Color

Specifies the gel color number according to manufacturer code, RGB values, color name from the file, or web (hex) codes; when the light associated with the lighting device is turned on, Color specifies the actual light color. Use + between color numbers to indicate combinations of two or more colors. See Lighting device color.

The color setting can affect the display of the lighting device color, depending on the Spotlight preferences; see Spotlight preferences: Lighting Devices: Classes and Color pane.

Frame Size

Indicates the dimensions of the color cut 

Gobo 1

Indicates the gobo texture number for the first gobo.

Specifying the gobo texture by clicking Edit in the Object Info palette provides a graphical method of selecting gobo textures.

Gobo 1 Rotation

Sets the rotation angle of gobo texture 1

Gobo 2

Indicates the gobo texture number for the second gobo

Gobo 2 Rotation

Sets the rotation angle of gobo texture 2

Use Legend

Select the label legend to apply from the list of label legends in the file (see Label Legend Manager)

3D Legend View

When the label legend includes 3D labels, select the view for the labels when displaying the drawing in a 3D view.

Select Screen Aligned to always view the labels aligned with the screen plane (in a viewport, screen aligned labels match the view).

After changing the view, click Refresh Labels to obtain the selected legend view, or select the Refresh Lighting Devices command.

Easily copy the label legend positions to selected lighting devices by Changing the label legend properties of a selection

Flip top and bottom 3D legend

Mirrors the 3D label along the X axis of the lighting device (for example, a label legend that displays at the top of the device displays on the bottom instead)

Flip left and right 3D legend

Mirrors the 3D label along the Y axis of the lighting device (for example, a label legend that displays to the right of the lighting device displays on the left instead)

Rotate 3D legend with Z rotation

Matches the 3D label legend views with the lighting device’s rotation

Flip front and back 2D legend

Mirrors the label legend along the X axis of the lighting device (a label legend that displays in front of the lighting device displays behind it instead)

Flip left and right 2D legend

Mirrors the label legend along the Y axis of the lighting device (a label legend that displays to the right of the lighting device displays on the left instead)

Custom plan rotation

Select this option to specify a rotation angle for Top/Plan view that is independent from the device’s Rotation parameter. When this option is selected, specify the Plan Rotation angle.

Zoom

Enter the zoom percentage, or use the slider to set the value. This controls the beam and field angle for lights that can zoom.

If the light has an oval beam, it is considered to be a light that cannot zoom; set specific field and beam angles instead.

Field Angle

Displays the angle for zoomed lights, or sets the vertical field angle of the lighting device's light beam for lights that cannot zoom

Field Angle 2

Displays the angle for zoomed lights, or sets the horizontal field angle of the lighting device's light beam for lights that cannot zoom

Beam Angle

Displays the angle for zoomed lights, or sets the vertical beam angle of the lighting device's light beam for lights that cannot zoom

Beam Angle 2

Displays the angle for zoomed lights, or sets the horizontal beam angle of the lighting device's light beam for lights that cannot zoom

Focus

Names the focus point object assigned to the lighting device. The focus point must be defined first (see Creating a focus point object).

If the Pan and Tilt values are adjusted later, the lighting device loses its association with the focus point.

Draw beam

Draws an accurate wireframe representation of the light beam; the light beam is drawn based on the lighting device parameters, and can be used to check whether the stage and focus areas have been adequately lit (see Drawing light beam representations). Spotlight preferences setup can globally specify the appearance and display of the elements in the light beam (angles and centerline). 

Draw beam as 3D solid

Generates a light beam that appears solid when rendered 

Use vertical beam

By default, draws the wireframe beam in a vertical orientation when possible, when either Draw beam or Draw beam as 3D solid is selected. When deselected, the beam is usually drawn in a horizontal orientation.

Show Beam at

In a 2D view, select whether to draw the beam as it crosses the focus, at the falloff distance as projected through the focus, or in both areas 

Refresh Labels

Refreshes lighting device label contents if parameter changes have been made, or 3D label positions if the view has changed

Brightness (%)

Sets the light source brightness; enter a percentage or use the slider to set the value. A value over 100% can be entered. 

Use emitter

Specifies the light’s actual brightness and color temperature based on the Brightness Value multiplied by the Brightness (%). Leave this option deselected to use the light as a simple light source, with its baseline light source value multiplied by the Brightness (%).

If the light has an attached GDTF definition, the emitter brightness is set from the GDTF file when Use GDTF geometry is selected.

Brightness Value

Enter the brightness value; units are set in the Lighting Device dialog box

Falloff Distance

Specifies how far the wireframe light beam is drawn beyond the focus

Lamp Rotation Angle

Indicates the rotation angle of the virtual elliptical light source, from 0 to 90° 

Pan

Enter the pan angle, or use the slider to set the value; this controls the lateral rotation angle of the lighting device (range: +/- 180º). If a focus point is assigned, this value automatically updates. 

Tilt 

Enter the tilt angle, or use the slider to set the value; this controls the vertical rotation angle of the lighting device (range: +/- 180º). If a focus point is assigned, this value automatically updates.

Invert pan/Invert tilt

Inverts the lighting device's pan and tilt directions, including when running Showcase

Shutter parameters

Enter the shutter depth/angle, or use the slider to set the value. This controls the angle and depth of top, left, right, and bottom shutter cuts. Each shutter is located at 90º intervals around the lighting device, and angles can be adjusted within a range of +/- 45º. The shutter depth ranges from 0 to 100%, with 100% cutting through the center of the light source. 

Throw Distance

Controls the distance from the lighting device to its focus location. If a focus point is assigned, this value automatically updates. 

Vertical Focus Angle

Displays the focus angle up from vertical

Focus_angles.png 

Horizontal Focus Angle

Displays the focus angle down from horizontal

Angle To Face

Displays the angle at which the light hits the face plane of the lit subject at the focus

Off Axis Angle

Displays the angle from the centerline of the focus to the lighting device. The bottom of the focus is the centerline; if a focus point is used, move the focus point to change the centerline location.

Off_axis.png

Weight

Specifies the lighting device weight.

For lighting devices with accessories and/or hardware, use the Edit Accessory field to select each accessory or hardware and then specify its weight. The weight of the lighting device and all accessories and/or hardware is combined to calculate the Total Weight of the lighting device.

Load Information

A lighting device is considered a point load in Braceworks calculations; if the insertion point is on a structural element, it is considered to be a load on that structure. Load information is used for Braceworks calculations and reports (Braceworks required). 

Include in calculations

(Braceworks required)

Includes the lighting device in Braceworks calculations; deselect to exclude the device from participating in structural calculations

Load Group Name

The load category is always Light for lighting devices

Load ID

Enter a unique ID for the load for informational use in reports

Load Name

Identifies the object in load calculations; normally the object name is used 

Total Weight

Enter the total weight of the object.

For lighting devices with accessories and/or hardware, this parameter displays the total weight of the device and its accessories and/or hardware and it cannot be edited.

Position

Enter the load position 

Device Type

Displays the type of object that is selected. Normally, lighting devices are Light device types (Moving Light, Device, Practical, SFX, Power, and Other are also considered Light types). Accessories such as color frames, barn doors, top hats, and clamps are Static Accessory types. Accessories that require a control channel, such as color scrollers, are Accessory types. 

Wattage

Indicates the power consumed by the lighting device

Voltage

Specifies the voltage of the lighting device 

Breaker ID

Provides the power distribution identifier of the lighting device

Time

Approximates the time required to work with the device, useful in reports

Cost

Specifies the rental cost of the device, useful in reports

System

Specifies the letter describing the control system (Lightwright-compatible parameter)

User Field 1-6

Provides user-defined fields; use these extra fields to keep track of any desired data (see Spotlight preferences: Lighting Devices: Parameters pane)

Mark

Provides a user-defined label (Lightwright-compatible parameter) 

Power Information

A lighting device can be power patched within the electrical system; see Power patching from the Object Info palette. Power information is used for power calculations and reports. 

Select Range

The socket connection parameters are displayed in sets of seven. Select which set of sockets to display for editing. The sets are numbered according to the input stacking order. 

Power In

Displays the patching information (connectors) for the lighting device. You can search for and select a new socket for the input connection; once connected, the connection displays at the top of the list. 

Consumption

Displays the amount of power required by the device 

Voltage

Displays the voltage required by the input connection

Connector

Displays the connector used for the input connection

Select Power Source

Selects the connected input source of power for the lighting device in the drawing area

Link Through

Displays an additional output connector that enables lighting devices to be daisy chained without twofers, for lighting device symbols without electrical components. You can search for and select a new link through for the output connection; once connected, the connection displays at the top of the list.

Voltage

Displays the voltage required by the output connection

Connector

Displays the connector used for the output connection

Equipment Subparts

Lists the subparts that make up the object. These subparts are counted and reported separately in equipment and inventory lists.

The parameters must be selected for display for this type of object in Spotlight preferences: Inventory pane.

Equipment Virtual Parts

Virtual parts are associated with an object and are reported in equipment and inventory lists, but do not display in the drawing. After adding virtual parts, they are listed in the Object Info palette.

Edit Virtual Parts

Opens the Virtual Parts dialog box to add virtual parts to the object; see Managing virtual parts and independent virtual parts 

Assign Sources

Opens the Assign Sources dialog box to assign the object and its subparts and virtual parts to an inventory source; see Assigning equipment to an inventory

Editing from the Lighting Device dialog box

The Lighting Device dialog box allows you to edit the lighting parameters of one or more lighting devices, including the cell-specific parameters of multi-cell devices. You can view and change the lighting device properties and the light source properties, as well as the device specifications for visualization.

Many of the parameters listed in this dialog box are also available in the Object Info palette. Only the parameters that are unique to the Lighting Device dialog box or have special behavior are listed here.

To edit the properties of a lighting device:

Select one or more lighting devices.

From the Object Info palette or the context menu, click Edit, or simply double-click a single device. The Lighting Device dialog box opens.

If multiple lighting devices are selected, they display in a list on the left.

If one or more multi-cell devices are selected, a list of the cells displays.

If any of the selected devices have accessories and/or hardware, a list of the accessories and/or hardware displays.

Lighting Device: Overall

Select items from the Lighting Devices and/or Cells and Accessories lists to view and edit their parameters.

If multiple items are selected, the parameters display the shared values only.

Click to show/hide the parameters.Click to show/hide the parameters.

Parameter

Description

Lighting Devices

(multiple selection only)

Displays the selected lighting devices, sorted by channel number. Select one or more lighting devices to view their parameters, or select <All selected> to view the parameters of all the lighting devices in the multiple selection.

You can also sort by Instrument Type, Position, or Purpose; click a column heading to sort in ascending or descending order.

Cells

(multi-cell lighting devices only)

Displays the cells in the selected lighting device. If multiple lighting devices were selected, the cells in the device that is currently selected in the Lighting Devices list are displayed.

Select one or more cells to view their parameters, or select <All cells> to view the parameters of all the cells in the selected lighting device.

Accessories

(accessories and/or hardware required)

Displays the accessories and/or hardware attached to the selected lighting devices or cells.

<None>: Displays if any selected lighting device or cell has accessories and/or hardware. Select this option to view the parameters of the selected devices or cells, instead of their accessories and/or hardware.

<All accessories>: Displays if any selected lighting device or cell has accessories and/or hardware. Select this option to view the parameters of all the accessories and/or hardware attached to the selected devices or cells.

Accessory: Displays if a single selected lighting device or cell has accessories and/or hardware, or if each lighting device or cell in a multiple selection has the same number of accessories and/or hardware. Select this option to view the parameters of a specific accessory or hardware.

If each selected lighting device or cell has the same number of accessories and/or hardware, but the accessories and/or hardware are different (for example, one device has a top hat while the other has a gobo holder), the accessories’ index numbers display in the list with a Symbol Name of <Multiple values>. Select one of these options to view the parameters of all accessories and/or hardware that have the same index number.

Lighting Device: Properties tab

Click to show/hide the parameters.Click to show/hide the parameters.

Parameter

Description

Position

Displays the name of the hanging position. Select a different hanging position, or select <Custom> and enter the name of an object to use as the hanging position.

Enter text in the search box to filter by name.

Symbol Name

Opens the Resource Selector to select a different lighting device symbol, accessory, or hardware; double-click a resource to select it

Get Data from Symbol

Obtains the light information from the Light Info Record attached to the symbol definition

Lighting Device: Light Information tab

Click to show/hide the parameters.Click to show/hide the parameters.

Parameter

Description

Focus

Controls the focus settings

Focus

Displays the name of the focus point, if one is assigned. Select a different focus point, or select <Custom> and enter the name of an object to use as the focus point.

Enter text in the search box to filter by name.

Beam

Controls the settings for light beam representations

Physics

Controls the settings for wattage, voltage, and frame size

Render

Contains many of the parameters described in Light source properties

On/Off

Shows or hides the light produced by the light source. This setting can also be accessed from the light context menu: right-click on the light, and select Turn On or Turn Off.

Lighting devices can be inserted on or off by default; see Spotlight preferences: Lighting Devices: Parameters pane.

Gobo 1

Enables a Resource Selector. Click the Resource Selector to select a texture for the first gobo; double-click a resource to activate it.

Gobo 2

Enables a Resource Selector. Click the Resource Selector to select a texture for the second gobo; double-click a resource to activate it.

Comments

Provides notes about how the lighting device is configured in the Vision program

Lighting Device: Shutters tab 

Specify the depth and angles for the top, left, right, and/or bottom shutters. Each shutter is located at 90° intervals around the lighting device, and angles can be adjusted within a range of +/- 45°. The shutter depth ranges from 0 to 100%, with 100% cutting through the center of the light source.

Lighting Device: User Data tab 

User data fields and any default values display here. You can edit the default values by selecting a field name and entering new data in the Value column.

Lighting Device: Wheels tab

Click the Wheels tab to control lighting devices used for previsualization in Showcase, or sent to (or exported to) a lighting console or visualizer. When the lighting device has a Fixture Mode, the gobo, color, and animation data for the lighting device can be set here.

If multiple devices are selected, these tabs display the shared data only. Some fixture modes are specific to the Vision program, while others are available in General Device Type Format (GDTF); see Workflow: Previsualization with Spotlight. The devices must have the same Fixture Mode and the same gobo, color, or animation data in order to be edited simultaneously.

The default specifications are set according to the Fixture Mode specified in the Object Info palette. Customizations to the data are applied to the lighting device and show in the MVR file upon export; see Exporting MVR files. On the Wheels tab, click Reset Wheel Defaults to restore the default data for the lighting device based on the Fixture Mode. 

Click to show/hide the parametersClick to show/hide the parameters

Parameter

Description

Data

Select whether to display GDTF or LIT (Vision) data 

Wheels list

Lists the wheels, in hierarchical order, from the selected accessory of the lighting device:

Wheel: Displays the name of the gobo, animation, or color wheel group and its slot locations. Each Slot location displays any selected item for the slot. Click the disclosure arrow next to the wheel name to quickly expand or collapse the group. 

Slot: Displays the gobo, animation, or color slot location in the wheel.

Name: Displays the name of the gobo, animation, or color in the slot.

Color: Selects the custom colors to load into the slots of the wheel. To select or change the color for the slot, click the Color column and click the color box to select the color (see Applying colors). The Color name changes to Custom and a preview of the custom color and new Color Value displays. 

Color Value: Displays the RGB color value in the slot. 

Reset Wheel Defaults

Reverts to the default wheel data

Select Image File

For gobo or animation wheels, a preview on the right displays when available. Click Select Image File and select a gobo image from the Select Gobo dialog box or animation image from the Select Anim dialog box to change the image for the slot. 

Advanced light properties

Spotlight preferences: Lighting Devices: Parameters pane

Changing the label legend

Attaching GDTF data

DMX patching

Drawing light beam representations

Workflow: Previsualization with Spotlight

Spotlight preferences setup

Concept: Inventory and equipment lists

Concept: Resource libraries

Exporting Vectorworks Spotlight data

 

Was this page helpful?