SampleGrad::SampleGrad(S,float,float,float,int,float,uint) function for Texture2D
Samples a Texture2D, using a gradient to influence the way the sample location is calculated, with an optional value to clamp sample level-of-detail (LOD) values to. Returns status about the operation.
Syntax
DXGI_FORMAT SampleGrad(
in SamplerState S,
in float Location,
in float DDX,
in float DDY,
in int Offset,
in float Clamp,
out uint Status
);
Parameters
-
S [in]
-
Type: SamplerState
A Sampler state. This is an object declared in an effect file that contains state assignments.
-
Location [in]
-
Type: float
The texture coordinates. The argument type is dependent on the texture-object type.
Texture-Object Type Parameter Type Texture1D float Texture1DArray, Texture2D float2 Texture2DArray, Texture3D, TextureCube float3 TextureCubeArray float4 -
DDX [in]
-
Type: float
The rate of change of the surface geometry in the x direction. The argument type is dependent on the texture-object type.
Texture-Object Type Parameter Type Texture1D, Texture1DArray float Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray not supported -
DDY [in]
-
Type: float
The rate of change of the surface geometry in the y direction. The argument type is dependent on the texture-object type.
Texture-Object Type Parameter Type Texture1D, Texture1DArray float Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray not supported -
Offset [in]
-
Type: int
An optional texture coordinate offset, which can be used for any texture-object type; the offset is applied to the location before sampling. Use an offset only at an integer miplevel; otherwise, you may get results that do not translate well to hardware. The argument type is dependent on the texture-object type. For more info, see Applying Integer Offsets.
Texture-Object Type Parameter Type Texture1D, Texture1DArray int Texture2D, Texture2DArray int2 Texture3D int3 TextureCube, TextureCubeArray not supported -
Clamp [in]
-
Type: float
An optional value to clamp sample LOD values to. For example, if you pass 2.0f for the clamp value, you ensure that no individual sample accesses a mip level less than 2.0f.
-
Status [out]
-
Type: uint
The status of the operation. You can't access the status directly; instead, pass the status to the CheckAccessFullyMapped intrinsic function. CheckAccessFullyMapped returns TRUE if all values from the corresponding Sample, Gather, or Load operation accessed mapped tiles in a tiled resource. If any values were taken from an unmapped tile, CheckAccessFullyMapped returns FALSE.
Return value
Type: DXGI_FORMAT
The texture format, which is one of the typed values listed in DXGI_FORMAT.
See also