RenderMaterial Methods |
The RenderMaterial type exposes the following members.
Name | Description | |
---|---|---|
AddAutomaticUserInterfaceSection |
Add a new automatic user interface section, Field values which include
prompts will be automatically added to this section.
(Inherited from RenderContent.) | |
AddChild(RenderContent) | Obsolete. (Inherited from RenderContent.) | |
AddChild(RenderContent, String) | Obsolete. (Inherited from RenderContent.) | |
AddUserInterfaceSection(ICollapsibleSection) | (Inherited from RenderContent.) | |
AddUserInterfaceSection(Type, String, Boolean, Boolean) | Obsolete.
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.
(Inherited from RenderContent.) | |
AssignTo(ObjRef) | ||
AssignTo(IEnumerableObjRef, RenderMaterialAssignToSubFaceChoices, RenderMaterialAssignToBlockChoices, Boolean) | ||
BeginChange |
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.
(Inherited from RenderContent.) | |
BeginCreateDynamicFields |
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().
(Inherited from RenderContent.) | |
BindParameterToField(String, Field, RenderContentChangeContexts) |
Use bindings to automatically wire parameters to fields
(Inherited from RenderContent.) | |
BindParameterToField(String, String, Field, RenderContentChangeContexts) |
Use bindings to automatically wire parameters to fields
(Inherited from RenderContent.) | |
CalculateRenderHash | Obsolete.
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.
(Inherited from RenderContent.) | |
CalculateRenderHash2 | (Inherited from RenderContent.) | |
ChangeChild | Obsolete. (Inherited from RenderContent.) | |
ChildSlotAmount |
Gets the amount property for the texture in the specified child slot.
(Inherited from RenderContent.) | |
ChildSlotNameFromParamName |
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".
(Inherited from RenderContent.) | |
ChildSlotOn |
Gets the on-ness property for the texture in the specified child slot.
(Inherited from RenderContent.) | |
ConvertToPhysicallyBased |
Returns a material that is the best approximation of the original, but as a physically based material.
| |
ConvertUnits |
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.
(Inherited from RenderContent.) | |
CreateBasicMaterial(Material) | Obsolete.
Constructs a new basic material from a Material.
| |
CreateBasicMaterial(Material, RhinoDoc) | ||
CreateDynamicField |
Create a dynamic field with an initial value and min and max limits.
(Inherited from RenderContent.) | |
CreateImportedMaterial | ||
DeleteAllChildren | (Inherited from RenderContent.) | |
DeleteChild | (Inherited from RenderContent.) | |
Dispose | (Inherited from RenderContent.) | |
Dispose(Boolean) |
Dispose
(Inherited from RenderContent.) | |
DynamicIcon | (Inherited from RenderContent.) | |
Edit |
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.
(Inherited from RenderContent.) | |
EndChange |
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.
(Inherited from RenderContent.) | |
EndCreateDynamicFields |
You must call this after creating dynamic fields. Calls to this method are counted; you must call
BeginCreateDynamicFields() once for every call to EndCreateDynamicFields().
(Inherited from RenderContent.) | |
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) | |
Factory | (Inherited from RenderContent.) | |
Finalize |
Finalizer
(Inherited from RenderContent.) | |
FindChild | (Inherited from RenderContent.) | |
ForDisplay |
**** 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.
(Inherited from RenderContent.) | |
FromMaterial |
Constructs a new material from a Material.
| |
GetChildSlotParameter |
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().
(Inherited from RenderContent.) | |
GetEmbeddedFilesList | (Inherited from RenderContent.) | |
GetExtraRequirementParameter |
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.
(Inherited from RenderContent.) | |
GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
GetParameter |
Query the content instance for the value of a given named parameter.
If you do not support this parameter, call the base class.
(Inherited from RenderContent.) | |
GetTextureAmountFromUsage | ||
GetTextureFromUsage | ||
GetTextureOnFromUsage | ||
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
GetUiHash |
This allows a content to have more than one UI for the same content type.
(Inherited from RenderContent.) | |
GetUnderlyingInstances | (Inherited from RenderContent.) | |
HandleTexturedValueT |
Handle a textured content field. Values will be read into an
instance of TexturedColor
| |
Icon | (Inherited from RenderContent.) | |
ImportMaterialAndAssignToLayers | Imports a material file (.RMTL) and assigns the imported material to one or more layers. | |
Initialize | Obsolete. (Inherited from RenderContent.) | |
IsCompatible | (Inherited from RenderContent.) | |
IsContentTypeAcceptableAsChild | (Inherited from RenderContent.) | |
IsFactoryProductAcceptableAsChild(ContentFactory, String) | (Inherited from RenderContent.) | |
IsFactoryProductAcceptableAsChild(Guid, String, String) |
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'.
(Inherited from RenderContent.) | |
IsReference |
Query whether or not the content or any of its ancestors is a reference content.
(Inherited from RenderContent.) | |
IsRenderHashCached | Obsolete.
This method is deprecated and no longer called. For more information see CalculateRenderHash(UInt64) (Inherited from RenderContent.) | |
MakeCopy |
Create a copy of the render content. All content is the same, except for the
instance Id.
(Inherited from RenderContent.) | |
MakeGroupInstance |
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.
(Inherited from RenderContent.) | |
MatchData |
Implement to transfer data from another content to this content during creation.
(Inherited from RenderContent.) | |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
ModifyRenderContentStyles |
ModifyRenderContentStyles
(Inherited from RenderContent.) | |
NewPreviewSceneServer |
Gets the PreviewSceneServer of the content
(Inherited from RenderContent.) | |
OnAddUserInterfaceSections |
Override to provide UI sections to display in the editor.
(Inherited from RenderContent.) | |
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.
(Inherited from RenderContent.) | |
OnMakeCopy |
Override this function to supplement the standard copying behavour for your RenderContent.
(Inherited from RenderContent.) | |
OpenInEditor |
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.
(Inherited from RenderContent.) | |
OpenInModalEditor | Obsolete.
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.
(Inherited from RenderContent.) | |
ParamNameFromChildSlotName |
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".
(Inherited from RenderContent.) | |
RenderHashExclude(CrcRenderHashFlags, String) |
As RenderHash, but allows you to specify flags and exclude specific parameters.
(Inherited from RenderContent.) | |
RenderHashExclude(TextureRenderHashFlags, String) |
This method is deprecated in favor of the one that takes CrcRenderHashFlags.
(Inherited from RenderContent.) | |
RenderHashExclude(CrcRenderHashFlags, String, LinearWorkflow) |
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.
(Inherited from RenderContent.) | |
Replace | (Inherited from RenderContent.) | |
SaveToFile |
Saves content to a file - RMTL, RENV or RTEX.
(Inherited from RenderContent.) | |
SetChild(RenderContent, String) |
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.
(Inherited from RenderContent.) | |
SetChild(RenderContent, String, RenderContentChangeContexts) | Obsolete.
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.
(Inherited from RenderContent.) | |
SetChildSlotAmount |
Sets the amount property for the texture in the specified child slot.
(Inherited from RenderContent.) | |
SetChildSlotOn |
Sets the on-ness property for the texture in the specified child slot.
(Inherited from RenderContent.) | |
SetChildSlotParameter |
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().
(Inherited from RenderContent.) | |
SetExtraRequirementParameter |
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.
(Inherited from RenderContent.) | |
SetIsRenderHashRecursive |
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 (Inherited from RenderContent.) | |
SetName |
Set instance name for this content
(Inherited from RenderContent.) | |
SetParameter(String, Object) |
Set the named parameter value for this content instance.
If you do not support this parameter, call the base class.
(Inherited from RenderContent.) | |
SetParameter(String, Object, RenderContentChangeContexts) | Obsolete.
Set the named parameter value for this content instance.
If you do not support this parameter, call the base class.
(Inherited from RenderContent.) | |
SetRenderHash | Obsolete.
This method is deprecated and no longer called. For more information see CalculateRenderHash(UInt64) (Inherited from RenderContent.) | |
SimulatedMaterial | Obsolete. | |
SimulateMaterial(Boolean) | Obsolete.
Call this function to receive the simulation for a RenderMaterial used by the display and other rendering engines.
| |
SimulateMaterial(Material, RenderTextureTextureGeneration) |
Override this function to provide a Rhino.DocObjects.Material definition for this material
to be used by other rendering engines including the display.
| |
SimulateMaterial(Material, Boolean) | Obsolete.
Override this function to provide a Rhino.DocObjects.Material definition for this material
to be used by other rendering engines including the display.
| |
SlotFromTextureType | ||
SmartUngroupRecursive |
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.
(Inherited from RenderContent.) | |
TextureChildSlotName |
Override this function to provide information about which texture is used for
the standard (ie - defined in ON_Texture) texture channels.
| |
TextureTypeFromSlot | ||
ToMaterial | ||
ToString | Returns a string that represents the current object. (Inherited from Object.) | |
Ungroup |
Remove this content from any instance group it may be a member of.
Does not record undo but does send the OnContentGroupIdChanged event.
(Inherited from RenderContent.) | |
UngroupRecursive |
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.
(Inherited from RenderContent.) | |
Uninitialize | Obsolete. (Inherited from RenderContent.) | |
UseCount |
UseCount returns how many times the content is used
(Inherited from RenderContent.) | |
VirtualIcon |
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.
(Inherited from RenderContent.) |