RenderContent Class

Determines if the content can be edited.

Category for this content.

If this content is in a document content list, the document will be returned. Otherwise null.

If this content is associated by a document in any way, the document will be returned. This includes copies of contents that were initially in the document. Otherwise null.

If this content is used by a document, including not in the content lists (for example, as a decal), the document will be returned. Otherwise null.

Rhino.Render.Fields FieldDictionary which provides access to setting and retrieving field values.

A string array of full paths to files used by the content that may be embedded in .3dm files and library files (.rmtl, .renv, .rtex). The default implementation returns an empty string list. Override this to return the file name or file names used by your content. This is typically used by textures that reference files containing the texture imagery.

Return First child of this content or nullptr if none.

Determines if the content has the hidden flag set.

Instance identifier for this content.

Checks if render content is default instance.

Set this property to true prior to adding content to the document to lock the content browser editing UI methods. Setting this to true will keep the browser from allowing things like deleting, renaming or changing content. This is useful for custom child content that you want to be editable but persistent. Setting this after adding content to the document will cause an exception to be thrown.

Instance name for this content.

Return First sibling of this content or nullptr if none.

Notes for this content.

Returns the top content in this parent/child chain.

Gets the proxy type of the render content

Render hash for the content hierarchy. It iterates children and includes a caching mechanism which means the hash value can be retrieved quickly if it hasn't changed. The cache is invalidated when Changed() is called. You can override the CalculateRenderHash(UInt64) method to provide a custom hash value.

Tags for this content.

Returns true if this content has no parent, false if it is the child of another content.

Returns the top content in this parent/child chain.

Description for your content type. ie. "Procedural checker pattern"

Type identifier for this content

Name for your content type. ie. "My .net Texture"

Add a new automatic user interface section, Field values which include prompts will be automatically added to this section.

Add a material, environment or texture to the internal RDK document lists as top level content. The content must have been returned from RenderContent::MakeCopy, NewContentFromType or a similar function that returns a non-document content.

Add a material, environment or texture to the internal RDK document lists as top level content. The content must have been returned from RenderContent::MakeCopy, NewContentFromType or a similar function that returns a non-document content.

Add a new .NET control to an content expandable tab section, the height of the createExpanded tabs client area will be the initial height of the specified control.

Begins a change or batch of changes. This returns a reference to the content which you should use to make your changes. It may also make a copy of the content state allowing EndChange to send an event with the old and new contents. Calls to this method are counted; you must call EndChange() once for every call to BeginChange(). Note: If Changed() was called between the calls to BeginChange() and EndChange(), the last call to EndChange() may cause the ContentChanged event to be sent.

Use bindings to automatically wire parameters to fields

Use bindings to automatically wire parameters to fields

Override this method to calculate the render hash of the state that affects how the content is rendered. Does not include children or perform any caching. Render hash values are now automatically cached by the content framework and you do not have to worry about caching. You also do not have to worry about iterating into children. This method is now only called internally by the framework, use the RenderHash property to get the current hash value.

Gets the amount property for the texture in the specified child slot. Values are typically from 0.0 - 100.0

A "child slot" is the specific "slot" that a child (usually a texture) occupies. This is generally the "use" of the child - in other words, the thing the child operates on. Some examples are "color", "transparency".

Gets the on-ness property for the texture in the specified child slot.

Constructs a new content of the specified type and add it to the persistent content list. This function cannot be used to create temporary content that you delete after use. Content created by this function is owned by RDK and appears in the content editor. To create a temporary content which is owned by you, call RenderContentType.NewContentFromType().

Constructs a new content of the specified type and add it to the persistent content list. This function cannot be used to create temporary content that you delete after use. Content created by this function is owned by RDK and appears in the content editor. To create a temporary content which is owned by you, call RenderContentType.NewContentFromType().

Constructs a new content of the specified type and add it to the persistent content list. This function cannot be used to create temporary content that you delete after use. Content created by this function is owned by RDK and appears in the content editor. To create a temporary content which is owned by you, call RenderContentType.NewContentFromType().

Constructs a new content of the specified type and add it to the persistent content list. This function cannot be used to create temporary content that you delete after use. Content created by this function is owned by RDK and appears in the content editor. To create a temporary content which is owned by you, call RenderContentType.NewContentFromType().

Releases all resources used by the RenderContent

Releases the unmanaged resources used by the RenderContent and optionally releases the managed resources

Ends a change or batch of changes. Calls to this method are counted; you must call this method once for every call to BeginChange(RenderContentChangeContexts). Note: If BeginChange(RenderContentChangeContexts) was called with ChangeContexts.UI, ChangeContexts.Program, ChangeContexts.Drop or ChangeContexts.UI.Tree and Changed() was called between the calls to BeginChange(RenderContentChangeContexts) and EndChange(), the last call to EndChange() will raise the ContentChanged event.

Search for a content object based on its Id

Extra requirements are a way of specifying extra functionality on parameters in the automatic UI. Implement this function to specify additional functionality for automatic UI sections or the texture summary. See IAutoUIExtraRequirements.h in the C++ RDK for string definitions for the parameter names.

Query the content instance for the value of a given named parameter. If you do not support this parameter, call the base class.

Override this method to restrict the type of acceptable child content. The default implementation of this method just returns true.

This method is deprecated and no longer called. For more information see CalculateRenderHash(UInt64)

Loads content from a library file. Does not add the content to the persistent content list. Use AddPersistantContent to add it to the list.

Create a copy of the render content. All content is the same, except for the instance Id.

Implement to transfer data from another content to this content during creation.

Gets the PreviewSceneServer of the content

Override to provide UI sections to display in the editor.

Override this method to prompt user for information necessary to create a new content object. For example, if you are created a textured material you may prompt the user for a bitmap file name prior to creating the textured material.

Call this method to open the content in the relevant thumbnail editor and select it for editing by the user. The content must be in the document or the call will fail.

Call this method to open the content in the a modal version of the editor. The content must be in the document or the call will fail.

A "child slot" is the specific "slot" that a child (usually a texture) occupies. This is generally the "use" of the child - in other words, the thing the child operates on. Some examples are "color", "transparency".

Call RegisterContent in your plug-in's OnLoad function in order to register all of the custom RenderContent classes in your assembly.

Call RegisterContent in your plug-in's OnLoad function in order to register all of the custom RenderContent classes in your assembly.

As RenderHash, but ignore parameter names given.

As RenderHash, but ignore parameter names given.

Set another content as a child of this content. This content may or may not be attached to a document. If this content already has a child with the specified child slot name, that child will be deleted. If this content is not attached to a document, the child will be added without sending any events. If this content is attached to a document, the necessary events will be sent to update the UI. Note: Do not call this method to add children in your constructor. If you want to add default children, you should override Initialize() and add them there.

Set another content as a child of this content. This content may or may not be attached to a document. If this content already has a child with the specified child slot name, that child will be deleted. If this content is not attached to a document, the child will be added without sending any events. If this content is attached to a document, the necessary events will be sent to update the UI. Note: Do not call this method to add children in your constructor. If you want to add default children, you should override Initialize() and add them there.

Sets the amount property for the texture in the specified child slot. Values are typically from 0.0 - 100.0

Sets the on-ness property for the texture in the specified child slot.

Extra requirements are a way of specifying extra functionality on parameters in the automatic UI. Implement this function to support values being set from automatic UI sections or the texture summary. See IAutoUIExtraRequirements.h in the C++ RDK for string definitions for the parameter names.

Set the named parameter value for this content instance. If you do not support this parameter, call the base class.

Set the named parameter value for this content instance. If you do not support this parameter, call the base class.

This method is deprecated and no longer called. For more information see CalculateRenderHash(UInt64)

Icon to display in the content browser, this bitmap needs to be valid for the life of this content object, the content object that returns the bitmap is responsible for disposing of the bitmap.

Used to monitor render content addition to the document.

Used to monitor render content modifications.

Used to monitor render content deletion from the document.

Used to monitor render content deletion from the document.

This event is raised when a field value is modified.

Used to monitor render content renaming in the document.

Used to monitor render content replacing in the document.

Used to monitor render content replacing in the document.

Used to monitor render content preview updates.