QMesh Class
class Qt3DRender::QMeshA 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.
| Constant | Value | Description |
|---|---|---|
Qt3DRender::QMesh::None | 0 | A source mesh hasn't been assigned a source yet |
Qt3DRender::QMesh::Loading | 1 | The mesh geometry is loading |
Qt3DRender::QMesh::Ready | 2 | The mesh geometry was successfully loaded |
Qt3DRender::QMesh::Error | 3 | An 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.