Property IMaterialPropertyValues As System.Double

Dim instance As IFace2
Dim value As System.Double
 
instance.IMaterialPropertyValues = value
 
value = instance.IMaterialPropertyValues

System.double IMaterialPropertyValues {get; set;}

property System.double IMaterialPropertyValues {
   System.double get();
   void set ( &   System.double value);
}

Property Value

The material values include the face color (R,G,B values), reflectivity (ambient, diffuse, specular, shininess), transparency and emission. All values can be from 0 to 1.

This method returns a NULL VARIANT (or an S_false HRESULT for COM implementations) if this face has not been explicitly modified from the material property values of the body. If you create a body and change the body color to red, then IFace2::IGetMaterialPropertyValues2 and IFace2::GetMaterialPropertyValues2 return a NULL array because you did not specifically change the values of the face.

The format of the parameters or return values is an array of doubles as follows:

[ R, G, B, Ambient, Diffuse, Specular, Shininess, Transparency, Emission ]

1. Specify R, G, and B, each with a value between 0.0 and 1.0, inclusive. (These values are internally multiplied by 255.0 to determine the RGB color.)
2. Specify the reflectivity properties (Diffuse, Specular, Shininess (1.0 - Specular spread/Blurriness)), each with a value greater than 0.0 and less than or equal to 1.0.
3. Specify Ambient, Transparency and Emission, each with a value between 0.0 and 1.0, inclusive.
4. Refresh the graphics area after setting this property.

To reset the face to use the default part material properties, use IModelDoc2::SelectedFaceProperties.

This method does not support faces obtained from reference surface bodies.