Тип QML ShaderImage

Предоставляет доступ к изображениям для программ шейдеров. Подробнее...

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

Свойства

• access : перечисление
• format : перечисление
• layer : int
• layered : bool
• mipLevel : int

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

Для того, чтобы содержимое текстур было доступно для операций чтения и записи в шейдере, они должны быть представлены как ShaderImage. Текстуры могут состоять из нескольких уровней mip, слоёв и граней. Кроме того, объявление ShaderImage позволяет указать, какой уровень, слой или грань содержимого текстуры мы хотим получить доступ.

ShaderImage должен быть присвоен в качестве значения параметра и ссылаться на допустимую Qt3D.Render.AbstractTexture для корректной работы.

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

Поддержка ShaderImage поддерживается только с OpenGL 4 и частично с OpenGL ES 3.1 и 3.2.

OpenGL 4 поддерживает следующие типы изображений:

OpenGL ES 3.1 поддерживает следующие типы изображений:

OpenGL ES 3.2 поддерживает все типы изображений OpenGL ES 3.1, а также следующие:

Ожидаемое использование:

import Qt3D.Render 2.14

Entity {
...
    Texture2D {
        id: tex2D
        ...
    }

    Material {
        parameters: Parameter {
            name: "imageUniformName"
            value: ShaderImage {
                texture: tex2D
            }
        }
        ...
    }
 ...
}

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

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

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

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

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

Указывает формат изображения, что очень важно при хранении значений в ShaderImage из шейдера.

Формат не обязательно должен совпадать с форматом текстуры, к которой он относится. Однако он должен быть совместим (совпадать по размеру, но не обязательно по типу). Например, текстура формата R32F (размер 32 бита, класс 1x32) может использоваться с изображением формата RGBA8I (размер 32 бита, класс 4x8). Таблица 8.27 спецификаций OpenGL показывает размер и класс для всех поддерживаемых форматов изображений.

По умолчанию Qt3D попытается установить формат изображения, соответствующий формату связанной текстуры.

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

layer : целое

Указывает, какой слой из связанной текстуры следует использовать для ShaderImage. Это свойство ничего не делает, если layered установлено в значение true или если тип текстуры-ссылки несовместим со слоями.

Примечание: Когда связанная текстура является текстурой типа куб или массивом текстур куб и ĺayered установлено в значение false, грань и слой извлекаются следующим образом:

cubeMapLayer = layer / 6
cubeMapFace = layer - (cubeMapLayer * 6)

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

layered : логическое

*

Если установлено в значение true, если связанная текстура является одномерным, двумерным, трехмерным, массивом текстур куб, массивом текстур куб или двумерным многократным массивом текстур, весь уровень будет привязан для всех слоев. Если установлено в значение false, будет привязана только единственная плоскость, определённая свойством layer.

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

mipLevel : целое

Указывает, какой mipLevel из связанной текстуры следует использовать для ShaderImage.

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