Texture2DArray에 대한 SampleLevel::SampleLevel(S,float,float,int,uint) 함수

  • 아티클

지정된 Mipmap 수준에서 텍스처를 샘플하고 작업에 대한 상태를 반환합니다.

구문

DXGI_FORMAT SampleLevel(
  in  SamplerState S,
  in  float        Location,
  in  float        LOD,
  in  int          Offset,
  out uint         Status
);

매개 변수

S [in]

형식: SamplerState

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

Location [in]

형식: float

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

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

 

LOD [in]

형식: float

[in] Mipmap 수준을 지정하는 숫자입니다. 값이 ≤ 0이면 Mipmap 수준 0(가장 큰 맵)이 사용됩니다. 소수 값(제공된 경우)은 두 mipmap 수준 사이를 보간하는 데 사용됩니다.

Offset [in]

형식: int

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

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

 

Status [out]

형식: uint

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

반환 값

형식: DXGI_FORMAT

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

추가 정보

SampleLevel 메서드

Texture2DArray