Referencing resources

Use the Resource Manager to reference the resources from any Vectorworks file. The master file that contains the resource and the target file that references it must be the same Vectorworks version number.

To reference the resources from another file:

Display the resources of the master file in the Resource Manager. Either use the Browse a Document command on the file options menu, or if the master file is a favorite or library file, use the file browser pane to access it (see Resource Manager: File browser pane).

Right-click on the desired resource, and select Reference.

The Reference Resource(s) dialog box opens. Specify the location of the referenced resource.

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

Parameter

Description

Preserve folder hierarchy

Maintains the same folder structure the referenced resource had in its source file

Select destination folder

Adds the referenced resource to the selected folder

Folder list

Displays the folders in the target file that are the same type as the resource being referenced; the selected folder becomes the destination for the referenced resource

New Folder

Creates a new folder within the selected folder; specify the folder name

If the master file has never been referenced in the current file, the New Reference dialog box opens. Specify the reference parameters.

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

Parameter

Description

Source File

Displays the path and file name of the referenced resource file

Save reference location as

Maintains either an absolute or relative file path reference from the current file to the referenced resource’s file. Use the absolute path when the location of the referenced file with respect to the current file is not going to change. Use the relative path when the files might be moved to another computer or platform; as long as the relative path between the files remains the same, the reference can be found. Both files must be saved on the save volume to select this option.

The Source File path displays either an absolute or relative path, depending on the selection.

Save referenced cache to disk

Saves a copy of the referenced resource with the target file. When this option is deselected, a copy of the referenced resource is not saved, which means that the target file size is smaller; the referenced resource is refreshed when the target file is opened.

Automatically update out of date reference during file open

Updates the reference each time the target file is opened; when deselected, the reference is updated only when Update is clicked from the References tab of the Organization dialog box

Update class definitions

Updates class definitions along with the referenced resources that use those classes

The resource is added to the target file. Referenced resources display with italicized names in the Resource Manager.

The following rules apply to referenced resources.

Situation

Description

Editing a referenced resource

If in-place editing is enabled in the target file, a referenced resource can be modified from the target file (see Setting the referencing options). Even when in-place editing is enabled, the master file must not be open, the reference must not be broken, and the resource must not be out of date. Changes to the referenced resource are automatically exported to the master file; while in edit mode, the master file is locked.

The following resources can be edited within the referenced file:

Gradients

Hatches

Images

Line types

Record formats

Renderworks backgrounds, styles, and textures

Plant symbols (Vectorworks Landmark required)

Symbol definitions

Text styles

Tiles

Sketch styles

Roof, slab, and wall styles (Vectorworks Design Suite required)

Resource name conflict

If there is a name conflict between a referenced resource and another resource when you are creating a reference, an alert displays. If the resources are of different types (a hatch and a tile, for example), rename the resource in the target file to continue. If the resources are of the same type, replace the resource in the target file to continue.

Change user origin of master file

If the user origin of a master file is changed, the location of the referenced resources do not change, if Ignore source user origin is selected in the Edit Reference dialog box

Change master file classes

Changes to the class of a referenced resource are only reflected in the target file after an update if Update class definitions is selected in the New Reference dialog box

To break a reference, right-click on the desired resource, and select Break Reference from the context menu. The resource remains in the target file, but it is no longer referenced to the master file.

Adding and editing reference files

Creating a referenced design layer viewport

 

Was this page helpful?