C++ API Reference
cgFx/nv_dds.h
//
// Copyright (C) 2002-2003 NVIDIA
//
// File: nv_dds.h
//-
// ==========================================================================
// Copyright 2020 Autodesk, Inc. All rights reserved.
//
// Use of this software is subject to the terms of the Autodesk
// license agreement provided at the time of installation or download,
// or which otherwise accompanies this software in either electronic
// or hard copy form.
// ==========================================================================
//+
#ifndef __NV_DDS_H__
#define __NV_DDS_H__
#ifdef WIN32
# include <windows.h>
#endif
#include <string>
#include <vector>
#include <assert.h>
#if defined(_WIN32) || defined(__linux__)
#include <GL/gl.h>
#if defined(_WIN32)
#include <QtGui/qopenglext.h>
#endif
#else
#include <OpenGL/gl.h>
#endif
using namespace std;
namespace nv_dds
{
const unsigned int DDS_FOURCC = 0x00000004;
const unsigned int DDS_RGB = 0x00000040;
const unsigned int DDS_RGBA = 0x00000041;
const unsigned int DDS_DEPTH = 0x00800000;
const unsigned int DDS_COMPLEX = 0x00000008;
const unsigned int DDS_CUBEMAP = 0x00000200;
const unsigned int DDS_VOLUME = 0x00200000;
const unsigned int FOURCC_DXT1 = 0x31545844; //(MAKEFOURCC('D','X','T','1'))
const unsigned int FOURCC_DXT3 = 0x33545844; //(MAKEFOURCC('D','X','T','3'))
const unsigned int FOURCC_DXT5 = 0x35545844; //(MAKEFOURCC('D','X','T','5'))
struct DDS_PIXELFORMAT
{
unsigned int dwSize;
unsigned int dwFlags;
unsigned int dwFourCC;
unsigned int dwRGBBitCount;
unsigned int dwRBitMask;
unsigned int dwGBitMask;
unsigned int dwBBitMask;
unsigned int dwABitMask;
};
struct DXTColBlock
{
unsigned short col0;
unsigned short col1;
unsigned char row[4];
};
struct DXT3AlphaBlock
{
unsigned short row[4];
};
struct DXT5AlphaBlock
{
unsigned char alpha0;
unsigned char alpha1;
unsigned char row[6];
};
struct DDS_HEADER
{
unsigned int dwSize;
unsigned int dwFlags;
unsigned int dwHeight;
unsigned int dwWidth;
unsigned int dwPitchOrLinearSize;
unsigned int dwDepth;
unsigned int dwMipMapCount;
unsigned int dwReserved1[11];
DDS_PIXELFORMAT ddspf;
unsigned int dwCaps1;
unsigned int dwCaps2;
unsigned int dwReserved2[3];
};
class CSurface
{
friend class CTexture;
friend class CDDSImage;
public:
CSurface();
CSurface(int w, int h, int d, int imgsize);
CSurface(const CSurface &copy);
CSurface &operator= (const CSurface &rhs);
virtual ~CSurface();
operator char*();
void create(int w, int h, int d, int imgsize);
void clear();
inline int get_width() { return width; }
inline int get_height() { return height; }
inline int get_depth() { return depth; }
inline int get_size() { return size; }
protected:
int width;
int height;
int depth;
int size;
char *pixels;
};
class CTexture : public CSurface
{
friend class CDDSImage;
public:
CTexture();
CTexture(int w, int h, int d, int imgSize);
CTexture(const CTexture &copy);
CTexture &operator= (const CTexture &rhs);
~CTexture() override;
inline CSurface &get_mipmap(int index)
{
assert(index < (int)mipmaps.size());
return mipmaps[index];
}
inline int get_num_mipmaps() { return (int)mipmaps.size(); }
protected:
vector<CSurface> mipmaps;
};
class CDDSImage
{
public:
CDDSImage();
~CDDSImage();
bool load(string filename, bool flipImage = true);
void clear();
operator char*();
CTexture &operator[](int index);
bool upload_texture1D();
bool upload_texture2D(int imageIndex = 0, GLenum target = GL_TEXTURE_2D);
#ifdef GL_NV_texture_rectangle
bool upload_textureRectangle();
#endif
bool upload_texture3D();
bool upload_textureCubemap();
inline int get_width()
{
assert(valid);
assert(images.size() > 0);
return images[0].get_width();
}
inline int get_height()
{
assert(valid);
assert(images.size() > 0);
return images[0].get_height();
}
inline int get_depth()
{
assert(valid);
assert(images.size() > 0);
return images[0].get_depth();
}
inline int get_size()
{
assert(valid);
assert(images.size() > 0);
return images[0].get_size();
}
inline int get_num_mipmaps()
{
assert(valid);
assert(images.size() > 0);
return images[0].get_num_mipmaps();
}
inline CSurface &get_mipmap(int index)
{
assert(valid);
assert(images.size() > 0);
assert(index < images[0].get_num_mipmaps());
return images[0].get_mipmap(index);
}
inline int get_components() { return components; }
inline int get_format() { return format; }
inline bool is_compressed() { return compressed; }
inline bool is_cubemap() { return cubemap; }
inline bool is_volume() { return volume; }
inline bool is_valid() { return valid; }
private:
int clamp_size(int size);
int get_line_width(int width, int bpp);
int size_dxtc(int width, int height);
int size_rgb(int width, int height);
inline void swap_endian(void *val);
void align_memory(CTexture *surface);
void flip(char *image, int width, int height, int depth, int size);
void swap(void *byte1, void *byte2, int size);
void flip_blocks_dxtc1(DXTColBlock *line, int numBlocks);
void flip_blocks_dxtc3(DXTColBlock *line, int numBlocks);
void flip_blocks_dxtc5(DXTColBlock *line, int numBlocks);
void flip_dxt5_alpha(DXT5AlphaBlock *block);
int format;
int components;
bool compressed;
bool cubemap;
bool volume;
bool valid;
vector<CTexture> images;
#if defined(WIN32) || defined(__linux__)
static PFNGLTEXIMAGE3DEXTPROC glTexImage3D;
static PFNGLCOMPRESSEDTEXIMAGE1DARBPROC glCompressedTexImage1DARB;
static PFNGLCOMPRESSEDTEXIMAGE2DARBPROC glCompressedTexImage2DARB;
static PFNGLCOMPRESSEDTEXIMAGE3DARBPROC glCompressedTexImage3DARB;
#endif
};
}
#endif