MaterialAppearance

A plot attribute for adding material appearance to 3D volume plots, 2D and 3D surface plots, isosurface plots. surface data plots, and radiation pattern plots.

Syntax

model.result(<pgtag>).feature(<ftag>).create(<atag>,"MaterialAppearance");

model.result(<pgtag>).feature(<ftag>).feature(<atag>).set(property, <value>);

Description

model.result(<pgtag>).feature(<ftag>).create(<atag>,"MaterialAppearance") adds a material appearance plot named <atag> as an attribute to a volume, surface or surface data, isosurface, or radiation pattern plot named <ftag>.

This plot attribute replaces the standard results plot with a material appearance.

The following properties are available:

Table 7-67: Valid Properties for A MaterialAppearance attribute
name	Value	Default	Description
appearance	material \| custom	material	Take the appearance from a material or define a custom appearance.
material	tag of a material or none		The tag of the material with the appearance to use, when appearance is set to material.
usematerialsel	true \| false	true	Use the selection for the material specified for the material property. Not available when material is set to none.
useplotcolors	true \| false	false	Use the color from the parent plot instead of the material’s color. Also, set this property to true to overlay an image.

If appearance is set to custom, the following additional properties are available:

Table 7-68: Properties for custom appearance of Materials
Property	Value	Default	Description
alpha	double	1	Diffuse and ambient color opacity.
ambient	string[] (a color or custom)	custom	Ambient light color.
customambient	double[]		RGB values for a custom ambient color.
customdiffuse	double[]		RGB values for a custom diffuse color.
customspecular	double[]		RGB values for a custom specular color.
diffuse	string[] (a color or custom)	custom	Diffuse light color.
fresnel	double	0.5	Reflectance at normal incidence for Cook-Torrance.
lighting	phong \| cooktorrance \| simple	phong	Lighting model.
noise	on \| off	off	Add noise to the appearance.
noisefreq	double[]	1	Normal vector noise scale.
noisescale	double[]	0	Normal vector noise scale.
roughness	double	0.1	Surface roughness for Cook-Torrance lighting model.
shininess	double	64	Specular exponent for Blinn-Phong lighting model.
specular	string[] (a color or custom)	custom	Specular light color.