Library for building topology from sets of surfaces and unfolding them using Protogeometry tools in Dynamo
Clone or download
Latest commit cdfa2c6 Sep 26, 2018

README.md

DynamoUnfold

Library for building topology from sets of surfaces and unfolding them using Protogeometry tools in Dynamo.

This project includes references to:

  • DynamoCore
  • Nunit
  • DynamoText
  • DynamoPack
  • Protogeometry

###Building / Installing### Building this library requires that you have also cloned Dynamo, DynamoText, and DynamoPack.

These projects (Dynamo,DynamoText,DynamoPack) must be located in the same directory that DynamoUnfold has been cloned into.

Build Steps
  1. Clone Dynamo Dynamo
  2. Build Dynamo
  3. Clone DynamoText DynamoText
  4. Build DynamoText
  5. Clone DynamoPack DynamoPack
  6. Build DynamoPack
  7. Clone DynamoUnfold - you are here
  8. Build DynamoUnfold

The reason for this build order is to ensure that both DynamoText and DynamoUnfold are referencing the same version of the geometry library interfaces and the Dynamo Core. You can actually clone all repos at the same time, but Dynamo must be built before the others.

OR

Skip all of these steps and use the auto clone and build script in the tools folder. This python script will clone all the projects and build them in the correct order for you.

Importing Into Dynamo

Once DynamoUnfold is finished building, navigate to DynamoUnfold/bin/... and import the DynamoUnfold.dll into Dynamo using library import.

Pre-built

If you are just looking for the necessary .dll's to import through Zero-Touch Import into Dynamo check the Pre-built folder. These .dll's will be updated periodically - but they may be out of snyc with the version of dynamo you are using! Also Does Not Exist YET!

Through The Package Manager

Master branch of this library will periodically be wrapped up as a package and distributed on the package manager with samples!

Running Unit Tests

To run unit tests on this library requires manually copying over the correct libG.dll's from Dynamo's Bin Folder. Please look at HostFactorySetup.cs for further instructions. You will also need to specify a directory for the geometry library to search for ASM .dll's. This will be an Autodesk host application install directory, examples exist in src/UnfoldTests/HostFactorySetup.cs

Contributing

please see: https://github.com/holyjewsus/DynamoUnfold/wiki

Known Issues

  • There is a speed issue when unfolding a tesselated surface with more than approximately 1000 faces, stems from the conversion of triangle data to surfaces.
  • There is an intersection bug that occurs intermittently - more so with large numbers of surfaces, this is being looked into.

Dynamo License

Those portions created by Ian are provided with the following copyright:

Copyright 2014 Ian Keough

Those portions created by Autodesk employees are provided with the following copyright:

Copyright 2014 Autodesk

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

NUnit

http://www.nunit.org/

http://www.nunit.org/index.php?p=license&r=2.6.2

DynamoPack

This library makes use of the Nuclex Framework's CygonRectanglePacker.

Eclipse CPL