Rhino Developer Samples

rhino3dm is a set of libraries based on the OpenNURBS geometry library that follows a "RhinoCommon" style. It allows developers to access and manipulate geometry independently of the Rhino application using .NET, Python, or JavaScript.

Core Functionality:

• Geometry Manipulation: Create, interrogate, and store geometry types including points, point clouds, NURBS curves/surfaces, polysurfaces (B-Reps), meshes, annotations, extrusions, and SubDs.
• Non-Geometry Data: Work with layers, object attributes, transforms, and viewports.
• File I/O: Read and write .3dm files.
• Rhino Compute Integration: Act as a client to make calls to the Rhino Compute cloud server for advanced geometry manipulation.
• Cross-Platform: Supported on Windows, macOS, and Linux.

Rhino.Compute provides a stateless REST API running on Windows Servers that allows you to access the Rhino and Grasshopper SDKs. This enables developers to create and manipulate 2D and 3D curves, surfaces, and solids within online solutions or cloud-based frameworks.

These samples demonstrate how to perform various geometric operations by calling the Rhino.Compute API using different programming languages.

Rhino.Inside® technology enables embedding Rhino and Grasshopper directly within other 64-bit Windows applications. This allows developers to:

• Start Rhino and Grasshopper as an add-in within a host product.
• Call the host's native APIs directly from a Grasshopper or Rhino plugin.
• Access Rhino's APIs through the host application.
• Open and preview Grasshopper definitions in Rhino within the same process as the parent application.
• Natively create Rhino or Grasshopper objects within the parent product.

The repository contains the following sample project:

• HelloRhinoMobile: A sample application that demonstrates how to open a .3dm file, draw it to the screen, and manipulate the view using gestures.

The lines.py sample demonstrates how to use Rhino.Compute to solve a Grasshopper graph. The workflow involves:

1. Creating a curve (a circle) using the rhino3dm library.
2. Providing an angle of rotation as an input to the Grasshopper graph.
3. Using Rhino.Compute to solve the graph.
4. Writing the resulting list of lines to a .3dm file.

python lines.py

In Rhino 6 and subsequent versions, deriving classes from CRhinoDisplayPipeline is discouraged. Instead, follow these modern patterns for display customization:

1. Use Conduits: For general customization of the display process, implement conduits.
2. Use Realtime Rendering: To display real-time rendering results in the viewport without managing the complexities of the display pipeline, use the RhRdk::Realtime::DisplayMode class.

The JavaScript applications rely on specific .NET library projects to bridge the gap between JavaScript runtimes and Rhino:

• RhinoMethods: Exposes simple methods to start Rhino and perform basic geometry operations (e.g., creating a sphere). Used in Node.js and standard Electron samples.
• RhinoTaskManager: Provides a task scheduler to manage complex tasks to be run by Rhino. Used in Electron + Grasshopper and CEF samples.

To build the SampleSharedXform solution, ensure you have the following prerequisites installed:

• Rhino 6
• Rhino 6 C/C++ SDK
• Microsoft Visual C++ 2017
• Microsoft Visual C# 2017

The Python samples demonstrate integrating Rhino.Compute with Python-based workflows:

• SampleTkinter: Uses rhino3dm to create a BREP from a sphere, sends it to Compute to generate a mesh, and visualizes the resulting mesh using Python's built-in Tkinter GUI framework.

RhinoMobileSamples provides C#-based samples for developing mobile applications using Xamarin's iOS and Android twins.

To begin developing with RhinoMobile, refer to the official developer documentation for comprehensive guides and setup instructions: http://developer.rhino3d.com/guides/rhinomobile/