Skip to content

Plant library

Preferences - Plant Library

Libraries

Here you can adjust the locations of your plant libraries. These usually don’t need to be changed if you’ve installed everything in the default location, but you can adjust them if needed. The interface will indicate if the libraries are found.

  • PlantCatalog: The location of the PlantCatalog library folder, which should contain categorized subfolders for each plant type. Within these subfolders, you should find the actual .tpf plant files. Read more here about how to install this library.
  • PlantFactory: The location of the PlantFactory library folder, which should contain multiple subfolders, including the Species folder that holds the actual .tpf plant files. This library contains the plants that ship with the PlantFactory application itself.
  • Personal: Enable this option if you have custom plants to include, and select the folder containing them. This folder can contain subfolders to organize the plants into categories.

    Only plants that are saved in .tpf file format are handled, so if you have plants that you have saved in the default PlantFactory .tpfp format, please save them inside PlantFactory as a .tpf file by going to File > Export > Export as Species.

    Note on paths

    The library folders must be named 'PlantCatalog', 'PlantFactory' and 'Personal' respectively. Case does not matter.

Library Cache

To use the Browse via Blender mode, a cache must be generated. See First time use & Importing cache for instructions, and refer to What is the PF2B cache? in the FAQ for more details.

The Presets Cache and Plant Thumbnails Cache are required, while the Preset Thumbnails Cache is optional. If not generated, presets will be displayed as a list instead of thumbnails.

Generally, you won't need to adjust these settings if you're only using the built-in plants and libraries from PlantFactory. These settings are only necessary if you want to expand your library with custom plants.

Presets Cache

  • Verify: Checks if all presets in your Plant Library are cached and provides an estimate of the time required to generate any missing presets. Shows a popup where you can specify which libraries to check.

    Cache Verify

    Examples

    Here are a few examples of different states: first, with a full cache and no missing thumbnails, then with a few missing thumbnails, and finally with no cache at all.

    Cache Verify Cache Verify Cache Verify

  • Cache Missing Plants: Will show a prompt to select which libraries to target and then launches PlantFactory to check your plants and cache any missing presets.

    Cache Missing Presets

Thumbnails Cache

  • Verify: Checks the thumbnails cache for any missing plant thumbnails and provides an estimate of the time required to generate them. Shows a popup where you can specify which libraries to check.

    Cache Verify

    Examples

    Here are a few examples of different states: first, with a full cache and no missing thumbnails, then with a few missing thumbnails, and finally with no cache at all.

    Cache Verify Cache Verify Cache Verify

  • Create Missing: Generates thumbnails for all missing items. Generating thumbnails involves PlantFactory rendering each plant or preset individually and saving the results as thumbnail images. Preset thumbnails also include details like plant height and polygon count.

    Cache Missing Plants

  • Verify: Checks the thumbnails cache for any missing preset thumbnails and provides an estimate of the time required to generate them. Shows a popup where you can specify which libraries to check.

    Cache Verify

    Examples

    Here are a few examples of different states: first, with a full cache and no missing thumbnails, then with a few missing thumbnails, and finally with no cache at all.

    Cache Verify Cache Verify Cache Verify

  • Create Missing: Generates thumbnails for all missing items. Generating thumbnails involves PlantFactory rendering each plant or preset individually and saving the results as thumbnail images. Preset thumbnails also include details like plant height and polygon count.

    Cache Missing Plants

Import / Export Cache

To avoid rebuilding the entire cache, you can import or export an existing cache.

  • Import Cache: Imports a .pf2b cache file.
  • Export Cache: Exports a .pf2b cache file.
  • Open Cache Folder: Opens the folder containing the cache files for manual management.