RDSamplerState

public RDSamplerState();

Создаёт описание sampler с nearest-фильтрами, ClampToEdge по трём осям, LodBias=MinLod=0, MaxLod≈1e20, анизотропией и сравнением false, AnisotropyMax=1, CompareOp=Always, BorderColor=FloatOpaqueBlack и нормализованными координатами. GPU sampler пока не существует.

public float AnisotropyMax { get; set; }

Запрошенная максимальная анизотропия, изначально 1. Учитывается при UseAnisotropy; число не является уровнем MSAA. Vulkan передаёт значение драйверу, поэтому не рассчитывайте на автоматическое ограничение произвольного числа. Общий для всех GPU максимум 16 не гарантируется.

public RenderingDevice.SamplerBorderColor BorderColor { get; set; }

Цвет вне текстуры при SamplerRepeatMode.ClampToBorder, изначально SamplerBorderColor.FloatOpaqueBlack. ClampToEdge использует крайний texel, а не этот цвет. Доступен набор enum-цветов, а не произвольный Color; цвет не записывается в текстуру.

public RenderingDevice.CompareOperator CompareOp { get; set; }

Операция comparison sampler, изначально CompareOperator.Always. Учитывается при EnableCompare=true и совместимой инструкции/текстуре. Не является depth test геометрии и не меняет сортировку draw calls.

public bool EnableCompare { get; set; }

Включение comparison sampling, изначально false. Для depth/shadow sampler результат определяется CompareOp и опорным значением инструкции сравнения. Флаг не создаёт shadow map, источник света или глубину и не является обычной цветовой фильтрацией.

public float LodBias { get; set; }

Добавка к вычислению mip LOD, изначально 0. В обычной выборке положительное смещение способствует выбору более грубого уровня, отрицательное — более детального. Не меняет mip-данные и не заменяет MinLod/MaxLod; результат зависит от инструкции выборки и доступных уровней.

public RenderingDevice.SamplerFilter MagFilter { get; set; }

Фильтр при увеличении texel на экране, изначально SamplerFilter.Nearest. Linear интерполирует соседние texel; Nearest выбирает ближайший. Не выбирает число mip-уровней. Для корректного сочетания фильтра и формата проверяйте SamplerIsFormatSupportedForFilter.

public float MaxLod { get; set; }

Верхняя граница выбираемого mip LOD, изначально около 1e20. Большое значение само не создаёт уровни. При MinLod=MaxLod=0 чтение ограничивается базовым уровнем, в том числе в выполненном примере textureLod. Это не величина смещения LOD.

public RenderingDevice.SamplerFilter MinFilter { get; set; }

Фильтр внутри выбранного mip-уровня при уменьшении изображения, изначально SamplerFilter.Nearest. Linear не заменяет MipFilter: последний определяет переход между уровнями. Поддержка фильтра зависит от формата текстуры.

public float MinLod { get; set; }

Нижняя граница выбираемого mip LOD, изначально 0 — базовый уровень. Это ограничение уровня, а не смещение LodBias. Повышение значения ограничивает доступ к более детальным уровням; исходная текстура должна содержать нужные уровни.

public RenderingDevice.SamplerFilter MipFilter { get; set; }

Способ выбора между mip-уровнями, изначально SamplerFilter.Nearest. Linear допускает смешивание соседних уровней. Нужны реально созданные и заполненные уровни текстуры; это поле не генерирует их и не меняет RDTextureFormat.Mipmaps.

public RenderingDevice.SamplerRepeatMode RepeatU { get; set; }

Режим адресации оси U, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Не изменяет сохранённые пиксели или UV геометрии.

public RenderingDevice.SamplerRepeatMode RepeatV { get; set; }

Режим адресации оси V, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Не изменяет сохранённые пиксели или UV геометрии.

public RenderingDevice.SamplerRepeatMode RepeatW { get; set; }

Режим адресации оси W, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Для 3D это третья пространственная координата; не индекс слоя массива.

public bool UnnormalizedUvw { get; set; }

Ненормализованные координаты выборки, изначально false. При false координаты задаются относительно размера текстуры; true использует texel-координаты. Это специальный режим с ограничениями backend и инструкции, а не свободная замена UV. Требования Vulkan приведены во введении.

public bool UseAnisotropy { get; set; }

Запрос анизотропной фильтрации, изначально false. В Vulkan включается только при поддержке samplerAnisotropy устройством; одного true недостаточно для гарантии результата. Обычно применяется к поверхностям под острым углом; оценка качества и стоимости требует целевой сцены.

public float GetAnisotropyMax();

Возвращает сохранённое AnisotropyMax этого описания, не запрос GPU. Запрошенная максимальная анизотропия, изначально 1. Учитывается при UseAnisotropy; число не является уровнем MSAA. Vulkan передаёт значение драйверу, поэтому не рассчитывайте на автоматическое ограничение произвольного числа. Общий для всех GPU максимум 16 не гарантируется.

public RenderingDevice.SamplerBorderColor GetBorderColor();

Возвращает сохранённое BorderColor этого описания, не запрос GPU. Цвет вне текстуры при SamplerRepeatMode.ClampToBorder, изначально SamplerBorderColor.FloatOpaqueBlack. ClampToEdge использует крайний texel, а не этот цвет. Доступен набор enum-цветов, а не произвольный Color; цвет не записывается в текстуру.

public RenderingDevice.CompareOperator GetCompareOp();

Возвращает сохранённое CompareOp этого описания, не запрос GPU. Операция comparison sampler, изначально CompareOperator.Always. Учитывается при EnableCompare=true и совместимой инструкции/текстуре. Не является depth test геометрии и не меняет сортировку draw calls.

public bool GetEnableCompare();

Возвращает сохранённое EnableCompare этого описания, не запрос GPU. Включение comparison sampling, изначально false. Для depth/shadow sampler результат определяется CompareOp и опорным значением инструкции сравнения. Флаг не создаёт shadow map, источник света или глубину и не является обычной цветовой фильтрацией.

public float GetLodBias();

Возвращает сохранённое LodBias этого описания, не запрос GPU. Добавка к вычислению mip LOD, изначально 0. В обычной выборке положительное смещение способствует выбору более грубого уровня, отрицательное — более детального. Не меняет mip-данные и не заменяет MinLod/MaxLod; результат зависит от инструкции выборки и доступных уровней.

public RenderingDevice.SamplerFilter GetMagFilter();

Возвращает сохранённое MagFilter этого описания, не запрос GPU. Фильтр при увеличении texel на экране, изначально SamplerFilter.Nearest. Linear интерполирует соседние texel; Nearest выбирает ближайший. Не выбирает число mip-уровней. Для корректного сочетания фильтра и формата проверяйте SamplerIsFormatSupportedForFilter.

public float GetMaxLod();

Возвращает сохранённое MaxLod этого описания, не запрос GPU. Верхняя граница выбираемого mip LOD, изначально около 1e20. Большое значение само не создаёт уровни. При MinLod=MaxLod=0 чтение ограничивается базовым уровнем, в том числе в выполненном примере textureLod. Это не величина смещения LOD.

public RenderingDevice.SamplerFilter GetMinFilter();

Возвращает сохранённое MinFilter этого описания, не запрос GPU. Фильтр внутри выбранного mip-уровня при уменьшении изображения, изначально SamplerFilter.Nearest. Linear не заменяет MipFilter: последний определяет переход между уровнями. Поддержка фильтра зависит от формата текстуры.

public float GetMinLod();

Возвращает сохранённое MinLod этого описания, не запрос GPU. Нижняя граница выбираемого mip LOD, изначально 0 — базовый уровень. Это ограничение уровня, а не смещение LodBias. Повышение значения ограничивает доступ к более детальным уровням; исходная текстура должна содержать нужные уровни.

public RenderingDevice.SamplerFilter GetMipFilter();

Возвращает сохранённое MipFilter этого описания, не запрос GPU. Способ выбора между mip-уровнями, изначально SamplerFilter.Nearest. Linear допускает смешивание соседних уровней. Нужны реально созданные и заполненные уровни текстуры; это поле не генерирует их и не меняет RDTextureFormat.Mipmaps.

public RenderingDevice.SamplerRepeatMode GetRepeatU();

Возвращает сохранённое RepeatU этого описания, не запрос GPU. Режим адресации оси U, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Не изменяет сохранённые пиксели или UV геометрии.

public RenderingDevice.SamplerRepeatMode GetRepeatV();

Возвращает сохранённое RepeatV этого описания, не запрос GPU. Режим адресации оси V, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Не изменяет сохранённые пиксели или UV геометрии.

public RenderingDevice.SamplerRepeatMode GetRepeatW();

Возвращает сохранённое RepeatW этого описания, не запрос GPU. Режим адресации оси W, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Для 3D это третья пространственная координата; не индекс слоя массива.

public bool GetUnnormalizedUvw();

Возвращает сохранённое UnnormalizedUvw этого описания, не запрос GPU. Ненормализованные координаты выборки, изначально false. При false координаты задаются относительно размера текстуры; true использует texel-координаты. Это специальный режим с ограничениями backend и инструкции, а не свободная замена UV. Требования Vulkan приведены во введении.

public bool GetUseAnisotropy();

Возвращает сохранённое UseAnisotropy этого описания, не запрос GPU. Запрос анизотропной фильтрации, изначально false. В Vulkan включается только при поддержке samplerAnisotropy устройством; одного true недостаточно для гарантии результата. Обычно применяется к поверхностям под острым углом; оценка качества и стоимости требует целевой сцены.

public void SetAnisotropyMax(float pMember);

Сохраняет AnisotropyMax в описании, не меняя уже созданные sampler. Запрошенная максимальная анизотропия, изначально 1. Учитывается при UseAnisotropy; число не является уровнем MSAA. Vulkan передаёт значение драйверу, поэтому не рассчитывайте на автоматическое ограничение произвольного числа. Общий для всех GPU максимум 16 не гарантируется.

public void SetBorderColor(RenderingDevice.SamplerBorderColor pMember);

Сохраняет BorderColor в описании, не меняя уже созданные sampler. Цвет вне текстуры при SamplerRepeatMode.ClampToBorder, изначально SamplerBorderColor.FloatOpaqueBlack. ClampToEdge использует крайний texel, а не этот цвет. Доступен набор enum-цветов, а не произвольный Color; цвет не записывается в текстуру.

public void SetCompareOp(RenderingDevice.CompareOperator pMember);

Сохраняет CompareOp в описании, не меняя уже созданные sampler. Операция comparison sampler, изначально CompareOperator.Always. Учитывается при EnableCompare=true и совместимой инструкции/текстуре. Не является depth test геометрии и не меняет сортировку draw calls.

public void SetEnableCompare(bool pMember);

Сохраняет EnableCompare в описании, не меняя уже созданные sampler. Включение comparison sampling, изначально false. Для depth/shadow sampler результат определяется CompareOp и опорным значением инструкции сравнения. Флаг не создаёт shadow map, источник света или глубину и не является обычной цветовой фильтрацией.

public void SetLodBias(float pMember);

Сохраняет LodBias в описании, не меняя уже созданные sampler. Добавка к вычислению mip LOD, изначально 0. В обычной выборке положительное смещение способствует выбору более грубого уровня, отрицательное — более детального. Не меняет mip-данные и не заменяет MinLod/MaxLod; результат зависит от инструкции выборки и доступных уровней.

public void SetMagFilter(RenderingDevice.SamplerFilter pMember);

Сохраняет MagFilter в описании, не меняя уже созданные sampler. Фильтр при увеличении texel на экране, изначально SamplerFilter.Nearest. Linear интерполирует соседние texel; Nearest выбирает ближайший. Не выбирает число mip-уровней. Для корректного сочетания фильтра и формата проверяйте SamplerIsFormatSupportedForFilter.

public void SetMaxLod(float pMember);

Сохраняет MaxLod в описании, не меняя уже созданные sampler. Верхняя граница выбираемого mip LOD, изначально около 1e20. Большое значение само не создаёт уровни. При MinLod=MaxLod=0 чтение ограничивается базовым уровнем, в том числе в выполненном примере textureLod. Это не величина смещения LOD.

public void SetMinFilter(RenderingDevice.SamplerFilter pMember);

Сохраняет MinFilter в описании, не меняя уже созданные sampler. Фильтр внутри выбранного mip-уровня при уменьшении изображения, изначально SamplerFilter.Nearest. Linear не заменяет MipFilter: последний определяет переход между уровнями. Поддержка фильтра зависит от формата текстуры.

public void SetMinLod(float pMember);

Сохраняет MinLod в описании, не меняя уже созданные sampler. Нижняя граница выбираемого mip LOD, изначально 0 — базовый уровень. Это ограничение уровня, а не смещение LodBias. Повышение значения ограничивает доступ к более детальным уровням; исходная текстура должна содержать нужные уровни.

public void SetMipFilter(RenderingDevice.SamplerFilter pMember);

Сохраняет MipFilter в описании, не меняя уже созданные sampler. Способ выбора между mip-уровнями, изначально SamplerFilter.Nearest. Linear допускает смешивание соседних уровней. Нужны реально созданные и заполненные уровни текстуры; это поле не генерирует их и не меняет RDTextureFormat.Mipmaps.

public void SetRepeatU(RenderingDevice.SamplerRepeatMode pMember);

Сохраняет RepeatU в описании, не меняя уже созданные sampler. Режим адресации оси U, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Не изменяет сохранённые пиксели или UV геометрии.

public void SetRepeatV(RenderingDevice.SamplerRepeatMode pMember);

Сохраняет RepeatV в описании, не меняя уже созданные sampler. Режим адресации оси V, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Не изменяет сохранённые пиксели или UV геометрии.

public void SetRepeatW(RenderingDevice.SamplerRepeatMode pMember);

Сохраняет RepeatW в описании, не меняя уже созданные sampler. Режим адресации оси W, изначально SamplerRepeatMode.ClampToEdge. Repeat повторяет текстуру, MirroredRepeat чередует отражение, ClampToEdge берёт крайний texel, ClampToBorder использует BorderColor. Для 3D это третья пространственная координата; не индекс слоя массива.

public void SetUnnormalizedUvw(bool pMember);

Сохраняет UnnormalizedUvw в описании, не меняя уже созданные sampler. Ненормализованные координаты выборки, изначально false. При false координаты задаются относительно размера текстуры; true использует texel-координаты. Это специальный режим с ограничениями backend и инструкции, а не свободная замена UV. Требования Vulkan приведены во введении.

public void SetUseAnisotropy(bool pMember);

Сохраняет UseAnisotropy в описании, не меняя уже созданные sampler. Запрос анизотропной фильтрации, изначально false. В Vulkan включается только при поддержке samplerAnisotropy устройством; одного true недостаточно для гарантии результата. Обычно применяется к поверхностям под острым углом; оценка качества и стоимости требует целевой сцены.