ppsspp/Common/Data/Format/DDSLoad.h
2023-03-14 11:55:21 +01:00

83 lines
3.3 KiB
C++

#pragma once
#include <cstdint>
// DDSPixelFormat.dwFlags bits
enum {
DDPF_ALPHAPIXELS = 1, // Texture contains alpha data; dwRGBAlphaBitMask contains valid data.
DDPF_ALPHA = 2, // Used in some older DDS files for alpha channel only uncompressed data(dwRGBBitCount contains the alpha channel bitcount; dwABitMask contains valid data)
DDPF_FOURCC = 4, // Texture contains compressed RGB data; dwFourCC contains valid data. 0x4
DDPF_RGB = 8, // Texture contains uncompressed RGB data; dwRGBBitCount and the RGB masks(dwRBitMask, dwGBitMask, dwBBitMask) contain valid data. 0x40
DDPF_YUV = 16, //Used in some older DDS files for YUV uncompressed data(dwRGBBitCount contains the YUV bit count; dwRBitMask contains the Y mask, dwGBitMask contains the U mask, dwBBitMask contains the V mask)
DDPF_LUMINANCE = 32, // Used in some older DDS files for single channel color uncompressed data (dwRGBBitCount contains the luminance channel bit count; dwRBitMask contains the channel mask). Can be combined with DDPF_ALPHAPIXELS for a two channel DDS file.
};
// dwCaps members
enum {
DDSCAPS_COMPLEX = 8,
DDSCAPS_MIPMAP = 0x400000,
DDSCAPS_TEXTURE = 0x1000, // Required
};
// Not using any D3D headers here, this is cross platform and minimal.
// Boiled down from the public documentation.
struct DDSPixelFormat {
uint32_t dwSize; // must be 32
uint32_t dwFlags;
uint32_t dwFourCC;
uint32_t dwRGBBitCount;
uint32_t dwRBitMask;
uint32_t dwGBitMask;
uint32_t dwBBitMask;
uint32_t dwABitMask;
};
struct DDSHeader {
uint32_t dwMagic; // Magic is not technically part of the header struct but convenient to have here when reading the files.
uint32_t dwSize; // must be 124
uint32_t dwFlags;
uint32_t dwHeight;
uint32_t dwWidth;
uint32_t dwPitchOrLinearSize; // The pitch or number of bytes per scan line in an uncompressed texture; the total number of bytes in the top level texture for a compressed texture
uint32_t dwDepth; // we'll always use 1 here
uint32_t dwMipMapCount;
uint32_t dwReserved1[11];
DDSPixelFormat ddspf;
uint32_t dwCaps;
uint32_t dwCaps2; // nothing we care about
uint32_t dwCaps3; // unused
uint32_t dwCaps4; // unused
uint32_t dwReserved2;
};
// DDS header extension to handle resource arrays, DXGI pixel formats that don't map to the legacy Microsoft DirectDraw pixel format structures, and additional metadata.
struct DDSHeaderDXT10 {
uint32_t dxgiFormat;
uint32_t resourceDimension; // 1d = 2, 2d = 3, 3d = 4. very intuitive
uint32_t miscFlag;
uint32_t arraySize; // we only support 1 here
uint32_t miscFlags2; // sets alpha interpretation, let's not bother
};
// Simple DDS parser, suitable for texture replacement packs.
// Doesn't actually load, only does some logic to fill out DDSLoadInfo so the caller can then
// do the actual load with a simple series of memcpys or whatever is appropriate.
struct DDSLoadInfo {
uint32_t bytesToCopy;
};
bool DetectDDSParams(const DDSHeader *header, DDSLoadInfo *info);
// We use the Basis library for the actual reading, but before we do, we pre-scan using this, similarly to the png trick.
struct KTXHeader {
uint8_t identifier[12];
uint32_t vkFormat;
uint32_t typeSize;
uint32_t pixelWidth;
uint32_t pixelHeight;
uint32_t pixelDepth;
uint32_t layerCount;
uint32_t faceCount;
uint32_t levelCount;
uint32_t supercompressionScheme;
};