- Qt 6.10
- Qt Quick 3D
- QML Types
- QtQuick3D.Helpers
- CapsuleGeometry
- Qt Quick 3D | Commercial or GPLv3

# CapsuleGeometry QML Type

Provides geometry for a capsule. More...

Import Statement: | `import QtQuick3D.Helpers`
Since: | Qt 6.10
Inherits: | Geometry

- List of all members, including inherited members

## Properties

- asynchronous : bool
- diameter : real
- enableNormals : bool
- enableUV : bool
- height : real
- latitudes : int
- longitudes : int
- rings : int
- status : bool
- uvProfile : UVProfile

## Detailed Description

A geometry for generating a capsule model. The capsule is centered at `(0, 0, 0)` with the height of the capsule extending in the x direction and the diameter on the yz plane.

## Property Documentation

asynchronous : bool `[default: true]`

This property holds whether the geometry generation should be asynchronous.

diameter : real `[default: 100]`

Diameter on the yz plane.

enableNormals : bool `[default: true]`

Generate mesh face normals.

enableUV : bool `[default: false]`

Generate mesh uv coordinates.

height : real `[default: 100]`

Height of the middle cylinder on the x axis, excluding the hemispheres.

latitudes : int `[default: 16]`

Number of latitudes, distributed by inclination. Will always be snapped to an even number.

longitudes : int `[default: 32]`

Number of longitudes, or meridians, distributed by azimuth.

rings : int `[default: 1]`

Number of sections in cylinder between hemispheres.

status : bool `[read-only]`

This property holds the status of the geometry generation when asynchronous is true.

Constant | Description
--- | ---
`CapsuleGeometry.Null` | The geometry generation has not started
`CapsuleGeometry.Ready` | The geometry generation is complete.
`CapsuleGeometry.Loading` | The geometry generation is in progress.
`CapsuleGeometry.Error` | The geometry generation failed.

uvProfile : UVProfile `[default: CapsuleGeometry.Fixed]`

Manner in which UV coordinates are distributed along the length of the capsule.

Constant | Description
--- | ---
`CapsuleGeometry.Fixed` | The upper third of the UV texture is the North hemisphere, the middle third is the cylinder and the last third is the South hemisphere.
`CapsuleGeometry.Aspect` | UVs match the height to radius ratio.
`CapsuleGeometry.Uniform` | Uniform proportion for all UV cells, according to the ratio of latitudes to rings.