QMesh Class

class Qt3DRender::QMesh

A custom mesh loader. More...

Header: #include <Qt3DRender/QMesh>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Instantiated By: Mesh
Inherits: Qt3DRender::QGeometryRenderer

Public Types

enum Status { None, Loading, Ready, Error }

Properties

Public Functions

QMesh(Qt3DCore::QNode *parent = nullptr)
QString meshName() const
QUrl source() const
Qt3DRender::QMesh::Status status() const

Public Slots

void setMeshName(const QString &meshName)
void setSource(const QUrl &source)

Signals

void meshNameChanged(const QString &meshName)
void sourceChanged(const QUrl &source)
void statusChanged(Qt3DRender::QMesh::Status status)

Detailed Description

Loads mesh data from external files in a variety of formats. Qt3DRender::QMesh loads data into a single mesh.

In Qt3D 5.9, QMesh supports the following formats:

  • Wavefront OBJ
  • Stanford Triangle Format PLY
  • STL (STereoLithography)

QMesh will also support the following format if the SDK is installed and the fbx geometry loader plugin is built and found:

  • Autodesk FBX

If you wish to load an entire scene made of several objects, you should rather use the Qt3DRender::QSceneLoader instead.

See also Qt3DRender::QSceneLoader.

Member Type Documentation

enum QMesh::Status

This enum identifies the status of shader used.

ConstantValueDescription
Qt3DRender::QMesh::None0A source mesh hasn't been assigned a source yet
Qt3DRender::QMesh::Loading1The mesh geometry is loading
Qt3DRender::QMesh::Ready2The mesh geometry was successfully loaded
Qt3DRender::QMesh::Error3An error occurred while loading the mesh

Property Documentation

meshName : QString

Holds the name of the mesh.

Access functions:

QString meshName() const
void setMeshName(const QString &meshName)

Notifier signal:

void meshNameChanged(const QString &meshName)

source : QUrl

Holds the source url to the file containing the custom mesh.

Access functions:

QUrl source() const
void setSource(const QUrl &source)

Notifier signal:

void sourceChanged(const QUrl &source)

[read-only] status : const Status

Holds the status of the mesh loading.

Access functions:

Qt3DRender::QMesh::Status status() const

Notifier signal:

void statusChanged(Qt3DRender::QMesh::Status status)

See also Qt3DRender::QMesh::Status.

Member Function Documentation

[explicit] QMesh::QMesh(Qt3DCore::QNode *parent = nullptr)

Constructs a new QMesh with parent.