Custom3DVolume QML Type
Fügt ein gerendertes Volumenobjekt zu einem Diagramm hinzu. Mehr...
| Import Statement: | import QtDataVisualization 1.8 |
| Since: | QtDataVisualization 1.2 |
| In C++: | QCustom3DVolume |
| Inherits: |
Eigenschaften
- alphaMultiplier : real
- drawSliceFrames : bool
- drawSlices : bool
- preserveOpacity : bool
- sliceFrameColor : color
- sliceFrameGaps : vector3d
- sliceFrameThicknesses : vector3d
- sliceFrameWidths : vector3d
- sliceIndexX : int
- sliceIndexY : int
- sliceIndexZ : int
- textureDepth : int
- textureHeight : int
- textureWidth : int
- useHighDefShader : bool
Detaillierte Beschreibung
Ein gerendertes Volumenobjekt ist ein Kasten mit einer 3D-Textur. Für das Volumen werden drei Slicing-Ebenen unterstützt, eine entlang jeder Hauptachse des Volumens.
Das Rendern von Volumenobjekten ist sehr leistungsintensiv, insbesondere wenn das Volumen weitgehend transparent ist, da der Inhalt des Volumens durch Strahlen verfolgt wird. Die Leistung skaliert nahezu linear mit der Anzahl der Pixel, die das Volumen auf dem Bildschirm einnimmt, so dass die Darstellung des Volumens in einer kleineren Ansicht oder die Begrenzung der Zoomstufe des Diagramms einfache Möglichkeiten zur Verbesserung der Leistung sind. Auch die Größe der Volumentextur hat einen großen Einfluss auf die Leistung. Wenn die Framerate wichtiger ist als die pixelgenaue Darstellung des Volumeninhalts, sollten Sie den High-Definition-Shader deaktivieren, indem Sie die Eigenschaft useHighDefShader auf false setzen.
Hinweis: Das Ausfüllen der Volumendaten wäre in der Regel in reinem QML nicht effizient oder praktikabel, daher werden Eigenschaften, die sich direkt darauf beziehen, nicht vollständig von QML unterstützt. Erstellen Sie eine hybride QML/C++-Anwendung, wenn Sie Volumenobjekte mit einer Qt Quick UI verwenden möchten.
Hinweis: Volumetrische Objekte werden nur bei orthografischer Projektion unterstützt.
Hinweis: Volumetrische Objekte verwenden 3D-Texturen, die in OpenGL ES2-Umgebungen nicht unterstützt werden.
Siehe auch AbstractGraph3D::orthoProjection und useHighDefShader.
Dokumentation der Eigenschaften
alphaMultiplier : real |
Der Alphawert jedes Texels der Volumentextur wird zur Renderzeit mit diesem Wert multipliziert. Dies kann verwendet werden, um dem Volumen eine einheitliche Transparenz zu verleihen. Wenn preserveOpacity gleich true ist, sind nur Texel betroffen, die zu Beginn zumindest etwas transparent sind, und völlig undurchsichtige Texel sind nicht betroffen. Der Wert darf nicht negativ sein. Der Standardwert ist 1.0.
Siehe auch preserveOpacity.
drawSliceFrames : bool |
Wenn der Wert dieser Eigenschaft true ist, werden die Rahmen der Slices, die durch die Slice-Index-Eigenschaften angegeben sind, um das Volumen herum gezeichnet. Wenn der Wert false lautet, werden keine Slice-Rahmen gezeichnet. Das Zeichnen von Slice-Rahmen ist unabhängig vom Zeichnen von Slices, so dass Sie das gesamte Volumen anzeigen und trotzdem die Slice-Rahmen um das Volumen herum zeichnen können. Der Standardwert ist false.
Siehe auch sliceIndexX, sliceIndexY, sliceIndexZ, und drawSlices.
drawSlices : bool |
Wenn der Wert dieser Eigenschaft true lautet, werden die durch die Slice-Index-Eigenschaften angegebenen Slices anstelle des gesamten Volumens gezeichnet. Wenn der Wert false lautet, wird immer das gesamte Volumen gezeichnet. Der Standardwert ist false.
Hinweis: Die Slices werden immer entlang der Objektachsen gezeichnet, d. h. wenn das Objekt gedreht wird, werden auch die Slices gedreht.
Siehe auch sliceIndexX, sliceIndexY, und sliceIndexZ.
preserveOpacity : bool |
Wenn diese Eigenschaft den Wert true hat, wird alphaMultiplier nur auf Texel angewendet, die bereits eine gewisse Transparenz aufweisen. Wenn der Wert false lautet, wird der Multiplikator auf den Alphawert aller Texel angewandt. Der Standardwert ist true.
Siehe auch alphaMultiplier.
sliceFrameColor : color |
Die Farbe des Slice-Rahmens. Die Farbe des transparenten Slice-Rahmens wird nicht unterstützt.
Der Standardwert ist Schwarz.
Siehe auch drawSliceFrames.
sliceFrameGaps : vector3d |
Die Größe des Luftspalts, der zwischen dem Volumen selbst und dem Rahmen in jeder Dimension verbleibt. Der Abstand kann in verschiedenen Dimensionen unterschiedlich sein. Die Werte sind Bruchteile der Volumendicke in der gleichen Dimension. Die Werte können nicht negativ sein.
Der Standardwert ist vector3d(0.01, 0.01, 0.01).
Siehe auch drawSliceFrames.
sliceFrameThicknesses : vector3d |
Die Dicke der Schichtrahmen für jede Dimension. Die Werte sind Bruchteile der Volumendicke in der gleichen Dimension. Die Werte können nicht negativ sein.
Der Standardwert ist vector3d(0.01, 0.01, 0.01).
Siehe auch drawSliceFrames.
sliceFrameWidths : vector3d |
Die Breite des Schichtrahmens. Die Breite kann in verschiedenen Dimensionen unterschiedlich sein, so dass Sie z. B. das Zeichnen der Rahmen an bestimmten Seiten des Volumens auslassen können, indem Sie den Wert für diese Dimension auf Null setzen. Die Werte sind Bruchteile der Volumendicke in derselben Dimension. Die Werte können nicht negativ sein.
Der Standardwert ist vector3d(0.01, 0.01, 0.01).
Siehe auch drawSliceFrames.
sliceIndexX : int |
Der Index der x-Dimension in den Texturdaten, der angibt, welche vertikale Schicht angezeigt werden soll. Wird eine Dimension auf negativ gesetzt, wird kein Slice oder Slice-Rahmen für diese Dimension gezeichnet. Wenn alle Dimensionen negativ sind, werden keine Slices oder Slicerahmen gezeichnet und das Volumen wird normal gezeichnet. Die Voreinstellung ist -1.
Siehe auch QCustom3DVolume::textureData, drawSlices, und drawSliceFrames.
sliceIndexY : int |
Der Index der y-Dimension in den Texturdaten, der angibt, welcher horizontale Slice angezeigt werden soll. Wenn eine Dimension negativ ist, wird kein Slice oder Slice-Rahmen für diese Dimension gezeichnet. Wenn alle Dimensionen negativ sind, werden keine Slices oder Slicerahmen gezeichnet und das Volumen wird normal gezeichnet. Die Voreinstellung ist -1.
Siehe auch QCustom3DVolume::textureData, drawSlices, und drawSliceFrames.
sliceIndexZ : int |
Der Index der z-Dimension in den Texturdaten, der angibt, welcher vertikale Slice angezeigt werden soll. Wenn eine Dimension negativ ist, wird kein Slice oder Slice-Rahmen für diese Dimension gezeichnet. Wenn alle Dimensionen negativ sind, werden keine Slices oder Slicerahmen gezeichnet und das Volumen wird normal gezeichnet. Die Voreinstellung ist -1.
Siehe auch QCustom3DVolume::textureData, drawSlices, und drawSliceFrames.
textureDepth : int |
Die Tiefe der 3D-Textur, die den Volumeninhalt definiert, in Pixeln. Der Standardwert ist 0.
Hinweis: Das Ändern dieser Eigenschaft von QML aus wird nicht unterstützt, da die Texturdaten nicht entsprechend angepasst werden können.
textureHeight : int |
Die Höhe der 3D-Textur, die den Inhalt des Volumens definiert, in Pixeln. Der Standardwert ist 0.
Hinweis: Das Ändern dieser Eigenschaft von QML aus wird nicht unterstützt, da die Größe der Texturdaten nicht entsprechend angepasst werden kann.
textureWidth : int |
Die Breite der 3D-Textur, die den Inhalt des Volumens definiert, in Pixeln. Der Standardwert ist 0.
Hinweis: Das Ändern dieser Eigenschaft von QML aus wird nicht unterstützt, da die Größe der Texturdaten nicht entsprechend angepasst werden kann.
useHighDefShader : bool |
Wenn der Wert dieser Eigenschaft true ist, wird ein hochauflösender Shader zum Rendern des Volumens verwendet. Bei false wird ein Low-Definition-Shader verwendet.
Der hochauflösende Shader garantiert, dass jedes sichtbare Texel der Volumentextur beim Rendern des Volumens abgetastet wird. Der Low-Definition-Shader rendert nur eine grobe Annäherung an den Volumeninhalt, aber mit einer viel höheren Bildrate. Der Low-Definition-Shader garantiert nicht, dass jedes Texel der Volumentextur abgetastet wird, so dass es zu Flackern kommen kann, wenn das Volumen ausgeprägte dünne Merkmale enthält.
Hinweis: Dieser Wert hat keinen Einfluss auf den Detailgrad beim Rendern der Slices des Volumens.
Die Standardeinstellung ist true.
© 2025 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.
