Plant settings

By using plug-in object styles, you can create plants with a combination of parameters that are determined by style or by instance. Style parameters have a fixed value established by the style; instance parameters can be set independently for each instance of the object in the drawing; see Concept: Plug-in object styles and Creating plug-in object styles.

If plant data were obtained from the plant catalog or database, those are displayed. Values and settings entered on the Plant Style or Plant Preferences dialog boxes become the default for the plant.

The parameters in the Plant Preferences, Plant Settings, and Edit Plant Style dialog boxes are identical, except for the controls related to selecting or creating a style.

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

Parameter	Description
Use Style (Plant Preferences and Plant Settings dialog boxes)	Select a style from the Resource Selector
Duplicate Style (Plant Preferences and Plant Settings dialog boxes)	Opens the Edit Plant Style dialog box to create a duplicate plant style based on the selected plant's style
Plant Style Name (Edit Plant Style dialog box)	Displays the plant style’s name as specified in the Name Formula; this name also displays in the Resource Manager and Object Info palette
Name Formula (Edit Plant Style dialog box)	Enter a name for the plant style and select a prefix and suffix to be appended to the name, if desired. To create a new plant style, enter a new name. To edit the current plant style, leave the name unchanged.
Previews	Dynamically previews the plant appearance, showing how it will appear when added to the drawing
Top/Plan Preview	Displays the 2D component of the plant symbol
3D Preview	Displays the 3D component of the plant symbol, if one has been added to the symbol definition (image props, such as those provided by xFrog, can be used as 3D plant geometry)

Plant settings: Species and Data pane

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

Parameter	Description
Species
Latin Name	Specifies the plant genus and species (botanical name)
Common Name	Specifies the plant common name or names
Plant Catalog (Edit Plant Syle dialog box only)	Depending on the selection made in the Choose Plant Data Source dialog box (see Selecting the plant data source), plant data can be either associated with plants from plant catalogs or from the plant database. If plant catalogs are the source, the Select Plant Data dialog box opens. Select the plant to associate from the list. The plant data from the catalog is imported. See Using plant catalogs for additional information. If the plant database is the source, the plant database opens, if it is not already open (this may take several seconds). A dialog box in Vectorworks indicates that Vectorworks is waiting for you to select data from the plant database for the plant style. If you change your mind about obtaining the plant style data from the plant database, click Cancel Data Acquisition. Select a plant record from the plant database as described in Searching for plants. Once the correct plant has been located, from the plant database, select Vectorworks > Use Currently Selected Record. This associates the plant database record with the plant style. From either source, once the plant data has been associated with the plant style, the catalog or database information updates the appropriate plant style parameters, if specified when the plant data source was selected.
Data
Plant/TagID	Identifies the plant with a unique code; this code appears in the plant list and on ID tags, if selected (see Plant ID codes for the definition of common code categories)
Scheduled Size	Indicates the plant caliper or container size; displays in the Plant List worksheet
Quantity Type	Determines the Quantity value for the attached Plant record, primarily for the purpose of calculating plant worksheets with the plant cost per count or the cost per area. The Quantity Type can be defined by unit count, dripline area, or border area: Count: Counts the number of plants within an array of plants Dripline area: Considers the area, in current document units, of the drip line polygon (the tight bounding polygon around the plants) Boundary area: Considers the area, in current document units, of the plant array polygon as drawn
Price Code (SKU)	Specifies the price code entry in Stock Keeping Units (SKU)
Price	Indicate the plant cost per unit of quantity; the plant cost and quantity are reflected in the Extended Price calculation in the Plant List worksheet
Planting/Nursery Schedule Comments	Specifies default comments about the plant that display in the Plant List worksheet

Plant settings: Size and Spacing pane

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

Parameter	Description
Size
Spread	Specifies the default plant spread diameter (the maximum width of the mature plant, as drawn) for both single and multiple plant placement
Height	Sets the default height of the typical mature plant at insertion
Hedge Rows	Specifies the number of hedge rows to create when Hedge mode is enabled
Hedge Mode	Select the arrangement of hedge rows when Hedge mode is enabled
Space and Array Modes Options
Spacing by	For the Poly-Vertex Placement, Poly-Edge Spaced, Rectangular Array, and Triangular Array insertion modes, sets the default spacing between plants at insertion; select Distance, Rate, or Coverage
Distance	Sets the horizontal distance between plants (Spacing) and between vertical rows of plant arrays (Row Spacing). Fixed Spacing: Places plants at the specified distance Best Fit: Places plants at the start and end of the line or array, and then distributes the plants evenly at the specified distance Count: Distributes the specified number of plants evenly along the line or within the array Same as Spacing: Sets the Row Spacing to be the same as the Spacing selection
Rate (rectangular and triangular array)	Calculates the plant spacing, for arrays only, based on the plant area. Specify the rate: Plants per square unit: Spaces the plants according to the set density, with the square unit specified in the document settings Unit on center: Spaces the plants from center to center, according to the length units specified in the document settings
Coverage	Calculates the plant spacing based on the actual plant area and Spread values, and places them according to the set Percentage. A value of 100%, for example, indicates full coverage, with plants spaced according to the Spread.

Plant settings: Insertion Options pane

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

Parameter

Description

Mode

(Plant Preferences and Plant Settings dialog boxes only)

Select the default placement mode for this plant

Include on plant list

Includes this plant on a plant list

Plant settings: Graphics pane

The plant graphics, which are defined by the plant style, can easily be created from a symbol, from an existing plant, from automatically generated 3D geometry, or from an image.

Plant graphics can also be created from 2D and optionally 3D drawing objects, including xFrog plant images, image props, and Laubwerk plants. Once the plant has been created, edit the symbol components as necessary; see Editing symbol definitions.

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

Parameter	Description
Edit Current Graphics	Closes the Edit Plant Style dialog box to set all parameters, and opens Object editing mode to edit the 2D or 3D graphics for the plant symbol. Alternatively, right-click on a plant instance that uses the style, and select Edit from the context menu, and then click 2D Graphics or 3D Graphics. Editing the plant attributes from an instance edits the plant style and affects all plants that use that style.
Laubwerk Geometry	Opens the Laubwerk Plant Catalog dialog box, to select a Laubwerk plant and specify its seasonal and appearance settings. See Adding 3D plants from Laubwerk.
Copy from Symbol	Obtains the 2D or 3D plant geometry from a symbol in the file or from a library. The Copy From Symbol 2D or Copy From Symbol 3D dialog box opens. Click the plant selector. From the Resource Selector, double-click a plant resource to activate it, and then specify whether to resize the diameter and/or height of the symbol geometry.
Generate	Generates 3D plant geometry when the 3D representation of the symbol used to create the plant is not suitable; see Generating 3D plant geometry from a shape
Create from Image	Generates 3D plant geometry when the 3D representation of the image used to create the plant is not suitable. The Create From Image dialog box opens. Click the image selector. From the Resource Selector, double-click an image resource to activate it, and then specify whether the diameter and/or height of the plant geometry image.

Generating 3D plant geometry from a shape

When generating plant geometry from another symbol, the 3D representation may not be available, or not suitable for the new plant. 3D geometry can be automatically generated, creating a suitable representation of the plant style in 3D views.

On the plant settings Graphics pane, click Generate. The Generate 3D Plant Geometry dialog box opens.

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

Parameter	Description
Preview	Displays a preview of the 3D geometry to be generated. Select a View for the preview.
Parameters
Canopy Shape	Select a general shape for the tree canopy; the preview dynamically displays the shape
Canopy Spread	Sets the diameter of the canopy shape at its widest point
First Branch Height	Sets the height where the trunk ends and the canopy starts
Canopy Height	Specifies the height of the canopy, not including the trunk
Item Height	Specifies the total height of the canopy including the trunk

Plant settings: Appearance pane

A document preference makes it easy to give plans a uniform appearance by applying a document-wide shadow style to all plants and massing models in a drawing (see Document preferences: Plan Shadows tab), but this document preference can be overridden for plant instances or plant styles. The outline, massing, and shadow parameters can be toggled on or off for all plants in a document by selecting View > Show > Show or Hide Plant Details.

The massing, outline, and shadow effects display in Top/Plan view only; plant shadows do not display in worksheet images.

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

Parameter	Description
Plan View Effects
Polygon Display	For multiple plant placements, changes the display of the boundary or center polygon defining the plant cluster shape.
Mass Outline	Select a plant outline style The outline’s pen attributes can be changed for selected plant objects in the Attributes palette.
Apply fill across plant grouping	A continuous outline is created around overlapping plants, and internal details are hidden. The 2D appearance of the massed group is controlled by the back polygon in the plant symbol group, so massing could cause the plant to display without a fill color. (An alternative way of hiding plant details is to use the Plant-Components classes to control the visibility of elements within the plant symbol.) Keep in mind the following points about this setting: Open areas in a plant style's background fill cannot be filled. Plants that contain bitmap images cannot be massed. Hedges only fill when inserted with Poly-Edge Spaced mode.
Show shadow	Displays shadow effects in Top/Plan view only. Select whether to use the plan shadows settings in document preferences or custom shadow settings, and click the appropriate button to confirm or adjust the settings; see Document preferences: Plan Shadows tab or Plant shadow settings.
Tick Mark
Style	Select a tick mark (plant center mark) style
Size	Specifies the tick mark size
Class	To control appearance and visibility, select a class for the tick mark from the list of classes present in the drawing, or create a new class. Select <Plant Class> to place the tick mark in the same class as the plant object.
Rotation and Variation
Plant Rotation	For multi-plant placements, orients the plants in the horizontal direction, rotates the plants along the line created by the drawn polygon, or rotates the plants randomly, creating a more natural appearance
Plant Diameter Variation	Keeps the plants at a fixed size, or randomly varies the plant diameter according to the specified percentage of variation
Plant Height Variation	Keeps the plants at a fixed height, or randomly varies the plant heights according to the specified percentage of variation

Plant settings: Root Zones pane

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

Parameter	Description
Root Ball	The root ball is the main mass of the plant's roots
Show	Select which view displays the root ball: 2D Only 3D Only 2D and 3D To hide the root ball, select Bare Root (None).
Shape	Select the 3D shape of the root ball
Size	Select the size of the root ball. The values available depend on the selected Shape. To add, edit, or delete custom sizes, see Adding, editing, or deleting custom root ball sizes.
Class	To control appearance and visibility, select a class from the list of classes present in the drawing, or create a new class. Select <Plant Class> to place the root ball in the same class as the plant object.
Attributes by class	Select to set all 2D root ball attributes by class. If this parameter is selected, Line Style and Line Color are disabled.
Line Style	Select the line style of the root ball
Line Color	Select the line color of the root ball
Planting Excavation	The planting excavation is the area that needs to be dug out for the root ball to be planted
Show	Select which view displays the planting excavation: 2D Only 3D Only 2D and 3D To hide the planting excavation, select None.
Shape	Select the 3D shape of the planting excavation
Depth	Select the planting excavation depth. To specify a custom depth, select Custom and specify a Value.
Value	Displays the value of the planting excavation Depth
Diameter (Round)	Select the planting excavation diameter. To specify a custom diameter, select Custom and specify a Value. The diameter must be large enough to fit the root ball shape.
Side (Rectangular)	Specify the side dimension of the rectangular Shape. To add, edit, or delete custom sizes, and to specify non-vertical sides and excavation components, see Adding, editing, or deleting custom rectangular plant excavation sides.
Value	Displays the value of the planting excavation Diameter and/or Side
Class	To control appearance and visibility, select a class from the list of classes present in the drawing, or create a new class. Select <Plant Class> to place the excavation in the same class as the plant object.
Attributes by class	Select to set all 2D planting excavation attributes by class. If this parameter is selected, Line Style and Line Color are disabled.
Line Style	Select the line style of the planting excavation
Line Color	Select the line color of the planting excavation

Adding, editing, or deleting custom root ball sizes

To add, edit, or delete root ball sizes:

On the Root Ball tab, select a root ball Shape. The selected shape determines the values available in the Size list.

The Container and the Balled and Burlapped Shape allow a flanged root ball, with different diameters at the top and bottom of the shape.

Select Edit Custom Items from the Size list.

The Edit Custom Items dialog box opens.

Do one of the following:

To add an item, click Add; the Add Custom Dimensions dialog box opens. Specify the Name and dimensions. The calculated Volume displays. Click OK; the item is added to the Edit Custom Items dialog box.

To edit an item, select the item and click Edit; the Edit Custom Dimensions dialog box opens. Edit the Name and/or one or more dimensions. The calculated Volume displays. Click OK; the edited item is displayed in the Edit Custom Items dialog box.

To delete an item, select the item and click Delete.

Click OK.

If you added or edited an item, the item is displayed in the Size list. If you deleted an item, the item is removed from the Size list.

Adding, editing, or deleting custom rectangular plant excavation sides

Rectangular excavations allow a flanged excavation, with different diameters at the top and bottom of the shape. You can also specify backfill components for a rectangular excavation pit.

To add, edit, or delete excavation side sizes:

On the Plant Excavation tab, select a rectangular excavation Shape.

Specify the Depth.

Select Edit Custom Items for the Side dimension.

The Edit Custom Items dialog box opens.

Do one of the following:

To add an item, click Add; the Add Custom Dimensions dialog box opens. Specify the Name. Enter two of the dimensions to automatically calculate the third dimension (with the calculator next to its button); the dynamic preview shows the dimensions that need to be entered. The calculated Volume displays. Click OK; the item is added to the Edit Custom Items dialog box.

To delete an item, select the item and click Delete.

While adding or editing a custom dimension, specify the backfill components for the excavation by clicking Edit Components.

The Planting Excavation Backfill Components dialog box opens.

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

Parameter	Description
Preview	Displays a sectioned preview of the backfill structure, including any defined components. The top of the preview backfill indicates the top part of the slab as it will be drawn.
Overall Thickness	Displays the thickness of the backfill, which is determined by the thickness of its components. Backfill always has one component by default, set to the excavation Depth.
Backfill component list	Lists the backfill components in order from top to bottom; click on a Name, Description, or Thickness to edit it. The total thickness of the components should be equal to the Depth.
New	Adds a component to the list
Duplicate	Duplicates one or more selected components; the duplicates are added to the component list right below the originally selected components
Delete	Deletes one or more selected components

Click OK twice.

If you added or edited an item, the item is displayed in the Size list. If you deleted an item, the item is removed from the Size list.

Plant settings: Tag pane

The Data Tag tool provides more flexible options for tagging plants; see Adding data tags and labels.

To create a custom plant tag using the plant object's tag capabilities, see Creating a custom plant tag. After creation, the plant tag’s appearance can also be modified via the Object Info palette, tag class settings, and the control point locations on the drawing (see Plant tag appearance).

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

Parameter	Description
Display	Select whether to display a plant tag to the right or left of the leader line, in the center of the plant or group of plants, or to display no tag. A Center tag has no shoulder or leader; set the X/Y Offset for Center tags, if needed.
Class	To control appearance and visibility, select a class from the list of classes present in the drawing, or create a new class
Approach Angle	Specifies the angle of the leader line, from 0 to 360°. Setting the same angle for several selected plants aligns their leader lines, for an attractive planting plan (see Aligning and distributing leader lines).
Shoulder Angle	When a tag shoulder line is enabled, sets the angle of the shoulder line and, if selected, tag display, from 0 to 360°. To display the plant tag to the left, specify an angle greater than 90 or less than 270 degrees. To display the plant tag to the right, specify an angle less than 90 or greater than 270 degrees. Setting the same angle for several selected plants aligns their shoulder lines, for an attractive planting plan.
Bubble	Specifies the bubble style, if any, for displaying quantity or optionally, Plant ID, with the plant tag
Top/Center/Bottom	The custom tags present in the drawing and the predefined plant record field combinations for tags are listed. Specify the information to display on each level of the plant tag. For the center level, select Continuation Line to continue the shoulder as a dividing line between the top and bottom tag information. Alternatively, select Set Custom Tag to define a custom plant tag (see Creating a custom plant tag).
Enable tag shoulder line	Adds a shoulder line to the leader line; adjust the shoulder angle with the shoulder control point, or by entering a tag Shoulder Angle
Snap tag to plant centers	Snaps the end of the leader line to the center of the plant; deselect to adjust the endpoint location manually
Display tag line marker	Displays a marker at the end of the leader line; specify the marker to use by editing the plant tag class (see Setting class properties)
Image Size	Sets the size of any images included in a custom plant tag

Plant settings: More Data pane

Plant data parameters that are not available on another pane in the dialog box are listed on the More Data pane.

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

Parameter	Description
The list of visible fields	List of plant data parameters and their values, the list can be customized for each plant
Fields Visibility	Opens the Fields Visibility dialog box; click in the Show column to place a check mark beside fields to include in the list for this plant
Plant Catalog (Edit Plant Syle dialog box only)	Depending on the selection made in the Choose Plant Data Source dialog box (see Selecting the plant data source), plant data can be either associated with plants from plant catalogs or from the plant database. If plant catalogs are the source, the Select Plant Data dialog box opens. Select the plant to associate from the list. The plant data from the catalog is imported. See Using plant catalogs for additional information. If the plant database is the source, the plant database opens, if it is not already open (this may take several seconds). A dialog box in Vectorworks indicates that Vectorworks is waiting for you to select data from the plant database for the plant style. If you change your mind about obtaining the plant style data from the plant database, click Cancel Data Acquisition. Select a plant record from the plant database as described in Searching for plants. Once the correct plant has been located, from the plant database, select Vectorworks > Use Currently Selected Record. This associates the plant database record with the plant style. From either source, once the plant data has been associated with the plant style, the catalog or database information updates the appropriate plant style parameters, if specified when the plant data source was selected.
Field	Click an item in the list, and its Value displays; click Edit to change the value

As described in Concept: Plant style and plant data integration, if either Update the Plant catalog with Vectorworks Plant style changes or Update the Plant Database with Vectorworks Plant style changes is selected in the Choose Plant Data Source dialog box, the associated plant catalog (or plant database) automatically updates with any changes made on the More Data pane.

If you're using a plant database file from a version of Vectorworks prior to 2018, the synchronization of images between the plant style and the plant database cannot occur even when using the Migration Manager during the version update, because the older plant database file does not include the new functionality. To fix this issue, export the records in the plant database with the File > Export Records plant database command. Then import the records back into the plant database with the File > Import Records plant database command.

Setting plant data images

Up to four plant images can be selected from the More Data pane. The images can be synchronized with the images in the plant catalog or plant database; see Accessing the plant catalogs or Editing plant records. The fourth option, Custom Image, is not populated by default in the plant database, so it is useful for including an additional graphic in the plant style.

Other image sources, besides those from the plant catalog or database, can be specified from the More Data pane. If not using plant images from the plant style or the plant catalog/database, prepare image files or create/locate a suitable image resource.

To set the plant data image source:

In the list of fields, scroll to the Image Plant Form, Image Detail, Image Misc, and Custom Image parameters.

Click on each one to set its image source. Set Image becomes available; click to specify the image for tag display.

The Set Plant Data Image dialog box opens. Specify the location of the plant image.

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

Parameter	Description
Plant Top/Plan Preview	Uses the plant style image specified for the Top/Plan view. This method of displaying plant images is useful with a plant key.
Plant 3D Preview	Uses the plant style image specified for 3D views
Import an External File	Uses an imported image file; click Browse to select the file to import
Image Resource	Uses an image resource. From the Resource Selector, select an image resource; double-click a resource to activate it.
Plant Image	Uses the image that was specified for the plant within the plant catalog or database
Remove Image	If an image source had previously been specified, removes the image. <not set> displays in the Value column of the More Data pane for the item, and no image displays in any associated custom plant tag. The image is also removed from the associated plant catalog or database, when updating is enabled.

When an image source has been specified, <image> displays in the Value column of the More Data pane. The plant images are synchronized with the plant catalog or database. For this reason, the selection may change to Plant Image regardless of the original selection. For example, if you import an external file for the Image Detail, the plant catalog or database is updated with this image for the Detail Image. In the Set Plant Data Image dialog box, the setting switches to Plant Image since the image now originates from the catalog or database.

To prevent image and plant data synchronization between the associated plant catalog/database and the plant style, deselect either Update the Plant catalog with Vectorworks Plant style changes or Update the Plant Database with Vectorworks Plant style changes (see Selecting the plant data source).

Display images in the drawing within plant tags by Creating a custom plant tag, and add them to worksheets by Inserting images in worksheet cells.

Adding plants to the design

Editing plants

Creating plant styles

The plant database

Plant graphics

Converting plant clusters

Was this page helpful?