Add dkImageFormatGetFlags (format introspection)

Author: fincs

include/deko3d.h

@@ -379,6 +379,10 @@ enum
 	DkImageFlags_UsagePresent   = 1U << 10, // Specifies that the image will be used with a DkSwapchain.
 	DkImageFlags_Usage2DEngine  = 1U << 11, // Specifies that the image will be used with the 2D Engine (e.g. for transfers between images)
 	DkImageFlags_UsageVideo     = 1U << 12, // Specifies that the image will be used with hardware video encoding/decoding engines
+
+	// Informational flags only (for dkImageFormatGetFlags)
+	DkImageFormatFlags_IsInt    = 1U << 16, // Specifies that the image format is pure integer
+	DkImageFormatFlags_IsDepth  = 1U << 17, // Specifies that the image format is for depth/stencil
 };
 
 typedef enum DkImageFormat
@@ -498,7 +502,7 @@ typedef enum DkImageFormat
 	DkImageFormat_BGR565_Unorm,
 	DkImageFormat_BGR5_Unorm,
 	DkImageFormat_BGR5A1_Unorm,
-	DkImageFormat_A5BGR5_Unorm,
+	DkImageFormat_A1BGR5_Unorm,
 	DkImageFormat_BGRX8_Unorm,
 	DkImageFormat_BGRA8_Unorm,
 	DkImageFormat_BGRX8_Unorm_sRGB,
@@ -1338,6 +1342,8 @@ void dkShaderInitialize(DkShader* obj, DkShaderMaker const* maker);
 bool dkShaderIsValid(DkShader const* obj);
 DkStage dkShaderGetStage(DkShader const* obj);
 
+uint32_t dkImageFormatGetFlags(DkImageFormat format);
+
 void dkImageLayoutInitialize(DkImageLayout* obj, DkImageLayoutMaker const* maker);
 uint64_t dkImageLayoutGetSize(DkImageLayout const* obj);
 uint32_t dkImageLayoutGetAlignment(DkImageLayout const* obj);

source/maxwell/image_formats.cpp

@@ -131,3 +131,41 @@ unsigned maxwell::pickImageMemoryKind(FormatTraits const& traits, uint32_t msMod
 	// Otherwise just return Generic
 	return NvKind_Generic_16BX2;
 }
+
+uint32_t dkImageFormatGetFlags(DkImageFormat format)
+{
+	if (format < 0 || format >= DkImageFormat_Count)
+		return 0;
+
+	FormatTraits const& traits = formatTraits[format];
+	uint32_t flags = 0;
+
+	if (traits.flags & FormatTraitFlags_CanRender)
+		flags |= DkImageFlags_UsageRender;
+	if (traits.flags & FormatTraitFlags_CanLoadStore)
+		flags |= DkImageFlags_UsageLoadStore;
+	if (traits.flags & FormatTraitFlags_CanUse2DEngine)
+		flags |= DkImageFlags_Usage2DEngine;
+
+	if (traits.flags & FormatTraitFlags_IsRawInt)
+		flags |= DkImageFormatFlags_IsInt;
+	if (traits.depthBits || traits.stencilBits)
+		flags |= DkImageFormatFlags_IsDepth;
+
+	switch (format)
+	{
+		default: break;
+
+		case DkImageFormat_RGBA8_Unorm:
+		case DkImageFormat_RGBX8_Unorm_sRGB:
+		case DkImageFormat_RGBA8_Unorm_sRGB:
+		case DkImageFormat_RGBX8_Unorm:
+		case DkImageFormat_BGR565_Unorm:
+		case DkImageFormat_BGRA8_Unorm:
+		case DkImageFormat_BGRA8_Unorm_sRGB:
+			flags |= DkImageFlags_UsagePresent;
+			break;
+	}
+
+	return flags;
+}