Класс 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

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

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

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

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

int	textureDepth() const
void	setTextureDepth(int value)

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

void	textureDepthChanged(int value)

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

textureHeight : int

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

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

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

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

int	textureHeight() const
void	setTextureHeight(int value)

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

void	textureHeightChanged(int value)

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

textureWidth : int

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

Значение по умолчанию: 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().