BH.UI: Expose your code to User Interfaces
For an user perspective on the UIs, you might be looking for Getting started for visual programmers.
The UI layer has been designed so that it will automatically pick everything implemented in the BHoM, the Engines and the Adapters without the need to change anything on the code of the UI.
Here's what the menu looks like in Grasshopper. The number of component there doesn't have to change when more functionality is added to the rest of the code:
When dropped on the cavas, most of those components will have no input and no output. They will be converted to their final form once you have selected what they need to be in their menu:
You can get more information on how to use one of the BHoM UI on this page.
Automatic rendering of a
BHoMObjects are rich objects, which may or may not contain a geometry representation.
If a geometry representation can be extracted, either from one of its properties, or as a result of their manipulation, it can be used to automatically render the object in the GUIs. The only action to enable that, is to create a
Query.Geometry method, whose only parameter is the object you want to display, and place it in the
Engine namespace that corresponds to the
oM of the object. The method has to return an
IGeometry or one of its assignable types.
For example, let's assume I want to automatically display a
BH.oM.Structure.Elements.Bar. I'd do as follows:
- Go into the correspondent Engine - i.e.
- Go into the
Queryfolder - i.e.
- If it does not exist yet, create a
- Add an extension method name
Geometry, whose only parameter is the object you want to display:
Creating a new UI
Most of the functionality required by every UI has already been ported to the BHoM_UI repository or to the Engine (when used in more than the UIs). This makes the creation of a new UI a lot less cumbersome but this is still by no mean a small task. I would recommend to reach out to those that have already worked on UI (check the contributors of those repos) before you start writing a new UI from scratch.