Skip to content

Latest commit

 

History

History
51 lines (31 loc) · 3.03 KB

README.md

File metadata and controls

51 lines (31 loc) · 3.03 KB

Dendro

Dendro is a volumetric modeling plug-in for Grasshopper-3D built on top of the OpenVDB library. It provides multiple ways to wrap points, curves, and meshes as a volumetric data within Grasshopper-3D, allowing you to perform various operations on those volumes. Dendro includes components for boolean, smoothing, offsets, and morphing operations. You can find out more details of its features and download a working version here

Design

I have been using the OpenVDB library for a couple years, but needed something to prototype quicker with. I had built a rough version of this for Grasshopper-3D, but decided to package it up nicer and put a release together. Hopefully it is something to build upon and the hope was it could serve as a starting point to add more features and functionality to.

The goal was to make Dendro integrate into Grasshopper-3D as seamlessly as possible. Whereas many voxel solutions require you to think of geometry as living with a bounding box, Dendro makes working with volumes no different than handling any other geometry in Grasshopper-3D. Dendro works with many native Grasshopper-3D components, avoiding the 'blocking' found in other plugins, and allowing you to move in and out of volume operations very quickly.

Installation

Dendro contains two projects, a C++ project for working with OpenVDB and a C# project creating the Grasshopper-3D plugin.

DendroAPI (C++)

OpenVDB and all its dependencies are added to the supplied VCPKG manifest. Upon build, it should automatically download and install everything required.

DendroAPI (C++) on MacOS

Use Homebrew (brew) to install the dependencies for the C++ library:

brew install boost cmake c-blosc openvdb tbb zlib

Run the following from the DendroAPI directory to compile using cmake:

mkdir build
cd build
cmake ..
make

DendroGH (C#)

Since there are multiple versions of Rhino, each with their specific SDK, I added the Rhinocommon and Grasshopper-3D libraries as a nuget package in order to let you specifically target your desired Rhino version. That can be changed by Right-clicking the C# project, then selecting Manage Nuget Packages, clicking the Installed tab, Selecting your desired package, and finally, changing the Version in the right panel.

It is targeted for Rhino 8 by default.

DendroGH (C#) on MacOS
  • Install .Net Core (currently v8, v6+ is required for Apple Silicon) via brew: brew install dotnet
  • Compile with dotnet build DendroGH.Mac.csproj

Building

Dendro was built using Microsoft Visual Studio 2022, but you should be able to re-target for other versions. It will also copy all necessary dependency dlls into the output folder to provide an easy reference for where dependency dlls can be found. Make sure to build for "Release" and "x64". You will need to bring "DendroGH.gha" and "DendroAPI.dll" into your Grasshopper library folder.

More Info

Dendro is using OpenVDB. For more information on the library, please visit here.