Rhinoceros Interface Plugin¶
Embedded Material Editor in Rhino 5¶

Adding a new material in Rhino¶
To facilitate the export of a Rhinoceros scene to Ocean, it is possible to create, edit and assign Ocean materials within Rhinoceros.
In Rhinoceros 5, the creation of a custom material is done via the Materials Panel. First open it up (Render Tools Toolbar > Toggle Materials Panel).
Clicking on the plus button opens a dialog prompting you for a file to serve as template.

The ocean material is not listed here …¶
The dialog prompts you to create a material from various templates, but it will only create a Rhinoceros “basic” material. To create an Ocean material, you need to use the “More Types” button on the right of the dialog window.

… But there¶
It should provide you with the option to create a few kinds of materials. The plugin adds the OceanMaterial type to this list.
Finally choose to create an OceanMaterial

The embedded Ocean material editor¶
After selecting the OceanMaterial, the Material Panel should be displaying your new material and a familiar view to edit its parameters.
Indeed, the same Ocean node structure edition panel has been used in Rhinoceros. You can edit materials almost the same way you would through the Ocean user interface.
The nodes displayed here can be copied to and pasted from the clipboard, allowing the user to copy nodes in Ocean to Rhinoceros and vice-versa.

Surface lightmap editor¶
A lightmap can be associated with any ocean material, by checking the “Assign Lightmap” option.
On export, it will create a lightmap targetting the associated material.
The user can also set various parameters for the lightmap inside Rhino.
Environment Editor¶

The embedded Ocean environment editor¶
Like for the materials, it is possible to create and edit ocean environments in Rhino
Light Editor¶

A light using Ocean data¶
Lights can be customized with ocean parameters.
When a light is selected, a panel is added in the properties tab of the object.
Clicking “Use Ocean Light” brings ocean specific parameters that can be edited.

Light color preview in the Rhino viewport¶
The spectrum and emitter parameters influence the preview window with approximate colors and intensities

A directional light with ocean light data¶
If the selected light is directional, there won’t be any “emitter” parameters ; only spectrum.
This is because the exported object will be an Ocean “Disc” environment

IES “shape” preview in Rhino viewport¶
It is possible to specify IES data when the light type is SpotLight.
In the preview window, a mesh is drawn around the light approximately representing the intensity of the IES in spherical coordinates.
Material Irradiance Groups¶

All those spheres are now in the “Group0” material irradiance group¶
Material Irradiance instrument can be created by targetting multiple objects.
When one or multiple objects are selected, an Ocean object properties panel is added to the Properties tab. For now, the only option available is to attach the object to a material irradiance group.
Applying a group name to the current selection will create a Material Irradiance Instrument with clones of the material assigned to each object.
All the group names created in the document are stored so the user can quickly add an object to a group by selecting it instead of typing it.
Sensor Array¶

AddSensorArray button¶
Grids of material irradiance instruments can be created easily using the “OceanAddSensorArray” command.

First, draw a rect in the viewport …¶
When launching the command (either typing it or clicking the button) the user needs to draw the grid area in which to place sensors.

… then provide parameters in the command line interface¶
The command provides options to specify
The number of sensors in rows and columns
A relative padding between sensors
The name of the sensor group (it has to be typed in the command line interface)