QCustom3DVolume Class

プロパティ・ドキュメンテーション

alphaMultiplier : float

このプロパティは、ボリュームテクスチャの各テクセルのアルファ値がレンダリング時に乗算される値を保持します。

このプロパティは、ボリュームに均一な透明度を導入するために使用できます。preserveOpacity がtrue の場合、少なくともある程度の透明度を持つテクセルのみが影響を受け、完全に不透明なテクセルは影響を受けません。値は負であってはいけません。デフォルトは1.0f です。

アクセス関数：

Notifier シグナル：

preserveOpacity およびtextureDataも参照 。

colorTable : QList<QRgb>

このプロパティは、インデックス付きテクスチャフォーマットの色を含む配列を保持します。

テクスチャフォーマットがインデックス化されていない場合、この配列は使用されず、空にすることができます。

デフォルトは0 です。

アクセス関数

Notifier シグナル：

textureData 、setTextureFormat()、QImage::colorTable()も参照してください 。

drawSliceFrames : bool

このプロパティは、スライスフレームがボリュームの周囲に描画されるかどうかを保持する。

このプロパティ値がtrue の場合、スライスインデックスプロパティで示されるスライスのフレームがボリュームの周囲に描画されます。false の場合、スライスフレームは描画されません。

スライス枠の描画はスライスの描画とは独立しているので、ボリューム全体を表示しながら、その周囲にスライス枠を描画することができます。これは、renderSlice() を使用してグラフ自体の外側にスライスを表示する場合に便利です。

デフォルトはfalse 。

アクセス関数：

通知シグナル：

sliceIndexX,sliceIndexY,sliceIndexZ,drawSlices,renderSlice()も参照 。

drawSlices : bool

このプロパティは、指定されたスライスをフルボリュームの代わりに描画するかどうかを保持する。

このプロパティ値がtrue の場合、スライスインデックスプロパティで示されるスライスがフルボリュームの代わりに描画される。false の場合、常にフルボリュームが描画されます。デフォルトはfalse です。

アクセス関数

通知シグナル：

sliceIndexX 、sliceIndexY 、sliceIndexZも参照してください 。

preserveOpacity : bool

このプロパティは、アルファ乗数をすべてのテクセルに適用するかどうかを保持します。

このプロパティ値がtrue の場合、alphaMultiplier は、すでにある程度の透明度を持つテクセルにのみ適用されます。このプロパティの値がfalse の場合、倍率はすべてのテキセルのアルファ値に適用されます。デフォルトはtrue です。

アクセス関数：

Notifier シグナル：

alphaMultiplierも参照してください 。

sliceFrameColor : QColor

このプロパティは、スライス枠の色を保持する。

透明なスライス枠の色はサポートされていません。

デフォルトは黒です。

アクセス関数：

通知シグナル：

drawSliceFramesも参照してください 。

sliceFrameGaps : QVector3D

このプロパティは、各次元でボリューム本体とフレームの間に残されたエアギャップのサイズを保持する。

ギャップは異なる寸法で異なることがある。値は、同じ寸法のボリュームの厚さの分数である。値を負にすることはできません。

デフォルトはQVector3D(0.01, 0.01, 0.01) 。

アクセス関数：

通知シグナル：

drawSliceFramesも参照 。

sliceFrameThicknesses : QVector3D

このプロパティは、各次元のスライス枠の厚さを保持する。

値は、同じ次元の体積の厚さの分数です。値を負にすることはできません。

デフォルトはQVector3D(0.01, 0.01, 0.01) です。

アクセス関数：

通知シグナル：

drawSliceFramesも参照 。

sliceFrameWidths : QVector3D

このプロパティはスライス枠の幅を保持します。

幅は異なる次元で異なることができるので、例えば、その次元の値をゼロに設定することで、ボリュームの特定の辺のフレームの描画を省略することができます。値は同じ次元のボリュームの厚さの分数です。値を負にすることはできません。

デフォルトはQVector3D(0.01, 0.01, 0.01) 。

アクセス関数：

通知シグナル：

drawSliceFramesも参照 。

sliceIndexX : int

このプロパティは、どの垂直スライスを表示するかを示すテクスチャデータのx次元インデックスを保持する。

いずれかの次元を負に設定すると、その次元のスライスまたはスライスフレームが描画されないことを示します。すべての次元が負の場合、スライスまたはスライスフレームは描画されず、ボリュームは正常に描画されます。

デフォルトは-1 。

アクセス関数：

Notifier シグナル：

textureData 、drawSlices 、drawSliceFramesも参照してください 。

sliceIndexY : int

このプロパティは、どの水平スライスを表示するかを示すテクスチャデータへのy次元インデックスを保持する。

いずれかの次元を負に設定すると、その次元のスライスまたはスライスフレームが描画されないことを示します。すべての次元が負の場合、スライスまたはスライスフレームは描画されず、ボリュームは正常に描画されます。

デフォルトは-1 。

アクセス関数：

Notifier シグナル：

textureData 、drawSlices 、drawSliceFramesも参照してください 。

sliceIndexZ : int

このプロパティは、どの垂直スライスを表示するかを示すテクスチャデータへのz次元インデックスを保持する。

いずれかの次元を負に設定すると、その次元のスライスまたはスライスフレームが描画されないことを示します。すべての次元が負の場合、スライスまたはスライスフレームは描画されず、ボリュームは正常に描画されます。

デフォルトは-1 。

アクセス関数：

Notifier シグナル：

textureData 、drawSlices 、drawSliceFramesも参照してください 。

textureData : QList<uchar>*

このプロパティは、textureFormat で指定されたフォーマットのテクスチャデータを含む配列を保持します。

この配列のサイズは少なくとも (textureDataWidth * textureHeight * textureDepth * texture format color depth in bytes) でなければならない。

3D テクスチャは 2D サブテクスチャのスタックによって定義されます。各サブテクスチャは同じサイズ (textureDataWidth * textureHeight) である必要があり、スタックの深さはtextureDepth プロパティで定義されます。各2Dテクスチャのデータは、同じフォーマットのQImage データと同じであるため、QImage::bits() を使用して各サブテクスチャのデータを供給することができます。

新しい配列の所有権はQCustom3DVolume インスタンスに移ります。別の配列が設定されると、前の配列は削除されます。同じ配列が再びセットされると、配列の内容が変更されたと見なされ、グラフのレンダリングがトリガーされます。

デフォルトは0 。

アクセス関数：

ノーティファイアシグナル：

colorTable 、setTextureFormat()、setSubTextureData()、textureDataWidth()も参照 。

textureDepth : int

このプロパティは、ボリュームの内容を定義する 3D テクスチャの深さをピクセル単位で保持します。

デフォルトは0 です。

アクセス関数：

Notifier シグナル：

textureData 、textureWidth 、textureHeight 、setTextureFormat （）も参照 。

textureHeight : int

このプロパティは、ボリューム内容を定義する 3D テクスチャの高さをピクセル単位で保持します。

デフォルトは0 です。

アクセス関数：

Notifier シグナル：

textureData 、textureWidth 、textureDepth 、setTextureFormat （）も参照 。

textureWidth : int

このプロパティは、ボリュームの内容を定義する3Dテクスチャの幅をピクセル単位で保持します。

デフォルトは0 です。

アクセス関数：

Notifier シグナル：

textureData 、textureHeight 、textureDepth 、setTextureFormat （）、textureDataWidth （）も参照の こと。

useHighDefShader : bool

このプロパティは、ボリュームのレンダリングに高精細シェーダと低精細シェーダのどちらを使用するかを保持します。

このプロパティの値がtrue の場合、高解像度シェーダが使用されます。false の場合、低解像度シェーダが使用されます。

高解像度シェーダは、ボリュームのレンダリング時にボリュームテクスチャのすべての可視テクセルがサンプリングされることを保証します。低精細度シェーダはボリュームの内容の大まかな近似だけをレンダリング しますが、フレームレートはずっと高くなります。低解像度シェーダはボリュームテクスチャのすべてのテクセルがサンプリングされることを保証しないため、ボリュームに明瞭な薄い特徴がある場合、ちらつきが発生する可能性があります。

デフォルトはtrue です。

アクセス関数：

通知シグナル：

renderSlice()も参照 。