- Qt 6.12
- Qt Quick 3D Physics
- QML Types
- ConvexMeshShape
- Qt Quick 3D Physics | Commercial or GPLv3

# ConvexMeshShape QML Type

A convex collision shape based on a 3D mesh. More...

Import Statement: | `import QtQuick3D.Physics`
Since: | Qt 6.4
Inherits: | CollisionShape

- List of all members, including inherited members

## Properties

- geometry : Geometry `(since 6.7)`
- source : url

## Detailed Description

This type defines a convex shape based on the same 3D mesh file format used by QtQuick3D.Model. If the mesh is not convex, the convex hull of the mesh will be used.

See also Qt Quick 3D Physics Shapes, Bodies and Joints and TriangleMeshShape.

## Property Documentation

### geometry : Geometry `[since 6.7]`

This property defines the geometry of a mesh used to define the shape. If the mesh is not convex, the convex hull of the mesh will be used. The maximum number of faces and vertices is 255: If the mesh is more detailed than that, it will be simplified.

Note: If both the geometry and source properties are set then only geometry will be used.

This property was introduced in Qt 6.7.

See also ConvexMeshShape::source.

### source : url

This property defines the location of the mesh file used to define the shape. If the mesh is not convex, the convex hull of the mesh will be used. The maximum number of faces and vertices is 255: If the mesh is more detailed than that, it will be simplified.

Internally, ConvexMeshShape converts the mesh to an optimized data structure. This conversion can be done in advance. See the cooking overview documentation for details.

Note: If both the geometry and source properties are set then only geometry will be used.

See also ConvexMeshShape::geometry.