RenderPlugIn Class

Initializes a new instance of the RenderPlugIn class

Set to true if you would like Rhino to quickly create a basic render content in response to 'Create New' commands. Set to false if you would prefer Rhino to display the render content chooser dialog.

Override this property and return true if your plug-in supports decals and overrides ShowDecalProperties(ListNamedValue)

Default implementation returns true which means the content can be picked from the content browser by the user. Override this method and return false if you don't want to allow a certain content contentType to be picked from the content browser while your render engine is current.

Creates the preview bitmap that will appear in the content editor's thumbnail display when previewing materials and environments. If this function is not overridden or the PreviewImage is not set on the args, then the internal OpenGL renderer will generate a simulation of the content. This function is called with four different preview quality settings. The first quality level of RealtimeQuick is called on the main thread and needs to be drawn as fast as possible. This function is called with the other three quality settings on a separate thread and are meant for generating progressively refined preview.

Creates the preview bitmap that will appear in the content editor's thumbnail display when previewing textures in 2d (UV) mode. If this function is not overridden or the PreviewImage is not set on the args, then the internal OpenGL renderer will generate a simulation.

Called to enable/disable the "Material" button located on the "Material" tab in the Properties and Layer dialog boxes. The default return value is false which will disable the button. If the button is disabled then the OnAssignMaterial function is never called.

Called to enable/disable the "New" button located on the "Material" in the Properties and Layer dialog boxes. The default return value is false which will disable the button. If the button is disabled then the OnEditMaterial function is never called.

Called to enable/disable the "Edit" button located on the "Material" in the Properties and Layer dialog boxes. The default return value is false which will disable the button. If the button is disabled then the OnEditMaterial function is never called.

Initialize your custom decal properties here. The input list will be empty - add your default named property values and return.

This function is called by the Object Properties and Layer Control dialogs when the "Material" button is pressed in the "Render" tab. This is only called if EnableAssignMaterialButton returns true.

This function is called by the Object Properties and Layer Control dialogs when the "New" button is pressed in the "Material" tab. This is only called if EnableCreateMaterialButton returns true.

This function is called by the Object Properties and Layer Control dialogs when the "Edit" button is pressed in the "Material" tab. This is only called if EnableEditMaterialButton returns true. A return value of true means the material has been updated.

This plug-in (has become)/(is no longer) the current render plug-in

Tell what kind of preview rendering your renderer supports.

Override this method to add custom file types to the render window save file dialog.

Override this method and call RegisterPanel(PlugIn, RenderPanelType, Type, String, Boolean, Boolean) to add custom render UI to the render output window.

Override this method and call RegisterTab(PlugIn, Type, String, Icon) to add custom tabs to the render output window

Called by Render and RenderPreview commands if this plug-in is set as the default render engine.

Called by Rhino when it is time to register RenderContentSerializer derived classes. Override this method and return an array of an instance of each serialize custom content object you wish to add.

Override this method to replace the render properties page in the Rhino document properties dialog. The default implementation returns null which means just use the the default Rhino page.

Override this function to provide custom sections for the render settings panel that are displayed when your plug-in is the current render plug-in.

Override this method to provide the UUIDs of all sections that should be displayed in the Render Settings tab when this is the current renderer.The default implementation adds all the RDK's built-in Render Settings sections. These UUIDs start with the prefix uuidRenderSettingsSection'. They can be found in RhRdkUuids.h

This function is obsolete and only exists for legacy purposes. Do not override this function - prefer overriding the version with the blowup parameter.

Override this function to handle showing a modal dialog with your plugin's custom decal properties. You will be passed the current properties for the object being edited. The defaults will be set in InitializeDecalProperties.

Override this function to provide custom sections for the sun panel that are displayed when your plug-in is the current render plug-in.

Returns a list of output types which your renderer can write.

The default implementation returns bmp, jpg, png, tif, tga.

Determines if your renderer supports a specific feature.

Override this method to provide the UUIDs of all content types that should be presented to the user in the types combo box or the[+] button types menu.The default implementation adds only RDK's built-in types. Rhino automatically adds types in the most efficient way to minimize the list length. If you override this method, you may call the base class first to add the built-in types, a separator will be inserted at the end of the standard list followed by your own types. You may omit the base class call and only chosen types yourself, followed by a separator and your own types. A 'More Types...' item is automatically added when needed by Rhino. Specify a separator by adding uuidUiContentType_Separator.