algorithmic modeling for Rhino



Turtle is a open-source library containing a definition of an ngon face-vertex mesh. This is most probably the most basic mesh representation, and it is the same as the one used by Rhino, with the exception that this representation fully supports ngons, or faces with an arbitrary number of sides.

This is distributed for free under the terms of the GNU Lesser Public License (the repository can be found here). The source code is on Github, already there for you to download. This addon automatically converts Rhino meshes and closed polygons, and possibilities to Join and Explode meshes are available.

It can be used without any need to know programming.

To fully support ngon meshes, serialization is readily available, yey! It loads and saves vertices and faces in the very-interoperable .obj file format. Right now only vertices and faces are stored, but in the future also vertex and face normals will be stored, and more. TurtleMeshes can be already "internalized" in Gh files, making them simple to use and exchange.

Preview works directly and users can see their ngon mesh as though they were native.

The goal of this library is to be as open as possible, and be as interchangeable as possible. It uses interfaces all the time, so you can write your own implementation and even leverage the custom parameter functionality for storage and preview. It will also be made compatible with the next coming version of Weavebird and I hope MeshEdit, KangarooKaramba, Starling, and hopefully any further add-on using meshes will follow (if your addon is not here, just please let me know). When source code will be available, I will make it compatible also with Plankton and any other mesh representation that should come up. :)

I want to thank the community of Rhino and Grasshopper users for the continued support, and in particular, Kristoffer Josefsson, Harri Lewis, Daniel Piker, David Rutten, Dave Stasiuk and Mateusz Zwierzycki.

Members: 285
Latest Activity: Sep 8, 2023

Discussion Forum

ngon panelling to extruded solids

Hi, I want to transform any panel extrusions to solids and group them according to their volume or id. However, extruded planes on given surface are seperated and I do not know how to combine them in…Continue

Started by h Mar 21, 2019.

Python Closed Polylines to Turtle to Plankton 3 Replies

Hi Pac,I'd like to use Python with Turtle.dll and Plankton.dll. Could you please explain how to get to a plankton mesh from a selection of closed polylines. I realize it's not much, but this is what…Continue

Tags: Polylines, Plankton, Turtle

Started by Marko Tomicic. Last reply by Marko Tomicic Jul 8, 2015.

confusion 1 Reply

Hi Piac,I'm not quite familiar with this component and could you please explain a little bit? Thank you very much...Continue

Started by Jim. Last reply by Giulio Piacentino May 21, 2014.

Second release of Turtle 7 Replies

Hi all,This is the second release of Turtle, v1.2Here is the list of enhancements:-…Continue

Tags: library, obj, mesh, ngon, second

Started by Giulio Piacentino. Last reply by Will Pearson Aug 6, 2013.

Comment Wall


You need to be a member of Turtle to add comments!

Comment by Ethan Gross on June 29, 2015 at 2:17pm

Giulio, this appears when I open GH:

 Message: Could not load file or assembly 'Turtle, Version=, Culture=neutral, PublicKeyToken=1591915af8a60d0e' or one of its dependencies. The system cannot find the file specified.

I hope this means something to you.

Comment by Ethan Gross on June 29, 2015 at 11:46am

Hi Giulio,

I've downloaded Turtle v2 and have installed the assembly and dll in the components library. I've also unblocked them, but nothing appears on my toolbar after bringing Rhino and GH back up. What am I missing?



Comment by Giulio Piacentino on August 1, 2013 at 6:19am

Hi Remy

this plugin is open for everybody to contribute, and its copyright is even attributed to whoever publishes into it! Please feel free to add this feature if you want.

Here is one way to do what you would want, with a cluster, otherwise, feel free to add a new component to Turtle to do this!

Download (this is a link to a discussion)

Comment by Rémy Maurcot on August 1, 2013 at 4:48am

Hi Giulio,

Your plugin is very interesting.

It is possible to add an update with Compoment "To Obj Text", or a parameter for file of path.

Also, it would be interesting to generate a obj file each parameter change.

T: Represent a list of 3D ngonal meshes

P: File of path

B: boolean for update or copy

What do you think?

Comment by Giulio Piacentino on July 20, 2013 at 2:39pm

A new release of Turtle with better ngon support is now available!

Mateusz and a couple other people suggested some bugfixes and features, and I've implemented the ones that were directly fitting or had larger impact on usage of the library. This contains also the Open... and Save... as double-click feature and the support for bounding box, morphing, and transforms.



Comment by Christian Schmidts on July 12, 2013 at 3:39pm

thank you giulio, your the mesh master!

Comment by Rafat Ahmed on July 7, 2013 at 12:18pm

Great work, with the best for you piac

Comment by Javier Ruiz on July 7, 2013 at 12:14pm

Great! thanks a lot!!


Members (285)






  • Add Videos
  • View All

© 2024   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service