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 ，则该乘数将应用于所有纹理像素的alpha值。默认值为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()。