- Qt 6.12
- Qt 3D
- C++ Classes
- Qt3DExtras (Deprecated)
- QCuboidGeometry
- Qt 6.12.0 Reference Documentation

# Qt3DExtras::QCuboidGeometry Class

class Qt3DExtras::QCuboidGeometry

The QCuboidGeometry class allows creation of a cuboid in 3D space. More...

Header: | `#include <Qt3DExtras/QCuboidGeometry>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS 3dextras)` `target_link_libraries(mytarget PRIVATE Qt6::3dextras)`
qmake: | `QT += 3dextras`
In QML: | CuboidGeometry
Inherits: | Qt3DCore::QGeometry
Status: | Deprecated

This class is deprecated. We strongly advise against using it in new code.

- List of all members, including inherited members

## Properties

indexAttribute : Qt3DCore::QAttribute* const normalAttribute : Qt3DCore::QAttribute* const positionAttribute : Qt3DCore::QAttribute* const tangentAttribute : Qt3DCore::QAttribute* const texCoordAttribute : Qt3DCore::QAttribute* const xExtent : float | xyMeshResolution : QSize xzMeshResolution : QSize yExtent : float yzMeshResolution : QSize zExtent : float

## Public Functions

| QCuboidGeometry(Qt3DCore::QNode *parent = nullptr)
Qt3DCore::QAttribute * | indexAttribute() const
Qt3DCore::QAttribute * | normalAttribute() const
Qt3DCore::QAttribute * | positionAttribute() const
Qt3DCore::QAttribute * | tangentAttribute() const
Qt3DCore::QAttribute * | texCoordAttribute() const
void | updateIndices()
void | updateVertices()
float | xExtent() const
QSize | xyMeshResolution() const
QSize | xzMeshResolution() const
float | yExtent() const
QSize | yzMeshResolution() const
float | zExtent() const

## Public Slots

void | setXExtent(float xExtent)
void | setXYMeshResolution(const QSize &resolution)
void | setXZMeshResolution(const QSize &resolution)
void | setYExtent(float yExtent)
void | setYZMeshResolution(const QSize &resolution)
void | setZExtent(float zExtent)

## Signals

void | xExtentChanged(float xExtent)
void | xyMeshResolutionChanged(const QSize &xyMeshResolution)
void | xzMeshResolutionChanged(const QSize &xzMeshResolution)
void | yExtentChanged(float yExtent)
void | yzMeshResolutionChanged(const QSize &yzMeshResolution)
void | zExtentChanged(float zExtent)

## Detailed Description

The QCuboidGeometry class is most commonly used internally by the QCuboidMesh but can also be used in custom Qt3DRender::QGeometryRenderer subclasses.

## Property Documentation

### `[read-only]` indexAttribute : Qt3DCore::QAttribute* const

Holds the geometry index attribute.

Access functions:

Qt3DCore::QAttribute * | indexAttribute() const

### `[read-only]` normalAttribute : Qt3DCore::QAttribute* const

Holds the geometry normal attribute.

Access functions:

Qt3DCore::QAttribute * | normalAttribute() const

### `[read-only]` positionAttribute : Qt3DCore::QAttribute* const

Holds the geometry position attribute.

Access functions:

Qt3DCore::QAttribute * | positionAttribute() const

### `[read-only]` tangentAttribute : Qt3DCore::QAttribute* const

Holds the geometry tangent attribute.

Access functions:

Qt3DCore::QAttribute * | tangentAttribute() const

### `[read-only]` texCoordAttribute : Qt3DCore::QAttribute* const

Holds the geometry texture coordinate attribute.

Access functions:

Qt3DCore::QAttribute * | texCoordAttribute() const

### xExtent : float

Holds the x extent of the geometry.

Access functions:

float | xExtent() const
void | setXExtent(float xExtent)

Notifier signal:

void | xExtentChanged(float xExtent)

### xyMeshResolution : QSize

Holds the x-y resolution. The width and height values of this property specify the number of vertices generated for the x-y faces of the mesh.

Access functions:

QSize | xyMeshResolution() const
void | setXYMeshResolution(const QSize &resolution)

Notifier signal:

void | xyMeshResolutionChanged(const QSize &xyMeshResolution)

### xzMeshResolution : QSize

Holds the x-z resolution. The width and height values of this property specify the number of vertices generated for the x-z faces of the mesh.

Access functions:

QSize | xzMeshResolution() const
void | setXZMeshResolution(const QSize &resolution)

Notifier signal:

void | xzMeshResolutionChanged(const QSize &xzMeshResolution)

### yExtent : float

Holds the y extent of the geometry.

Access functions:

float | yExtent() const
void | setYExtent(float yExtent)

Notifier signal:

void | yExtentChanged(float yExtent)

### yzMeshResolution : QSize

Holds the y-z resolution. The width and height values of this property specify the number of vertices generated for the y-z faces of the mesh.

Access functions:

QSize | yzMeshResolution() const
void | setYZMeshResolution(const QSize &resolution)

Notifier signal:

void | yzMeshResolutionChanged(const QSize &yzMeshResolution)

### zExtent : float

Holds the z extent of the geometry.

Access functions:

float | zExtent() const
void | setZExtent(float zExtent)

Notifier signal:

void | zExtentChanged(float zExtent)

## Member Function Documentation

### `[explicit]` QCuboidGeometry::QCuboidGeometry(Qt3DCore::QNode *parent = nullptr)

Constructs a new QCuboidGeometry with parent.

### void QCuboidGeometry::updateIndices()

Updates indices based on mesh resolutions.

### void QCuboidGeometry::updateVertices()

Updates vertices based on mesh resolutions.