This class allows the definition of the type of a surface. Aspect attributes of a 3d face. Keywords: Material, FillArea, Shininess, Ambient, Color, Diffuse, Specular, Transparency, Emissive, ReflectionMode, BackFace, FrontFace, Reflection, Absorbtion. More...

#include <Graphic3d_MaterialAspect.hxx>

Public Member Functions
	Graphic3d_MaterialAspect ()
	Creates a material from default values. More...

	Graphic3d_MaterialAspect (const Graphic3d_NameOfMaterial theName)
	Creates a generic material. More...

Graphic3d_NameOfMaterial	Name () const
	Returns the material name (within predefined enumeration). More...

Graphic3d_NameOfMaterial	RequestedName () const
	Returns the material name within predefined enumeration which has been requested (before modifications). More...

const TCollection_AsciiString &	StringName () const
	Returns the given name of this material. This might be: More...

Standard_CString	MaterialName () const
	Returns the given name of this material. This might be: More...

void	SetMaterialName (const TCollection_AsciiString &theName)
	The current material become a "UserDefined" material. Set the name of the "UserDefined" material. More...

void	Reset ()
	Resets the material with the original values according to the material name but leave the current color values untouched for the material of type ASPECT. More...

const Quantity_Color &	Color () const
	Returns the diffuse color of the surface. More...

void	SetColor (const Quantity_Color &theColor)
	Modifies the ambient and diffuse color of the surface. More...

Standard_ShortReal	Transparency () const
	Returns the transparency coefficient of the surface (1.0 - Alpha); 0.0 means opaque. More...

Standard_ShortReal	Alpha () const
	Returns the alpha coefficient of the surface (1.0 - Transparency); 1.0 means opaque. More...

void	SetTransparency (const Standard_ShortReal theValue)
	Modifies the transparency coefficient of the surface, where 0 is opaque and 1 is fully transparent. Transparency is applicable to materials that have at least one of reflection modes (ambient, diffuse, specular or emissive) enabled. See also SetReflectionModeOn() and SetReflectionModeOff() methods. More...

void	SetAlpha (Standard_ShortReal theValue)
	Modifies the alpha coefficient of the surface, where 1.0 is opaque and 0.0 is fully transparent. More...

const Quantity_Color &	AmbientColor () const
	Returns the ambient color of the surface. More...

void	SetAmbientColor (const Quantity_Color &theColor)
	Modifies the ambient color of the surface. More...

const Quantity_Color &	DiffuseColor () const
	Returns the diffuse color of the surface. More...

void	SetDiffuseColor (const Quantity_Color &theColor)
	Modifies the diffuse color of the surface. More...

const Quantity_Color &	SpecularColor () const
	Returns the specular color of the surface. More...

void	SetSpecularColor (const Quantity_Color &theColor)
	Modifies the specular color of the surface. More...

const Quantity_Color &	EmissiveColor () const
	Returns the emissive color of the surface. More...

void	SetEmissiveColor (const Quantity_Color &theColor)
	Modifies the emissive color of the surface. More...

Standard_ShortReal	Ambient () const
	Returns the reflection properties of the surface. More...

void	SetAmbient (const Standard_ShortReal theValue)
	Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0. More...

Standard_ShortReal	Diffuse () const
	Returns the reflection properties of the surface. More...

void	SetDiffuse (const Standard_ShortReal theValue)
	Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0. More...

Standard_ShortReal	Specular () const
	Returns the reflection properties of the surface. More...

void	SetSpecular (const Standard_ShortReal theValue)
	Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0. More...

Standard_ShortReal	Emissive () const
	Returns the emissive coefficient of the surface. More...

void	SetEmissive (const Standard_ShortReal theValue)
	Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0. More...

Standard_ShortReal	Shininess () const
	Returns the luminosity of the surface. More...

void	SetShininess (const Standard_ShortReal theValue)
	Modifies the luminosity of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0. More...

void	IncreaseShine (const Standard_ShortReal theDelta)
	Increases or decreases the luminosity. More...

Standard_ShortReal	RefractionIndex () const
	Returns the refraction index of the material. More...

void	SetRefractionIndex (const Standard_ShortReal theValue)
	Modifies the refraction index of the material. Warning: Raises MaterialDefinitionError if given value is a lesser than 1.0. More...

const Graphic3d_BSDF &	BSDF () const
	Returns BSDF (bidirectional scattering distribution function). More...

void	SetBSDF (const Graphic3d_BSDF &theBSDF)
	Modifies the BSDF (bidirectional scattering distribution function). More...

Standard_Boolean	ReflectionMode (const Graphic3d_TypeOfReflection theType) const
	Returns TRUE if the reflection mode is active, FALSE otherwise. More...

void	SetReflectionMode (const Graphic3d_TypeOfReflection theType, const Standard_Boolean theValue)
	Activates or deactivates the reflective properties of the surface with specified reflection type. More...

void	SetReflectionModeOn (const Graphic3d_TypeOfReflection theType)
	Activates the reflective properties of the surface with specified reflection type. More...

void	SetReflectionModeOff (const Graphic3d_TypeOfReflection theType)
	Deactivates the reflective properties of the surface with specified reflection type. More...

Standard_Boolean	MaterialType (const Graphic3d_TypeOfMaterial theType) const
	Returns TRUE if type of this material is equal to specified type. More...

void	SetMaterialType (const Graphic3d_TypeOfMaterial theType)
	Set material type. More...

Standard_Boolean	IsDifferent (const Graphic3d_MaterialAspect &theOther) const
	Returns TRUE if this material differs from specified one. More...

Standard_Boolean	operator!= (const Graphic3d_MaterialAspect &theOther) const
	Returns TRUE if this material differs from specified one. More...

Standard_Boolean	IsEqual (const Graphic3d_MaterialAspect &theOther) const
	Returns TRUE if this material is identical to specified one. More...

Standard_Boolean	operator== (const Graphic3d_MaterialAspect &theOther) const
	Returns TRUE if this material is identical to specified one. More...

Static Public Member Functions
static Standard_Integer	NumberOfMaterials ()
	Returns the number of predefined textures. More...

static Standard_CString	MaterialName (const Standard_Integer theRank)
	Returns the name of the predefined material of specified rank within range [1, NumberOfMaterials()]. More...

static Graphic3d_TypeOfMaterial	MaterialType (const Standard_Integer theRank)
	Returns the type of the predefined material of specified rank within range [1, NumberOfMaterials()]. More...

static Graphic3d_NameOfMaterial	MaterialFromName (const Standard_CString theName)
	Returns the material for specified name or Graphic3d_NOM_DEFAULT if name is unknown. More...

Detailed Description

This class allows the definition of the type of a surface. Aspect attributes of a 3d face. Keywords: Material, FillArea, Shininess, Ambient, Color, Diffuse, Specular, Transparency, Emissive, ReflectionMode, BackFace, FrontFace, Reflection, Absorbtion.

Constructor & Destructor Documentation

◆ Graphic3d_MaterialAspect() [1/2]

Graphic3d_MaterialAspect::Graphic3d_MaterialAspect ( )

Creates a material from default values.

◆ Graphic3d_MaterialAspect() [2/2]

Graphic3d_MaterialAspect::Graphic3d_MaterialAspect ( const Graphic3d_NameOfMaterial theName )

Creates a generic material.

Member Function Documentation

◆ Alpha()

Standard_ShortReal Graphic3d_MaterialAspect::Alpha ( ) const

inline

Returns the alpha coefficient of the surface (1.0 - Transparency); 1.0 means opaque.

◆ Ambient()

Standard_ShortReal Graphic3d_MaterialAspect::Ambient ( ) const

inline

Returns the reflection properties of the surface.

◆ AmbientColor()

const Quantity_Color& Graphic3d_MaterialAspect::AmbientColor ( ) const

inline

Returns the ambient color of the surface.

◆ BSDF()

const Graphic3d_BSDF& Graphic3d_MaterialAspect::BSDF ( ) const

inline

Returns BSDF (bidirectional scattering distribution function).

◆ Color()

const Quantity_Color& Graphic3d_MaterialAspect::Color ( ) const

inline

Returns the diffuse color of the surface.

◆ Diffuse()

Standard_ShortReal Graphic3d_MaterialAspect::Diffuse ( ) const

inline

Returns the reflection properties of the surface.

◆ DiffuseColor()

const Quantity_Color& Graphic3d_MaterialAspect::DiffuseColor ( ) const

inline

Returns the diffuse color of the surface.

◆ Emissive()

Standard_ShortReal Graphic3d_MaterialAspect::Emissive ( ) const

inline

Returns the emissive coefficient of the surface.

◆ EmissiveColor()

const Quantity_Color& Graphic3d_MaterialAspect::EmissiveColor ( ) const

inline

Returns the emissive color of the surface.

◆ IncreaseShine()

void Graphic3d_MaterialAspect::IncreaseShine ( const Standard_ShortReal theDelta )

Increases or decreases the luminosity.

Parameters

theDelta a signed percentage

◆ IsDifferent()

Standard_Boolean Graphic3d_MaterialAspect::IsDifferent ( const Graphic3d_MaterialAspect & theOther ) const

inline

Returns TRUE if this material differs from specified one.

◆ IsEqual()

Standard_Boolean Graphic3d_MaterialAspect::IsEqual ( const Graphic3d_MaterialAspect & theOther ) const

inline

Returns TRUE if this material is identical to specified one.

◆ MaterialFromName()

static Graphic3d_NameOfMaterial Graphic3d_MaterialAspect::MaterialFromName ( const Standard_CString theName )

static

Returns the material for specified name or Graphic3d_NOM_DEFAULT if name is unknown.

◆ MaterialName() [1/2]

static Standard_CString Graphic3d_MaterialAspect::MaterialName ( const Standard_Integer theRank )

static

Returns the name of the predefined material of specified rank within range [1, NumberOfMaterials()].

◆ MaterialName() [2/2]

Standard_CString Graphic3d_MaterialAspect::MaterialName ( ) const

inline

Returns the given name of this material. This might be:

◆ MaterialType() [1/2]

static Graphic3d_TypeOfMaterial Graphic3d_MaterialAspect::MaterialType ( const Standard_Integer theRank )

static

Returns the type of the predefined material of specified rank within range [1, NumberOfMaterials()].

◆ MaterialType() [2/2]

Standard_Boolean Graphic3d_MaterialAspect::MaterialType ( const Graphic3d_TypeOfMaterial theType ) const

inline

Returns TRUE if type of this material is equal to specified type.

◆ Name()

Graphic3d_NameOfMaterial Graphic3d_MaterialAspect::Name ( ) const

inline

Returns the material name (within predefined enumeration).

◆ NumberOfMaterials()

static Standard_Integer Graphic3d_MaterialAspect::NumberOfMaterials ( )

inlinestatic

Returns the number of predefined textures.

◆ operator!=()

Standard_Boolean Graphic3d_MaterialAspect::operator!= ( const Graphic3d_MaterialAspect & theOther ) const

inline

Returns TRUE if this material differs from specified one.

◆ operator==()

Standard_Boolean Graphic3d_MaterialAspect::operator== ( const Graphic3d_MaterialAspect & theOther ) const

inline

Returns TRUE if this material is identical to specified one.

◆ ReflectionMode()

Standard_Boolean Graphic3d_MaterialAspect::ReflectionMode ( const Graphic3d_TypeOfReflection theType ) const

inline

Returns TRUE if the reflection mode is active, FALSE otherwise.

◆ RefractionIndex()

Standard_ShortReal Graphic3d_MaterialAspect::RefractionIndex ( ) const

inline

Returns the refraction index of the material.

◆ RequestedName()

Graphic3d_NameOfMaterial Graphic3d_MaterialAspect::RequestedName ( ) const

inline

Returns the material name within predefined enumeration which has been requested (before modifications).

◆ Reset()

void Graphic3d_MaterialAspect::Reset ( void )

inline

Resets the material with the original values according to the material name but leave the current color values untouched for the material of type ASPECT.

◆ SetAlpha()

void Graphic3d_MaterialAspect::SetAlpha ( Standard_ShortReal theValue )

inline

Modifies the alpha coefficient of the surface, where 1.0 is opaque and 0.0 is fully transparent.

◆ SetAmbient()

void Graphic3d_MaterialAspect::SetAmbient ( const Standard_ShortReal theValue )

Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0.

◆ SetAmbientColor()

void Graphic3d_MaterialAspect::SetAmbientColor ( const Quantity_Color & theColor )

Modifies the ambient color of the surface.

◆ SetBSDF()

void Graphic3d_MaterialAspect::SetBSDF ( const Graphic3d_BSDF & theBSDF )

inline

Modifies the BSDF (bidirectional scattering distribution function).

◆ SetColor()

void Graphic3d_MaterialAspect::SetColor ( const Quantity_Color & theColor )

Modifies the ambient and diffuse color of the surface.

◆ SetDiffuse()

void Graphic3d_MaterialAspect::SetDiffuse ( const Standard_ShortReal theValue )

Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0.

◆ SetDiffuseColor()

void Graphic3d_MaterialAspect::SetDiffuseColor ( const Quantity_Color & theColor )

Modifies the diffuse color of the surface.

◆ SetEmissive()

void Graphic3d_MaterialAspect::SetEmissive ( const Standard_ShortReal theValue )

Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0.

◆ SetEmissiveColor()

void Graphic3d_MaterialAspect::SetEmissiveColor ( const Quantity_Color & theColor )

Modifies the emissive color of the surface.

◆ SetMaterialName()

void Graphic3d_MaterialAspect::SetMaterialName ( const TCollection_AsciiString & theName )

inline

The current material become a "UserDefined" material. Set the name of the "UserDefined" material.

◆ SetMaterialType()

void Graphic3d_MaterialAspect::SetMaterialType ( const Graphic3d_TypeOfMaterial theType )

Set material type.

◆ SetReflectionMode()

void Graphic3d_MaterialAspect::SetReflectionMode	(	const Graphic3d_TypeOfReflection	theType,
		const Standard_Boolean	theValue
	)

Activates or deactivates the reflective properties of the surface with specified reflection type.

Disabling diffuse and specular reflectance is useful for efficient visualization of large amounts of data as definition of normals for graphic primitives is not needed when only "all-directional" reflectance is active.

NOTE: Disabling all four reflection modes also turns off the following effects:

Lighting. Colors of primitives are not affected by the material properties when lighting is off.
Transparency.

◆ SetReflectionModeOff()

void Graphic3d_MaterialAspect::SetReflectionModeOff ( const Graphic3d_TypeOfReflection theType )

inline

Deactivates the reflective properties of the surface with specified reflection type.

◆ SetReflectionModeOn()

void Graphic3d_MaterialAspect::SetReflectionModeOn ( const Graphic3d_TypeOfReflection theType )

inline

Activates the reflective properties of the surface with specified reflection type.

◆ SetRefractionIndex()

void Graphic3d_MaterialAspect::SetRefractionIndex ( const Standard_ShortReal theValue )

Modifies the refraction index of the material. Warning: Raises MaterialDefinitionError if given value is a lesser than 1.0.

◆ SetShininess()

void Graphic3d_MaterialAspect::SetShininess ( const Standard_ShortReal theValue )

Modifies the luminosity of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0.

◆ SetSpecular()

void Graphic3d_MaterialAspect::SetSpecular ( const Standard_ShortReal theValue )

Modifies the reflection properties of the surface. Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0.

◆ SetSpecularColor()

void Graphic3d_MaterialAspect::SetSpecularColor ( const Quantity_Color & theColor )

Modifies the specular color of the surface.

◆ SetTransparency()

void Graphic3d_MaterialAspect::SetTransparency ( const Standard_ShortReal theValue )

Modifies the transparency coefficient of the surface, where 0 is opaque and 1 is fully transparent. Transparency is applicable to materials that have at least one of reflection modes (ambient, diffuse, specular or emissive) enabled. See also SetReflectionModeOn() and SetReflectionModeOff() methods.

Warning: Raises MaterialDefinitionError if given value is a negative value or greater than 1.0.

◆ Shininess()

Standard_ShortReal Graphic3d_MaterialAspect::Shininess ( ) const

inline

Returns the luminosity of the surface.

◆ Specular()

Standard_ShortReal Graphic3d_MaterialAspect::Specular ( ) const

inline

Returns the reflection properties of the surface.

◆ SpecularColor()

const Quantity_Color& Graphic3d_MaterialAspect::SpecularColor ( ) const

inline

Returns the specular color of the surface.

◆ StringName()

const TCollection_AsciiString& Graphic3d_MaterialAspect::StringName ( ) const

inline

Returns the given name of this material. This might be:

given name set by method ::SetMaterialName()
standard name for a material within enumeration
"UserDefined" for non-standard material without name specified externally.

◆ Transparency()

Standard_ShortReal Graphic3d_MaterialAspect::Transparency ( ) const

inline

Returns the transparency coefficient of the surface (1.0 - Alpha); 0.0 means opaque.

The documentation for this class was generated from the following file:

Graphic3d_MaterialAspect.hxx

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Graphic3d_MaterialAspect() [1/2]

◆ Graphic3d_MaterialAspect() [2/2]

Member Function Documentation

◆ Alpha()

◆ Ambient()

◆ AmbientColor()

◆ BSDF()

◆ Color()

◆ Diffuse()

◆ DiffuseColor()

◆ Emissive()

◆ EmissiveColor()

◆ IncreaseShine()

◆ IsDifferent()

◆ IsEqual()

◆ MaterialFromName()

◆ MaterialName() [1/2]

◆ MaterialName() [2/2]

◆ MaterialType() [1/2]

◆ MaterialType() [2/2]

◆ Name()

◆ NumberOfMaterials()

◆ operator!=()

◆ operator==()

◆ ReflectionMode()

◆ RefractionIndex()

◆ RequestedName()

◆ Reset()

◆ SetAlpha()

◆ SetAmbient()

◆ SetAmbientColor()

◆ SetBSDF()

◆ SetColor()

◆ SetDiffuse()

◆ SetDiffuseColor()

◆ SetEmissive()

◆ SetEmissiveColor()

◆ SetMaterialName()

◆ SetMaterialType()

◆ SetReflectionMode()

◆ SetReflectionModeOff()

◆ SetReflectionModeOn()

◆ SetRefractionIndex()

◆ SetShininess()

◆ SetSpecular()

◆ SetSpecularColor()

◆ SetTransparency()

◆ Shininess()

◆ Specular()

◆ SpecularColor()

◆ StringName()

◆ Transparency()