Editing symbol definitions

For blue and red symbol types, editing the symbol definition affects future placement of groups or plug-in objects only, since these symbol definition types do not create symbol instances.

For black and green symbol types, changes to the symbol definition affect all existing and future instances of the symbol. The symbol definition can either be edited from the Resource Manager, or from an instance in the drawing. Editing the symbol definition from the Resource Manager displays only the symbol while editing, but editing the symbol from the drawing area allows you to edit the symbol definition within the context of the drawing. Other objects in the drawing can be visible, grayed, or hidden depending on two settings in the Display tab of the Vectorworks preferences: Show other objects while in editing modes and Gray other objects. When other objects are visible, they are also snappable, which makes it is easier to edit the symbol definition quickly and accurately in relation to those objects.

The Show other objects while in editing modes preference does not work when editing a symbol definition from a flipped symbol instance; an alert message displays when this operation is attempted.

When editing page-based (green) symbols from the drawing area, the scale of the symbol editing window is set to 1:1 so that the symbol definition is the same size as the symbol instance, for ease of editing. The active layer scale cannot be changed from the document context menu while in the symbol editing mode. This is an exception for page-based symbols only. Due to the scale adjustment, other objects that are not part of the symbol definition are not snappable unless they are also at a 1:1 scale in the active layer.

Symbols can be nested within other symbols by inserting a symbol instance while editing a symbol definition.

Referenced symbol definitions can be edited or renamed in the target file, which changes the symbol definition in the source file. See Referencing resources.

● From the Resource Manager, right-click on the symbol definition, and select Edit from the context menu.

● For black or green symbols, right-click on a symbol instance in the drawing, and select Edit from the context menu. (You can also double-click on the symbol instance to edit it.)

Alternatively, select one of the other editing options from the context menu (for example, Edit 2D Components), to go directly into editing mode, and skip to step 4, or, select Modify > Edit Symbol.

Parameters	Description
2D Components	Edits and allows you to add 2D components of the symbol definition; see Creating 2D components for symbol definitions and plug-in objects
3D Component	Edits the 3D component of the symbol definition, including options for Customizing detail levels for 2D and 3D components of symbol definitions and plug-in objects and Displaying 2D and 3D components of a symbol definition together in a viewport
3D Wall Hole Component	Edits the 3D wall hole component of the symbol definition (see Adding a 3D wall hole component to a symbol definition)
Symbol Options	Opens the Symbol Options dialog box, to edit the method of inserting the symbol into a wall, the symbol category (black, green, blue, or red), the class assignment, and other parameters (see Creating symbol definitions for the parameter descriptions). When editing symbol definitions to make them story aware (Vectorworks Architect required), the Replace Height option controls how existing symbol instances are edited. With the option disabled, existing instances remain in place, becoming story aware with an added offset value that keeps them in position. When the option is enabled, the instances become story aware, with no additional offset; this may change instance elevations. A group or plug-in object symbol definition cannot be story-aware. This option is only available when the symbol is edited from the Resource Manager.
Double-click	Sets the future behavior when double-clicking on a symbol in a drawing. Select whether to display the Edit Symbol dialog box, or directly edit the 2D or 3D component or insertion options. Select Edits the Component based on current view to automatically edit the 2D component if in Top/Plan view, or the 3D component if in a 3D view. This option is only available when the symbol is edited from the drawing.
Use the edit view	Matches the Resource Manager and Resource Selector thumbnail view to the selected editing view. For example, if a hybrid symbol’s thumbnail preview is set to Top/Plan, and the 3D component of the symbol is edited while in a Right Isometric view, the thumbnail view switches to Right Isometric to match.

When editing symbol definition components, a Component Edit palette is available in object editing mode. Select the component to Edit from the list. For special functionality related to adding 2D components for use in hidden line rendered viewports, see Creating 2D components for symbol definitions and plug-in objects. To create multiple details levels for 2D and 3D components, see Customizing detail levels for 2D and 3D components of symbol definitions and plug-in objects. When you have completed editing one component, you can choose another component to edit from the Component Edit palette without exiting object editing mode.

Keep in mind that 2D objects that are part of a hybrid symbol must be in the screen plane to be visible in Top/Plan view; if they are not on the screen plane, they will be visible in 3D views. If you are pasting 2D layer plane objects from the clipboard while editing a symbol, an alert allows you to assign those objects to the screen plane. Normally, select Yes so that the top/plan graphics display correctly in Top/Plan view.

In addition, if you are editing a 2D-only symbol and adding 3D objects (including 2D layer plane objects), or editing a 3D-only symbol and adding screen plane objects, an alert informs you that you are creating a hybrid symbol. Portions of the symbol may not be visible in certain views. Similarly, if you are removing portions of a hybrid symbol during editing, you may be creating a 2D-only or 3D-only symbol which may not display as expected in certain views.

5. When editing components, make the object edits in the Attributes and/or Object Info palette. To edit the symbol insertion point, select all the components of the symbol, and relocate the components about the insertion point (origin) crosshairs. The intersection of the crosshairs gives the feedback segment Locus when encountered.

The other component of a hybrid symbol is not automatically adjusted to match changes made to the insertion point. It must be edited separately. Switch easily to the other component from the context menu.

6. A master snap point can be created when editing a symbol definition, setting the location by adding a 2D and/or 3D locus where priority snapping should occur, when enabled in Object snapping. Place the locus with the appropriate component (2D locus for 2D component, 3D locus for 3D component). In the Object Info palette of the selected locus, select Master Snap Point. If the master snap point is in an obscure location and you want it to always display when the snap box is over the symbol instance, select Show Master Snap Point Outside Snap Box.

7. After editing, click the Exit Symbol button (or select Modify > Exit Symbol) to modify the symbol definition. The instances of black and green symbols are also updated.

If the edited symbol is nested within another symbol, the Exit Symbol button takes you up a level to the symbol container.