QCustom3DVolume Class

属性文档

alphaMultiplier : float

该属性用于保存渲染时体积纹理每个像素的 alpha 值乘以的值。

该属性可用于为 volume 引入统一的透明度。如果preserveOpacity 为true ，则只有至少具有一定透明度的纹理会受到影响，完全不透明的纹理不会受到影响。该值不能为负。默认值为1.0f 。

访问功能：

Notifier 信号：

另请参见 preserveOpacity 和textureData 。

colorTable : QList<QRgb>

此属性保存包含索引纹理格式颜色的数组。

如果纹理格式没有索引，则不使用此数组，数组可以为空。

默认为0 。

访问功能：

Notifier 信号：

另请参阅 textureData,setTextureFormat() 和QImage::colorTable() 。

drawSliceFrames : bool

此属性用于确定是否在体积周围绘制切片框架。

如果该属性值为true ，则将在体积周围绘制切片索引属性所指示的切片框架。如果该属性值为false ，则不会绘制切片框架。

绘制切片框架与绘制切片无关，因此可以在显示完整体积的同时绘制其周围的切片框架。这在使用renderSlice() 在图形外显示切片时非常有用。

默认为false 。

访问功能：

Notifier 信号：

另请参阅 sliceIndexX,sliceIndexY,sliceIndexZ,drawSlices 和renderSlice() 。

drawSlices : bool

此属性表示是否绘制指定的切片而不是整个体积。

如果此属性值为true ，则将绘制切片索引属性所指示的切片，而不是整个体积。如果该属性值为false ，则将始终绘制全卷。默认值为false 。

访问功能：

通知信号：

另请参阅 sliceIndexX,sliceIndexY, 和sliceIndexZ 。

preserveOpacity : bool

此属性表示 Alpha 倍增器是否应用于所有像素。

如果此属性值为true ，则alphaMultiplier 只应用于已具有一定透明度的像素。如果该属性值为false ，则乘数将应用于所有像素的 alpha 值。默认值为true 。

访问功能：

Notifier 信号：

另请参阅 alphaMultiplier 。

sliceFrameColor : QColor

该属性用于保存切片边框的颜色。

不支持透明切片边框颜色。

默认为黑色。

访问功能：

Notifier 信号：

另请参见 drawSliceFrames 。

sliceFrameGaps : QVector3D

该属性表示在每个维度上，体积本身与边框之间的气隙大小。

不同尺寸的间隙可能不同。数值为同一尺寸内体积厚度的分数。数值不能为负。

默认值为QVector3D(0.01, 0.01, 0.01) 。

访问功能：

通知信号：

另请参阅 drawSliceFrames 。

sliceFrameThicknesses : QVector3D

此属性保存每个维度的切片框架厚度。

数值为同一维度体积厚度的分数。数值不能为负。

默认值为QVector3D(0.01, 0.01, 0.01) 。

访问功能：

Notifier 信号：

另请参阅 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)。

三维纹理由二维子纹理堆栈定义。每个子纹理的大小必须相同 (textureDataWidth * textureHeight) ，堆栈的深度由textureDepth 属性定义。每个 2D 纹理中的数据与QImage 数据格式相同，因此可以使用QImage::bits() 为每个子纹理提供数据。

新数组的所有权将转移到QCustom3DVolume 实例。如果设置了另一个数组，先前的数组将被删除。如果再次设置同一数组，则假定数组内容已更改，并触发图形渲染。

默认值为0 。

访问函数：

Notifier 信号：

另请参阅 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 。

访问功能：

Notifier 信号：

另请参阅 renderSlice().