SoMaterialElement Class

Manages several properties that need to be lazily tracked for rendering.

Inheritance Hierarchy

SystemObject
  OIV.InventorSoNetBase
    OIV.Inventor.ElementsSoElement
      OIV.Inventor.ElementsSoReplacedElement
        OIV.Inventor.ElementsSoMaterialElement

Namespace: OIV.Inventor.Elements
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2023.1.3.0 (2023.1.3)

Syntax

C++

Copy

public class SoMaterialElement : SoReplacedElement

Public Class SoMaterialElement
	Inherits SoReplacedElement

public ref class SoMaterialElement : public SoReplacedElement

type SoMaterialElement =  
    class
        inherit SoReplacedElement
    end

The SoMaterialElement type exposes the following members.

Methods

	Name	Description
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	GetAmbient
	GetClassStackIndex	Obsolete. Returns the stack id for this element.
	GetColorIndex
	GetColorIndices
	GetColorMaterial
	GetDefaultAmbient	Specify Open Inventor defaults for colors, etc.
	GetDefaultAmbientIntensity	Specify Open Inventor defaults for colors, etc.
	GetDefaultColorIndex	Specify Open Inventor defaults for colors, etc.
	GetDefaultDiffuse	Specify Open Inventor defaults for colors, etc.
	GetDefaultEmissive	Specify Open Inventor defaults for colors, etc.
	GetDefaultShininess	Specify Open Inventor defaults for colors, etc.
	GetDefaultSpecular	Specify Open Inventor defaults for colors, etc.
	GetDefaultTransparency	Specify Open Inventor defaults for colors, etc.
	GetDiffuse	get() methods get value from Inventor state.
	GetEmissive
	GetHashCode	Overrides GetHashCode(). (Inherited from SoNetBase.)
	GetNumColorIndices	Method to inquire about current colors.
	GetNumColorIndices(SoState)	Method to inquire about current colors.
	GetNumDiffuse	Method to inquire about current colors.
	GetNumDiffuse(SoState)	Return number of diffuse colors.
	GetNumTransparencies	Method to inquire about current colors.
	GetPackedColors	Return packed colors if any.
	GetShininess
	GetSpecular
	GetTransparency	get() methods get value from Inventor state.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	IsTransparent	Method to inquire about current colors.
	Pop	Unref buffer object of the popped element. (Overrides SoElementPop(SoState, SoElement).)
	Push	Copy current material into the pushed element. (Overrides SoElementPush(SoState).)
	SetAmbient
	SetColorIndices	Static set method.
	SetColorMaterial
	SetDiffuse	Static set method.
	SetEmissive
	SetPacked
	SetShininess
	SetSpecular
	SetTransparency	Static set method.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

This element manages several properties such as colors, that need to be lazily tracked for rendering. Allows Open Inventor property nodes to set these properties without immediately making any rendering calls. Thus we avoid making redundant rendering calls to set, for example, the material color. Open Inventor rendering nodes then request that the values of any properties that are relevant to that shape and "out of date" (not current with rendering state) be sent to the rendering engine.

Includes: Transparencies GLColorMaterial PolygonStipple Color index

Reference

OIV.Inventor.Elements Namespace

OIV.Inventor.Nodes.SoBaseColor

OIV.Inventor.Nodes.SoMaterial

OIV.Inventor.Nodes.SoPackedColor

OIV.Inventor.Nodes.SoVertexProperty