Тип QML ShaderImage

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

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

Свойства

• access : перечисление
• format : перечисление
• слой : int
• многослойный : bool
• уровеньMip : int

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

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

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

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

Поддержка 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.