A set of material properties that describes a physically realistic shading model for materials.
- iOS 9.0+
- macOS 10.11+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
The set of material properties that define a material's response to lighting is also called the Bidirectional Reflectance Distribution Function, or BRDF, for surfaces shaded using that MDLMaterial object. The properties defined by this class, along with some properties inherited from the superclass
MDLScatteringFunction, describe a shading model that more closely simulates real-world lighting physics than traditional shading models. (This shading model is similar to those used in recent game engines and feature films.)
The valid range for each material property in this shading function is
1.0, inclusive. Creating a new scattering function object with the inherited
init method creates a set of material properties with useful default values for this shading model.
Working with Shading Properties
The degree to which light scatters under the surface of the material.
The degree to which the material appears as a dielectric surface (lower values) or as a metal (higher values).
The tendency of the material to generate specular highlights.
The balance of color for specular highlights, between the light color (lower values) and the material’s base color (at higher values).
The degree to which a material appears smooth, affecting both diffuse and specular response.
The degree to which specular highlights elongate in the direction of the local tangent basis.
The angle at which anisotropic effects are rotated relative to the local tangent basis.
The intensity of highlights that appear only at glancing angles on a material’s surface.
The balance of color for highlights that appear only at glancing angles, between the light color (lower values) and the material’s base color (at higher values).
The intensity of a second specular highlight, similar to the gloss that results from a clear coat on an automotive finish.
The sharpness of a second specular highlight, similar to the gloss that results from a clear coat on an automotive finish.
A collection of material properties that together describe the intended surface appearance for rendering a 3D object.
A definition for one specific aspect of the rendering parameters for a material.
A set of material properties that describes a basic shading model for materials, and the superclass for more complex shading models.
This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.Learn more about using Apple's beta software