Package com.openinventor.inventor.elements

Class SoMaterialElement

java.lang.Object
com.openinventor.inventor.Inventor
com.openinventor.inventor.elements.SoElement
com.openinventor.inventor.elements.SoReplacedElement
com.openinventor.inventor.elements.SoMaterialElement
public class SoMaterialElement extends SoReplacedElement
Store in the state the material properties set by some property nodes. The values of this element are modified by property nodes that affects the material characteristics such as: SoBaseColor, SoMaterial, SoPhysicalMaterial.

See Also:

  • Method Details

    • getPackedColors

      public static SoCpuBufferObject getPackedColors(SoState state, SoMaterialElement.Faces face)
      Return packed colors if any.

    • getEmissive

      public static SbColor getEmissive(SoState state, SoMaterialElement.Faces face)

    • getColorIndices

      public static int[] getColorIndices(SoState state, SoMaterialElement.Faces face)

    • getDirectColorIndices

      public static IntBuffer getDirectColorIndices(SoState state, SoMaterialElement.Faces face)

    • getAmbient

      public static SbColor getAmbient(SoState state, SoMaterialElement.Faces face)

    • getColorIndex

      public static int getColorIndex(SoState state, SoMaterialElement.Faces face, int num)

    • setShininess

      @Deprecated(since="2025.1") public static void setShininess(SoState state, SoNode node, float value)
      Deprecated.
      As of Open Inventor 2025.1. Use the setShininess() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setShininess() method that takes a Face parameter instead.

    • setPacked

      @Deprecated(since="2025.1") public static void setPacked(SoState state, SoNode node, int[] colors)
      Deprecated.
      As of Open Inventor 2025.1. Use the setPacked() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setPacked() method that takes a Face parameter instead.

    • setColorMaterial

      @Deprecated(since="2025.1") public static void setColorMaterial(SoState state, SoNode node, boolean value)
      Deprecated.
      As of Open Inventor 2025.1. Use the setColorMaterial() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setColorMaterial() method that takes a Face parameter instead.

    • setTransparency

      @Deprecated(since="2025.1") public static void setTransparency(SoState state, SoNode node, float[] transp)
      Deprecated.
      As of Open Inventor 2025.1. Use the setTransparency() method that takes a Face parameter instead.
      Static set method.

      Warning Deprecated since Open Inventor 2025.1. Use the setTransparency() method that takes a Face parameter instead.

    • getShininess

      public static float getShininess(SoState state, SoMaterialElement.Faces face)

    • getSpecular

      public static SbColor getSpecular(SoState state, SoMaterialElement.Faces face)

    • setSpecular

      @Deprecated(since="2025.1") public static void setSpecular(SoState state, SoNode node, SbColor color)
      Deprecated.
      As of Open Inventor 2025.1. Use the setSpecular() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setSpecular() method that takes a Face parameter instead.

    • setColorIndices

      @Deprecated(since="2025.1") public static void setColorIndices(SoState state, SoNode node, int[] indices)
      Deprecated.
      As of Open Inventor 2025.1. Use the setColorIndices() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setColorIndices() method that takes a Face parameter instead.

    • push

      public void push(SoState state)
      Copy current material into the pushed element.
      Overrides:
      push in class SoElement

    • setColorIndices

      public static void setColorIndices(SoState state, SoMaterialElement.Faces face, SoNode node, int[] indices)
      Static set method.

    • setPacked

      public static void setPacked(SoState state, SoMaterialElement.Faces face, SoNode node, int[] colors)

    • setEmissive

      public static void setEmissive(SoState state, SoMaterialElement.Faces face, SoNode node, SbColor color)

    • setAmbient

      public static void setAmbient(SoState state, SoMaterialElement.Faces face, SoNode node, SbColor color)

    • setTransparency

      public static void setTransparency(SoState state, SoMaterialElement.Faces face, SoNode node, float[] transp)
      Static set method.

    • setEmissive

      @Deprecated(since="2025.1") public static void setEmissive(SoState state, SoNode node, SbColor color)
      Deprecated.
      As of Open Inventor 2025.1. Use the setEmissive() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setEmissive() method that takes a Face parameter instead.

    • setAmbient

      @Deprecated(since="2025.1") public static void setAmbient(SoState state, SoNode node, SbColor color)
      Deprecated.
      As of Open Inventor 2025.1. Use the setAmbient() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setAmbient() method that takes a Face parameter instead.

    • setDiffuse

      public static void setDiffuse(SoState state, SoMaterialElement.Faces face, SoNode node, SbColor[] colors)
      Static set method.

    • getClassStackIndex

      @Deprecated(since="9.3.0.0") public static int getClassStackIndex()
      Deprecated.
      As of Open Inventor 9.3.0.0. replaced by SoElement.getClassStackIndex(Class)
      Returns the stack id for this element. ] *

    • getDiffuse

      public static SbColor getDiffuse(SoState state, SoMaterialElement.Faces face, int index)
      get() methods get value from Inventor state. The public methods are static, they get an instance of the element.

    • setMetallic

      public static void setMetallic(SoState state, SoMaterialElement.Faces face, SoNode node, float value)

    • getTransparency

      public static float getTransparency(SoState state, SoMaterialElement.Faces face, int index)
      get() methods get value from Inventor state. The public methods are static, they get an instance of the element.

    • pop

      public void pop(SoState state, SoElement prevTopElement)
      Unref buffer object of the popped element.
      Overrides:
      pop in class SoElement

    • setRoughness

      public static void setRoughness(SoState state, SoMaterialElement.Faces face, SoNode node, float value)

    • setShininess

      public static void setShininess(SoState state, SoMaterialElement.Faces face, SoNode node, float value)

    • setSpecular

      public static void setSpecular(SoState state, SoMaterialElement.Faces face, SoNode node, SbColor color)

    • setSpecularFactor

      public static void setSpecularFactor(SoState state, SoMaterialElement.Faces face, SoNode node, float value)

    • setColorMaterial

      public static void setColorMaterial(SoState state, SoMaterialElement.Faces face, SoNode node, boolean value)

    • getNumTransparencies

      public static int getNumTransparencies(SoState state, SoMaterialElement.Faces face)
      Method to inquire about current colors.

    • getColorMaterial

      @Deprecated(since="2025.1") public static boolean getColorMaterial(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getColorMaterial() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getColorMaterial() method that takes a Face parameter instead.

    • getNumColorIndices

      public static long getNumColorIndices(SoState state, SoMaterialElement.Faces face)
      Method to inquire about current colors.

    • getSpecularFactor

      @Deprecated(since="2025.1") public static float getSpecularFactor(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getSpecularFactor() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getSpecularFactor() method that takes a Face parameter instead.

    • isTransparent

      public static boolean isTransparent(SoState state)
      Method to inquire about current colors.

    • getSpecular

      @Deprecated(since="2025.1") public static SbColor getSpecular(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getSpecular() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getSpecular() method that takes a Face parameter instead.

    • getDefaultDiffuse

      public static SbColor getDefaultDiffuse()
      Specify Open Inventor defaults for colors, etc.

    • getShininess

      @Deprecated(since="2025.1") public static float getShininess(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getShininess() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getShininess() method that takes a Face parameter instead.

    • getDefaultAmbientIntensity

      public static float getDefaultAmbientIntensity()
      Specify Open Inventor defaults for colors, etc.

    • getRoughness

      @Deprecated(since="2025.1") public static float getRoughness(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getRoughness() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getRoughness() method that takes a Face parameter instead.

    • getSpecularFactor

      public static float getSpecularFactor(SoState state, SoMaterialElement.Faces face)

    • getNumColorIndices

      @Deprecated(since="2025.1") public static long getNumColorIndices(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getNumColorIndices() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getNumColorIndices() method that takes a Face parameter instead.

    • getColorMaterial

      public static boolean getColorMaterial(SoState state, SoMaterialElement.Faces face)

    • getNumTransparencies

      @Deprecated(since="2025.1") public static int getNumTransparencies(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getNumTransparencies() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getNumTransparencies() method that takes a Face parameter instead.

    • getRoughness

      public static float getRoughness(SoState state, SoMaterialElement.Faces face)

    • getMetallic

      @Deprecated(since="2025.1") public static float getMetallic(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getMetallic() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getMetallic() method that takes a Face parameter instead.

    • getNumDiffuse

      public static long getNumDiffuse(SoState state, SoMaterialElement.Faces face)
      Returns the number of diffuse colors.

    • getNumDiffuse

      @Deprecated(since="2025.1") public static long getNumDiffuse(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getNumDiffuse() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getNumDiffuse() method that takes a Face parameter instead.

    • getMetallic

      public static float getMetallic(SoState state, SoMaterialElement.Faces face)

    • getEmissive

      @Deprecated(since="2025.1") public static SbColor getEmissive(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getEmissive() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getEmissive() method that takes a Face parameter instead.

    • getDefaultMetallic

      public static float getDefaultMetallic()

    • setMetallic

      @Deprecated(since="2025.1") public static void setMetallic(SoState state, SoNode node, float value)
      Deprecated.
      As of Open Inventor 2025.1. Use the setMetallic() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setMetallic() method that takes a Face parameter instead.

    • getDefaultRoughness

      public static float getDefaultRoughness()

    • getDiffuse

      @Deprecated(since="2025.1") public static SbColor getDiffuse(SoState state, int index)
      Deprecated.
      As of Open Inventor 2025.1. Use the getDiffuse() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getDiffuse() method that takes a Face parameter instead.

    • getDefaultTransparency

      public static float getDefaultTransparency()
      Specify Open Inventor defaults for colors, etc.

    • setSpecularFactor

      @Deprecated(since="2025.1") public static void setSpecularFactor(SoState state, SoNode node, float value)
      Deprecated.
      As of Open Inventor 2025.1. Use the setSpecularFactor() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setSpecularFactor() method that takes a Face parameter instead.

    • setDiffuse

      @Deprecated(since="2025.1") public static void setDiffuse(SoState state, SoNode node, SbColor[] colors)
      Deprecated.
      As of Open Inventor 2025.1. Use the setDiffuse() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setDiffuse() method that takes a Face parameter instead.

    • setRoughness

      @Deprecated(since="2025.1") public static void setRoughness(SoState state, SoNode node, float value)
      Deprecated.
      As of Open Inventor 2025.1. Use the setRoughness() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the setRoughness() method that takes a Face parameter instead.

    • getDefaultColorIndex

      public static int getDefaultColorIndex()
      Specify Open Inventor defaults for colors, etc.

    • getTransparency

      @Deprecated(since="2025.1") public static float getTransparency(SoState state, int index)
      Deprecated.
      As of Open Inventor 2025.1. Use the getTransparency() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getTransparency() method that takes a Face parameter instead.

    • getDefaultSpecular

      public static SbColor getDefaultSpecular()
      Specify Open Inventor defaults for colors, etc.

    • getColorIndex

      @Deprecated(since="2025.1") public static int getColorIndex(SoState state, int num)
      Deprecated.
      As of Open Inventor 2025.1. Use the getColorIndex() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getColorIndex() method that takes a Face parameter instead.

    • getDefaultAmbient

      public static SbColor getDefaultAmbient()
      Specify Open Inventor defaults for colors, etc.

    • getAmbient

      @Deprecated(since="2025.1") public static SbColor getAmbient(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getAmbient() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getAmbient() method that takes a Face parameter instead.

    • getDefaultEmissive

      public static SbColor getDefaultEmissive()
      Specify Open Inventor defaults for colors, etc.

    • getPackedColors

      @Deprecated(since="2025.1") public static SoCpuBufferObject getPackedColors(SoState state)
      Deprecated.
      As of Open Inventor 2025.1. Use the getPackedColors() method that takes a Face parameter instead.

      Warning Deprecated since Open Inventor 2025.1. Use the getPackedColors() method that takes a Face parameter instead.

    • getDefaultSpecularFactor

      public static float getDefaultSpecularFactor()

    • getDefaultShininess

      public static float getDefaultShininess()
      Specify Open Inventor defaults for colors, etc.