Instance Property


An object that provides color values to determine the apparent smoothness of the surface.


@property(nonatomic, readonly) SCNMaterialProperty *roughness;


This property measures only the total intensity of color values; texture contents are best defined in grayscale.

This property approximates the level of microscopic detail—for example tiny bumps and cracks—in a surface. By approximating these “microfacets” as a single term, this property helps produce lighting calculations that resemble the energy-conserving laws of real-world physics, resulting in more realistic variation between matte and shiny surfaces. Lower values (darker colors) cause the material to appear shiny, with well-defined specular highlights. Higher values (brighter colors) cause specular highlights to spread out and the diffuse color of the material to become more retroreflective.

This property applies only when the material’s lightingModelName value is SCNLightingModelPhysicallyBased.

See Also

Visual Properties for Physically Based Shading


An object that manages the material’s diffuse response to lighting.


An object that provides color values to determine how metallic the material’s surface appears.