KhronosPbrMaterial

@MainThread
public void close()

Closes the KhronosPbrMaterial and releases its underlying graphics resources.

After being closed, the KhronosPbrMaterial should not be used further.

@MainThread
public static final @NonNull KhronosPbrMaterial create(@NonNull Session session, @NonNull AlphaMode alphaMode)

Asynchronously creates a KhronosPbrMaterial.

@MainThread
public final void setAlphaCutoff(@FloatRange(from = 0.0, to = 1.0) float alphaCutoff)

Sets the alpha cutoff threshold.

This value is only used when the material's alphaMode is AlphaMode.MASK.

@MainThread
public final void setBaseColorFactor(@NonNull Vector4 factor)

Sets a linear multiplier for the base color.

By default this is 1, 1, 1, 1.

@MainThread
public final void setBaseColorTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets the material's base color using a texture.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the base color will always be the base color factor.

@MainThread
public final void setClearcoatFactor(@FloatRange(from = 0.0, to = 1.0) float factor)

Sets a scalar multiplier for the clearcoat layer's intensity.

Other methods for controlling the clearcoat layer include:

• setClearcoatTexture

• setClearcoatNormalTexture

• setClearcoatRoughnessTexture

• setClearcoatRoughnessFactor

@MainThread
public final void setClearcoatNormalTexture(
    @NonNull Texture texture,
    @FloatRange(from = 0.0) float scale,
    @NonNull TextureSampler sampler
)

Sets the normal map texture for the clearcoat layer.

By default the texture is unset, in which case no normal mapping is done for the clearcoat, even if the base color has normal mapping.

@MainThread
public final void setClearcoatRoughnessFactor(@FloatRange(from = 0.0, to = 1.0) float factor)

Sets a scalar multiplier for the clearcoat layer's roughness.

@MainThread
public final void setClearcoatRoughnessTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets the clearcoat roughness texture.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the clearcoat roughness values will always come from the clearcoat roughness factor.

@MainThread
public final void setClearcoatTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets the clearcoat intensity texture.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the clearcoat intensity values will always come from the clearcoat factor.

@MainThread
public final void setEmissiveFactor(@NonNull Vector3 factor)

Sets a linear multiplier for the emissive color.

By default this is 0, 0, 0.

@MainThread
public final void setEmissiveTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets the emissive texture, defining light emitted by the material.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the emissive values will always come from the emissive factor.

@MainThread
public final void setMetallicFactor(@FloatRange(from = 0.0, to = 1.0) float factor)

Sets a scalar multiplier for the material's metallic property.

@MainThread
public final void setMetallicRoughnessTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets a texture defining metallic and roughness properties.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the metalic and roughness values will always come from the corresponding factors.

@MainThread
public final void setNormalTexture(
    @NonNull Texture texture,
    @FloatRange(from = 0.0) float scale,
    @NonNull TextureSampler sampler
)

Sets the normal map texture for surface detail.

By default the texture is unset, in which case no normal mapping is done.

@MainThread
public final void setOcclusionTexture(
    @NonNull Texture texture,
    @FloatRange(from = 0.0, to = 1.0) float strength,
    @NonNull TextureSampler sampler
)

Sets the ambient occlusion texture.

By default this is unset, in which case there is no ambient occlusion.

@MainThread
public final void setRoughnessFactor(@FloatRange(from = 0.0, to = 1.0) float factor)

Sets a scalar multiplier for the material's roughness.

@MainThread
public final void setSheenColorFactor(@NonNull Vector3 factor)

Sets a linear multiplier for the sheen color.

By default this is 0, 0, 0.

@MainThread
public final void setSheenColorTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets the sheen color texture, for materials like fabric.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the sheen color values will always come from the sheen color factor.

@MainThread
public final void setSheenRoughnessFactor(@FloatRange(from = 0.0, to = 1.0) float factor)

Sets a scalar multiplier for the sheen layer's roughness.

@MainThread
public final void setSheenRoughnessTexture(
    @NonNull Texture texture,
    @NonNull TextureSampler sampler
)

Sets the sheen roughness texture.

By default this is a white texture, where all pixels are 1, 1, 1, 1. In other words, if this is left as default, the sheen roughness values will always come from the sheen roughness factor.