QCustom3DVolume Class

Dokumentation zu den Eigenschaften

alphaMultiplier : float

Diese Eigenschaft enthält den Wert, mit dem der Alpha-Wert jedes Texels der Volumen-Textur zum Zeitpunkt des Renderings multipliziert wird.

Diese Eigenschaft kann verwendet werden, um eine einheitliche Transparenz im Volumen zu erzeugen. Wenn „ preserveOpacity “ auf „ true “ gesetzt ist, sind nur Texel betroffen, die von vornherein zumindest eine gewisse Transparenz aufweisen; vollständig undurchsichtige Texel bleiben davon unberührt. Der Wert darf nicht negativ sein. Der Standardwert ist „ 1.0f “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch preserveOpacity und textureData.

colorTable : QList<QRgb>

Diese Eigenschaft enthält das Array mit den Farben für indizierte Texturformate.

Wenn es sich nicht um ein indiziertes Texturformat handelt, wird dieses Array nicht verwendet und kann leer sein.

Der Standardwert ist „ 0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ textureData“ , „ setTextureFormat()“ und „ QImage::colorTable()“.

drawSliceFrames : bool

Diese Eigenschaft legt fest, ob um das Volumen herum Schnittrahmen gezeichnet werden.

Wenn der Wert dieser Eigenschaft „ true “ lautet, werden die Rahmen der durch die Schnittindex-Eigenschaften angegebenen Schnitte um das Volumen herum gezeichnet. Lautet er „ false “, werden keine Schnittrahmen gezeichnet.

Das Zeichnen von Schnittrahmen ist unabhängig vom Zeichnen der Schnitte, sodass Sie das gesamte Volumen anzeigen und dennoch die Schnittrahmen darum herum zeichnen können. Dies ist nützlich, wenn Sie mit ` renderSlice()` die Schnitte außerhalb der Grafik selbst anzeigen.

Standardwert ist ` false`.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` sliceIndexX`, ` sliceIndexY`, ` sliceIndexZ`, ` drawSlices` und ` renderSlice()`.

drawSlices : bool

Diese Eigenschaft legt fest, ob anstelle des gesamten Volumens die angegebenen Schnitte gezeichnet werden.

Wenn der Wert dieser Eigenschaft „ true “ lautet, werden anstelle des gesamten Volumens die durch die Schnittindex-Eigenschaften angegebenen Schnitte gezeichnet. Lautet der Wert „ false “, wird immer das gesamte Volumen gezeichnet. Der Standardwert ist „ false “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ sliceIndexX “, „ sliceIndexY “ und „ sliceIndexZ “.

preserveOpacity : bool

Diese Eigenschaft legt fest, ob der Alpha-Multiplikator auf alle Texel angewendet wird.

Wenn dieser Eigenschaftswert „ true “ lautet, wird „ alphaMultiplier “ nur auf Texel angewendet, die bereits eine gewisse Transparenz aufweisen. Lautet er „ false “, wird der Multiplikator auf den Alpha-Wert aller Texel angewendet. Der Standardwert ist „ true “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch alphaMultiplier.

sliceFrameColor : QColor

Diese Eigenschaft legt die Farbe des Schnittrahmens fest.

Transparente Slice-Rahmenfarben werden nicht unterstützt.

Standardmäßig ist die Farbe Schwarz.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ drawSliceFrames “.

sliceFrameGaps : QVector3D

Diese Eigenschaft gibt die Größe des Luftspalts an, der in jeder Dimension zwischen dem Volumen selbst und dem Rahmen verbleibt.

Der Spalt kann in den verschiedenen Dimensionen unterschiedlich groß sein. Die Werte sind Bruchteile der Volumendicke in derselben Dimension. Die Werte dürfen nicht negativ sein.

Standardwert: QVector3D(0.01, 0.01, 0.01).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ drawSliceFrames “.

sliceFrameThicknesses : QVector3D

Diese Eigenschaft enthält die Dicke der Schnittrahmen für jede Dimension.

Die Werte sind Bruchteile der Volumendicke in derselben Dimension. Die Werte dürfen nicht negativ sein.

Standardwert ist „ QVector3D(0.01, 0.01, 0.01) “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ drawSliceFrames “.

sliceFrameWidths : QVector3D

Diese Eigenschaft gibt die Breite des Schnittrahmens an.

Die Breite kann je nach Dimension unterschiedlich sein, sodass Sie beispielsweise das Zeichnen der Rahmen an bestimmten Seiten des Volumens unterlassen können, indem Sie den Wert für diese Dimension auf Null setzen. Die Werte sind Bruchteile der Volumendicke in derselben Dimension. Die Werte dürfen nicht negativ sein.

Standardwert: QVector3D(0.01, 0.01, 0.01).

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch drawSliceFrames.

sliceIndexX : int

Diese Eigenschaft enthält den x-Dimensionsindex in den Texturdaten, der angibt, welcher vertikale Schnitt angezeigt werden soll.

Wird eine Dimension auf einen negativen Wert gesetzt, bedeutet dies, dass für diese Dimension kein Schnitt oder Schnittrahmen gezeichnet wird. Sind alle Dimensionen negativ, werden keine Schnitte oder Schnittrahmen gezeichnet und das Volumen wird normal dargestellt.

Standardwert ist „ -1 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ textureData “, „ drawSlices “ und „ drawSliceFrames “.

sliceIndexY : int

Diese Eigenschaft enthält den y-Dimensionsindex in den Texturdaten, der angibt, welche horizontale Scheibe angezeigt werden soll.

Wird eine Dimension auf einen negativen Wert gesetzt, bedeutet dies, dass für diese Dimension kein Schnitt oder Schnittrahmen gezeichnet wird. Sind alle Dimensionen negativ, werden keine Schnitte oder Schnittrahmen gezeichnet und das Volumen wird normal dargestellt.

Standardwert ist „ -1 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ textureData “, „ drawSlices “ und „ drawSliceFrames “.

sliceIndexZ : int

Diese Eigenschaft enthält den Z-Dimension-Index in den Texturdaten, der angibt, welcher vertikale Schnitt angezeigt werden soll.

Wird eine Dimension auf einen negativen Wert gesetzt, bedeutet dies, dass für diese Dimension kein Schnitt oder Schnittrahmen gezeichnet wird. Sind alle Dimensionen negativ, werden keine Schnitte oder Schnittrahmen gezeichnet und das Volumen wird normal dargestellt.

Standardwert ist „ -1 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ textureData “, „ drawSlices “ und „ drawSliceFrames “.

textureData : QList<uchar>*

Diese Eigenschaft enthält das Array mit den Texturdaten in dem unter textureFormat angegebenen Format.

Die Größe dieses Arrays muss mindestens (textureDataWidth * textureHeight * textureDepth * texture format color depth in bytes) betragen.

Eine 3D-Textur wird durch einen Stapel von 2D-Teiltexturen definiert. Jede Teiltextur muss dieselbe Größe haben (textureDataWidth * textureHeight), und die Tiefe des Stapels wird durch die Eigenschaft „ textureDepth “ definiert. Die Daten in jeder 2D-Textur entsprechen den Daten von „ QImage “ mit demselben Format, sodass „ QImage::bits()“ verwendet werden kann, um die Daten für jede Teiltextur bereitzustellen.

Die Eigentumsrechte am neuen Array gehen auf die Instanz „ QCustom3DVolume “ über. Wird ein anderes Array festgelegt, wird das vorherige Array gelöscht. Wird dasselbe Array erneut festgelegt, wird davon ausgegangen, dass der Inhalt des Arrays geändert wurde, und die Grafikdarstellung wird ausgelöst.

Standardwert ist „ 0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ colorTable“ , „ setTextureFormat()“, „ setSubTextureData()“ und „ textureDataWidth()“.

textureDepth : int

Diese Eigenschaft gibt die Tiefe der 3D-Textur an, die den Voluminhalt in Pixeln definiert.

Standardwert ist „ 0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ textureData“ , „ textureWidth “, „ textureHeight “ und „ setTextureFormat()“.

textureHeight : int

Diese Eigenschaft enthält die Höhe der 3D-Textur, die den Volumengehalt in Pixeln definiert.

Standardwert ist „ 0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ textureData“ , „ textureWidth “, „ textureDepth “ und „ setTextureFormat()“.

textureWidth : int

Diese Eigenschaft enthält die Breite der 3D-Textur, die den Volumengehalt in Pixeln definiert.

Standardwert ist „ 0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch ` textureData`, ` textureHeight`, ` textureDepth`, ` setTextureFormat()` und ` textureDataWidth()`.

useHighDefShader : bool

Diese Eigenschaft legt fest, ob zum Rendern des Volumens ein Shader mit hoher oder niedriger Auflösung verwendet wird.

Wenn der Wert dieser Eigenschaft „ true “ lautet, wird ein Shader mit hoher Auflösung verwendet. Lautet er „ false “, wird ein Shader mit niedriger Auflösung verwendet.

Der hochauflösende Shader gewährleistet, dass jedes sichtbare Texel der Volumen-Textur beim Rendern des Volumens abgetastet wird. Der Shader mit niedriger Auflösung rendert nur eine grobe Annäherung an den Inhalt des Volumens, dafür jedoch mit einer deutlich höheren Bildrate. Der Shader mit niedriger Auflösung garantiert nicht, dass jedes Texel der Volumentextur abgetastet wird, sodass es zu Flackern kommen kann, wenn das Volumen ausgeprägte, dünne Strukturen enthält.

Standardwert ist „ true “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch ` renderSlice()`.