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.

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.