Класс QCustom3DVolume

Документация свойств

alphaMultiplier : float

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

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

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

float	alphaMultiplier() const
void	setAlphaMultiplier(float mult)

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

void	alphaMultiplierChanged(float mult)

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

colorTable : QList<QRgb>

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

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

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

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

QList<QRgb>	colorTable() const
void	setColorTable(const QList<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 : QList<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.

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

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

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

void	textureDataChanged(QList<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().