API Reference › core-backend› Elements › RenderMaterialElement

RenderMaterialElement Namespace

Class

Name Description
RenderMaterialElement.Params Parameters used to construct a RenderMaterial.

Defined in

RenderMaterialElement Class

Defines a rendering material.

@note See PhysicalMaterial for the DefinitionElement used to define the matter that makes up physical elements.

Extends

Methods

Name Description
toJSON(): RenderMaterialProps Obtain the JSON representation of this Entity.  
create(iModelDb: IModelDb, definitionModelId: string, materialName: string, params: RenderMaterialElementParams): RenderMaterialElement Static Create a RenderMaterial with given parameters.  
createCode(iModel: IModelDb, scopeModelId: string, name: string): Code Static Create a Code for a RenderMaterial given a name that is meant to be unique within the scope of the specified DefinitionModel.  
deserialize(props: DeserializeEntityArgs): RenderMaterialProps Static Converts an ECSqlRow of an Entity to an EntityProps.  
insert(txn: EditTxn, definitionModelId: string, materialName: string, params: RenderMaterialElementParams): string Static Insert a new RenderMaterial into a model.  
insert(iModelDb: IModelDb, definitionModelId: string, materialName: string, params: RenderMaterialElementParams): string Static Insert a new RenderMaterial into a model. Deprecated  
onCloned(context: IModelElementCloneContext, sourceProps: ElementProps, targetProps: ElementProps): Promise<void> Protected Static    
serialize(props: RenderMaterialProps, iModel: IModelDb): ECSqlRow Static Converts an EntityProps to an ECSqlRow.  

Inherited methods

Name Inherited from Description
collectReferenceIds(referenceIds: EntityReferenceSet): void Protected Inherited DefinitionElement Collect the Ids of this entity's references at this level of the class hierarchy.
delete(txn: EditTxn): void Inherited DefinitionElement Delete this Element from the iModel using the supplied EditTxn.
delete(): void Inherited DefinitionElement Delete this Element from the iModel.
forEach(func: PropertyHandler, includeCustom: boolean = true): void Inherited DefinitionElement Call a function for each property of this Entity.
forEachProperty(func: PropertyCallback, includeCustom: boolean = true): void Inherited DefinitionElement Call a function for each property of this Entity.
getClassMetaData(): EntityMetaData | undefined Inherited DefinitionElement Get the class metadata for this element.
getDisplayLabel(): string Inherited DefinitionElement Get a display label for this Element.
getJsonProperty(nameSpace: string): any Inherited DefinitionElement Get a JSON property of this element, by namespace
getMetaData(): Promise<EntityClass> Inherited DefinitionElement Query metadata for this entity class from the iModel's schema.
getReferenceIds(): EntityReferenceSet Inherited DefinitionElement Get the set of this entity's entity references, EntityReferenceSet.
getToolTipMessage(): string[] Inherited DefinitionElement Get a list of HTML strings that describe this Element for the tooltip.
getUserProperties(namespace: string): any Inherited DefinitionElement Get a set of JSON user properties by namespace
insert(txn: EditTxn): string Inherited DefinitionElement Insert this Element into the iModel using the supplied EditTxn.
insert(): string Inherited DefinitionElement Insert this Element into the iModel.
removeUserProperties(nameSpace: string): void Inherited DefinitionElement Remove a set of JSON user properties, specified by namespace, from this Element
setJsonProperty(nameSpace: string, value: any): void Inherited DefinitionElement  
setUserProperties(nameSpace: string, value: any): void Inherited DefinitionElement Change a set of user JSON properties of this Element by namespace.
update(txn: EditTxn): void Inherited DefinitionElement Update this Element in the iModel using the supplied EditTxn.
update(): void Inherited DefinitionElement Update this Element in the iModel.
is(otherClass: Entity): boolean Static Inherited DefinitionElement return whether this Entity class is a subclass of another Entity class
onAllInputsHandled(_id: string, _iModel: IModelDb): void Protected Static Inherited DefinitionElement Called on an element in a graph after all of its inputs have been processed and before its outputs are processed.
onAllInputsHandledArg(arg: OnElementDependencyArg): void Protected Static Inherited DefinitionElement Called on an element in a graph after all of its inputs have been processed and before its outputs are processed.
onBeforeOutputsHandled(_id: string, _iModel: IModelDb): void Protected Static Inherited DefinitionElement Called when a root element in a subgraph is changed and before its outputs are processed.
onBeforeOutputsHandledArg(arg: OnElementDependencyArg): void Protected Static Inherited DefinitionElement Called when a root element in a subgraph is changed and before its outputs are processed.
onBulkChildDeleted(arg: OnBulkChildDeletedBatchArg): void Protected Static Inherited DefinitionElement Called after a batch of child Elements of this class's instances were deleted in a bulk delete operation.
onBulkDeleted(arg: OnBulkDeletedBatchArg): void Protected Static Inherited DefinitionElement Called after a batch of Elements of this class were deleted in a bulk delete operation.
onChildAdd(_arg: OnChildElementPropsArg): void Protected Static Inherited DefinitionElement Called when an existing element is about to be updated so that an instance of this class will become its new parent.
onChildAdded(arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called after an existing element has been updated so that an instance of this class is its new parent.
onChildDelete(_arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called when an element with an instance of this class as its parent is about to be deleted.
onChildDeleted(arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called after an element with an instance of this class as its parent was successfully deleted.
onChildDrop(_arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called when an element with an instance of this class as its parent is about to be updated change to a different parent.
onChildDropped(arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called after an element with an instance of this class as its previous parent was updated to have a new parent.
onChildInsert(_arg: OnChildElementPropsArg): void Protected Static Inherited DefinitionElement Called when a new element with an instance of this class as its parent is about to be inserted.
onChildInserted(arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called after a new element with an instance of this class as its parent was inserted.
onChildUpdate(_arg: OnChildElementPropsArg): void Protected Static Inherited DefinitionElement Called when an element with an instance of this class as its parent is about to be updated.
onChildUpdated(arg: OnChildElementIdArg): void Protected Static Inherited DefinitionElement Called after an element with an instance of this the class as its parent was updated.
onDelete(arg: OnElementIdArg): void Protected Static Inherited DefinitionElement Called before an Element is deleted.
onDeleted(arg: OnElementIdArg): void Protected Static Inherited DefinitionElement Called after an Element was deleted.
onInsert(arg: OnElementPropsArg): void Protected Static Inherited DefinitionElement Called before a new Element is inserted.
onInserted(arg: OnElementIdArg): void Protected Static Inherited DefinitionElement Called after a new Element was inserted.
onSubModelDelete(_arg: OnSubModelIdArg): void Protected Static Inherited DefinitionElement Called when a sub-model of an instance of this class is being deleted.
onSubModelDeleted(arg: OnSubModelIdArg): void Protected Static Inherited DefinitionElement Called after a sub-model of an instance of this class was deleted.
onSubModelInsert(arg: OnSubModelPropsArg): void Protected Static Inherited DefinitionElement Called when an instance of this class is being sub-modeled by a new Model.
onSubModelInserted(arg: OnSubModelIdArg): void Protected Static Inherited DefinitionElement Called after an instance of this class was sub-modeled by a new Model.
onUpdate(arg: OnElementPropsArg): void Protected Static Inherited DefinitionElement Called before an Element is updated.
onUpdated(arg: OnElementIdArg): void Protected Static Inherited DefinitionElement Called after an Element was updated.

Properties

Name Type Description
_customHandledProps Protected Static Readonly CustomHandledProperty[] List of properties that are need to be custom handled during deserialization and serialization.  
className Accessor Static ReadOnly string The name of the BIS class associated with this class.  
description string | undefined An optional description of the material.  
paletteName string The name of a palette that can be used to categorize multiple materials.  

Inherited properties

Name Type Inherited from Description
_metadata Protected Inherited EntityClass | RelationshipClass DefinitionElement Cached Metadata for the ECClass
allowedSubModelClasses Accessor Protected Static Inherited ReadOnly EntityClassType<Model>[] | undefined DefinitionElement The Model classes that may sub-model an instance of this class.
A sub-model is accepted if its class is, or derives from, one of these classes, including generated JavaScript classes for unregistered EC subclasses.
The default is undefined, which permits any Model class.
Domain classes implementing bis:ISubModeledElement should override this to restrict their sub-model class.
classFullName Accessor Inherited ReadOnly string DefinitionElement Get the full BIS class name of this Entity in the form "schema:class".
classFullName Accessor Static Inherited ReadOnly string DefinitionElement Get the full BIS class name of this Entity in the form "schema:class"
className Accessor Inherited ReadOnly string DefinitionElement The name of the BIS class associated with this class.
code Inherited Code DefinitionElement The Code for this element
federationGuid Inherited string | undefined DefinitionElement A FederationGuid assigned to this element by some other federated database
id Inherited string DefinitionElement The Id of this Entity.
iModel Inherited IModelDb DefinitionElement The IModelDb that contains this Entity
isInstanceOfEntity Readonly Inherited "true" DefinitionElement An immutable property used to discriminate between Entity and EntityProps, used to inform the TypeScript compiler that these two types
isPrivate Inherited boolean DefinitionElement If true, don't show this DefinitionElement in user interface lists.
jsonProperties Readonly Inherited [key: string]: any DefinitionElement Optional json properties of this element.
model Readonly Inherited string DefinitionElement The ModelId of the Model containing this element
parent Inherited RelatedElement | undefined DefinitionElement The parent element, if present, of this element.
requiredReferenceKeys Static Readonly Inherited ReadonlyArray DefinitionElement A required reference is an element that had to be inserted before this element could have been inserted.
schema Static Inherited Schema DefinitionElement The Schema that defines this class.
schemaItemKey Accessor Inherited ReadOnly SchemaItemKey DefinitionElement Get the item key used by the ecschema-metadata package to identify this entity class
schemaItemKey Accessor Static Inherited ReadOnly SchemaItemKey DefinitionElement Serves as a unique identifier for this class. Typed variant of classFullName.
schemaName Accessor Inherited ReadOnly string DefinitionElement The name of the BIS Schema that defines this class
userLabel Inherited string | undefined DefinitionElement A user-assigned label for this element.

Defined in

Last Updated: 12 October, 2026