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 das Texturformat nicht indiziert ist, 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 Schnitte, die durch die Schnittindex-Eigenschaften angegeben werden, um das Volumen herum gezeichnet. Lautet der Wert „ false “, werden keine Schnittrahmen gezeichnet.

Das Zeichnen von Schnittrahmen erfolgt 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 des Diagramms 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 dieser Eigenschaftswert auf „ true “ gesetzt ist, werden anstelle des gesamten Volumens die durch die Schnittindex-Eigenschaften angegebenen Schnitte gezeichnet. Bei „ 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 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 Schnittbilder 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. So können Sie beispielsweise das Zeichnen der Rahmen an bestimmten Seiten des Volumens unterdrücken, 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-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 “.

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, wird für diese Dimension kein Schnitt oder Schnittrahmen gezeichnet. 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 mit „ QImage::bits()“ die Daten für jede Teiltextur bereitgestellt werden können.

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 Volumeninhalt in Pixeln definiert.

Standardwert ist „ 0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

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

textureWidth : int

Diese Eigenschaft gibt die Breite der 3D-Textur in Pixeln an, die den Inhalt des Volumens 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 hochauflösender Shader verwendet. Lautet er „ false “, wird ein niedrigauflösender Shader 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 Volumen-Textur abgetastet wird; daher kann es zu Flackern kommen, wenn das Volumen ausgeprägte, dünne Merkmale enthält.

Standardwert ist „ true “.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch renderSlice().