Initializer

init(name:semantic:float:)

Initializes a material property with a scalar value.

Declaration

convenience init(name: String, semantic: MDLMaterialSemantic, float value: Float)

Parameters

name

A descriptive name for the material property. For details, see the name property.

semantic

The semantic meaning for the material property’s value. For details, see the semantic property.

value

The scalar floating-point value for the material property.

Return Value

A new material property object whose type property is MDLMaterialPropertyType.float.

Discussion

Scalar values are appropriate for some semantics, such as the MDLMaterialSemantic.specularTint semantic (which controls the balance between material and light colors in specular highlighting). Providing a float value for the material property applies that value for all pixels rendered using the material; to provide variation in the semantic’s value across a surface, use a grayscale texture image instead.

See Also

Creating a Material Property

init(name: String, semantic: MDLMaterialSemantic)

Initializes a material property without a value.

init(name: String, semantic: MDLMaterialSemantic, string: String?)

Initializes a material property with a string value.

init(name: String, semantic: MDLMaterialSemantic, url: URL?)

Initializes a material property with a URL value.

init(name: String, semantic: MDLMaterialSemantic, textureSampler: MDLTextureSampler?)

Initializes a material property with a texture sampler object.

init(name: String, semantic: MDLMaterialSemantic, color: CGColor)

Initializes a material property with a color value.

init(name: String, semantic: MDLMaterialSemantic, float2: vector_float2)

Initializes a material property with a 2-component vector value.

init(name: String, semantic: MDLMaterialSemantic, float3: vector_float3)

Initializes a material property with a 3-component vector value.

init(name: String, semantic: MDLMaterialSemantic, float4: vector_float4)

Initializes a material property with a 4-component vector value.

init(name: String, semantic: MDLMaterialSemantic, matrix4x4: matrix_float4x4)

Initializes a material property with a 4 x 4 matrix value.