Класс QAbstractTexture

Базовый класс для предоставления текстур. Подробнее...

• Список всех членов, включая наследуемые

Общедоступные типы

Свойства

Общедоступные функции

Открытые слоты

Сигналы

Защищённые функции

Подробное описание

Класс QAbstractTexture не должен использоваться напрямую, а вместо этого следует использовать один из его подклассов. Каждый подкласс реализует определённую цель текстуры (2D, 2DArray, 3D, CubeMap ...). Каждый подкласс предоставляет набор функций для каждого слоя, грани куба и уровня mipmap. В свою очередь, бэкенд использует эти функции для правильного заполнения соответствующей OpenGL-текстуры данными. Ожидается, что функция будет выполнять минимальную обработку, чтобы не замедлять генерацию и загрузку текстур. Если содержимое текстуры является результатом медленного процедурного процесса генерации, рекомендуется не реализовывать это непосредственно в функции.

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

Документация типов членов

enum QAbstractTexture::CubeMapFace

Этот перечисление идентифицирует грани текстуры куба.

Примечание: AllFaces следует использовать только тогда, когда поведение необходимо применить ко всем граням куба. Это, например, случай использования карты куба в качестве текстурного прикрепления. Использование AllFaces в спецификации прикрепления приведет к привязке всех граней к точке прикрепления. С другой стороны, если указана конкретная грань, прикрепление будет использовать только указанную грань.

enum QAbstractTexture::Filter

Содержит тип фильтра поставщика текстуры.

enum QAbstractTexture::Status

Содержит состояние поставщика текстуры.

enum QAbstractTexture::Target

enum QAbstractTexture::TextureFormat

Этот список описывает все возможные форматы текстур

Документация по функциям-членам

[protected] QAbstractTexture::QAbstractTexture(Qt3DRender::QAbstractTexture::Target target, Qt3DCore::QNode *parent = nullptr)

Конструктор создаёт новый экземпляр QAbstractTexture::QAbstractTexture с указанным target и parent.

[protected] QAbstractTexture::QAbstractTexture(Qt3DCore::QNode *parent = nullptr)

Конструктор создаёт новый экземпляр QAbstractTexture::QAbstractTexture с указанным parent.

[slot] void QAbstractTexture::setComparisonFunction(Qt3DRender::QAbstractTexture::ComparisonFunction function)

Устанавливает функцию сравнения на function.

Примечание: Функция-сеттер для свойства comparisonFunction.

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

[slot] void QAbstractTexture::setComparisonMode(Qt3DRender::QAbstractTexture::ComparisonMode mode)

Устанавливает режим сравнения на mode.

Примечание: Функция-сеттер для свойства comparisonMode.

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

[slot] void QAbstractTexture::setDepth(int depth)

Устанавливает глубину текстуры на depth.

Примечание: Функция-сеттер для свойства depth.

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

[slot] void QAbstractTexture::setFormat(Qt3DRender::QAbstractTexture::TextureFormat format)

Устанавливает формат текстуры на format.

Примечание: Функция-сеттер для свойства format.

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

[slot] void QAbstractTexture::setGenerateMipMaps(bool gen)

Булевый параметр gen устанавливает флаг, указывающий, должен ли поставщик текстур генерировать mipmap или нет.

Примечание: Функция-сеттер для свойства generateMipMaps.

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

[slot] void QAbstractTexture::setHeight(int height)

Устанавливает высоту на height.

Примечание: Функция-сеттер для свойства height.

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

[slot] void QAbstractTexture::setLayers(int layers)

Устанавливает максимальное количество слоёв на layers.

Примечание: Функция-сеттер для свойства layers.

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

[slot] void QAbstractTexture::setMagnificationFilter(Qt3DRender::QAbstractTexture::Filter f)

Устанавливает фильтр увеличения на f.

Примечание: Функция-сеттер для свойства magnificationFilter.

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

[slot] void QAbstractTexture::setMaximumAnisotropy(float anisotropy)

Устанавливает максимальную анизотропию на anisotropy.

Примечание: Функция-сеттер для свойства maximumAnisotropy.

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

[slot] void QAbstractTexture::setMinificationFilter(Qt3DRender::QAbstractTexture::Filter f)

Устанавливает фильтр уменьшения на указанное значение f.

Примечание: Функция-сеттер для свойства minificationFilter.

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

[slot] void QAbstractTexture::setSamples(int samples)

Устанавливает количество выборок на пиксель на samples.

Примечание: Функция-сеттер для свойства samples.

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

[slot] void QAbstractTexture::setWidth(int width)

Устанавливает ширину поставщика текстур на width.

Примечание: Функция-сеттер для свойства width.

См. также ширину().

void QAbstractTexture::addTextureImage(Qt3DRender::QAbstractTextureImage *textureImage)

Добавляет новый Qt3DCore::QAbstractTextureImage textureImage в поставщик текстур.

Примечание: Qt3DRender::QAbstractTextureImage не должен использоваться совместно между несколькими экземплярами Qt3DRender::QAbstractTexture.

Qt3DRender::QAbstractTexture::ComparisonFunction QAbstractTexture::comparisonFunction() const

Возвращает текущую функцию сравнения.

Примечание: Функция-геттер для свойства comparisonFunction.

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

Qt3DRender::QAbstractTexture::ComparisonMode QAbstractTexture::comparisonMode() const

Возвращает текущий режим сравнения.

Примечание: Функция-геттер для свойства comparisonMode.

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

int QAbstractTexture::depth() const

Возвращает глубину текстуры

Примечание: Функция-геттер для свойства depth.

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

Qt3DRender::QAbstractTexture::TextureFormat QAbstractTexture::format() const

Возвращает формат поставщика текстур.

Примечание: Функция-геттер для свойства format.

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

[since 5.13] QVariant QAbstractTexture::handle() const

Возвращает текущую ручку текстуры. Если Qt 3D использует рендерер OpenGL, handle — это целое число идентификатора текстуры.

Примечание: Функция-геттер для свойства handle.

Данная функция была добавлена в Qt 5.13.

[since 5.13] Qt3DRender::QAbstractTexture::HandleType QAbstractTexture::handleType() const

Возвращает текущий тип ручки текстуры.

Примечание: Функция-геттер для свойства handleType.

Данная функция была добавлена в Qt 5.13.

int QAbstractTexture::height() const

Возвращает высоту текстуры

Примечание: Функция-геттер для свойства height.

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

int QAbstractTexture::layers() const

Возвращает максимальное количество слоёв для поставщика текстур.

Примечание: Это имеет значение только для поставщиков текстур с 3D или массивом целевых форматов.

Примечание: Функция-геттер для свойства layers.

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

float QAbstractTexture::maximumAnisotropy() const

Возвращает текущий максимальный изотропию.

Примечание: Функция-геттер для свойства maximumAnisotropy.

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

void QAbstractTexture::removeTextureImage(Qt3DRender::QAbstractTextureImage *textureImage)

Удаляет Qt3DCore::QAbstractTextureImage textureImage из поставщика текстур.

int QAbstractTexture::samples() const

Возвращает количество выборок на пиксель для поставщика текстур.

Примечание: Это имеет значение только для поставщиков текстур с многообразными форматами.

Примечание: Функция-геттер для свойства samples.

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

void QAbstractTexture::setSize(int w, int h = 1, int d = 1)

Устанавливает размер поставщика текстур на ширину w, высоту h и глубину d.

[protected] void QAbstractTexture::setStatus(Qt3DRender::QAbstractTexture::Status status)

Устанавливает статус поставщика текстур на заданный status.

См. также статус().

void QAbstractTexture::setWrapMode(const Qt3DRender::QTextureWrapMode &wrapMode)

Устанавливает режим обёртки на значение, указанное в wrapMode.

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

Qt3DRender::QAbstractTexture::Status QAbstractTexture::status() const

Возвращает текущий статус поставщика текстур.

Примечание: Функция-геттер для свойства status.

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

Qt3DRender::QAbstractTexture::Target QAbstractTexture::target() const

Возвращает целевой формат поставщика текстур.

Примечание: Функция-геттер для свойства target.

QList<Qt3DRender::QAbstractTextureImage *> QAbstractTexture::textureImages() const

Возвращает список указателей на объекты QAbstractTextureImage, содержащиеся в поставщике текстур.

[since 5.14] void QAbstractTexture::updateData(const Qt3DRender::QTextureDataUpdate &update)

Обновляет подобласть текстуры, определённую параметром update, без изменения генератора данных или использования добавления или удаления изображений текстур.

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

Данная функция была добавлена в Qt 5.14.

int QAbstractTexture::width() const

Возвращает ширину текстуры

Примечание: Функция-геттер для свойства width.

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