Custom3DVolume QML Type
Ajoute un objet rendu volumique à un graphique. Plus d'informations...
| Import Statement: | import QtDataVisualization 1.10 |
| Since: | QtDataVisualization 1.2 |
| In C++: | QCustom3DVolume |
| Inherits: |
Propriétés
- 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
Description détaillée
Un objet rendu en volume est une boîte avec une texture 3D. Trois plans de coupe sont pris en charge pour le volume, un le long de chaque axe principal du volume.
Le rendu des objets volumiques est très gourmand en performances, en particulier lorsque le volume est largement transparent, car le contenu du volume est tracé par rayons. Les performances sont presque linéairement proportionnelles à la quantité de pixels que le volume occupe à l'écran, de sorte qu'il est facile d'améliorer les performances en affichant le volume dans une vue plus petite ou en limitant le niveau de zoom du graphique. De même, les dimensions de la texture du volume ont un impact important sur les performances. Si le taux de rafraîchissement est plus important que le rendu parfait du contenu du volume, vous pouvez désactiver le shader haute définition en définissant la propriété useHighDefShader sur false.
Remarque : le remplissage des données de volume ne serait généralement pas efficace ou pratique en QML pur, de sorte que les propriétés directement liées à cela ne sont pas entièrement prises en charge par QML. Créez une application hybride QML/C++ si vous souhaitez utiliser des objets volumétriques avec une interface utilisateur Qt Quick.
Remarque : les objets volumétriques ne sont pris en charge qu'avec la projection orthographique.
Remarque : les objets volumétriques utilisent des textures 3D, qui ne sont pas prises en charge dans les environnements OpenGL ES2.
Voir également AbstractGraph3D::orthoProjection et useHighDefShader.
Documentation de la propriété
alphaMultiplier : real |
La valeur alpha de chaque texel de la texture du volume est multipliée par cette valeur au moment du rendu. Ceci peut être utilisé pour introduire une transparence uniforme dans le volume. Si preserveOpacity est true, seuls les texels ayant au moins une certaine transparence au départ sont affectés, et les texels totalement opaques ne sont pas affectés. La valeur ne doit pas être négative. La valeur par défaut est 1.0.
Voir également preserveOpacity.
drawSliceFrames : bool |
Si la valeur de cette propriété est true, les cadres de tranches indiqués par les propriétés d'indice de tranche seront dessinés autour du volume. Si la valeur est false, aucun cadre de tranche ne sera dessiné. Le dessin des cadres de tranches est indépendant du dessin des tranches, de sorte que vous pouvez afficher le volume complet tout en dessinant les cadres de tranches autour de celui-ci. La valeur par défaut est false.
Voir également sliceIndexX, sliceIndexY, sliceIndexZ, et drawSlices.
drawSlices : bool |
Si la valeur de cette propriété est true, les tranches indiquées par les propriétés d'index de tranche seront dessinées à la place du volume complet. Si la valeur de cette propriété est false, le volume complet sera toujours dessiné. La valeur par défaut est false.
Remarque : les tranches sont toujours dessinées le long des axes de l'élément, de sorte que si l'élément est tourné, les tranches le sont également.
Voir également sliceIndexX, sliceIndexY, et sliceIndexZ.
preserveOpacity : bool |
Si la valeur de cette propriété est true, alphaMultiplier n'est appliqué qu'aux texels qui ont déjà une certaine transparence. Si la valeur est false, le multiplicateur est appliqué à la valeur alpha de tous les texels. La valeur par défaut est true.
Voir également alphaMultiplier.
sliceFrameColor : color |
Couleur du cadre de la tranche. La couleur du cadre de la tranche transparente n'est pas prise en charge.
La valeur par défaut est le noir.
Voir également drawSliceFrames.
sliceFrameGaps : vector3d |
La taille de l'espace d'air laissé entre le volume lui-même et le cadre dans chaque dimension. L'espace peut être différent selon les dimensions. Les valeurs sont des fractions de l'épaisseur du volume dans la même dimension. Les valeurs ne peuvent pas être négatives.
La valeur par défaut est vector3d(0.01, 0.01, 0.01).
Voir également drawSliceFrames.
sliceFrameThicknesses : vector3d |
L'épaisseur des cadres de la tranche pour chaque dimension. Les valeurs sont des fractions de l'épaisseur du volume dans la même dimension. Les valeurs ne peuvent pas être négatives.
La valeur par défaut est vector3d(0.01, 0.01, 0.01).
Voir également drawSliceFrames.
sliceFrameWidths : vector3d |
La largeur du cadre de la tranche. La largeur peut être différente selon les dimensions, de sorte que vous pouvez par exemple ne pas dessiner les cadres sur certains côtés du volume en définissant la valeur de cette dimension à zéro. Les valeurs sont des fractions de l'épaisseur du volume dans la même dimension. Les valeurs ne peuvent pas être négatives.
La valeur par défaut est vector3d(0.01, 0.01, 0.01).
Voir également drawSliceFrames.
sliceIndexX : int |
L'index de la dimension x dans les données de texture indique la tranche verticale à afficher. Si une dimension est négative, cela signifie qu'aucune tranche ou cadre de tranche n'est dessiné pour cette dimension. Si toutes les dimensions sont négatives, aucune tranche ou cadre de tranche n'est dessiné et le volume est dessiné normalement. La valeur par défaut est -1.
Voir également QCustom3DVolume::textureData, drawSlices, et drawSliceFrames.
sliceIndexY : int |
L'index de la dimension y dans les données de texture indiquant la tranche horizontale à afficher. Si l'une des dimensions est négative, aucune tranche ou cadre de tranche n'est dessiné pour cette dimension. Si toutes les dimensions sont négatives, aucune tranche ou cadre de tranche n'est dessiné et le volume est dessiné normalement. La valeur par défaut est -1.
Voir également QCustom3DVolume::textureData, drawSlices, et drawSliceFrames.
sliceIndexZ : int |
L'index de la dimension z dans les données de texture indiquant la tranche verticale à afficher. Si l'une des dimensions est négative, aucune tranche ou cadre de tranche n'est dessiné pour cette dimension. Si toutes les dimensions sont négatives, aucune tranche ou cadre de tranche n'est dessiné et le volume est dessiné normalement. La valeur par défaut est -1.
Voir également QCustom3DVolume::textureData, drawSlices, et drawSliceFrames.
textureDepth : int |
Profondeur de la texture 3D définissant le contenu du volume en pixels. La valeur par défaut est 0.
Remarque : il n'est pas possible de modifier cette propriété à partir de QML, car les données de texture ne peuvent pas être redimensionnées en conséquence.
textureHeight : int |
La hauteur de la texture 3D définissant le contenu du volume en pixels. La valeur par défaut est 0.
Remarque : il n'est pas possible de modifier cette propriété à partir de QML, car les données de texture ne peuvent pas être redimensionnées en conséquence.
textureWidth : int |
La largeur de la texture 3D définissant le contenu du volume en pixels. La valeur par défaut est 0.
Remarque : il n'est pas possible de modifier cette propriété à partir de QML, car les données de texture ne peuvent pas être redimensionnées en conséquence.
useHighDefShader : bool |
Si la valeur de cette propriété est true, un shader haute définition est utilisé pour le rendu du volume. Si la valeur est false, un shader basse définition est utilisé.
Le shader haute définition garantit que chaque texel visible de la texture du volume est échantillonné lors du rendu du volume. Le shader basse définition ne rend qu'une approximation grossière du contenu du volume, mais à une fréquence d'images beaucoup plus élevée. Le shader basse définition ne garantit pas que chaque texel de la texture du volume est échantillonné, ce qui peut entraîner un scintillement si le volume contient des éléments fins distincts.
Remarque : cette valeur n'affecte pas le niveau de détail lors du rendu des tranches du volume.
La valeur par défaut est 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.