Класс QCustom3DVolume

Свойства

alphaMultiplier : float

Это свойство содержит значение, на которое умножается альфа-значение каждого текселя объёмной текстуры во время рендеринга.

Это свойство может использоваться для введения равномерной прозрачности в объём. Если preserveOpacity равно true, то влиянию подвергаются только тексели, изначально обладающие некоторой прозрачностью, а полностью непрозрачные тексели не затрагиваются. Значение не должно быть отрицательным. Значение по умолчанию: 1.0f.

Функции доступа:

float	alphaMultiplier() const
void	setAlphaMultiplier(float mult)

Сигнал уведомления:

void	alphaMultiplierChanged(float mult)

См. также preserveOpacity и textureData.

colorTable : QVector<QRgb>

Это свойство содержит массив, содержащий цвета для индексированных форматов текстур.

Если формат текстуры не является индексированным, этот массив не используется и может быть пустым.

Значение по умолчанию: 0.

Функции доступа:

QVector<QRgb>	colorTable() const
void	setColorTable(const QVector<QRgb> &colors)

Сигнал уведомления:

void	colorTableChanged()

См. также textureData, setTextureFormat(), и QImage::colorTable().

drawSliceFrames : bool

Это свойство определяет, отрисовываются ли рамки срезов вокруг объёма.

Если значение этого свойства равно true, то рамки срезов, указанные свойствами индекса среза, будут отрисованы вокруг объёма. Если оно равно false, рамки срезов отрисовываться не будут.

Отрисовка рамок срезов независима от отрисовки самих срезов, поэтому вы можете отображать полный объём и при этом отрисовывать рамки срезов вокруг него. Это полезно при использовании renderSlice() для отображения срезов за пределами самого графика.

Значение по умолчанию: false.

Функции доступа:

bool	drawSliceFrames() const
void	setDrawSliceFrames(bool enable)

Сигнал уведомления:

void	drawSliceFramesChanged(bool enabled)

См. также sliceIndexX, sliceIndexY, sliceIndexZ, drawSlices, и renderSlice().

drawSlices : bool

Это свойство определяет, отрисовываются ли указанные срезы вместо полного объёма.

Если значение этого свойства равно true, то срезы, указанные свойствами индекса среза, будут отрисованы вместо полного объёма. Если оно равно false, всегда будет отрисовываться полный объём. Значение по умолчанию: false.

Примечание: Срезы всегда отрисовываются вдоль осей элемента, поэтому если элемент повернут, срезы также будут повернуты.

Функции доступа:

bool	drawSlices() const
void	setDrawSlices(bool enable)

Сигнал уведомления:

void	drawSlicesChanged(bool enabled)

См. также sliceIndexX, sliceIndexY, и sliceIndexZ.

preserveOpacity : bool

Это свойство определяет, применяется ли множитель альфа ко всем текселям.

Если значение этого свойства равно true, alphaMultiplier применяется только к текселям, которые уже обладают некоторой прозрачностью. Если оно равно false, множитель применяется к альфа-значению всех текселей. Значение по умолчанию: true.

Функции доступа:

bool	preserveOpacity() const
void	setPreserveOpacity(bool enable)

Сигнал уведомления:

void	preserveOpacityChanged(bool enabled)

См. также alphaMultiplier.

sliceFrameColor : QColor

Это свойство содержит цвет рамки среза.

Прозрачный цвет рамки среза не поддерживается.

Значение по умолчанию: чёрный.

Функции доступа:

QColor	sliceFrameColor() const
void	setSliceFrameColor(const QColor &color)

Сигнал уведомления:

void	sliceFrameColorChanged(const QColor &color)

См. также drawSliceFrames.

sliceFrameGaps : QVector3D

Это свойство содержит размер воздушного зазора между самим объёмом и рамкой в каждом измерении.

Зазор может быть различным в разных измерениях. Значения представляют собой доли толщины объёма в том же измерении. Значения не могут быть отрицательными.

Значение по умолчанию: QVector3D(0.01, 0.01, 0.01).

Функции доступа:

QVector3D	sliceFrameGaps() const
void	setSliceFrameGaps(const QVector3D &values)

Сигнал уведомления:

void	sliceFrameGapsChanged(const QVector3D &values)

См. также drawSliceFrames.

sliceFrameThicknesses : QVector3D

Это свойство содержит толщину рамок срезов для каждого измерения.

Значения представляют собой доли толщины объёма в том же измерении. Значения не могут быть отрицательными.

Значение по умолчанию: QVector3D(0.01, 0.01, 0.01).

Функции доступа:

QVector3D	sliceFrameThicknesses() const
void	setSliceFrameThicknesses(const QVector3D &values)

Сигнал уведомления:

void	sliceFrameThicknessesChanged(const QVector3D &values)

См. также drawSliceFrames.

sliceFrameWidths : QVector3D

Это свойство содержит ширину рамки среза.

Ширина может быть различной в разных измерениях, поэтому вы можете, например, опустить отрисовку рамок на определённых сторонах объёма, установив значение для этого измерения равным нулю. Значения представляют собой доли толщины объёма в том же измерении. Значения не могут быть отрицательными.

Значение по умолчанию: QVector3D(0.01, 0.01, 0.01).

Функции доступа:

QVector3D	sliceFrameWidths() const
void	setSliceFrameWidths(const QVector3D &values)

Сигнал уведомления:

void	sliceFrameWidthsChanged(const QVector3D &values)

См. также drawSliceFrames.

sliceIndexX : int

Это свойство содержит индекс по оси x в данных текстуры, указывающий, какой вертикальный срез отобразить.

Установка любого измерения в отрицательное значение означает, что срез или рамка среза для этого измерения не рисуются. Если все измерения отрицательны, срезы и рамки срезов не рисуются, и объём рисуется обычно.

По умолчанию -1.

Функции доступа:

int	sliceIndexX() const
void	setSliceIndexX(int value)

Сигнал уведомления:

void	sliceIndexXChanged(int value)

См. также textureData, drawSlices и drawSliceFrames.

sliceIndexY : int

Это свойство содержит индекс по оси y в данных текстуры, указывающий, какой горизонтальный срез отобразить.

Установка любого измерения в отрицательное значение означает, что срез или рамка среза для этого измерения не рисуются. Если все измерения отрицательны, срезы и рамки срезов не рисуются, и объём рисуется обычно.

По умолчанию -1.

Функции доступа:

int	sliceIndexY() const
void	setSliceIndexY(int value)

Сигнал уведомления:

void	sliceIndexYChanged(int value)

См. также textureData, drawSlices и drawSliceFrames.

sliceIndexZ : int

Это свойство содержит индекс по оси z в данных текстуры, указывающий, какой вертикальный срез отобразить.

Установка любого измерения в отрицательное значение означает, что срез или рамка среза для этого измерения не рисуются. Если все измерения отрицательны, срезы и рамки срезов не рисуются, и объём рисуется обычно.

По умолчанию -1.

Функции доступа:

int	sliceIndexZ() const
void	setSliceIndexZ(int value)

Сигнал уведомления:

void	sliceIndexZChanged(int value)

См. также textureData, drawSlices и drawSliceFrames.

textureData : QVector<uchar> *

Это свойство содержит массив, содержащий данные текстуры в формате, указанном в textureFormat.

Размер этого массива должен быть как минимум (textureDataWidth * textureHeight * textureDepth * texture format color depth in bytes).

Трехмерная текстура определяется стеком двумерных подтекстур. Каждая подтекстура должна иметь одинаковый размер (textureDataWidth * textureHeight), а глубина стека определяется свойством textureDepth. Данные в каждой двумерной текстуре идентичны данным QImage с тем же форматом, поэтому можно использовать QImage::bits() для предоставления данных для каждой подтекстуры.

Владение новым массивом переходит к экземпляру QCustom3DVolume. Если устанавливается другой массив, предыдущий массив удаляется. Если устанавливается тот же массив, предполагается, что содержимое массива изменилось, и запускается отрисовка графика.

Примечание: Каждая строка данных по оси x должна иметь 32-битную выравнивание. Если textureFormat равен QImage::Format_Indexed8, а значение textureWidth не делится на четыре, могут потребоваться добавление заполняющих байтов к каждой строке данных по оси x. Функция textureDataWidth() возвращает количество байтов с заполнением. Заполняющие байты должны указывать полностью прозрачный цвет, чтобы избежать артефактов отрисовки.

По умолчанию 0.

Функции доступа:

QVector<uchar> *	textureData() const
void	setTextureData(QVector<uchar> *data)

Сигнал уведомления:

void	textureDataChanged(QVector<uchar> *data)

См. также colorTable, setTextureFormat(), setSubTextureData() и textureDataWidth().

textureDepth : int

Это свойство содержит глубину 3D текстуры, определяющую содержимое объёма в пикселях.

По умолчанию 0.

Примечание: Значение textureData может потребоваться изменить размер или пересоздать, если это значение изменено. По умолчанию 0.

Функции доступа:

int	textureDepth() const
void	setTextureDepth(int value)

Сигнал уведомления:

void	textureDepthChanged(int value)

См. также textureData, textureWidth, textureHeight и setTextureFormat().

textureHeight : int

Это свойство содержит высоту 3D текстуры, определяющей содержимое объёма в пикселях.

По умолчанию 0.

Примечание: Значение textureData может потребоваться изменить размер или пересоздать, если это значение изменено. По умолчанию 0.

Функции доступа:

int	textureHeight() const
void	setTextureHeight(int value)

Сигнал уведомления:

void	textureHeightChanged(int value)

См. также textureData, textureWidth, textureDepth и setTextureFormat().

textureWidth : int

Это свойство содержит ширину 3D текстуры, определяющей содержимое объёма в пикселях.

По умолчанию 0.

Примечание: Значение textureData может потребоваться изменить размер или пересоздать, если это значение изменено. По умолчанию 0.

Функции доступа:

int	textureWidth() const
void	setTextureWidth(int value)

Сигнал уведомления:

void	textureWidthChanged(int value)

См. также textureData, textureHeight, textureDepth, setTextureFormat() и textureDataWidth().

useHighDefShader : bool

Это свойство указывает, используется ли высоко- или низкокачественный шейдер для отрисовки объёма.

Если это свойство имеет значение true, используется высококачественный шейдер. Если оно имеет значение false, используется низкокачественный шейдер.

Высокодетализированная шейдерная модель гарантирует, что при отрисовке объёмной текстуры каждый видимый тексель этой текстуры будет просчитан. Низкодетализированная шейдерная модель отображает только приблизительное содержимое объёма, но с гораздо большей частотой кадров. Низкодетализированная шейдерная модель не гарантирует, что каждый тексель объёмной текстуры будет просчитан, поэтому при наличии тонких деталей в объёме может наблюдаться мерцание.

Примечание: Это значение не влияет на уровень детализации при отрисовке срезов объёма.

По умолчанию true.

Функции доступа:

bool	useHighDefShader() const
void	setUseHighDefShader(bool enable)

Сигнал уведомления:

void	useHighDefShaderChanged(bool enabled)

См. также renderSlice().