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

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

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

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