org.lwjgl.vulkan.EXTAstcDecodeMode Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of lwjgl-vulkan Show documentation

A new generation graphics and compute API that provides high-efficiency, cross-platform access to modern GPUs used in a wide variety of devices from PCs and consoles to mobile phones and embedded platforms.

There is a newer version: 3.3.4

Show newest version

/*
 * Copyright LWJGL. All rights reserved.
 * License terms: https://www.lwjgl.org/license
 * MACHINE GENERATED FILE, DO NOT EDIT
 */
package org.lwjgl.vulkan;

/**
 * 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:
 * 
 * 
 * Decode to {@link VK10#VK_FORMAT_R16G16B16A16_SFLOAT FORMAT_R16G16B16A16_SFLOAT} precision: This is the default, and matches the required behavior in the core API.
 * Decode to {@link VK10#VK_FORMAT_R8G8B8A8_UNORM FORMAT_R8G8B8A8_UNORM} precision: This is provided as an option in LDR mode.
 * Decode to {@link VK10#VK_FORMAT_E5B9G9R9_UFLOAT_PACK32 FORMAT_E5B9G9R9_UFLOAT_PACK32} precision: This is provided as an option in both LDR and HDR mode. In this mode, negative values cannot be represented and are clamped to zero. The alpha component is ignored, and the results are as if alpha was 1.0. This decode mode is optional and support can be queried via the physical device properties.
 * 
 * 
 * Example
 * 
 * Create an image view that decodes to {@link VK10#VK_FORMAT_R8G8B8A8_UNORM FORMAT_R8G8B8A8_UNORM} precision:
 * 
 * 
 *     VkImageViewASTCDecodeModeEXT decodeMode =
 *     {
 *         VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT, // sType
 *         NULL, // pNext
 *         VK_FORMAT_R8G8B8A8_UNORM // decode mode
 *     };
 * 
 *     VkImageViewCreateInfo createInfo =
 *     {
 *         VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO, // sType
 *         &decodeMode, // pNext
 *         // flags, image, viewType set to application-desired values
 *         VK_FORMAT_ASTC_8x8_UNORM_BLOCK, // format
 *         // components, subresourceRange set to application-desired values
 *     };
 * 
 *     VkImageView imageView;
 *     VkResult result = vkCreateImageView(
 *         device,
 *         &createInfo,
 *         NULL,
 *         &imageView);
 * 
 * VK_EXT_astc_decode_mode
 * 
 * 
 * Name String
 * {@code VK_EXT_astc_decode_mode}
 * Extension Type
 * Device extension
 * Registered Extension Number
 * 68
 * Revision
 * 1
 * Extension and Version Dependencies
 * 
 * Requires Vulkan 1.0
 * Requires {@link KHRGetPhysicalDeviceProperties2 VK_KHR_get_physical_device_properties2}
 * 
 * Contact
 * 
 * Jan-Harald Fredriksen janharaldfredriksen-arm
 * 
 * 
 * 
 * Other Extension Metadata
 * 
 * 
 * Last Modified Date
 * 2018-08-07
 * Contributors
 * 
 * Jan-Harald Fredriksen, Arm
 * 
 * 
 */
public final class EXTAstcDecodeMode {

    /** The extension specification version. */
    public static final int VK_EXT_ASTC_DECODE_MODE_SPEC_VERSION = 1;

    /** The extension name. */
    public static final String VK_EXT_ASTC_DECODE_MODE_EXTENSION_NAME = "VK_EXT_astc_decode_mode";

    /**
     * Extends {@code VkStructureType}.
     * 
     * Enum values:
     * 
     * 
     * {@link #VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT}
     * {@link #VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ASTC_DECODE_FEATURES_EXT STRUCTURE_TYPE_PHYSICAL_DEVICE_ASTC_DECODE_FEATURES_EXT}
     * 
     */
    public static final int
        VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT          = 1000067000,
        VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ASTC_DECODE_FEATURES_EXT = 1000067001;

    private EXTAstcDecodeMode() {}

}