Texture2DArray에 대한 SampleCmp::SampleCmp(S,float,float,int,float,uint) 함수
샘플을 거부하는 비교 값과 샘플 LOD(세부 수준) 값을 클램프하는 선택적 값을 사용하여 텍스처를 샘플링합니다. 작업에 대한 상태를 반환합니다.
구문
DXGI_FORMAT SampleCmp(
in SamplerState S,
in float Location,
in float CompareValue,
in int Offset,
in float Clamp,
out uint Status
);
매개 변수
-
S [in]
-
형식: SamplerState
샘플러 상태 상태 할당을 포함하는 효과 파일에 선언된 개체입니다.
-
Location [in]
-
형식: float
질감 좌표입니다. 인수 형식은 texture-object 형식에 따라 달라집니다.
텍스처-개체 형식 매개 변수 유형 Texture1D float Texture1DArray, Texture2D float2 Texture2DArray, Texture3D, TextureCube float3 TextureCubeArray float4 -
CompareValue [in]
-
형식: float
비교 값으로 사용할 부동 소수점 값입니다.
-
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 수준에 액세스하지 않도록 합니다.
-
Status [out]
-
형식: uint
작업의 상태입니다. 상태에 직접 액세스할 수 없습니다. 대신 CheckAccessFullyMapped 내장 함수에 상태를 전달합니다. CheckAccessFullyMapped는 해당 Sample, Gather 또는 Load 작업의 모든 값이 타일식 리소스의 매핑된 타일에 액세스한 경우 TRUE를 반환합니다. 매핑되지 않은 타일에서 값을 가져온 경우 CheckAccessFullyMapped는 FALSE를 반환합니다.
반환 값
형식: DXGI_FORMAT
DXGI_FORMAT에 나열된 형식화된 값 중 하나인 텍스처 형식입니다.
추가 정보