doom3-bfg/neo/renderer/DXT/DXTCodec.h

/*
===========================================================================

Doom 3 BFG Edition GPL Source Code
Copyright (C) 1993-2012 id Software LLC, a ZeniMax Media company.

This file is part of the Doom 3 BFG Edition GPL Source Code ("Doom 3 BFG Edition Source Code").

Doom 3 BFG Edition Source Code is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Doom 3 BFG Edition Source Code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Doom 3 BFG Edition Source Code.  If not, see <http://www.gnu.org/licenses/>.

In addition, the Doom 3 BFG Edition Source Code is also subject to certain additional terms. You should have received a copy of these additional terms immediately following the terms and conditions of the GNU General Public License which accompanied the Doom 3 BFG Edition Source Code.  If not, please request a copy in writing from id Software at the address below.

If you have questions concerning this license or the applicable additional terms, you may contact in writing id Software LLC, c/o ZeniMax Media Inc., Suite 120, Rockville, Maryland 20850 USA.

===========================================================================
*/
#ifndef __DXTCODEC_H__
#define __DXTCODEC_H__

/*
================================================================================================
Contains the DxtEncoder and DxtDecoder declarations.
================================================================================================
*/

/*
================================================
idDxtEncoder encodes Images in a number of DXT formats. Raw input Images are assumed to be in
4-byte RGBA format. Raw input NormalMaps are assumed to be in 4-byte tangent-space NxNyNz format.

The supported formats are:
	* DXT1 = colors in 4x4 block approximated by equidistant points on a line through 3D space
	* DXT2 = DXT3 + colors are pre-multiplied by alpha
	* DXT3 = DXT1 + explicit 4-bit alpha
	* DXT4 = DXT5 + colors are pre-multiplied by alpha
	* DXT5 = DXT1 + alpha values in 4x4 block approximated by equidistant points on line through alpha space
	* CTX1 = colors in a 4x4 block approximated by equidistant points on a line through 2D space
	* DXN1 = one DXT5 alpha block (aka DXT5A, or ATI1N)
	* DXN2 = two DXT5 alpha blocks (aka 3Dc, or ATI2N)
================================================
*/
class idDxtEncoder
{
public:
	idDxtEncoder()
	{
		srcPadding = dstPadding = 0;
	}
	~idDxtEncoder() {}
	
	void	SetSrcPadding( int pad )
	{
		srcPadding = pad;
	}
	void	SetDstPadding( int pad )
	{
		dstPadding = pad;
	}
	
	// high quality DXT1 compression (no alpha), uses exhaustive search to find a line through color space and is very slow
	void	CompressImageDXT1HQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast DXT1 compression (no alpha), for real-time use at the cost of a little quality
	void	CompressImageDXT1Fast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXT1Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXT1Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height );
	
	// high quality DXT1 compression (with alpha), uses exhaustive search to find a line through color space and is very slow
	void	CompressImageDXT1AlphaHQ( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// fast DXT1 compression (with alpha), for real-time use at the cost of a little quality
	void	CompressImageDXT1AlphaFast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXT1AlphaFast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXT1AlphaFast_SSE2( const byte* inBuf, byte* outBuf, int width, int height );
	
	// high quality DXT5 compression, uses exhaustive search to find a line through color space and is generally
	// too slow to actually use for anything
	void	CompressImageDXT5HQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast DXT5 compression for real-time use at the cost of a little quality
	void	CompressImageDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXT5Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXT5Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height );
	
	// high quality CTX1 compression, uses exhaustive search to find a line through 2D space and is very slow
	void	CompressImageCTX1HQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast CTX1 compression for real-time use
	void	CompressImageCTX1Fast( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	void	CompressImageCTX1Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	void	CompressImageCTX1Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// high quality DXN1 (aka DXT5A or ATI1N) compression, uses exhaustive search to find a line through color space and is very slow
	void	CompressImageDXN1HQ( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// fast single channel compression into, DXN1 (aka DXT5A or ATI1N) format, for real-time use
	void	CompressImageDXN1Fast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXN1Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressImageDXN1Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// high quality YCoCg DXT5 compression, uses exhaustive search to find a line through color space and is very slow
	void	CompressYCoCgDXT5HQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast YCoCg DXT5 compression for real-time use (the input is expected to be in CoCg_Y format)
	void	CompressYCoCgDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressYCoCgDXT5Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressYCoCgDXT5Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast YCoCg-Alpha DXT5 compression for real-time use (the input is expected to be in CoCgAY format)
	void	CompressYCoCgAlphaDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height );
	
	// high quality YCoCg CTX1 + DXT5A compression, uses exhaustive search to find a line through 2D space and is very slow
	void	CompressYCoCgCTX1DXT5AHQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast YCoCg CTX1 + DXT5A compression for real-time use (the input is expected to be in CoCg_Y format)
	void	CompressYCoCgCTX1DXT5AFast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressYCoCgCTX1DXT5AFast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressYCoCgCTX1DXT5AFast_SSE2( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// high quality tangent space NxNyNz normal map compression into DXT1 format (Nz is not used)
	void	CompressNormalMapDXT1HQ( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressNormalMapDXT1RenormalizeHQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast tangent space NxNyNz normal map compression into DXT1 format (Nz is not used), for real-time use
	void	CompressNormalMapDXT1Fast( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	void	CompressNormalMapDXT1Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	void	CompressNormalMapDXT1Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// high quality tangent space _Ny_Nx normal map compression into DXT5 format
	void	CompressNormalMapDXT5HQ( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressNormalMapDXT5RenormalizeHQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast tangent space _Ny_Nx normal map compression into DXT5 format, for real-time use
	void	CompressNormalMapDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressNormalMapDXT5Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressNormalMapDXT5Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height );
	
	// high quality tangent space NxNy_ normal map compression into DXN2 (3Dc, ATI2N) format
	void	CompressNormalMapDXN2HQ( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast tangent space NxNy_ normal map compression into DXN2 (3Dc, ATI2N) format, for real-time use
	void	CompressNormalMapDXN2Fast( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressNormalMapDXN2Fast_Generic( const byte* inBuf, byte* outBuf, int width, int height );
	void	CompressNormalMapDXN2Fast_SSE2( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// fast single channel conversion from DXN1 (aka DXT5A or ATI1N) to DXT1, reasonably fast (also works in-place)
	void	ConvertImageDXN1_DXT1( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast single channel conversion from DXT1 to DXN1 (aka DXT5A or ATI1N), reasonably fast (also works in-place)
	void	ConvertImageDXT1_DXN1( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// fast tangent space NxNyNz normal map conversion from DXN (3Dc, ATI2N) to DXT5, reasonably fast (also works in-place)
	void	ConvertNormalMapDXN2_DXT5( const byte* inBuf, byte* outBuf, int width, int height );
	
	// fast tangent space NxNyNz normal map conversion DXT5 to DXN (3Dc, ATI2N), reasonably fast (also works in-place)
	void	ConvertNormalMapDXT5_DXN2( const byte* inBuf, byte* outBuf, int width, int height );
	
private:
	int					width;
	int					height;
	byte* 				outData;
	int					srcPadding;
	int					dstPadding;
	
	void				EmitByte( byte b );
	void				EmitUShort( unsigned short s );
	void				EmitUInt( unsigned int i );
	unsigned int		AlphaDistance( const byte a1, const byte a2 ) const;
	unsigned int		ColorDistance( const byte* c1, const byte* c2 ) const;
	unsigned int		ColorDistanceWeighted( const byte* c1, const byte* c2 ) const;
	unsigned int		CTX1Distance( const byte* c1, const byte* c2 ) const;
	unsigned short		ColorTo565( const byte* color ) const;
	unsigned short		ColorTo565( byte r, byte g, byte b ) const;
	void				ColorFrom565( unsigned short c565, byte* color ) const;
	byte				GreenFrom565( unsigned short c565 ) const;
	
	void				NV4XHardwareBugFix( byte* minColor, byte* maxColor ) const;
	
	bool				HasConstantValuePer4x4Block( const byte* inBuf, int width, int height, int channel ) const;
	void				WriteTinyColorDXT1( const byte* inBuf, int width, int height );
	void				WriteTinyColorDXT5( const byte* inBuf, int width, int height );
	void				WriteTinyColorCTX1DXT5A( const byte* inBuf, int width, int height );
	void				WriteTinyNormalMapDXT5( const byte* NxNy, int width, int height );
	void				WriteTinyNormalMapDXN( const byte* NxNy, int width, int height );
	void				WriteTinyDXT5A( const byte* NxNy, int width, int height );
	
	void				GetMinMaxColorsMaxDist( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				GetMinMaxColorsLuminance( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	int					GetSquareAlphaError( const byte* colorBlock, const int alphaOffset, const byte minAlpha, const byte maxAlpha, int lastError ) const;
	int					GetMinMaxAlphaHQ( const byte* colorBlock, const int alphaOffset, byte* minColor, byte* maxColor ) const;
	int					GetSquareColorsError( const byte* colorBlock, const unsigned short color0, const unsigned short color1, int lastError ) const;
	int					GetMinMaxColorsHQ( const byte* colorBlock, byte* minColor, byte* maxColor, bool noBlack ) const;
	int					GetSquareCTX1Error( const byte* colorBlock, const byte* color0, const byte* color1, int lastError ) const;
	int					GetMinMaxCTX1HQ( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	int					GetSquareNormalYError( const byte* colorBlock, const unsigned short color0, const unsigned short color1, int lastError, int scale ) const;
	int					GetMinMaxNormalYHQ( const byte* colorBlock, byte* minColor, byte* maxColor, bool noBlack, int scale ) const;
	int					GetSquareNormalsDXT1Error( const int* colorBlock, const unsigned short color0, const unsigned short color1, int lastError, unsigned int& colorIndices ) const;
	int					GetMinMaxNormalsDXT1HQ( const byte* colorBlock, byte* minColor, byte* maxColor, unsigned int& colorIndices, bool noBlack ) const;
	int					GetSquareNormalsDXT5Error( const int* normalBlock, const byte* minNormal, const byte* maxNormal, int lastError, unsigned int& colorIndices, byte* alphaIndices ) const;
	int					GetMinMaxNormalsDXT5HQ( const byte* normalBlock, byte* minColor, byte* maxColor, unsigned int& colorIndices, byte* alphaIndices ) const;
	int					GetMinMaxNormalsDXT5HQFast( const byte* normalBlock, byte* minColor, byte* maxColor, unsigned int& colorIndices, byte* alphaIndices ) const;
	void				ScaleYCoCg( byte* colorBlock ) const;
	void				BiasScaleNormalY( byte* colorBlock ) const;
	void				RotateNormalsDXT1( byte* block ) const;
	void				RotateNormalsDXT5( byte* block ) const;
	int					FindColorIndices( const byte* colorBlock, const unsigned short color0, const unsigned short color1, unsigned int& result ) const;
	int					FindAlphaIndices( const byte* colorBlock, const int alphaOffset, const byte alpha0, const byte alpha1, byte* indexes ) const;
	int					FindCTX1Indices( const byte* colorBlock, const byte* color0, const byte* color1, unsigned int& result ) const;
	
	void				ExtractBlock( const byte* inPtr, int width, byte* colorBlock ) const;
	void				GetMinMaxBBox( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				InsetColorsBBox( byte* minColor, byte* maxColor ) const;
	void				SelectColorsDiagonal( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				ScaleYCoCg( byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				InsetYCoCgAlpaBBox( byte* minColor, byte* maxColor ) const;
	void				InsetYCoCgBBox( byte* minColor, byte* maxColor ) const;
	void				SelectYCoCgDiagonal( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				InsetNormalsBBoxDXT5( byte* minNormal, byte* maxNormal ) const;
	void				InsetNormalsBBox3Dc( byte* minNormal, byte* maxNormal ) const;
	void				EmitColorIndices( const byte* colorBlock, const byte* minColor, const byte* maxColor );
	void				EmitColorAlphaIndices( const byte* colorBlock, const byte* minColor, const byte* maxColor );
	void				EmitCTX1Indices( const byte* colorBlock, const byte* minColor, const byte* maxColor );
	void				EmitAlphaIndices( const byte* colorBlock, const int channel, const byte minAlpha, const byte maxAlpha );
	void				EmitGreenIndices( const byte* block, const int channel, const byte minGreen, const byte maxGreen );
	
	// Keeping the ASM versions to keep the performance of 32-bit debug builds reasonable.
	// The implementation using intrinsics is very slow in debug builds because registers are continuously spilled to memory.
	void				ExtractBlock_SSE2( const byte* inPtr, int width, byte* colorBlock ) const;
	void				GetMinMaxBBox_SSE2( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				InsetColorsBBox_SSE2( byte* minColor, byte* maxColor ) const;
	void				InsetNormalsBBoxDXT5_SSE2( byte* minNormal, byte* maxNormal ) const;
	void				EmitColorIndices_SSE2( const byte* colorBlock, const byte* minColor, const byte* maxColor );
	void				EmitColorAlphaIndices_SSE2( const byte* colorBlock, const byte* minColor, const byte* maxColor );
	void				EmitCoCgIndices_SSE2( const byte* colorBlock, const byte* minColor, const byte* maxColor );
	void				EmitAlphaIndices_SSE2( const byte* colorBlock, const int minAlpha, const int maxAlpha );
	void				EmitAlphaIndices_SSE2( const byte* colorBlock, const int channelBitOffset, const int minAlpha, const int maxAlpha );
	void				EmitGreenIndices_SSE2( const byte* block, const int channelBitOffset, const int minGreen, const int maxGreen );
	void				ScaleYCoCg_SSE2( byte* colorBlock, byte* minColor, byte* maxColor ) const;
	void				InsetYCoCgBBox_SSE2( byte* minColor, byte* maxColor ) const;
	void				SelectYCoCgDiagonal_SSE2( const byte* colorBlock, byte* minColor, byte* maxColor ) const;
	
	
	
	void				EmitNormalYIndices( const byte* normalBlock, const int offset, const byte minNormalY, const byte maxNormalY );
	void				EmitNormalYIndices_SSE2( const byte* normalBlock, const int offset, const byte minNormalY, const byte maxNormalY );
	
	void				DecodeDXNAlphaValues( const byte* inBuf, byte* values );
	void				EncodeDXNAlphaValues( byte* outBuf, const byte min, const byte max, const byte* values );
	
	void				DecodeNormalYValues( const byte* inBuf, byte& min, byte& max, byte* values );
	void				EncodeNormalRGBIndices( byte* outBuf, const byte min, const byte max, const byte* values );
};

/*
========================
idDxtEncoder::CompressImageDXT1Fast
========================
*/
ID_INLINE void idDxtEncoder::CompressImageDXT1Fast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressImageDXT1Fast_SSE2( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressImageDXT1AlphaFast
========================
*/
ID_INLINE void idDxtEncoder::CompressImageDXT1AlphaFast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressImageDXT1AlphaFast_SSE2( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressImageDXT5Fast
========================
*/
ID_INLINE void idDxtEncoder::CompressImageDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressImageDXT5Fast_SSE2( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressImageDXN1Fast
========================
*/
ID_INLINE void idDxtEncoder::CompressImageDXN1Fast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressImageDXN1Fast_Generic( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressYCoCgDXT5Fast
========================
*/
ID_INLINE void idDxtEncoder::CompressYCoCgDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressYCoCgDXT5Fast_SSE2( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressYCoCgCTX1DXT5AFast
========================
*/
ID_INLINE void idDxtEncoder::CompressYCoCgCTX1DXT5AFast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressYCoCgCTX1DXT5AFast_Generic( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressNormalMapDXT5Fast
========================
*/
ID_INLINE void idDxtEncoder::CompressNormalMapDXT5Fast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressNormalMapDXT5Fast_SSE2( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::CompressNormalMapDXN2Fast
========================
*/
ID_INLINE void idDxtEncoder::CompressNormalMapDXN2Fast( const byte* inBuf, byte* outBuf, int width, int height )
{
	CompressNormalMapDXN2Fast_Generic( inBuf, outBuf, width, height );
}

/*
========================
idDxtEncoder::EmitByte
========================
*/
ID_INLINE void idDxtEncoder::EmitByte( byte b )
{
	*outData = b;
	outData += 1;
}

/*
========================
idDxtEncoder::EmitUShort
========================
*/
ID_INLINE void idDxtEncoder::EmitUShort( unsigned short s )
{
	*( ( unsigned short* )outData ) = s;
	outData += 2;
}

/*
========================
idDxtEncoder::EmitUInt
========================
*/
ID_INLINE void idDxtEncoder::EmitUInt( unsigned int i )
{
	*( ( unsigned int* )outData ) = i;
	outData += 4;
}

/*
========================
idDxtEncoder::AlphaDistance
========================
*/
ID_INLINE unsigned int idDxtEncoder::AlphaDistance( const byte a1, const byte a2 ) const
{
	return ( a1 - a2 ) * ( a1 - a2 );
}

/*
========================
idDxtEncoder::ColorDistance
========================
*/
ID_INLINE unsigned int idDxtEncoder::ColorDistance( const byte* c1, const byte* c2 ) const
{
	return ( ( c1[ 0 ] - c2[ 0 ] ) * ( c1[ 0 ] - c2[ 0 ] ) ) + ( ( c1[ 1 ] - c2[ 1 ] ) * ( c1[ 1 ] - c2[ 1 ] ) ) + ( ( c1[ 2 ] - c2[ 2 ] ) * ( c1[ 2 ] - c2[ 2 ] ) );
}

/*
========================
idDxtEncoder::ColorDistanceWeighted
========================
*/
ID_INLINE unsigned int idDxtEncoder::ColorDistanceWeighted( const byte* c1, const byte* c2 ) const
{
	int r, g, b;
	int rmean;
	
	// http://www.compuphase.com/cmetric.htm
	rmean = ( ( int )c1[0] + ( int )c2[0] ) / 2;
	r = ( int )c1[0] - ( int )c2[0];
	g = ( int )c1[1] - ( int )c2[1];
	b = ( int )c1[2] - ( int )c2[2];
	return ( ( ( 512 + rmean ) * r * r ) >> 8 ) + 4 * g * g + ( ( ( 767 - rmean ) * b * b ) >> 8 );
}

/*
========================
idDxtEncoder::CTX1Distance
========================
*/
ID_INLINE unsigned int idDxtEncoder::CTX1Distance( const byte* c1, const byte* c2 ) const
{
	return ( ( c1[ 0 ] - c2[ 0 ] ) * ( c1[ 0 ] - c2[ 0 ] ) ) + ( ( c1[ 1 ] - c2[ 1 ] ) * ( c1[ 1 ] - c2[ 1 ] ) );
}

/*
========================
idDxtEncoder::ColorTo565
========================
*/
ID_INLINE unsigned short idDxtEncoder::ColorTo565( const byte* color ) const
{
	return ( ( color[ 0 ] >> 3 ) << 11 ) | ( ( color[ 1 ] >> 2 ) << 5 ) | ( color[ 2 ] >> 3 );
}

/*
========================
idDxtEncoder::ColorFrom565
========================
*/
ID_INLINE void idDxtEncoder::ColorFrom565( unsigned short c565, byte* color ) const
{
	color[0] = byte( ( ( c565 >> 8 ) & ( ( ( 1 << ( 8 - 3 ) ) - 1 ) << 3 ) ) | ( ( c565 >> 13 ) & ( ( 1 << 3 ) - 1 ) ) );
	color[1] = byte( ( ( c565 >> 3 ) & ( ( ( 1 << ( 8 - 2 ) ) - 1 ) << 2 ) ) | ( ( c565 >>  9 ) & ( ( 1 << 2 ) - 1 ) ) );
	color[2] = byte( ( ( c565 << 3 ) & ( ( ( 1 << ( 8 - 3 ) ) - 1 ) << 3 ) ) | ( ( c565 >>  2 ) & ( ( 1 << 3 ) - 1 ) ) );
}

/*
========================
idDxtEncoder::ColorTo565
========================
*/
ID_INLINE unsigned short idDxtEncoder::ColorTo565( byte r, byte g, byte b ) const
{
	return ( ( r >> 3 ) << 11 ) | ( ( g >> 2 ) << 5 ) | ( b >> 3 );
}

/*
========================
idDxtEncoder::GreenFrom565
========================
*/
ID_INLINE byte idDxtEncoder::GreenFrom565( unsigned short c565 ) const
{
	byte c = byte( ( c565 & ( ( ( 1 << 6 ) - 1 ) << 5 ) ) >> 3 );
	return ( c | ( c >> 6 ) );
}

/*
================================================
idDxtDecoder decodes DXT-compressed Images. Raw output Images are in
4-byte RGBA format. Raw output NormalMaps are in 4-byte tangent-space NxNyNz format.
================================================
*/
class idDxtDecoder
{
public:

	// DXT1 decompression (no alpha)
	void	DecompressImageDXT1( const byte* inBuf, byte* outBuf, int width, int height );
	
	// DXT5 decompression
	void	DecompressImageDXT5( const byte* inBuf, byte* outBuf, int width, int height );
	
	// DXT5 decompression with nVidia 7x hardware bug
	void	DecompressImageDXT5_nVidia7x( const byte* inBuf, byte* outBuf, int width, int height );
	
	// CTX1
	void	DecompressImageCTX1( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// DXN1
	void	DecompressImageDXN1( const byte* inBuf, byte* outBuf, int width, int height )
	{
		/* not implemented */ assert( 0 );
	}
	
	// YCoCg DXT5 (the output is in CoCg_Y format)
	void	DecompressYCoCgDXT5( const byte* inBuf, byte* outBuf, int width, int height );
	
	// YCoCg CTX1 + DXT5A (the output is in CoCg_Y format)
	void	DecompressYCoCgCTX1DXT5A( const byte* inBuf, byte* outBuf, int width, int height );
	
	// tangent space normal map decompression from DXT1 format
	void	DecompressNormalMapDXT1( const byte* inBuf, byte* outBuf, int width, int height );
	void	DecompressNormalMapDXT1Renormalize( const byte* inBuf, byte* outBuf, int width, int height );
	
	// tangent space normal map decompression from DXT5 format
	void	DecompressNormalMapDXT5( const byte* inBuf, byte* outBuf, int width, int height );
	void	DecompressNormalMapDXT5Renormalize( const byte* inBuf, byte* outBuf, int width, int height );
	
	// tangent space normal map decompression from DXN2 format
	void	DecompressNormalMapDXN2( const byte* inBuf, byte* outBuf, int width, int height );
	
	// decompose a DXT image into indices and two images with colors
	void	DecomposeImageDXT1( const byte* inBuf, byte* colorIndices, byte* pic1, byte* pic2, int width, int height );
	void	DecomposeImageDXT5( const byte* inBuf, byte* colorIndices, byte* alphaIndices, byte* pic1, byte* pic2, int width, int height );
	
private:
	int					width;
	int					height;
	const byte* 		inData;
	
	byte				ReadByte();
	unsigned short		ReadUShort();
	unsigned int		ReadUInt();
	unsigned short		ColorTo565( const byte* color ) const;
	void				ColorFrom565( unsigned short c565, byte* color ) const;
	unsigned short		NormalYTo565( byte y ) const;
	byte				NormalYFrom565( unsigned short c565 ) const;
	byte				NormalScaleFrom565( unsigned short c565 ) const;
	byte				NormalBiasFrom565( unsigned short c565 ) const;
	
	void				EmitBlock( byte* outPtr, int x, int y, const byte* colorBlock );
	void				DecodeAlphaValues( byte* colorBlock, const int offset );
	void				DecodeColorValues( byte* colorBlock, bool noBlack, bool writeAlpha );
	void				DecodeCTX1Values( byte* colorBlock );
	
	void				DecomposeColorBlock( byte colors[2][4], byte colorIndices[16], bool noBlack );
	void				DecomposeAlphaBlock( byte colors[2][4], byte alphaIndices[16] );
	
	void				DecodeNormalYValues( byte* normalBlock, const int offsetY, byte& bias, byte& scale );
	void				DeriveNormalZValues( byte* normalBlock );
};

/*
========================
idDxtDecoder::ReadByte
========================
*/
ID_INLINE byte idDxtDecoder::ReadByte()
{
	byte b = *inData;
	inData += 1;
	return b;
}

/*
========================
idDxtDecoder::ReadUShort
========================
*/
ID_INLINE unsigned short idDxtDecoder::ReadUShort()
{
	unsigned short s = *( ( unsigned short* )inData );
	inData += 2;
	return s;
}

/*
========================
idDxtDecoder::ReadUInt
========================
*/
ID_INLINE unsigned int idDxtDecoder::ReadUInt()
{
	unsigned int i = *( ( unsigned int* )inData );
	inData += 4;
	return i;
}

/*
========================
idDxtDecoder::ColorTo565
========================
*/
ID_INLINE unsigned short idDxtDecoder::ColorTo565( const byte* color ) const
{
	return ( ( color[ 0 ] >> 3 ) << 11 ) | ( ( color[ 1 ] >> 2 ) << 5 ) | ( color[ 2 ] >> 3 );
}

/*
========================
idDxtDecoder::ColorFrom565
========================
*/
ID_INLINE void idDxtDecoder::ColorFrom565( unsigned short c565, byte* color ) const
{
	color[0] = byte( ( ( c565 >> 8 ) & ( ( ( 1 << ( 8 - 3 ) ) - 1 ) << 3 ) ) | ( ( c565 >> 13 ) & ( ( 1 << 3 ) - 1 ) ) );
	color[1] = byte( ( ( c565 >> 3 ) & ( ( ( 1 << ( 8 - 2 ) ) - 1 ) << 2 ) ) | ( ( c565 >>  9 ) & ( ( 1 << 2 ) - 1 ) ) );
	color[2] = byte( ( ( c565 << 3 ) & ( ( ( 1 << ( 8 - 3 ) ) - 1 ) << 3 ) ) | ( ( c565 >>  2 ) & ( ( 1 << 3 ) - 1 ) ) );
}

/*
========================
idDxtDecoder::NormalYTo565
========================
*/
ID_INLINE unsigned short idDxtDecoder::NormalYTo565( byte y ) const
{
	return ( ( y >> 2 ) << 5 );
}

/*
========================
idDxtDecoder::NormalYFrom565
========================
*/
ID_INLINE byte idDxtDecoder::NormalYFrom565( unsigned short c565 ) const
{
	byte c = byte( ( c565 & ( ( ( 1 << 6 ) - 1 ) << 5 ) ) >> 3 );
	return ( c | ( c >> 6 ) );
}

/*
========================
idDxtDecoder::NormalBiasFrom565
========================
*/
ID_INLINE byte idDxtDecoder::NormalBiasFrom565( unsigned short c565 ) const
{
	byte c = byte( ( c565 & ( ( ( 1 << 5 ) - 1 ) << 11 ) ) >> 8 );
	return ( c | ( c >> 5 ) );
}

/*
========================
idDxtDecoder::NormalScaleFrom565
========================
*/
ID_INLINE byte idDxtDecoder::NormalScaleFrom565( unsigned short c565 ) const
{
	byte c = byte( ( c565 & ( ( ( 1 << 5 ) - 1 ) << 0 ) ) << 3 );
	return ( c | ( c >> 5 ) );
}

#endif // !__DXTCODEC_H__