cloudcompare/libs/qCC_db/include/ccNormalCompressor.h

//##########################################################################
//#                                                                        #
//#                              CLOUDCOMPARE                              #
//#                                                                        #
//#  This program 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; version 2 or later of the License.      #
//#                                                                        #
//#  This program 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.                          #
//#                                                                        #
//#          COPYRIGHT: EDF R&D / TELECOM ParisTech (ENST-TSI)             #
//#                                                                        #
//##########################################################################

#ifndef CC_NORMAL_COMPRESSOR_HEADER
#define CC_NORMAL_COMPRESSOR_HEADER

//Local
#include "qCC_db.h"
#include "ccBasicTypes.h"

//! Normal compressor
class QCC_DB_LIB_API ccNormalCompressor
{
public:

	//! Compressed normals quantization level (number of directions: 2^(2*N+3))
	/** \warning Never pass a 'constant initializer' by reference
	**/
	static const unsigned char QUANTIZE_LEVEL = 9; //2097152 normals * 12 bytes = 24 Mb of memory

	//! Last valid normal code
	static const unsigned MAX_VALID_NORM_CODE = (1 << (QUANTIZE_LEVEL * 2 + 3)) - 1;
	//! Null normal code
	static const unsigned NULL_NORM_CODE = MAX_VALID_NORM_CODE + 1;

	//! Compression algorithm
	static unsigned Compress(const PointCoordinateType N[3]);

	//! Decompression algorithm
	static void Decompress(unsigned index, PointCoordinateType N[3], unsigned char level = QUANTIZE_LEVEL);

	//! Inverts a (compressed) normal
	static void InvertNormal(CompressedNormType &code);

};

 #endif //CC_NORMAL_COMPRESSOR_HEADER