Material QML Type | Qt Quick 3D 5.15.1

- Qt 5.15
- Qt Quick 3D
- QML Types
- Material QML Type
- Qt Quick 3D | Commercial or GPLv3

# Material QML Type

Lets you define material for the 3D item. More...

Import Statement: | import QtQuick3D 1.15
Inherits: | Object3D
Inherited By: | CustomMaterial, DefaultMaterial, and PrincipledMaterial

- List of all members, including inherited members

## Properties

- cullMode : enumeration
- displacementAmount : real
- displacementMap : Texture
- lightProbe : Texture
- lightmapIndirect : Texture
- lightmapRadiosity : Texture
- lightmapShadow : Texture

## Detailed Description

## Property Documentation

cullMode : enumeration

This property defines whether culling is enabled and which mode is actually enabled.

FrontFace means polygons' winding is clockwise in window coordinates and BackFace means otherwise.

Constant | Description
--- | ---
`Material.BackFaceCulling` | Default; Backface will not be rendered.
`Material.FrontFaceCulling` | Frontface will not be rendered.
`Material.NoCulling` | Both faces will be rendered.

displacementAmount : real

This property controls the offset amount for the Material::displacmentMap.

displacementMap : Texture

This property defines grayscale image used to offset the vertices of geometry across the surface of the material. Brighter pixels indicate raised regions.

Note: Displacement maps require vertices to offset. I.e. the result will be more accurate on a high poly model than on a low poly model.

Note: Displacement maps do not affect the normals of your geometry. To look correct with lighting or reflections you will likely want to also add a matching bump map or normal map to your material.

lightProbe : Texture

This property defines a Texture for overriding or setting an image based lighting Texture for use with this material.

See also SceneEnvironment::lightProbe.

lightmapIndirect : Texture

This property defines a baked lightmap Texture containing indirect lighting information for this material.

Note: This feature is still in development so there is currently no way to bake lights. The texture currently still uses the UV1 coordinates which is going to change later to UV2.

lightmapRadiosity : Texture

This property defines a baked lightmap Texture containing direct lighting information for this material.

Note: This feature is still in development so there is currently no way to bake lights. The texture currently still uses the UV1 coordinates which is going to change later to UV2.

lightmapShadow : Texture

This property defines a baked lightmap Texture containing shadowing information for this material.

Note: This feature is still in development so there is currently no way to bake lights. The texture currently still uses the UV1 coordinates which is going to change later to UV2.