Тип 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 или если тип ссылки на текстуру несовместим со слоями.

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

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

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

*

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

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

mipLevel : целое число

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

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