QCustom3DVolume Class

Documentation sur les propriétés

alphaMultiplier : float

Cette propriété contient la valeur par laquelle la valeur alpha de chaque texel de la texture de volume est multipliée au moment du rendu.

Cette propriété permet d’appliquer une transparence uniforme au volume. Si la valeur de « preserveOpacity » est « true », seuls les texels présentant une certaine transparence initiale sont affectés ; les texels entièrement opaques ne le sont pas. La valeur ne doit pas être négative. La valeur par défaut est « 1.0f ».

Fonctions d’accès :

Signal de notification :

Voir également preserveOpacity et textureData.

colorTable : QList<QRgb>

Cette propriété contient le tableau renfermant les couleurs pour les formats de texture indexés.

Si le format de texture n'est pas indexé, ce tableau n'est pas utilisé et peut être vide.

Valeur par défaut : 0.

Fonctions d'accès :

Signal de notification :

Voir également textureData, setTextureFormat() et QImage::colorTable().

drawSliceFrames : bool

Cette propriété détermine si des cadres de coupe sont dessinés autour du volume.

Si la valeur de cette propriété est « true », les cadres des coupes indiqués par les propriétés d’index de coupe seront dessinés autour du volume. Si elle est « false », aucun cadre de coupe ne sera dessiné.

Le tracé des cadres de coupe est indépendant de celui des coupes ; vous pouvez donc afficher le volume complet tout en dessinant les cadres de coupe autour de celui-ci. Cela s’avère utile lorsque vous utilisez ` renderSlice()` pour afficher les coupes en dehors du graphique lui-même.

La valeur par défaut est false.

Fonctions d’accès :

Signal de notification :

Voir également sliceIndexX, sliceIndexY, sliceIndexZ, drawSlices et renderSlice().

drawSlices : bool

Cette propriété détermine si les tranches spécifiées sont dessinées à la place du volume complet.

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 elle est « false », le volume complet sera toujours dessiné. La valeur par défaut est « false ».

Fonctions d’accès :

Signal de notification :

Voir également sliceIndexX, sliceIndexY et sliceIndexZ.

preserveOpacity : bool

Cette propriété indique si le multiplicateur alpha est appliqué à tous les texels.

Si la valeur de cette propriété est « true », « alphaMultiplier » n’est appliqué qu’aux texels présentant déjà une certaine transparence. Si elle est « false », le multiplicateur est appliqué à la valeur alpha de tous les texels. La valeur par défaut est « true ».

Fonctions d’accès :

Signal de notification :

Voir également alphaMultiplier.

sliceFrameColor : QColor

Cette propriété définit la couleur du cadre de la tranche.

La couleur transparente n'est pas prise en charge pour le cadre de tranche.

La valeur par défaut est le noir.

Fonctions d'accès :

Signal de notification :

Voir également drawSliceFrames.

sliceFrameGaps : QVector3D

Cette propriété définit la largeur de l'espace d'air laissé entre le volume lui-même et le cadre dans chaque dimension.

Cet espace peut varier selon les dimensions. Les valeurs sont exprimées en fractions de l'épaisseur du volume dans la même dimension. Les valeurs ne peuvent pas être négatives.

Valeur par défaut : QVector3D(0.01, 0.01, 0.01).

Fonctions d'accès :

Signal de notification :

Voir également drawSliceFrames.

sliceFrameThicknesses : QVector3D

Cette propriété contient l'épaisseur des cadres de coupe 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.

Valeur par défaut : QVector3D(0.01, 0.01, 0.01).

Fonctions d'accès :

Signal de notification :

Voir également drawSliceFrames.

sliceFrameWidths : QVector3D

Cette propriété définit la largeur du cadre de la tranche.

La largeur peut varier selon les dimensions ; vous pouvez ainsi, par exemple, omettre l'affichage des cadres sur certains côtés du volume en définissant la valeur de cette dimension sur zéro. Les valeurs sont exprimées en fractions de l'épaisseur du volume dans la même dimension. Les valeurs ne peuvent pas être négatives.

Valeur par défaut : QVector3D(0.01, 0.01, 0.01).

Fonctions d'accès :

Signal de notification :

Voir également drawSliceFrames.

sliceIndexX : int

Cette propriété contient l'index de la dimension x dans les données de texture, indiquant quelle tranche verticale doit être affichée.

Si une dimension est définie sur une valeur négative, cela signifie qu’aucune tranche ni aucun cadre de tranche n’est dessiné pour cette dimension. Si toutes les dimensions sont négatives, aucune tranche ni aucun cadre de tranche n’est dessiné et le volume est affiché normalement.

Valeur par défaut : -1.

Fonctions d'accès :

Signal de notification :

Voir également textureData, drawSlices et drawSliceFrames.

sliceIndexY : int

Cette propriété contient l'index de la dimension y dans les données de texture, indiquant quelle coupe horizontale doit être affichée.

Si une dimension est définie sur une valeur négative, cela signifie qu'aucune coupe ni aucun cadre de coupe n'est dessiné pour cette dimension. Si toutes les dimensions sont négatives, aucune coupe ni aucun cadre de coupe n'est dessiné et le volume est affiché normalement.

Valeur par défaut : -1.

Fonctions d'accès :

Signal de notification :

Voir également textureData, drawSlices et drawSliceFrames.

sliceIndexZ : int

Cette propriété contient l'index de la dimension z dans les données de texture, indiquant quelle tranche verticale doit être affichée.

Si une dimension est définie sur une valeur négative, cela signifie qu'aucune tranche ni aucun cadre de tranche n'est dessiné pour cette dimension. Si toutes les dimensions sont négatives, aucune tranche ni aucun cadre de tranche n'est dessiné et le volume s'affiche normalement.

Valeur par défaut : -1.

Fonctions d'accès :

Signal de notification :

Voir également textureData, drawSlices et drawSliceFrames.

textureData : QList<uchar>*

Cette propriété contient le tableau renfermant les données de texture au format spécifié par textureFormat.

La taille de ce tableau doit être au moins égale à (textureDataWidth * textureHeight * textureDepth * texture format color depth in bytes).

Une texture 3D est définie par une pile de sous-textures 2D. Chaque sous-texture doit être de taille identique (textureDataWidth * textureHeight), et la profondeur de la pile est définie par la propriété textureDepth. Les données de chaque texture 2D sont identiques à celles d’un objet QImage de même format ; ainsi, la fonction QImage::bits() peut être utilisée pour fournir les données de chaque sous-texture.

La propriété du nouveau tableau est transférée à l’instance QCustom3DVolume. Si un autre tableau est défini, le tableau précédent est supprimé. Si le même tableau est défini à nouveau, on suppose que son contenu a été modifié et le rendu du graphe est déclenché.

La valeur par défaut est 0.

Fonctions d’accès :

Signal de notification :

Voir également colorTable, setTextureFormat(), setSubTextureData() et textureDataWidth().

textureDepth : int

Cette propriété indique la profondeur, en pixels, de la texture 3D définissant le contenu volumétrique.

Valeur par défaut : 0.

Fonctions d'accès :

Signal de notification :

Voir également textureData, textureWidth, textureHeight et setTextureFormat().

textureHeight : int

Cette propriété contient la hauteur, en pixels, de la texture 3D définissant le contenu volumétrique.

La valeur par défaut est « 0 ».

Fonctions d'accès :

Signal de notification :

Voir également textureData, textureWidth, textureDepth et setTextureFormat().

textureWidth : int

Cette propriété indique, en pixels, la largeur de la texture 3D définissant le contenu du volume.

Valeur par défaut : 0.

Fonctions d'accès :

Signal de notification :

Voir également textureData, textureHeight, textureDepth, setTextureFormat() et textureDataWidth().

useHighDefShader : bool

Cette propriété détermine si un shader haute ou basse définition est utilisé pour le rendu du volume.

Si la valeur de cette propriété est « true », un shader haute définition est utilisé. Si elle 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 bien plus élevée. Le shader basse définition ne garantit pas que chaque texel de la texture du volume soit échantillonné ; il peut donc y avoir un scintillement si le volume contient des éléments fins bien distincts.

Valeur par défaut : true.

Fonctions d’accès :

Signal de notification :

Voir également renderSlice().