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


Функция Texture3D::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]

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

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

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

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

 

Смещение [в]

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

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

 

Зажим [in]

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

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

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

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

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

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

Примеры методов

Texture3D