Поделиться через

Функция SampleGrad::SampleGrad(S,float,float,float,int,float,uint) для Texture2D

  • Статья

Примеры Texture2D с использованием градиента для влияния на способ вычисления расположения выборки с необязательным значением для закрепления значений уровня детализации (LOD). Возвращает состояние операции.

Синтаксис

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

Параметры

S [in]

Тип: SamplerState

Состояние выборки. Это объект, объявленный в файле эффекта, который содержит назначения состояний.

Расположение [in]

Тип: float

Координаты текстуры. Тип аргумента зависит от типа объекта текстуры.

Тип Texture-Object Тип параметра
Texture1D FLOAT
Texture1DArray, Texture2D float2
Texture2DArray, Texture3D, TextureCube float3
TextureCubeArray float4

 

DDX [вход]

Тип: 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 не поддерживается

 

Смещение [в]

Тип: int

Необязательное смещение координат текстуры, которое можно использовать для любого типа объекта текстуры; смещение применяется к расположению перед выборкой. Использовать смещение только при целочисленном miplevel; В противном случае вы можете получить результаты, которые не будут хорошо преобразованы в оборудование. Тип аргумента зависит от типа объекта текстуры. Дополнительные сведения см. в разделе Применение целочисленных смещения.

Тип Texture-Object Тип параметра
Texture1D, Texture1DArray INT
Texture2D, Texture2DArray int2
Texture3D int3
TextureCube, TextureCubeArray не поддерживается

 

Зажим [in]

Тип: float

Необязательное значение для закрепления примеров значений LOD. Например, если передать значение 2,0f для значения зажима, убедитесь, что ни один отдельный образец не обращается к уровню MIP меньше 2,0f.

Состояние [out]

Тип: uint

Состояние операции. Вы не можете получить доступ к состоянию напрямую; Вместо этого передайте состояние встроенной функции CheckAccessFullyMapped . CheckAccessFullyMapped возвращает значение TRUE , если все значения из соответствующей операции Sample, Gather или Load обращались к сопоставленным плиткам в ресурсе с плитками. Если какие-либо значения были взяты из несопоставленной плитки, Функция CheckAccessFullyMapped возвращает значение FALSE.

Возвращаемое значение

Тип: DXGI_FORMAT

Формат текстуры, который является одним из типизированных значений, перечисленных в DXGI_FORMAT.

См. также раздел

Методы SampleGrad