QShaderDescription Class

멤버 함수 문서

QShaderDescription::QShaderDescription()

새로운 빈 QShaderDescription 객체를 생성합니다.

QShaderDescription::QShaderDescription(const QShaderDescription &other)

other 의 복사본을 생성합니다.

[noexcept] QShaderDescription::~QShaderDescription()

소멸자.

QList<QShaderDescription::InOutVariable> QShaderDescription::combinedImageSamplers() const

결합된 이미지 샘플러 목록을 반환합니다.

GLSL/Vulkan 셰이더를 소스로 할 때, ` layout(binding = 1) uniform sampler2D tex; ` 유니폼은 다음과 같은 결과를 생성합니다(여기서는 텍스트 형식의 JSON으로 표시됨).

"combinedImageSamplers": [
     {
         "binding": 1,
         "name": "tex",
         "set": 0,
         "type": "sampler2D"
     }
 ]

그렇다고 해서 셰이더의 다른 언어 버전에서도 반드시 결합된 이미지 샘플러를 사용해야 한다는 의미는 아닙니다. 특히 이 개념이 모든 언어에 존재하는 것은 아니기 때문입니다. 예를 들어, HLSL 버전은 각각 레지스터 t1과 s1을 사용하는 Texture2D 및 SamplerState 객체를 사용할 가능성이 높습니다.

std::array<uint, 3> QShaderDescription::computeShaderLocalSize() const

컴퓨트 셰이더의 로컬 크기를 반환합니다.

예를 들어, 다음과 같이 선언된 컴퓨트 셰이더의 경우 이 함수는 { 256, 16, 1}을 반환합니다.

layout(local_size_x = 256, local_size_y = 16, local_size_z = 1) in;

[static] QShaderDescription QShaderDescription::deserialize(QDataStream *stream, int version)

stream 에서 로드된 새로운 QShaderDescription 객체를 반환합니다. version 는 qsb 버전을 지정합니다.

serialize()도 참조하십시오 .

QList<QShaderDescription::BuiltinVariable> QShaderDescription::inputBuiltinVariables() const

입력으로 사용되는 활성 내장 변수 목록을 반환합니다. 예를 들어, gl_TessCoord와 gl_Position의 값을 읽는 테셀레이션 평가 셰이더의 경우, 여기에는 TessCoordBuiltin 와 PositionBuiltin 가 나열됩니다.

QList<QShaderDescription::InOutVariable> QShaderDescription::inputVariables() const

입력 변수 목록을 반환합니다. 여기에는 정점 단계에 대한 정점 입력(때로는 ‘속성’이라고도 함)과 다른 단계에 대한 입력(때로는 ‘변수’라고도 함)이 포함됩니다.

bool QShaderDescription::isValid() const

QShaderDescription 에 변수 목록이나 블록 목록 중 하나에 적어도 하나의 항목이 포함되어 있으면 true를 반환합니다.

QList<QShaderDescription::BuiltinVariable> QShaderDescription::outputBuiltinVariables() const

입력으로 사용되는 활성 내장 변수 목록을 반환합니다. 예를 들어, 버텍스 셰이더에서는 ` PositionBuiltin `가 출력 내장 변수로 사용되는 경우가 매우 흔합니다.

QList<QShaderDescription::InOutVariable> QShaderDescription::outputVariables() const

출력 변수 목록을 반환합니다.

QList<QShaderDescription::PushConstantBlock> QShaderDescription::pushConstantBlocks() const

푸시 상수 블록의 목록을 반환합니다.

void QShaderDescription::serialize(QDataStream *stream, int version) const

이 QShaderDescription 을 stream 로 직렬화합니다. version 는 qsb 버전을 지정합니다.

deserialize() 및 toJson()도 참조하십시오 .

QList<QShaderDescription::StorageBlock> QShaderDescription::storageBlocks() const

셰이더 스토리지 블록 목록을 반환합니다.

예를 들어, GLSL/Vulkan 셰이더를 소스로 사용할 경우, 다음 선언문

struct Stuff {
    vec2 a;
    vec2 b;
};
layout(std140, binding = 0) buffer StuffSsbo {
    vec4 whatever;
    Stuff stuff[];
} buf;

다음과 같은 결과를 생성합니다. (여기서는 텍스트 형식의 JSON으로 표시됨)

"storageBlocks": [ {
    "binding": 0,
    "blockName": "StuffSsbo",
    "instanceName": "buf",
    "knownSize": 16,
    "runtimeArrayStride": 16
    "members": [
        {
            "name": "whatever",
            "offset": 0,
            "size": 16,
            "type": "vec4"
        },
        {
            "arrayDims": [
                0
            ],
            "name": "stuff",
            "offset": 16,
            "size": 0,
            "structMembers": [
                {
                    "name": "a",
                    "offset": 0,
                    "size": 8,
                    "type": "vec2"
                },
                {
                    "name": "b",
                    "offset": 8,
                    "size": 8,
                    "type": "vec2"
                }
            ],
            "type": "struct"
        }
    ],
    "set": 0
} ]

QList<QShaderDescription::InOutVariable> QShaderDescription::storageImages() const

이미지 변수 목록을 반환합니다.

이러한 변수들은 주로 컴퓨트 셰이더에서 사용됩니다. 예를 들어, ` layout (binding = 0, rgba8) uniform readonly image2D inputImage; `는 다음과 같은 결과를 생성합니다(여기서는 텍스트 형식의 JSON으로 표시됨):

"storageImages": [
     {
         "binding": 0,
         "imageFormat": "rgba8",
         "name": "inputImage",
         "set": 0,
         "type": "image2D"
     }
 ]

QShaderDescription::TessellationMode QShaderDescription::tessellationMode() const

테셀레이션 제어 셰이더 또는 평가 셰이더에 대한 테셀레이션 실행 모드를 반환합니다.

설정되지 않은 경우, 반환 값은 UnknownTessellationMode 입니다.

예를 들어, 다음과 같이 선언된 테셀레이션 평가 셰이더의 경우 이 함수는 ` TrianglesTessellationMode`을 반환합니다.

layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

출력 버텍스의 개수를 반환합니다.

예를 들어, 다음과 같이 선언된 테셀레이션 제어 셰이더의 경우 이 함수는 3을 반환합니다.

layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

테셀레이션 제어 셰이더 또는 평가 셰이더에 대한 테셀레이션 분할 모드를 반환합니다.

설정되지 않은 경우, 반환 값은 ` UnknownTessellationPartitioning`입니다.

예를 들어, 다음과 같이 선언된 테셀레이션 평가 셰이더의 경우, 이 함수는 ` FractionalOddTessellationPartitioning`를 반환합니다.

layout(triangles, fractional_odd_spacing, ccw) in;

QShaderDescription::TessellationWindingOrder QShaderDescription::tessellationWindingOrder() const

테셀레이션 제어 셰이더 또는 평가 셰이더에 대한 테셀레이션 와인딩 순서를 반환합니다.

설정되지 않은 경우, 반환 값은 UnknownTessellationWindingOrder 입니다.

예를 들어, 다음과 같이 선언된 테셀레이션 평가 셰이더의 경우, 이 함수는 ` CcwTessellationWindingOrder`를 반환합니다.

layout(triangles, fractional_odd_spacing, ccw) in;

QByteArray QShaderDescription::toJson() const

데이터를 직렬화된 JSON 텍스트 형식으로 반환합니다.

serialize()도 참조하십시오 .

QList<QShaderDescription::UniformBlock> QShaderDescription::uniformBlocks() const

균일 블록 목록을 반환합니다.

QShaderDescription &QShaderDescription::operator=(const QShaderDescription &other)

이 객체에 ` other `를 할당합니다.