Texture1DArray에 대한 SampleGrad::SampleGrad(S, float,float,float,int,float) 함수

샘플 위치가 계산되는 방식에 영향을 주는 그라데이션을 사용하여 텍스처를 샘플링하고 샘플 LOD(세부 수준) 값을 클램프하는 선택적 값을 사용합니다.

구문

DXGI_FORMAT SampleGrad(
  in SamplerState S,
  in float        Location,
  in float        DDX,
  in float        DDY,
  in int          Offset,
  in float        Clamp
);

매개 변수

S [in]

형식: SamplerState

샘플러 상태 상태 할당을 포함하는 효과 파일에 선언된 개체입니다.

Location [in]

형식: float

질감 좌표입니다. 인수 형식은 texture-object 형식에 따라 달라집니다.

텍스처-개체 형식 매개 변수 유형
Texture1D float
Texture1DArray, Texture2D float2
Texture2DArray, Texture3D, TextureCube float3
TextureCubeArray float4

 

DDX [in]

형식: float

x 방향의 표면 기하 도형 변화율입니다. 인수 형식은 texture-object 형식에 따라 달라집니다.

텍스처-개체 형식 매개 변수 유형
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray 지원되지 않음

 

DDY [in]

형식: float

표면 기하 도형의 y 방향 변동률입니다. 인수 형식은 texture-object 형식에 따라 달라집니다.

텍스처-개체 형식 매개 변수 유형
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray 지원되지 않음

 

Offset [in]

형식: int

모든 텍스처 개체 형식에 사용할 수 있는 선택적 텍스처 좌표 오프셋입니다. 이 오프셋은 샘플링 전에 위치에 적용됩니다. 정수 miplevel에서만 오프셋을 사용합니다. 그렇지 않으면 하드웨어로 잘 변환되지 않는 결과를 얻을 수 있습니다. 인수 형식은 texture-object 형식에 따라 달라집니다. 자세한 내용은 정수 오프셋 적용을 참조하세요.

텍스처-개체 형식 매개 변수 유형
Texture1D, Texture1DArray int
Texture2D, Texture2DArray int2
Texture3D int3
TextureCube, TextureCubeArray 지원되지 않음

 

Clamp [in]

형식: float

샘플 LOD 값을 클램프하는 선택적 값. 예를 들어, 클램프 값으로 2.0f를 전달하면 개별 샘플이 2.0f 미만의 mip 수준에 액세스하지 않도록 합니다.

반환 값

형식: DXGI_FORMAT

DXGI_FORMAT에 나열된 형식화된 값 중 하나인 텍스처 형식입니다.

추가 정보

SampleGrad 메서드