Texture2DArray::Sample(S,float,int,float,uint) 함수

  • 아티클

샘플 LOD(세부 수준) 값을 클램프할 선택적 값으로 텍스처를 샘플링하고 작업 상태를 반환합니다.

구문

DXGI_FORMAT Sample(
  in  SamplerState S,
  in  float        Location,
  in  int          Offset,
  in  float        Clamp,
  out uint         Status
);

매개 변수

S [in]

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

Location [in]

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

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

 

Offset [in]

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

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

 

Clamp [in]

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

Status [out]

작업의 상태입니다. 상태에 직접 액세스할 수 없습니다. 대신 CheckAccessFullyMapped 내장 함수에 상태를 전달합니다. CheckAccessFullyMapped는 해당 Sample, Gather 또는 Load 작업의 모든 값이 타일식 리소스의 매핑된 타일에 액세스한 경우 TRUE를 반환합니다. 매핑되지 않은 타일에서 값을 가져온 경우 CheckAccessFullyMapped는 FALSE를 반환합니다.

반환 값

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

추가 정보

Sample 메서드