QCustom3DVolume Class

プロパティのドキュメント

alphaMultiplier : float

このプロパティには、レンダリング時にボリュームテクスチャの各テクセルのアルファ値に掛けられる値が格納されます。

このプロパティを使用すると、ボリューム全体に均一な透明度を適用できます。preserveOpacity がtrue の場合、最初からある程度の透明度を持つテクセルのみが影響を受け、完全に不透明なテクセルは影響を受けません。値は負にしてはなりません。デフォルトは1.0f です。

アクセス関数：

通知シグナル:

preserveOpacity およびtextureDataも参照してください 。

colorTable : QList<QRgb>

このプロパティは、インデックス付きテクスチャ形式用の色を含む配列を保持します。

テクスチャ形式がインデックス付きでない場合、この配列は使用されず、空でもかまいません。

デフォルト値は0 です。

アクセス関数：

通知シグナル:

関連項目: ` 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 です。

アクセス関数：

通知シグナル：

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 です。

アクセス関数：

通知シグナル:

関連項目： textureData 、drawSlices 、およびdrawSliceFrames 。

sliceIndexY : int

このプロパティは、テクスチャデータ内のY方向のインデックスを保持しており、どの水平スライスを表示するかを指定します。

いずれかの次元を負の値に設定すると、その次元に対応するスライスまたはスライスフレームは描画されません。すべての次元が負の値の場合、スライスやスライスフレームは一切描画されず、ボリュームは通常通り描画されます。

デフォルト値は-1 です。

アクセス関数：

通知シグナル:

関連項目： textureData 、drawSlices 、およびdrawSliceFrames 。

sliceIndexZ : int

このプロパティは、どの垂直スライスを表示するかを示す、テクスチャデータ内のZ方向のインデックスを保持します。

いずれかの次元を負の値に設定すると、その次元に対応するスライスまたはスライス枠は描画されません。すべての次元が負の値の場合、スライスやスライス枠は一切描画されず、ボリュームは通常通り描画されます。

デフォルト値は-1 です。

アクセス関数：

通知シグナル:

関連項目: 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 です。

アクセス関数：

通知シグナル：

関連項目： textureData 、textureWidth 、textureHeight 、およびsetTextureFormat()。

textureHeight : int

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

デフォルト値は0 です。

アクセス関数：

通知シグナル:

関連項目: textureData 、textureWidth 、textureDepth 、およびsetTextureFormat()。

textureWidth : int

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

デフォルト値は0 です。

アクセス関数：

通知シグナル:

関連項目: textureData 、textureHeight 、textureDepth 、setTextureFormat()、およびtextureDataWidth()。

useHighDefShader : bool

このプロパティは、ボリュームのレンダリングに高解像度シェーダーと低解像度シェーダーのどちらが使用されるかを指定します。

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

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

デフォルトは「true 」です。

アクセス関数：

通知シグナル：

関連項目： renderSlice()。