Тип QML Texture

Определяет текстуру для использования в 3D-сценах. Подробнее...

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

Свойства

• autoOrientation : bool
• flipU : bool
• flipV : bool
• generateMipmaps : bool
• indexUV : int
• magFilter : перечисление
• mappingMode : перечисление
• minFilter : перечисление
• mipFilter : перечисление
• pivotU : float
• pivotV : float
• positionU : float
• positionV : float
• rotationUV : float
• scaleU : float
• scaleV : float
• source : url
• sourceItem : Item
• textureData : TextureData
• tilingModeHorizontal : перечисление
• tilingModeVertical : перечисление

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

Текстура — это, по сути, любой массив пикселей (1D, 2D или 3D) и связанные с ним настройки, такие как фильтры уменьшения и увеличения, масштабирование и преобразования UV.

Тип Texture в Qt Quick 3D представляет собой двумерное изображение. Он обычно используется для отображения/обертывания вокруг трехмерной геометрии, чтобы эмулировать дополнительные детали, которые невозможно эффективно смоделировать в 3D. Он также может использоваться для имитации других эффектов освещения, таких как отражения.

При отрисовке геометрии каждая точка на её поверхности преобразуется в соответствующую точку на текстуре путём преобразования и интерполяции координат UV (координаты текстуры), заданных для вершин сетки. Затем программа фрагментного шейдера, используемая для отрисовки активного материала, обычно будет брать образец материала по данным координатам и использовать полученные данные в расчетах освещения.

Объекты текстуры могут получать данные изображения из:

• изображения или файла текстуры, используя свойство source,
• элемента Qt Quick Item, используя свойство sourceItem,
• или, установив свойство textureData на подкласс элемента TextureData для определения пользовательского содержимого текстуры.

В следующем примере изображение «madewithqt.png» отображается на стандартной сфере, а координаты UV масштабируются для того, чтобы изображение повторялось на поверхности сферы.

Model {
    source: "#Sphere"
    materials: [ PrincipledMaterial {
            baseColorMap: Texture {
                source: "madewithqt.png"
                scaleU: 4.0
                scaleV: 4.0
            }
        }
    ]
}

Результат выглядит следующим образом:

См. также Пример динамической текстуры Qt Quick 3D и Пример процедурной текстуры Qt Quick 3D.

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

[с 6.2] autoOrientation : bool

Это свойство определяет, применяется ли преобразование текстуры, например, инвертирование вертикальной координаты текстуры, автоматически для текстур, для которых это обычно актуально.

По умолчанию это свойство установлено в true.

У некоторых типов данных текстуры, таких как сжатые текстуры, загруженные через свойство source из файла .ktx или .pkm, или текстуры, сгенерированные путем отрисовки сцены Qt Quick через свойство sourceItem, часто имеет другую ориентацию оси Y по сравнению с текстурами, загруженными из файлов изображений, таких как .png или .jpg. Поэтому такая текстура будет отображаться «вверх ногами» по сравнению с текстурой, у которой источник установлен на обычный файл изображения. Для исправления этого, любая соответствующая текстура получает неявное преобразование UV так, как будто свойство flipV было установлено в true. Если этого не требуется, установите это свойство в false.

Это свойство было добавлено в Qt 6.2.

См. также flipV.

flipU : bool

Это свойство устанавливает использование горизонтально инвертированных координат текстуры.

Значение по умолчанию — false.

См. также flipV.

flipV : bool

Это свойство устанавливает использование вертикально инвертированных координат текстуры.

Значение по умолчанию — false.

См. также flipU.

generateMipmaps : bool

Это свойство определяет, генерируются ли mipmaps для текстур, которые сами не предоставляют уровни mipmap. Использование mipmaps вместе с фильтром mip дает лучшее качество изображения при просмотре текстур на расстоянии по сравнению с рендерингом без них, но это может повлиять на производительность (как при инициализации изображения, так и при рендеринге).

По умолчанию это свойство установлено в false.

См. также mipFilter.

indexUV : int

Это свойство устанавливает индекс координаты UV, используемый этой текстурой. Поскольку QtQuick3D поддерживает сейчас 2 набора UV (0 или 1), значение будет ограничено диапазоном.

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

magFilter : перечисление

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

Значение по умолчанию — Texture.Linear.

См. также minFilter и mipFilter.

mappingMode : перечисление

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

minFilter : перечисление

Это свойство определяет, как текстура сэмплируется, когда тексель охватывает более одного пикселя.

Значение по умолчанию — Texture.Linear.

См. также magFilter и mipFilter.

mipFilter : перечисление

Это свойство определяет, как сэмплируются mip-уровни текстуры, когда тексель охватывает менее одного пикселя.

Значение по умолчанию — Texture.None.

См. также minFilter и magFilter.

pivotU : float

Это свойство устанавливает позицию оси U для центра вращения, которая используется при применении rotationUV.

Значение по умолчанию — 0.0.

См. также rotationUV.

pivotV : float

Это свойство устанавливает позицию оси V для центра вращения, которая используется при применении rotationUV.

Значение по умолчанию — 0.0.

См. также pivotU и rotationUV.

positionU : float

Это свойство смещает отображение координаты U слева направо.

Значение по умолчанию — 0.0.

См. также positionV.

positionV : float

Это свойство смещает отображение координаты V снизу вверх.

Значение по умолчанию — 0.0.

См. также positionU.

rotationUV : float

Это свойство вращает текстуру вокруг точки вращения. Оно определяется с помощью углов Эйлера, и положительное значение означает вращение по часовой стрелке.

Значение по умолчанию — 0.0.

См. также pivotU и pivotV.

scaleU : float

Это свойство определяет масштабирование координаты U текстуры при отображении на UV-координаты меша.

Масштабирование значения U при использовании горизонтального чередования определяет, сколько раз текстура повторяется слева направо.

Значение по умолчанию — 1.0.

См. также tilingModeHorizontal.

scaleV : float

Это свойство определяет масштабирование координаты V текстуры при отображении на UV-координаты меша.

Масштабирование значения V при использовании вертикального чередования определяет, сколько раз текстура повторяется снизу вверх.

Значение по умолчанию — 1.0.

См. также tilingModeVertical.

source : url

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

Свойство представляет собой URL-адрес, с теми же правилами, что и другие свойства source, такие как Image.source. В случае с Texture поддерживаются только схемы qrc и file. Если схема отсутствует, и значение является относительным путем, предполагается, что оно относительно расположения компонента (т.е. файла .qml).

Файл источника может иметь любой стандартный формат изображения поддерживаемый Qt. Кроме того, Texture поддерживает те же типы сжатых файлов текстур, что и QtQuick::Image.

См. также sourceItem, textureData, autoOrientation и flipV.

sourceItem : Элемент

Это свойство определяет Элемент, используемый в качестве источника текстуры. Использование этого свойства позволяет использовать любой 2D контент Qt Quick в качестве источника текстуры, рендеринга этого элемента как отдельного слоя.

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

Если это свойство установлено, значение source будет игнорироваться. Текстура должна использовать один метод для предоставления данных изображения и установить только одно из свойств: source, sourceItem или textureData.

См. также source, textureData и autoOrientation.

textureData : TextureData

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

Если это свойство используется, то значение source будет проигнорировано. Текстура должна использовать один метод для предоставления данных изображения и установить только одно из свойств: source, sourceItem или textureData.

См. также source, sourceItem и Qt Quick 3D - Пример процедурной текстуры.

tilingModeHorizontal : перечисление

Управляет способом отображения текстуры, когда значение масштабирования U больше 1.

По умолчанию это свойство установлено в Texture.Repeat.

См. также scaleU.

tilingModeVertical : перечисление

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

По умолчанию это свойство установлено в Texture.Repeat.

См. также scaleV.