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