Automatic UI

This document describes how to use the RDK's automatic UI classes in C/C++.

Introduction

The RDK provides a user interface that integrates into Rhino’s docking panel system and separates different areas by using collapsible sections, or roll-ups. There are several areas where these sections appear; in the render content UI, in the Rendering panel, and in the Sun panel. Each of these areas allows the plug-in developer to add customized sections. Creating these sections can take a lot of work, especially when using MFC on Windows. Sometimes it’s convenient, especially when prototyping, to be able to just see and edit a collection of values quickly. The RDK provides an automatic UI system for just that purpose. There are two ways to use this system. The raw automatic UI provides access to the entire system and allows control of almost every aspect of the interface. The Content Automatic UI uses the raw system internally to expose a much simpler interface suitable for quickly developing UIs for render contents. The latter is described in detail in the discussion of render contents. The former, a more complicated interface, is described here.

Getting started

Using the automatic UI at this level requires you to provide a data source that is capable of converting your data items to a form the automatic UI can understand. This form is called a param block and uses the IRhRdkParamBlock interface. The data source must respond to GetData(uuidData_RdkParamBlock) and populate a param block object which is returned as a pointer to IRhRdkParamBlock.

TODO: finish this

Summary