Тип QML Texture

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

Заявление об импорте:	import QtQuick3D .
Наследует:	Object3D

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

Свойства

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 (координаты текстуры), заданных для вершин сетки. Затем программа фрагментного шейдера, используемая для отрисовки активного материала, обычно сэмплирует текстуру(ы) материала в заданных координатах и использует полученные данные в своих расчётах освещения.

Примечание: Материал может использовать несколько текстур для достижения желаемого взаимодействия со светом в 3D-сцене. Он может представлять цвет каждого текселя на поверхности геометрии, но также и другие атрибуты поверхности. Например, "карта нормалей" может представлять отклонение от нормалей геометрии для каждого текселя на поверхности, эмулируя взаимодействие света с мелкими деталями на поверхности, такими как трещины или неровности. См. пример материала principled для демонстрации материала с несколькими картами текстур.

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

изображения или файла текстуры с помощью свойства 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
            }
        }
    ]
}

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

Оригинальное изображение	Проецированное на сферу

<img alt="" src="data:image/png;base64,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

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

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

flipV : bool

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

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

generateMipmaps : bool

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

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

Примечание: Для использования сгенерированных mipmap необходимо установить режим mipFilter.

См. также mipFilter.

indexUV : int

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

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

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

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

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

Постоянная	Описание
`Texture.Nearest`	использует значение ближайшего текселя.
`Texture.Linear`	берёт четыре ближайших текселя и выполняет билинейную интерполяцию.

Примечание: Использование Texture.None по умолчанию приведет к использованию Texture.Linear.

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

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

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

Постоянная	Описание
`Texture.UV`	Значение по умолчанию для карт диффузии и непрозрачности. Это вызывает привязку изображения к сетке. Один и тот же фрагмент изображения всегда будет отображаться на одной и той же вершине (если свойства UV анимированы).
`Texture.Environment`	Значение по умолчанию для карты отражения бликов. Это вызывает «проекцию» изображения на материал, как если бы оно отражалось. Использование среды отображения для карт диффузии обеспечивает эффект зеркала.
`Texture.LightProbe`	Значение по умолчанию для сферических карт HDRI, используемых зондами освещения. Обычно это не нужно устанавливать при использовании зонда освещения, но может потребоваться явное задание при использовании карт окружения.

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

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

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

Постоянная	Описание
`Texture.Nearest`	использует значение ближайшего текселя.
`Texture.Linear`	берёт четыре ближайших текселя и выполняет билинейную интерполяцию.

Примечание: Использование Texture.None по умолчанию приведет к использованию Texture.Linear.

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

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

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

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

Постоянная	Описание
`Texture.None`	отключает использование сэмплирования mipmap.
`Texture.Nearest`	использует mipmap и сэмплирует значение ближайшего текселя.
`Texture.Linear`	использует mipmap и выполняет интерполяцию между значениями нескольких текселей.

Примечание: Это свойство не повлияет на текстуры, у которых нет mipmap.

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

pivotU : float

Это свойство задаёт положение опорной точки U, используемой при применении rotationUV.

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

См. также rotationUV.

pivotV : float

Это свойство задаёт положение опорной точки V, используемой при применении rotationUV.

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

См. также rotationUV.

positionU : float

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

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

positionV : float

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

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

Примечание: Qt Quick 3D использует данные вершин в стиле OpenGL, независимо от используемого API графики во время выполнения. Поэтому UV-позиция (0, 0) относится к левому нижнему углу данных изображения.

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.

Примечание: Поскольку в Quick ось Y направлена вниз, а в Qt Quick 3D — вверх, ориентация текстур по умолчанию может отличаться. Для изменения ориентации можно использовать свойство flipV.

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

sourceItem : Item

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

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

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

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

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

textureData : TextureData

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

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

См. также source, sourceItem и Пример текстуры Qt Quick 3D.

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

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

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

Константа	Описание
`Texture.ClampToEdge`	Текстура не повторяется, а вместо этого используется значение на краю.
`Texture.MirroredRepeat`	Текстура повторяется и зеркально отражается по оси X.
`Texture.Repeat`	Текстура повторяется по оси X.

См. также scaleU.

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

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

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

Константа	Описание
`Texture.ClampToEdge`	Текстура не повторяется, а вместо этого используется значение на краю.
`Texture.MirroredRepeat`	Текстура повторяется и зеркально отражается по оси Y.
`Texture.Repeat`	Текстура повторяется по оси Y.

См. также scaleV.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qml-qtquick3d-texture.html