`textureGatherCompare`

함수

Compares the reference depth ref against the four texels a linear filter would blend at the coordinate on mip level 0, through the comparison sampler smp, and returns the four results (0 or 1 each) as a vec4 in the order (umin,vmax), (umax,vmax), (umax,vmin), (umin,vmin), in any stage.

이름마다 붙은 시그니처와 설명은 커밋 26de7be8의 컴파일러 소스에서 그대로 가져온 영어 원문입니다.

구문

declare function textureGatherCompare(
  tex: texture_depth_2d,
  smp: sampler_comparison,
  uv: vec2,
  ref: number,
): vec4
declare function textureGatherCompare(
  tex: texture_depth_2d_array,
  smp: sampler_comparison,
  uv: vec2,
  layer: number,
  ref: number,
): vec4
declare function textureGatherCompare(
  tex: texture_depth_cube,
  smp: sampler_comparison,
  dir: vec3,
  ref: number,
): vec4
declare function textureGatherCompare(
  tex: texture_depth_cube_array,
  smp: sampler_comparison,
  dir: vec3,
  layer: number,
  ref: number,
): vec4

매개변수나 반환 위치에 쓰인 number는 스칼라가 들어갈 자리입니다. 앰비언트 파일은 GPU 스칼라를 브랜드가 붙은 number로 선언하고 그 브랜드는 선택이라서, 리터럴도 브랜드가 붙은 스칼라도 이 자리에 들어갑니다.

type f32 = number & { readonly [f32Tag]?: true }

직접 쓰는 선언에는 여전히 너비가 필요합니다. 필드나 매개변수에 number만 적으면 거부되며, 그 행과 컴파일러가 낸 메시지는 TypeScript에서 페이지에 있습니다.

매개변수

tex texture_depth_2dtexture_depth_2d_arraytexture_depth_cubetexture_depth_cube_array
smp sampler_comparison
uv 선택 사항 vec2
dir 선택 사항 vec3
ref number
layer 선택 사항 number

반환값

vec4

설명

On a texture_depth_2d_array or a texture_depth_cube_array the layer comes before the reference. Compiles to textureGatherCompare on WGSL; GLSL ES 3.00 has no gather, so a module using it emits WGSL alone.

CPU 오라클에는 텍스처 메모리도 이웃 프래그먼트도 없습니다. { gpuStubs: true }로 컴파일한 모듈이 아니면 호출이 예외를 던집니다. 그 옵션을 주면 자리를 채우는 값이 돌아옵니다.

대상별 출력

WGSL: textureGatherCompare(a, b, c, d)
GLSL ES 3.00: textureGatherCompare has no GLSL ES 3.00 spelling (textureGather is ES 3.10)

예제

cube-array-gather.shade.ts

함께 보기

이 페이지 편집 문제 보고