RenderContent

References
public abstract class RenderContent : IDisposable
Base class for all RenderContent - RenderMaterial, RenderTexture and RenderEnvironment Contents have a unique type id which is the same for all instances of the same class and an instance id which is unique for each instance.They know how to provide a shader for rendering, how to read and write their state as XML and how to create their own user interfaces. There are two flavors of content in the RDK -- temporary and persistent.It is very important to understand the distinction between a temporary content instance and a persistent content instance, and the fact that a temporary instance (and all its children) can become persistent.Persistent content is registered with a document and is usually(but not always) owned by it. Temporary contents get created and deleted very often during the normal operation of the RDK.In fact, just about anything the user clicks on might result in a temporary content being created and deleted again.They are created by the content browser, the thumbnail rendering, and so on.They are 'free floating' and are owned by whomever created them.They do not appear in the modeless UI, they do not get saved in the 3dm file, and they can freely be deleted again after use. Contrast this with persistent contents which are attached to a document.They are always owned by RDK, appear in the modeless UI and get saved in the 3dm file. Pointers to persistent contents should never be stored by clients; you should only store their instance ids and look them up again using RenderContent.FromId. They can be deleted only after detaching them from the document. RenderContent::Create is the highest-level function for creating a content.It creates it, initializes it, adds it to the document and sends many events.It even records undo.You cannot call this method from just anywhere. It must only be called by 'UI code'; scripts or buttons on a dialog.It results in a persistent (usually top-level) content being attached to the document and appearing in all the RDK UI elements that display contents, like the thumbnail and tree views.If you call this method and specify a parent and child-slot name, your new content will be attached to the document-resident parent as a child and the UI will be updated accordingly. The important point is that everything is temporary while the content structure is being built. Only after the whole structure is complete will the top-level parent be attached to the document making the whole structure persistent.

Finalizer

~RenderContent

#
Finalizer
~RenderContent()

Properties

CanBeEdited

#Since v6.0
Determines if the content can be edited.
public bool CanBeEdited { get; }

Category

#Since v6.7
Category for this content.
public string Category { get; }

ChildSlotDisplayName

#Since v7.0
Returns the localized display name of the child slot name
public string ChildSlotDisplayName { get; }

ChildSlotName

#Since v5.1
public string ChildSlotName { get; set; }

CppPointer

#Since v6.0
public nint CppPointer { get; }

DisplayName

#Since v7.8
Display name for this content.
public string DisplayName { get; }

Document

#Since v5.10
Obsolete. Do not use. You should use DocumentOwner instead.
public RhinoDoc Document { get; }
obsoleteUse DocumentOwner

DocumentAssoc

#Since v6.0
If this render content is associated with a document in any way, the document will be returned. This includes copies of render contents that were attached to a document when the copy was made. Otherwise returns null.
public RhinoDoc DocumentAssoc { get; set; }

DocumentOwner

#Since v7.13
If this render content is owned by a document, the document will be returned. This is the same as getting the document the render content is attached to. Otherwise returns null.
public RhinoDoc DocumentOwner { get; }

DocumentRegistered

#Since v6.0
Obsolete. Do not use. You should use DocumentOwner instead.
public RhinoDoc DocumentRegistered { get; }
obsoleteUse DocumentOwner

Fields

#Since v5.1
Rhino.Render.Fields FieldDictionary which provides access to setting and retrieving field values.
public FieldDictionary Fields { get; }

Filename

#Since v7.4
If the content is file based, this function can be overridden to deal with setting/getting the filename. Corresponds to IRhRdkFileBasedContent in the C++ SDK
public virtual string Filename { get; set; }

FilesToEmbed

#Since v5.12
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.
public virtual IEnumerable<string> FilesToEmbed { get; }

FirstChild

#Since v6.0
Return First child of this content or null if none.
public RenderContent FirstChild { get; }

GroupId

#Since v6.26
Group ID of the content
public Guid GroupId { get; set; }

Hidden

#Since v5.1
Gets or sets the render content's 'hidden' state. This feature only works for top-level render contents because it hides the entire hierarchy. It is normally used for 'implementation detail' render contents. For expert use only. Hidden render contents are never shown in the UI, with the exception of the Object (or Layer) Material Properties UI which always shows whatever is assigned to the object (or layer). In the Object (or Layer) Material Properties UI, if the user drops down the list, hidden render contents are not listed. Hidden render contents, being part of the document content list, will be listed by any scripts or other code that iterates over the document render content list. It is recommended that you set IsHidden once when you create your render content and leave it on to prevent flicker or slow performance.
public bool Hidden { get; set; }

Id

#Since v5.1
Instance identifier for this content.
public Guid Id { get; set; }

IsDefaultInstance

#Since v6.0
Checks if render content is default instance.
public bool IsDefaultInstance { get; }

IsHiddenByAutoDelete

#Since v6.15
Contents can be created as 'auto-delete' by certain commands such as 'Picture'. These contents are automatically hidden from the user when the associated Rhino object is deleted. They are later deleted when the document is saved.
public bool IsHiddenByAutoDelete { get; }

IsLocked

#Since v5.12
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.
public bool IsLocked { get; set; }
ExceptionIsLocked must be called prior to adding content to the document

ModelUnits

#Since v9.0
Units used by this instance on length fields.
public LengthUnit ModelUnits { get; }

Name

#Since v5.1
Instance 'raw' name for this content.
public string Name { get; set; }

NextSibling

#Since v6.0
Return First sibling of this content or null if none.
public RenderContent NextSibling { get; }

Notes

#Since v5.1
Notes for this content.
public string Notes { get; set; }

Parent

#Since v5.11
Returns the top content in this parent/child chain.
public RenderContent Parent { get; }

Private

#Since v9.0
The Content type should not be shown in the UI if Private is true
public bool Private { get; }

ProxyType

#Since v6.0
Gets the proxy type of the render content
public ProxyTypes ProxyType { get; }

RenderHash

#Since v6.0
Render hash for the content hierarchy. It iterates over 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(ulong) method to provide a custom hash value.
[CLSCompliant(false)] public uint RenderHash { get; }

Styles

#Since v7.5
public RenderContentStyles Styles { get; }

Tags

#Since v6.4
Tags for this content.
public string Tags { get; set; }

TopLevel

#Since v5.1
Returns true if this content has no parent, false if it is the child of another content.
public bool TopLevel { get; }

TopLevelParent

#Since v5.1
Returns the top content in this parent/child chain.
public RenderContent TopLevelParent { get; }

TypeDescription

#Since v5.1
Description for your content type. i.e., "Procedural checker pattern"
public abstract string TypeDescription { get; }

TypeId

#Since v6.0
Type identifier for this content
public Guid TypeId { get; }

TypeName

#Since v5.1
Name for your content type. i.e., "My .net Texture"
public abstract string TypeName { get; }

Xml

#Since v6.0
public string Xml { get; }

Methods

AddAutomaticUserInterfaceSection

#Since v5.1
Add a new automatic user interface section, Field values which include prompts will be automatically added to this section.
public bool AddAutomaticUserInterfaceSection(
caption,
Expandable tab caption.
id
Tab id which may be used later on to reference this tab.
)
Returns true if the automatic tab section was added otherwise; returns false on error.

AddChild

#Since v6.0 Obsolete v6.0
public bool AddChild(
renderContent,
childSlotName
)
obsoleteThis method is obsolete and simply calls SetChild

AddChild

#Since v5.6 Obsolete v6.0
public bool AddChild(
renderContent
)
obsoleteThis method is obsolete and simply calls SetChild

AddPersistentRenderContent

#Since v5.1 Obsolete v6.0
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. Obsolete - use RhinoDoc.RenderMaterials.Add or similar.
public static bool AddPersistentRenderContent(
renderContent
The render content.
)
obsoleteUse RhinoDoc.RenderMaterials.Add
true on success.

AddPersistentRenderContent

#Since v6.0 Obsolete v6.0
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. Obsolete - use RhinoDoc.RenderMaterials.Add or similar.
public static bool AddPersistentRenderContent(
document,
The document to attach the render content to.
renderContent
The render content.
)
obsoleteUse RhinoDoc.RenderMaterials.Add
true on success.

AddUserInterfaceSection

#Since v6.0
public bool AddUserInterfaceSection()

AddUserInterfaceSection

#Since v5.1 Obsolete v6.0
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.
public UserInterfaceSection AddUserInterfaceSection(
classType,
The control class to create and embed as a child window in the expandable tab client area. This class type must be derived from IWin32Window or this method will throw an ArgumentException. Implement the IUserInterfaceSection interface in your classType to get UserInterfaceSection notification.
caption,
Expandable tab caption.
createExpanded,
If this value is true then the new expandable tab section will initially be expanded, if it is false it will be collapsed.
createVisible
If this value is true then the new expandable tab section will initially be visible, if it is false it will be hidden.
)
obsoleteUse AddUserInterfaceSection(Rhino.UI.Controls.ICollapsibleSection) below instead. This function will not work on the Mac and is not type-safe.
Returns the UserInterfaceSection object used to manage the new user control object.

BeginChange

#Since v6.0
Begins a change or batch of 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.
public void BeginChange(
changeContext
the change context. If this is ChangeContexts.UI, ChangeContexts.Program,ChangeContexts.Drop or ChangeContexts.Tree, the content will be copied. EndChange() will then send the copy as 'old' in the OnContentChanged event. EndChange() ContentChanged
)

BeginCreateDynamicFields

#Since v7.1
Automatic Dynamic Field support. Dynamic fields are typically created in the constructor of RenderContent and they are therefore created automatically whenever the content is created. However, some advanced users require the fields to be created in response to some user action which occurs much later. This creates the problem that the fields do not exist by default and therefore cannot be loaded when the document is loaded. These methods are provided to solve that problem by making it possible to automatically create the dynamic fields on loading if they don't already exist. Dynamic fields that have this auto-create-on-load behavior are referred to as automatic dynamic fields. Dynamic fields that do not require the advanced automatic feature can still be created by using these methods (recommended), or they can be created manually (legacy usage). You must call this before creating any dynamic fields. Calls to this method are counted; you must call EndCreateDynamicFields() once for every call to BeginCreateDynamicFields().
public void BeginCreateDynamicFields(
automatic
automatic specifies if the dynamic fields are automatic. If so, they will be created automatically during loading of the document.
)

BindParameterToField

#Since v5.7
Use bindings to automatically wire parameters to fields
public void BindParameterToField(
parameterName,
Field
field,
setEvent
)

BindParameterToField

#Since v5.7
Use bindings to automatically wire parameters to fields
public void BindParameterToField(
parameterName,
childSlotName,
Field
field,
setEvent
)

CalculateRenderHash

#
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.
[CLSCompliant(false)] protected virtual uint CalculateRenderHash(
rcrcFlags
)
obsoleteUse CalculateRenderHash2

CalculateRenderHash2

#
[CLSCompliant(false)] protected virtual uint CalculateRenderHash2(
flags,
excludeParameterNames
)

ChangeChild

#Since v5.6 Obsolete v6.0
public bool ChangeChild(
oldContent,
newContent
)
obsoleteThis method is obsolete and simply calls SetChild

ChildSlotAmount

#Since v5.7
Gets the amount property for the texture in the specified child slot.
public double ChildSlotAmount(
childSlotName
The child slot name of the texture.
)
The requested amount value. Values are typically from 0.0 to 100.0

ChildSlotNameFromParamName

#Since v5.1
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".
public string ChildSlotNameFromParamName(
paramName
The name of a parameter field. Since child textures will usually correspond with some parameter (they generally either replace or modify a parameter over UV space) these functions are used to specify which parameter corresponded with child slot. If there is no correspondence, return the empty string.
)
The default behavior for these functions is to return the input string. Sub-classes may (in the future) override these functions to provide different mappings.

ChildSlotOn

#Since v5.7
Gets the on-ness property for the texture in the specified child slot.
public bool ChildSlotOn(
childSlotName
The child slot name of the texture.
)
true if successful, else false.

ConvertUnits

#Since v9.0
Modify your content so that it is converted from meters into the units of the unit system. No need to call the base class when you override this, and no need to recurse into children.
public virtual void ConvertUnits()

ConvertUnits

#Since v7.0 Obsolete v9.0
Modify your content so that it is converted from meters into the units of the unit system. No need to call the base class when you override this, and no need to recurse into children.
[EditorBrowsable(EditorBrowsableState.Never)] public virtual void ConvertUnits()
obsolete. Use ConvertUnits with LengthUnit instead, and don't override this virtual function

Create

#Since v5.1 Obsolete v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
type,
The type of the content to create.
parent,
Parent is the parent content. If not null, this must be an RDK-owned content that is attached to the document (either top-level or child). The new content then becomes its child. If null, the new content is added to the top-level document content list instead.
childSlotName,
ChildSlotName is the unique child identifier to use for the new content when creating it as a child of parent (i.e., when parent is not null)
flags,
Flags for future use (please always pass ShowContentChooserFlags::None).
doc
The Rhino document to attach the new render content to.
)
A new document-resident render content.

Create

#Since v5.1 Obsolete v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
type,
The type of the content to create.
flags,
Flags for future use (please always pass ShowContentChooserFlags::None).
doc
The Rhino document to attach the new render content to.
)
A new document-resident render content.

Create

#Since v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
doc,
The Rhino document to attach the new render content to.
type,
The type of the content to create.
parent,
Parent is the parent content. If not null, this must be an RDK-owned content that is attached to the document (either top-level or child). The new content then becomes its child. If null, the new content is added to the top-level document content list instead.
childSlotName
ChildSlotName is the unique child identifier to use for the new content when creating it as a child of parent (i.e., when parent is not null)
)
A new document-resident render content.

Create

#Since v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
doc,
The Rhino document to attach the new render content to.
type
The type of the content to create.
)
A new document-resident render content.

Create

#Since v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
doc,
The Rhino document to attach the new render content to.
type,
The type of the content to create.
parent,
The parent content. If not null, this must be an RDK-owned content that is attached to the document (either top-level or child). The new content then becomes its child. If null, the new content is added to the top-level document content list instead.
childSlotName
ChildSlotName is the unique child identifier to use for the new content when creating it as a child of parent (i.e., when parent is not null)
)
A new document-resident render content.

Create

#Since v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
doc,
The Rhino document to attach the new render content to.
type
The type of the content to create.
)
A new document-resident render content.

Create

#Since v5.1 Obsolete v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
type,
The type of the content to create.
parent,
The parent content. If not null, this must be an RDK-owned content that is attached to the document (either top-level or child). The new content then becomes its child. If null, the new content is added to the top-level document content list instead.
childSlotName,
ChildSlotName is the unique child identifier to use for the new content when creating it as a child of parent (i.e., when parent is not null)
flags,
Flags for future use (please always pass ShowContentChooserFlags::None).
doc
The Rhino document to attach the new render content to.
)
A new document-resident render content.

Create

#Since v5.1 Obsolete v7.9
Constructs a new content of the specified type and attaches it to a document. 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.NewContentFromTypeId().
public static RenderContent Create(
type,
The type of the content to create.
flags,
Flags for future use (please always pass ShowContentChooserFlags::None).
doc
The Rhino document to attach the new render content to.
)
A new document-resident render content.

CreateDynamicField

#Since v7.1
Create a dynamic field with an initial value and min and max limits.
public bool CreateDynamicField(
internalName,
is the internal name of the field. Not localized.
localName,
is the localized user-friendly name of the field.
englishName,
is the English user-friendly name of the field.
value,
is the initial value of the field.
minValue,
is the minimum value of the field. Must be the same type as vValue.
maxValue,
is the maximum value of the field. Must be the same type as vValue.
sectionId
is used for filtering fields between sections. Zero if not needed.
)

DeleteAllChildren

#Since v5.10
public void DeleteAllChildren(
changeContexts
)

DeleteChild

#Since v5.10
public bool DeleteChild(
childSlotName,
changeContexts
)

Dispose

#Since v5.1
public void Dispose()

Dispose

#
Dispose
protected virtual void Dispose(
disposing
)

DynamicIcon

#Since v6.0
public virtual bool DynamicIcon(
size,
out Bitmap
bitmap,
usage
)

Edit

#Since v6.13
This method allows a render content hierarchy to be edited using a modal (AKA 'pop-up') editor. If the original render content is in a document, it will remain there, and the edited one will be 'free-floating'. Therefore it is the caller's responsibility to do any replacement in the document if required. The returned new content will be owned by the caller.
public RenderContent Edit()
Returns an edited version of the content hierarchy if successful, else null. The method always edits the entire hierarchy. It places a copy of the hierarchy in the editor and selects the copied item that corresponds to this one. Therefore, editing a child will return a top-level render content, not a child.

EndChange

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

EndCreateDynamicFields

#Since v7.1
You must call this after creating dynamic fields. Calls to this method are counted; you must call BeginCreateDynamicFields() once for every call to EndCreateDynamicFields().
public void EndCreateDynamicFields()

Factory

#Since v6.10
public ContentFactory Factory()

FindChild

#Since v5.1
public RenderContent FindChild(
childSlotName
)

ForDisplay

#Since v6.9
**** This method is for proxies and will be marked obsolete in the future **** The only place a single proxy can be displayed is in the New Content Control main thumbnail. All other attempts to use a single proxy in a UI require it to be replaced with the corresponding multi proxy. Single proxies override this to find the corresponding multi proxy.
public RenderContent ForDisplay()
The render content.

FromId

#Since v5.7
Search for a content object based on its Id
public static RenderContent FromId(
document,
The Rhino document containing the content.
id
Id of the content instance to search for.
)
Returns the content object with the specified Id if it is found otherwise it returns null.

FromXml

#Since v6.4
Creates a new content from the XML data. The resulting content will not be attached to the document.
public static RenderContent FromXml(
xml,
The input XML data.
doc
The document that the content will be associated with for units, linear workflow purposes.
)

FromXml

#Since v6.0 Obsolete v6.4
public static RenderContent FromXml(
xml
)
obsoleteUse other FromXml method

GenerateQuickContentPreview

#Since v8.16
Generate a quick render content preview
public static Bitmap GenerateQuickContentPreview(
lw,
Linear workflow
c,
Render Content
width,
Image width
height,
Image height
psc,
PreviewSceneServer
bSuppressLocalMapping,
SuppressLocalMapping
reason,
ContentChanged = 0, ViewChanged = 1, RefreshDisplay = 2, Other = 99
ref Result
result
Rhino.Command.Result value for successfull quick image creation
)
The Bitmap of the quick render content preview

GenerateQuickContentPreview

#Since v8.9
Generate a quick render content preview
public static Bitmap GenerateQuickContentPreview(
c,
Render Content
width,
Image width
height,
Image height
psc,
PreviewSceneServer
bSuppressLocalMapping,
SuppressLocalMapping
reason,
ContentChanged = 0, ViewChanged = 1, RefreshDisplay = 2, Other = 99
ref Result
result
Rhino.Command.Result value for successfull quick image creation
)
The Bitmap of the quick render content preview

GenerateRenderContentPreview

#Since v8.9
Generate a render content preview
public static Bitmap GenerateRenderContentPreview(
lwf,
Linear Workflow
c,
Render Content
width,
Image width
height,
Image height
bSuppressLocalMapping,
Suppress Local Mapping
pjs,
Preivew Job Signature
pa,
Preivew Appearance
result
Reference to PreviewRenderResult value
)
The Bitmap of the render content preview

GetChildSlotParameter

#Since v5.7
Extra requirements are a way of specifying extra functionality on parameters in the automatic UI. Override this function to specify additional functionality for automatic UI sections or the texture summary. See IAutoUIExtraRequirements.h in the C++ RDK SDK for string definitions for the parameter names. Call the base class from your override if you do not support the extra requirement parameter. Please do not call this function. It is only retained for backward compatibility. You should instead call GetExtraRequirementParameter().
public virtual object GetChildSlotParameter(
contentParameterName,
The parameter or field internal name to which this query applies.
extraRequirementParameter
The extra requirement parameter, as listed in IAutoUIExtraRequirements.h in the C++ RDK SDK.
)
The value of the requested extra requirement parameter or null if the parameter does not exist. Current supported return values are (int, bool, float, double, string, Guid, Color, Vector3d, Point3d, DateTime).

GetEmbeddedFilesList

#Since v6.0
public string[] GetEmbeddedFilesList()

GetExtraRequirementParameter

#Since v7.9
Extra requirements are a way of specifying extra functionality on parameters in the automatic UI. See IAutoUIExtraRequirements.h in the C++ RDK SDK for string definitions for the parameter names.
public object GetExtraRequirementParameter(
contentParameterName,
The parameter or field internal name to which this query applies.
extraRequirementParameter
The extra requirement parameter, as listed in IAutoUIExtraRequirements.h in the C++ RDK SDK.
)
The value of the requested extra requirement parameter or null if the parameter does not exist. Current supported return values are (int, bool, float, double, string, Guid, Color, Vector3d, Point3d, DateTime).

GetParameter

#Since v5.7
Query the content instance for the value of a given named parameter. If you do not support this parameter, call the base class.
[CLSCompliant(false)] public virtual object GetParameter(
parameterName
Name of the parameter
)
IConvertible. Note that you can't directly cast from object, instead you have to use the Convert mechanism.

GetUiHash

#Since v7.1
This allows a content to have more than one UI for the same content type.
[CLSCompliant(false)] public virtual ulong GetUiHash()
Default is zero and is ignored.

GetUnderlyingInstances

#Since v7.0
public bool GetUnderlyingInstances()

Icon

#Since v6.0
public virtual bool Icon(
size,
out Bitmap
bitmap
)

Initialize

#Since v6.1 Obsolete v7.2
public bool Initialize()
obsoleteThis method should not be called.

IsCompatible

#Since v6.0
public virtual bool IsCompatible(
renderEngineId
)

IsContentTypeAcceptableAsChild

#Since v6.0
public virtual bool IsContentTypeAcceptableAsChild(
type,
childSlotName
)

IsFactoryProductAcceptableAsChild

#Since v6.1
public virtual bool IsFactoryProductAcceptableAsChild(
factory,
childSlotName
)

IsFactoryProductAcceptableAsChild

#Since v5.11
Override this method to restrict the type of acceptable child content. The default implementation of this method returns true if the factory kind is 'texture'.
public virtual bool IsFactoryProductAcceptableAsChild(
kindId,
factoryKind,
childSlotName
)
Return true only if content with the specified kindId can be accepted as a child in the specified child slot.

IsOverridden

#
Checks if a method is overridden.
protected internal static bool IsOverridden(
method
)

IsReference

#Since v6.9
Query whether or not the content or any of its ancestors is a reference content.
public bool IsReference()
true if the content is a reference, else false

IsRenderHashCached

#Since v6.0 Obsolete v6.0
This method is deprecated and no longer called. For more information see CalculateRenderHash(ulong)
public bool IsRenderHashCached()
obsoleteThis method is deprecated and no longer called. For more information see CalculateRenderHash
bool

LoadFromFile

#Since v5.1
Loads content from a library file. Does not add the content to the document. Use RhinoDoc.RenderMaterials.Add or similar.
public static RenderContent LoadFromFile(
filename
full path to the file to be loaded.
)
The loaded content or null if an error occurred.

MakeCopy

#Since v6.0
Create a copy of the render content. All content is the same, except for the instance Id.
public RenderContent MakeCopy()
The new RenderContent

MakeGroupInstance

#Since v6.26
Create an 'instance' of the content hierarchy and group the new hierarchy with this hierarchy. If the instance is subsequently attached to the same document, the state of all members of the group will be kept synchronized. With the exception of the instance ids, all state is exactly preserved in the new instance hierarchy. \note The grouping will have no effect until the new instance is attached to the same document.
public RenderContent MakeGroupInstance()
A grouped instance of the content hierarchy.

MatchData

#Since v6.0
Implement to transfer data from another content to this content during creation.
public virtual RenderContent.MatchDataResult MatchData(
oldContent
An old content object from which the implementation may harvest data.
)
Information about how much data was matched.

ModifyRenderContentStyles

#
ModifyRenderContentStyles
protected void ModifyRenderContentStyles(
stylesToAdd,
stylesToRemove
)

NewPreviewSceneServer

#Since v6.0
Gets the PreviewSceneServer of the content
public PreviewSceneServer NewPreviewSceneServer(
ssd
SceneServerData
)

OnAddUserInterfaceSections

#
Override to provide UI sections to display in the editor.
protected virtual void OnAddUserInterfaceSections()

OnGetDefaultsInteractive

#
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.
protected virtual bool OnGetDefaultsInteractive()
If true is returned the content is created otherwise the creation is aborted.

OnMakeCopy

#
Override this function to supplement the standard copying behavour for your RenderContent.
protected virtual void OnMakeCopy(
newContent
Is the content that will be returned from MakeCopy.
)

OpenInEditor

#Since v5.7
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.
public bool OpenInEditor()
Returns true on success or false on error.

OpenInModalEditor

#Since v5.7 Obsolete v6.13
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.
public bool OpenInModalEditor()
obsoleteObsolete, use Edit a version that returns a RenderContent
Returns true on success or false on error.

ParamNameFromChildSlotName

#Since v5.1
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".
public string ParamNameFromChildSlotName(
childSlotName
The named of the child slot to receive the parameter name for.
)
The default behavior for these functions is to return the input string. Sub-classes may (in the future) override these functions to provide different mappings.

RegisterContent

#Since v5.1
Call RegisterContent in your plug-in's OnLoad function in order to register all of the custom RenderContent classes in your assembly.
public static Type[] RegisterContent(
assembly,
Assembly where custom content is defined, this may be a plug-in assembly or another assembly referenced by the plug-in.
pluginId
Parent plug-in for this assembly.
)
array of render content types registered on success. null on error.

RegisterContent

#Since v5.1
Call RegisterContent in your plug-in's OnLoad function in order to register all of the custom RenderContent classes in your assembly.
public static Type[] RegisterContent(
plugin
)
array of render content types registered on success. null on error.

RenderHashExclude

#Since v6.2
As RenderHash, but allows you to specify flags and exclude specific parameters. Use this version of the function to calculate a render hash when you have the linear workflow information and you are not running on the main thread. Access to LinearWorkflow data requires document access. CrcRenderHashFlags.ExcludeLinearWorkflow must be specified.
[CLSCompliant(false)] public uint RenderHashExclude(
flags,
Flags to finely control the render hash.
excludeParameterNames,
Semicolon-delimited string of parameter names to exclude.
lw
Linear Workflow to use.
)
The render hash.

RenderHashExclude

#Since v6.2
As RenderHash, but allows you to specify flags and exclude specific parameters.
[CLSCompliant(false)] public uint RenderHashExclude(
flags,
Flags to finely control the render hash.
excludeParameterNames
Semicolon-delimited string of parameter names to exclude.
)
The render hash.

RenderHashExclude

#Since v6.0 Obsolete v8.0
This method is deprecated in favor of the one that takes CrcRenderHashFlags.
[CLSCompliant(false)] public uint RenderHashExclude(
flags,
excludeParameterNames
)

Replace

#Since v6.13
public bool Replace(
newcontent
)

SaveToFile

#Since v8.6
Saves content to a file - RMTL, RENV or RTEX.
public bool SaveToFile(
filename,
Full path to the file to be saved.
embedFilesChoice
)
The loaded content or null if an error occurred.

SetChild

#Since v5.10 Obsolete v6.0
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.
public bool SetChild(
renderContent,
Child content to add to this content. If pChild is NULL, the function will fail. If pChild is already attached to a document, the function will fail. If pChild is already a child of this or another content, the function will fail.
childSlotName,
The name that will be assigned to this child slot. The child slot name cannot be an empty string. If it is, the function will fail.
changeContexts
)
obsoleteUse SetChild without ChangeContexts and Begin/EndChange
Returns true if the content was added or the child slot with this name was modified otherwise; returns false.

SetChild

#Since v6.0
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.
public bool SetChild(
renderContent,
Child content to add to this content. If renderContent is null, the function will fail. If renderContent is already attached to a document, the function will fail. If renderContent is already a child of this or another content, the function will fail.
childSlotName
The name that will be assigned to this child slot. The child slot name cannot be an empty string. If it is, the function will fail.
)
Returns true if the content was added or the child slot with this name was modified, otherwise returns false.

SetChildSlotAmount

#Since v5.7
Sets the amount property for the texture in the specified child slot.
public void SetChildSlotAmount(
childSlotName,
The child slot name of the texture.
amount,
The texture amount. Values are typically from 0.0 to 100.0
cc
The context of the change.
)

SetChildSlotOn

#Since v5.7
Sets the on-ness property for the texture in the specified child slot.
public void SetChildSlotOn(
childSlotName,
The child slot name of the texture.
bOn,
Value for the on-ness property.
cc
Context of the change
)

SetChildSlotParameter

#Since v5.7
Extra requirements are a way of specifying extra functionality on parameters in the automatic UI. Override this function to support values being set from automatic UI sections or the texture summary. See IAutoUIExtraRequirements.h in the C++ RDK SDK for string definitions for the parameter names. Call the base class from your override if you do not support the extra requirement parameter. Please do not call this function. It is only retained for backward compatibility. You should instead call SetExtraRequirementParameter().
public virtual bool SetChildSlotParameter(
contentParameterName,
The parameter or field internal name to which this query applies.
extraRequirementParameter,
The extra requirement parameter, as listed in IAutoUIExtraRequirements.h in the C++ RDK SDK.
value,
The value to set this extra requirement parameter. You will typically use System.Convert to convert the value to the type you need.
sc
The context of this operation.
)
true if successful, else false.

SetExtraRequirementParameter

#Since v7.9
Extra requirements are a way of specifying extra functionality on parameters in the automatic UI. See IAutoUIExtraRequirements.h in the C++ RDK SDK for string definitions for the parameter names.
public bool SetExtraRequirementParameter(
contentParameterName,
The parameter or field internal name to which this query applies.
extraRequirementParameter,
The extra requirement parameter, as listed in IAutoUIExtraRequirements.h in the C++ RDK SDK.
value,
The value to set this extra requirement parameter. You will typically use System.Convert to convert the value to the type you need.
sc
The context of this operation.
)
true if successful, else false.

SetIsRenderHashRecursive

#Since v7.0
By default, RenderHash recurses into children when computing the render hash. However, some applications may require children to be excluded from the render hash calculation. Call this method to enable or disable recursing into children. see RenderHash
public void SetIsRenderHashRecursive(
recursive
)

SetName

#Since v7.0
Set instance name for this content
public void SetName(
name,
renameEvents,
ensureNameUnique
)

SetParameter

#Since v5.7 Obsolete v6.0
Set the named parameter value for this content instance. If you do not support this parameter, call the base class.
public virtual bool SetParameter(
parameterName,
value,
changeContext
)
obsoleteUse SetParameter without ChangeContexts and Begin/EndChange

SetParameter

#Since v6.0
Set the named parameter value for this content instance. If you do not support this parameter, call the base class.
public virtual bool SetParameter(
parameterName,
value
)

SetRenderHash

#Since v6.0 Obsolete v6.0
This method is deprecated and no longer called. For more information see CalculateRenderHash(ulong)
[CLSCompliant(false)] public void SetRenderHash(
hash
)
obsoleteThis method is deprecated and no longer called. For more information see CalculateRenderHash

ShowContentInstanceBrowser

#Since v8.15
Allows the user to choose a content by displaying the Content Instance Browser dialog. The dialog will have OK, Cancel and Help buttons, and optional New and Edit buttons. Specifies the document to use. Sets the initially selected content and receives the instance id of the chosen content. Specifies the kind(s) of content that should be displayed in the browser. Specifies which optional buttons to display. Returns true if the user chooses a content or false if the dialog is cancelled.
public static bool ShowContentInstanceBrowser()

SmartUngroupRecursive

#Since v6.26
Remove this content and all its children from any instance groups they may be a member of. If any content in the same document is left alone in the group, that content is also ungrouped. Records undo and sends events OnContentChanged and OnContentGroupIdChanged. \note This method is designed to be called from a content UI and is intended for RDK internal use but may be used as an expert user override.
public bool SmartUngroupRecursive()
true if a content was ungrouped, \e false if no content or child was part of a group.

Ungroup

#Since v6.26
Remove this content from any instance group it may be a member of. Does not record undo but does send the OnContentGroupIdChanged event.
public bool Ungroup()
true if content was ungrouped, \e false if it was not part of a group.

UngroupRecursive

#Since v6.26
Remove this content and all its children from any instance groups they may be a member of. Does not record undo but does send the OnContentGroupIdChanged event.
public bool UngroupRecursive()
true if a content was ungrouped, \e false if no content or child was part of a group.

Uninitialize

#Since v6.1 Obsolete v7.2
public void Uninitialize()
obsoleteThis method should not be called.

UseCount

#Since v6.9
UseCount returns how many times the content is used
public int UseCount()

VirtualIcon

#Since v6.0
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.
public virtual bool VirtualIcon(
size,
Requested icon size
out Bitmap
bitmap
)
Return Icon to display in the content browser.

Events

ContentAdded

#Since v5.7
Used to monitor render content addition to the document.
public static event EventHandler<RenderContentEventArgs> ContentAdded

ContentChanged

#Since v5.7
Used to monitor render content modifications.
public static event EventHandler<RenderContentChangedEventArgs> ContentChanged

ContentDeleted

#Since v6.0
Used to monitor render content deletion from the document.
public static event EventHandler<RenderContentEventArgs> ContentDeleted

ContentDeleting

#Since v5.7
Used to monitor render content deletion from the document.
public static event EventHandler<RenderContentEventArgs> ContentDeleting

ContentFieldChanged

#Since v5.11
This event is raised when a field value is modified.
public static event EventHandler<RenderContentFieldChangedEventArgs> ContentFieldChanged

ContentRenamed

#Since v5.7
Used to monitor render content renaming in the document.
public static event EventHandler<RenderContentEventArgs> ContentRenamed

ContentReplaced

#Since v5.7
Used to monitor render content replacing in the document.
public static event EventHandler<RenderContentEventArgs> ContentReplaced

ContentReplacing

#Since v5.7
Used to monitor render content replacing in the document.
public static event EventHandler<RenderContentEventArgs> ContentReplacing

ContentUpdatePreview

#Since v5.7
Used to monitor render content preview updates.
public static event EventHandler<RenderContentEventArgs> ContentUpdatePreview

CurrentEnvironmentChanged

#Since v6.11
Event fired when changes to current environments have been made. This will be one of Background, Reflection or Skylighting Since 6.11
public static event EventHandler<RenderContentEventArgs> CurrentEnvironmentChanged

PreviewRendered

#
This event is raised when a preview has been rendered
public static event EventHandler<PreviewRenderedEventArgs> PreviewRendered