Thicket

Laubwerk Plants Add-on for Blender

Thicket is a Blender Add-on to import Laubwerk Plants high resolution plant and tree models.

Thicket is an open source community developed project using the Laubwerk Python SDK. While not affiliated with or officially supported by Laubwerk GmbH, this project would not be possible without Laubwerk's efforts to answer questions and address issues during the development of Thicket.

Using Laubwerk's level of detail controls, Thicket keeps the Blender viewport responsive and renderings photo-realistic. Cycles render of a Japanese Maple (Acer Palmatum):

Features

Thicket provides a visual plant selection gallery and options to configure the plant model variant, age, and leaf density. It generates separate viewport and render models, supporting various levels of detail for each. The viewport can display a low poly proxy (convex hull), partial or full geometry models in any of Blender's viewport modes. The rendered model geometry is generated using various level of detail controls.

• Sidebar "N Panel" UI
  • Visual plant selection gallery
  • Update existing plants
  • Update all identical instances at once
  • Make instances unique
  • Smart delete to manage scene size
• Plant model options
• Separate viewport and render models
• Render level of detail controls
• Material nodes
• Collection instancing

Install

• Download and install the prerequisites
  • Blender 2.80 or later. The plugin is known to run with Blender 2.82.
  • Laubwerk Python SDK 1.0.33 or later, provided by all Laubwerk Plant Kits, including the Plants Kit Freebie.
    • Choose the "Custom" installation method and ensure the "Python Extension" component is checked.
• Installation options
  • From a release Zip file (most users)
    • Download the latest release zip file from the Releases Tab
    • Start Blender
    • Choose Edit -> Preferences -> Add-ons -> Install
    • Select the zip file and click Install Add-on
  • Latest from GitHub (for testers and developers)
    • Exit Blender
    • Clone the thicket git repository into the Blender addons folder:
      • Mac: ~/Library/Blender/2.80/scripts/addons/thicket
      • Windows: %AppData%\Blender Foundation\Blender\2.80\scripts\addons\thicket
    • Start Blender
• Configure Thicket
  • Choose Edit -> Preferences...
  • Select the Add-ons tab and search for thicket
  • Check the box to enable the row Import-Export: Thicket: Laubwerk Plants Add-on for Blender
    • If you have more than one version installed, be sure to only enable one at a time
  • Click the arrow to expand the add-on preferences
  • Enter the Laubwerk install path. The box will be red until a valid path is entered, then the Laubwerk SDK version will be displayed below the path.
  • Click Rebuild Database. This will take a few minutes depending on your computer and the number of Laubwerk Plants Kits installed.
  • When it completes, the number of plants in the database is displayed
• Thicket is now ready to use (see Usage)

Usage

N Panel

Thicket adds a Blender N Panel to Add, Edit, and Delete plants. Access the panel by pressing n and clicking on the Thicket tab.

Add Plant

To add a plant, click Add Plant and select from the gallery presented. You can resize the panel to show up to 5 columns of plants. You can filter the results by entering a search term (clear the search by pressing the cancel icon to the right of the search field).

Once selected, the panel presents the plant model, season, leaf density, and level of detail options.

The image preview will update when you change the Model variant and age. You can also configure the season, leaf sensity, and level of detail properties:

Plant Model

Model: Select variant and age
Season: Affect foliage, color, and flowers
Leaf Density: Control how full the foliage appears

Level of Detail

Viewport: Control the model displayed in the viewport

• Proxy: low poly proxy (convex hull)
• Partial Geometry: low detail version of the render model
• Full Geometry: high detail render model

Render: Control the rendered model

• Proxy: low poly proxy (convex hull, forces viewport to Proxy)
• Full Geometry: high detail render model

Max Branching Level: Limit the number of branching levels off the trunk (uncheck to use the plant default)
Min Branch Thickness: Eliminate branches smaller than this value (uncheck to use the plant default)
Max Subdivisions: Control the max number of edges in a branch cross-section (1 is square)
Leaf Amount: Control the number of leaves used to reach the specified leaf density (fewer leaves result in larger individual leaves)

You can return to the gallery to select a different plant with Change Plant, add the current plant with Add, or cancel the operation with Cancel.

Adding Acer Palmatum with Viewport Proxy selected, loads the convex hull into the viewport:

Importing the same plant with Viewport Partial Geometry selected loads a low detail version of the render model into the viewport:

The rendered model is the same for each, resulting in the following rendered image:

Edit Plant

To edit the properties after a plant is added, select the plant in the viewport and press Edit Plant under the thumbnail in the panel. Here, you can change the plant and any of the options. Pressing Update will replace the selected plant's template, changing all plants using the same template. To change only the selected plant object, press Make Unique (#). The number of "sibling" plants (plants with the same template) is indicated by (#) in the Make Unique (#) label.

Delete Plants

To delete a plant, avoid using x. Instead, select the plant and press Delete in the panel. This will remove the plant instance from the viewport and will also remove the template plant when the last instance is removed. This will help keep your Blender file as small as possible.

Collections and Instancing

Thicket creates a template for each plant added, and places them in a top level collection named "Thicket" which is excluded from the View Layer by default. Each template is a collection consisting of the viewport object and the render object as a child of the viewport object. Object visibility settings determine which object is visible in the viewport, and which is visible for rendering. At import time, a Collection Instance of the template collection is added to the main scene collection. This is the object that is visible after import.

The object model is shown in the image below by checking the Thicket collection and expanding the template collection and object hierarchy:

The collection instance can be duplicated with Shift+D to add a second identical plant instance to the scene, without doubling the memory used. Because Collection Instances are displayed in the viewport, modifying the template in the Thicket collection will be reflected in all the instances (this is what Editing and Updating a plant with the Thicket N Panel does).

In short, leave the Thicket collection unchecked and duplicate the Collection Instance in the scene to make memory efficient copies of plants you can update in groups. To make a plant unique, select it, press Edit Plant, and then Make Unique (#).

Report an Issue

Thicket is an open source project that is not affiliated with Laubwerk GmbH. If you think you have found a problem or a bug with Thicket, please Check Existing Issues to see if someone has already reported it. If not, please Create a New Issue, providing as much detail as possible to help us recreate the problem. Please do not contact Laubwerk directly.

Contributing

See CONTRIBUTING for more information.