Package org.lwjgl.vulkan

Class KHRSamplerMirrorClampToEdge

java.lang.Object
org.lwjgl.vulkan.KHRSamplerMirrorClampToEdge
public final class KHRSamplerMirrorClampToEdge extends Object
VK_KHR_sampler_mirror_clamp_to_edge extends the set of sampler address modes to include an additional mode (SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE) that effectively uses a texture map twice as large as the original image in which the additional half of the new image is a mirror image of the original image.

This new mode relaxes the need to generate images whose opposite edges match by using the original image to generate a matching “mirror image”. This mode allows the texture to be mirrored only once in the negative s, t, and r directions.

Promotion to Vulkan 1.2

All functionality in this extension is included in core Vulkan 1.2. However, if Vulkan 1.2 is supported and this extension is not, the VkSamplerAddressMode SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE is optional. Since the original extension did not use an author suffix on the enum SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE, it is used by both core and extension implementations.

Example

Creating a sampler with the new address mode in each dimension


     VkSamplerCreateInfo createInfo =
     {
         .sType = VK_STRUCTURE_TYPE_SAMPLER_CREATE_INFO,
         // Other members set to application-desired values
     };
 
     createInfo.addressModeU = VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE;
     createInfo.addressModeV = VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE;
     createInfo.addressModeW = VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE;
 
     VkSampler sampler;
     VkResult result = vkCreateSampler(
         device,
         &createInfo,
         &sampler);
Name String
VK_KHR_sampler_mirror_clamp_to_edge
Extension Type
Device extension
Registered Extension Number
15
Revision
3
Deprecation State
Contact
Other Extension Metadata
Last Modified Date
2019-08-17
Contributors
  • Tobias Hector, Imagination Technologies
  • Jon Leech, Khronos