Geometry QML Type

Base type for custom geometry. More...

Import Statement: import QtQuick3D 1.0
Instantiates: QQuick3DGeometry
Inherits:

Object3D

Inherited By:

GridGeometry

Detailed Description

Custom geometry allows using application-generated vertex and index data, that can possibly change dynamically as well. To use custom geometry, do not assign a .mesh file as the source to a Model. Instead, set its geometry property to reference a Geometry object.

Custom geometry is implemented in C++ by setting up a QQuick3DGeometry instance, often subclassing it. The QQuick3DGeometry type is registered to QML under the name of Geometry. Once the subclass is registered to QML, Model objects can start referencing it.

One built-in custom geometry provider is the GridGeometry type in the Helpers module. This can be used like the following. Any other application-provided Geometry can be taken into use in the same manner.

 import QtQuick3D.Helpers 1.15

 Model {
     geometry: GridGeometry {
     }
     materials: [
         DefaultMaterial {
             emissiveColor: "white"
             lighting: DefaultMaterial.NoLighting
         }
     ]
 }

See also Model and QQuick3DGeometry.