Castle Game Engine

Class TMaterialNode

Description
Hierarchy
Fields
Methods
Properties

Unit

X3DNodes

Declaration

type TMaterialNode = class(TAbstractOneSidedMaterialNode)

Description

Material determines how the geometry looks on the screen, by providing parameters to the lighting equations. This is the material responsible for the Phong lighting model.

It specifies how light affects one side of the surface.

Note: Whether the shape is visible from both sides depends on the geometry TAbstractGeometryNode.Solid field, and is independent of whether you use this node or TTwoSidedMaterialNode.

Hierarchy

Overview

Methods

Public destructor Destroy; override;
Public class function ForVRMLVersion(const Version: TX3DVersion): boolean; override;
Public function Opacity: Single;
Public function ShininessExp: Single;
Public function MaterialInfo: TMaterialInfo; override;
Public function PureEmissive: boolean;
Public procedure ForcePureEmissive; deprecated 'use TUnlitMaterialNode for unlit materials';
Public procedure CreateNode; override;
Public class function ClassX3DType: String; override;
Public procedure SetReflSpecular(const Value: array of TCastleColorRGB); overload;
Public procedure SetReflSpecular(const Value: TVector3List); overload;
Public procedure SetReflDiffuse(const Value: array of TCastleColorRGB); overload;
Public procedure SetReflDiffuse(const Value: TVector3List); overload;
Public procedure SetTransSpecular(const Value: array of TCastleColorRGB); overload;
Public procedure SetTransSpecular(const Value: TVector3List); overload;
Public procedure SetTransDiffuse(const Value: array of TCastleColorRGB); overload;
Public procedure SetTransDiffuse(const Value: TVector3List); overload;

Properties

Public property FdAmbientIntensity: TSFFloat read FFdAmbientIntensity;
Public property AmbientIntensity: Single read GetAmbientIntensity write SetAmbientIntensity;
Public property FdAmbientTexture: TSFNode read FFdAmbientTexture;
Public property AmbientTexture: TAbstractSingleTextureNode read GetAmbientTexture write SetAmbientTexture;
Public property FdAmbientTextureMapping: TSFString read FFdAmbientTextureMapping;
Public property AmbientTextureMapping: String read GetAmbientTextureMapping write SetAmbientTextureMapping;
Public property FdDiffuseColor: TSFColor read FFdDiffuseColor;
Public property DiffuseColor: TCastleColorRGB read GetDiffuseColor write SetDiffuseColor;
Public property FdDiffuseTexture: TSFNode read FFdDiffuseTexture;
Public property DiffuseTexture: TAbstractSingleTextureNode read GetDiffuseTexture write SetDiffuseTexture;
Public property FdDiffuseTextureMapping: TSFString read FFdDiffuseTextureMapping;
Public property DiffuseTextureMapping: String read GetDiffuseTextureMapping write SetDiffuseTextureMapping;
Public property FdOcclusionStrength: TSFFloat read FFdOcclusionStrength;
Public property OcclusionStrength: Single read GetOcclusionStrength write SetOcclusionStrength;
Public property FdOcclusionTexture: TSFNode read FFdOcclusionTexture;
Public property OcclusionTexture: TAbstractSingleTextureNode read GetOcclusionTexture write SetOcclusionTexture;
Public property FdOcclusionTextureMapping: TSFString read FFdOcclusionTextureMapping;
Public property OcclusionTextureMapping: String read GetOcclusionTextureMapping write SetOcclusionTextureMapping;
Public property FdShininess: TSFFloat read FFdShininess;
Public property Shininess: Single read GetShininess write SetShininess;
Public property FdShininessTexture: TSFNode read FFdShininessTexture;
Public property ShininessTexture: TAbstractSingleTextureNode read GetShininessTexture write SetShininessTexture;
Public property FdShininessTextureMapping: TSFString read FFdShininessTextureMapping;
Public property ShininessTextureMapping: String read GetShininessTextureMapping write SetShininessTextureMapping;
Public property FdSpecularColor: TSFColor read FFdSpecularColor;
Public property SpecularColor: TCastleColorRGB read GetSpecularColor write SetSpecularColor;
Public property FdSpecularTexture: TSFNode read FFdSpecularTexture;
Public property SpecularTexture: TAbstractSingleTextureNode read GetSpecularTexture write SetSpecularTexture;
Public property FdSpecularTextureMapping: TSFString read FFdSpecularTextureMapping;
Public property SpecularTextureMapping: String read GetSpecularTextureMapping write SetSpecularTextureMapping;
Public property FdTransparency: TSFFloat read FFdTransparency;
Public property Transparency: Single read GetTransparency write SetTransparency;
Public property FdFogImmune: TSFBool read FFdFogImmune;
Public property FogImmune: Boolean read GetFogImmune write SetFogImmune;
Public property FdMirror: TSFFloat read FFdMirror;
Public property Mirror: Single read GetMirror write SetMirror;
Public property FdReflSpecular: TMFColor read FFdReflSpecular;
Public property FdReflDiffuse: TMFColor read FFdReflDiffuse;
Public property FdTransSpecular: TMFColor read FFdTransSpecular;
Public property FdTransDiffuse: TMFColor read FFdTransDiffuse;
Public property FdReflSpecularExp: TSFFloat read FFdReflSpecularExp;
Public property ReflSpecularExp: Single read GetReflSpecularExp write SetReflSpecularExp;
Public property FdTransSpecularExp: TSFFloat read FFdTransSpecularExp;
Public property TransSpecularExp: Single read GetTransSpecularExp write SetTransSpecularExp;

Description

Methods

Public destructor Destroy; override;
 
Public class function ForVRMLVersion(const Version: TX3DVersion): boolean; override;
 
Public function Opacity: Single;

Opacity is just a 1 - FdTransparency.Value. Defined for your comfort — for OpenGL you will usually want to pass Opacity, not Transparency.

Public function ShininessExp: Single;

ShininessExp is just 128 * FdShininess.Value, this is the "real" exponent indicated by shininess field value. Defined for your comfort — for any graphic library you will usually want to pass the "real" exponent given by this function, not just value of shininess field.

Public function MaterialInfo: TMaterialInfo; override;
 
Public function PureEmissive: boolean;

Only the emissiveColor is not black (zero), which means that the material behaves like unlit.

This checks that ambient and diffuse and specular colors are all zero. It's an important information about the material sometimes. It is similar to the NULL material situation (when "Appearance.material=NULL" case), but the color and transparency are still configurable (using FdEmissiveColor and FdTransparency fields).

We can optimize this case when rendering.

Public procedure ForcePureEmissive; deprecated 'use TUnlitMaterialNode for unlit materials';

Warning: this symbol is deprecated: use TUnlitMaterialNode for unlit materials

Force the material pure emissive (see PureEmissive) by setting other colors to black.

Public procedure CreateNode; override;

Create node fields and events.

Public class function ClassX3DType: String; override;
 
Public procedure SetReflSpecular(const Value: array of TCastleColorRGB); overload;
 
Public procedure SetReflSpecular(const Value: TVector3List); overload;
 
Public procedure SetReflDiffuse(const Value: array of TCastleColorRGB); overload;
 
Public procedure SetReflDiffuse(const Value: TVector3List); overload;
 
Public procedure SetTransSpecular(const Value: array of TCastleColorRGB); overload;
 
Public procedure SetTransSpecular(const Value: TVector3List); overload;
 
Public procedure SetTransDiffuse(const Value: array of TCastleColorRGB); overload;
 
Public procedure SetTransDiffuse(const Value: TVector3List); overload;
 

Properties

Public property FdAmbientIntensity: TSFFloat read FFdAmbientIntensity;

Internal wrapper for property AmbientIntensity. This wrapper API may change, we advise to access simpler AmbientIntensity instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property AmbientIntensity: Single read GetAmbientIntensity write SetAmbientIntensity;
 
Public property FdAmbientTexture: TSFNode read FFdAmbientTexture;

Internal wrapper for property AmbientTexture. This wrapper API may change, we advise to access simpler AmbientTexture instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property AmbientTexture: TAbstractSingleTextureNode read GetAmbientTexture write SetAmbientTexture;
 
Public property FdAmbientTextureMapping: TSFString read FFdAmbientTextureMapping;

Internal wrapper for property AmbientTextureMapping. This wrapper API may change, we advise to access simpler AmbientTextureMapping instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property AmbientTextureMapping: String read GetAmbientTextureMapping write SetAmbientTextureMapping;
 
Public property FdDiffuseColor: TSFColor read FFdDiffuseColor;

Internal wrapper for property DiffuseColor. This wrapper API may change, we advise to access simpler DiffuseColor instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property DiffuseColor: TCastleColorRGB read GetDiffuseColor write SetDiffuseColor;

The primary way to control the color of object with Phong material. The object reflects light sources depending on the angle of the surface with respect to the light source. The more directly the surface faces the light, the more diffuse light reflects.

Public property FdDiffuseTexture: TSFNode read FFdDiffuseTexture;

Internal wrapper for property DiffuseTexture. This wrapper API may change, we advise to access simpler DiffuseTexture instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property DiffuseTexture: TAbstractSingleTextureNode read GetDiffuseTexture write SetDiffuseTexture;

The primary texture to control the color of object with Phong material. The RGB channel of this texture is multiplied with DiffuseColor, and alpha channel is multiplied with the opacity (1-Transparency).

Public property FdDiffuseTextureMapping: TSFString read FFdDiffuseTextureMapping;

Internal wrapper for property DiffuseTextureMapping. This wrapper API may change, we advise to access simpler DiffuseTextureMapping instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property DiffuseTextureMapping: String read GetDiffuseTextureMapping write SetDiffuseTextureMapping;
 
Public property FdOcclusionStrength: TSFFloat read FFdOcclusionStrength;

Internal wrapper for property OcclusionStrength. This wrapper API may change, we advise to access simpler OcclusionStrength instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property OcclusionStrength: Single read GetOcclusionStrength write SetOcclusionStrength;
 
Public property FdOcclusionTexture: TSFNode read FFdOcclusionTexture;

Internal wrapper for property OcclusionTexture. This wrapper API may change, we advise to access simpler OcclusionTexture instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property OcclusionTexture: TAbstractSingleTextureNode read GetOcclusionTexture write SetOcclusionTexture;
 
Public property FdOcclusionTextureMapping: TSFString read FFdOcclusionTextureMapping;

Internal wrapper for property OcclusionTextureMapping. This wrapper API may change, we advise to access simpler OcclusionTextureMapping instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property OcclusionTextureMapping: String read GetOcclusionTextureMapping write SetOcclusionTextureMapping;
 
Public property FdShininess: TSFFloat read FFdShininess;

Internal wrapper for property Shininess. This wrapper API may change, we advise to access simpler Shininess instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property Shininess: Single read GetShininess write SetShininess;
 
Public property FdShininessTexture: TSFNode read FFdShininessTexture;

Internal wrapper for property ShininessTexture. This wrapper API may change, we advise to access simpler ShininessTexture instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property ShininessTexture: TAbstractSingleTextureNode read GetShininessTexture write SetShininessTexture;
 
Public property FdShininessTextureMapping: TSFString read FFdShininessTextureMapping;

Internal wrapper for property ShininessTextureMapping. This wrapper API may change, we advise to access simpler ShininessTextureMapping instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property ShininessTextureMapping: String read GetShininessTextureMapping write SetShininessTextureMapping;
 
Public property FdSpecularColor: TSFColor read FFdSpecularColor;

Internal wrapper for property SpecularColor. This wrapper API may change, we advise to access simpler SpecularColor instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property SpecularColor: TCastleColorRGB read GetSpecularColor write SetSpecularColor;

Color of specular highlight, on shiny objects.

Public property FdSpecularTexture: TSFNode read FFdSpecularTexture;

Internal wrapper for property SpecularTexture. This wrapper API may change, we advise to access simpler SpecularTexture instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property SpecularTexture: TAbstractSingleTextureNode read GetSpecularTexture write SetSpecularTexture;
 
Public property FdSpecularTextureMapping: TSFString read FFdSpecularTextureMapping;

Internal wrapper for property SpecularTextureMapping. This wrapper API may change, we advise to access simpler SpecularTextureMapping instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property SpecularTextureMapping: String read GetSpecularTextureMapping write SetSpecularTextureMapping;
 
Public property FdTransparency: TSFFloat read FFdTransparency;

Internal wrapper for property Transparency. This wrapper API may change, we advise to access simpler Transparency instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property Transparency: Single read GetTransparency write SetTransparency;

Setting Transparency to value > 0 makes the object partially-transparent. Setting it to 1.0 makes it even invisible (but still collidable). If you want to render the object using blending (which is usually the case for partially-transparent) it is recommended to specify it explicitly using TAppearanceNode.AlphaMode.

Public property FdFogImmune: TSFBool read FFdFogImmune;

Internal wrapper for property FogImmune. This wrapper API may change, we advise to access simpler FogImmune instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property FogImmune: Boolean read GetFogImmune write SetFogImmune;
 
Public property FdMirror: TSFFloat read FFdMirror;

Internal wrapper for property Mirror. This wrapper API may change, we advise to access simpler Mirror instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property Mirror: Single read GetMirror write SetMirror;
 
Public property FdReflSpecular: TMFColor read FFdReflSpecular;

Internal wrapper for property ReflSpecular. This wrapper API may change, we advise to access simpler ReflSpecular instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property FdReflDiffuse: TMFColor read FFdReflDiffuse;

Internal wrapper for property ReflDiffuse. This wrapper API may change, we advise to access simpler ReflDiffuse instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property FdTransSpecular: TMFColor read FFdTransSpecular;

Internal wrapper for property TransSpecular. This wrapper API may change, we advise to access simpler TransSpecular instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property FdTransDiffuse: TMFColor read FFdTransDiffuse;

Internal wrapper for property TransDiffuse. This wrapper API may change, we advise to access simpler TransDiffuse instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property FdReflSpecularExp: TSFFloat read FFdReflSpecularExp;

Internal wrapper for property ReflSpecularExp. This wrapper API may change, we advise to access simpler ReflSpecularExp instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property ReflSpecularExp: Single read GetReflSpecularExp write SetReflSpecularExp;
 
Public property FdTransSpecularExp: TSFFloat read FFdTransSpecularExp;

Internal wrapper for property TransSpecularExp. This wrapper API may change, we advise to access simpler TransSpecularExp instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Public property TransSpecularExp: Single read GetTransSpecularExp write SetTransSpecularExp;
 
Generated by PasDoc 0.16.0.

Copyright Michalis Kamburelis and Castle Game Engine Contributors.

This webpage is also open-source and we welcome pull requests to improve it.

We use cookies for analytics. See our privacy policy.