Package org.lwjgl.vulkan

Class KHRSamplerMirrorClampToEdge

  • public final class KHRSamplerMirrorClampToEdge
extends java.lang.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 =
     {
         VK_STRUCTURE_TYPE_SAMPLER_CREATE_INFO // sType
         // 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);
    VK_KHR_sampler_mirror_clamp_to_edge
    Name String
    VK_KHR_sampler_mirror_clamp_to_edge
    Extension Type
    Device extension
    Registered Extension Number
    15
    Revision
    3
    Extension and Version Dependencies
    • Requires Vulkan 1.0
    Deprecation state
    Contact
    Other Extension Metadata
    Last Modified Date
    2019-08-17
    Interactions and External Dependencies
    • Promoted to Vulkan 1.2 Core
    Contributors
    • Tobias Hector, Imagination Technologies
    • Jon Leech, Khronos