Top Description Fields Constructors Methods
org.lwjgl.vulkan

public final Class EXTAstcDecodeMode

extends Object
Class Inheritance

The existing specification requires that low dynamic range (LDR) ASTC textures are decompressed to FP16 values per component. In many cases, decompressing LDR textures to a lower precision intermediate result gives acceptable image quality. Source material for LDR textures is typically authored as 8-bit UNORM values, so decoding to FP16 values adds little value. On the other hand, reducing precision of the decoded result reduces the size of the decompressed data, potentially improving texture cache performance and saving power.

The goal of this extension is to enable this efficiency gain on existing ASTC texture data. This is achieved by giving the application the ability to select the intermediate decoding precision.

Three decoding options are provided:

Example

Create an image view that decodes to FORMAT_R8G8B8A8_UNORM precision:


    VkImageViewASTCDecodeModeEXT decodeMode =
    {
        .sType = VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT,
        .pNext = NULL,
        .decodeMode = VK_FORMAT_R8G8B8A8_UNORM
    };

    VkImageViewCreateInfo createInfo =
    {
        .sType = VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO,
        .pNext = &decodeMode,
        // flags, image, viewType set to application-desired values
        .format = VK_FORMAT_ASTC_8x8_UNORM_BLOCK,
        // components, subresourceRange set to application-desired values
    };

    VkImageView imageView;
    VkResult result = vkCreateImageView(
        device,
        &createInfo,
        NULL,
        &imageView);
VK_EXT_astc_decode_mode
Name String
VK_EXT_astc_decode_mode
Extension Type
Device extension
Registered Extension Number
68
Revision
1
Extension and Version Dependencies
VK_KHR_get_physical_device_properties2 or Version 1.1
Contact
Other Extension Metadata
Last Modified Date
2018-08-07
Contributors
  • Jan-Harald Fredriksen, Arm

Field Summary

Modifier and TypeField and Description
public static final String
public static final int
VK_EXT_ASTC_DECODE_MODE_SPEC_VERSION

The extension specification version.

public static final int
public static final int

Constructor Summary

AccessConstructor and Description
private

Method Summary

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

VK_EXT_ASTC_DECODE_MODE_EXTENSION_NAMEback to summary
public static final String VK_EXT_ASTC_DECODE_MODE_EXTENSION_NAME

The extension name.

VK_EXT_ASTC_DECODE_MODE_SPEC_VERSIONback to summary
public static final int VK_EXT_ASTC_DECODE_MODE_SPEC_VERSION

The extension specification version.

VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXTback to summary
public static final int VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ASTC_DECODE_FEATURES_EXTback to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ASTC_DECODE_FEATURES_EXT

Extends VkStructureType.

Enum values:

Constructor Detail

EXTAstcDecodeModeback to summary
private EXTAstcDecodeMode()