SoConversion.h

Go to the documentation of this file.

/*=======================================================================
 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.),            ***
 ***              AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT.                     ***
 ***                                                                                ***
 ***  REPRODUCTION, DISCLOSURE,  OR USE,  IN WHOLE OR IN PART,  OTHER THAN AS       ***
 ***  SPECIFIED  IN THE LICENSE ARE  NOT TO BE  UNDERTAKEN  EXCEPT WITH PRIOR       ***
 ***  WRITTEN AUTHORIZATION OF FEI S.A.S.                                           ***
 ***                                                                                ***
 ***                        RESTRICTED RIGHTS LEGEND                                ***
 ***  USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS      ***
 ***  WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN      ***
 ***  SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT      ***
 ***  CLAUSE  AT FAR 52.227-19  OR SUBPARAGRAPH  (C)(1)(II)  OF  THE RIGHTS IN      ***
 ***  TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013.             ***
 ***                                                                                ***
 ***                   COPYRIGHT (C) 1996-2023 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : VSG (MMM YYYY)
**=======================================================================*/
#if !defined SOCONVERSION_H
#define SOCONVERSION_H
 
#include <Inventor/SbString.h>
#include <Inventor/SbDataType.h>
 
#include <Inventor/STL/vector>
 
#include <Inventor/algorithms/SoAlgorithmsDefs.h>
 
#if defined(__i386__) || defined(__amd64__) || defined(__x86_64__) || defined(_M_IX86) || defined(_M_AMD64)
#   define HAS_SSE
#endif
 
#if ( __GNUC__ == 3 && __GNUC_MINOR__ == 2 )
#undef HAS_SSE
#endif
 
#ifdef HAS_SSE
#   include <mmintrin.h>
#   include <xmmintrin.h>
#   include <emmintrin.h>
#endif
 
class SoBufferObject;
class SoCpuBufferObject;
 
class   SoConversion
{
private:
  virtual ~SoConversion();
 
 
  static void initClass();
 
 
  static void exitClass();
 
public:
  SoConversion();
 
  virtual int convert(
    SoBufferObject* sourceBufferObject, const SbDataType src_type,
    SoBufferObject* targetBufferObject, const SbDataType dst_type, const size_t size );
 
 
  int convert(
    SoCpuBufferObject* sourceBufferObject, const SbDataType src_type,
    SoCpuBufferObject* targetBufferObject, const SbDataType dst_type, const size_t size );
 
  virtual int convertFloatToRGBA(
    SoBufferObject* sourceBufferObject,
    SoBufferObject* targetBufferObject,
    const size_t size, const float dataMin, const float dataMax );
 
 
  int convertFloatToRGBA(
    SoCpuBufferObject* sourceBufferObject,
    SoCpuBufferObject* targetBufferObject,
    const size_t size, const float dataMin, const float dataMax );
 
private:
  int convertToFloat(
    SoBufferObject* sourceBufferObject, const SbDataType src_type,
    SoBufferObject* targetBufferObject, const size_t size );
 
 
  int convertToUChar(
    SoBufferObject* sourceBufferObject, SbDataType src_type,
    SoBufferObject* targetBufferObject, const size_t size );
 
 
private:
 
  enum MappingMethod {
    MAP_TO_CENTER,
 
    MAP_TO_BORDER
  };
 
  virtual void mapDataRangeToIndex(
    SoBufferObject *sourceBufferObject, const SbDataType src_type,
    SoBufferObject *targetBufferObject, const SbDataType dst_type,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const double undefinedValue = std::numeric_limits<double>::quiet_NaN() );
 
 
  virtual void mapDataToIndex(
    SoBufferObject *sourceBufferObject, const SbDataType src_type,
    SoBufferObject *targetBufferObject, const SbDataType dst_type,
    const int numSigBits );
 
 
  virtual void mapDataRangeToRgba(
    SoBufferObject *sourceBufferObject, const SbDataType src_type,
    SoBufferObject *targetBufferObject, const SbDataType dst_type,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    SoBufferObject *rgbaBufferObject, const int numRgba, MappingMethod rgbaMapping );
 
 
  virtual void mapDataToRgba(
    SoBufferObject *sourceBufferObject, const SbDataType src_type,
    SoBufferObject *targetBufferObject, const SbDataType dst_type,
    const int numSigBits,
    SoBufferObject *rgbaBufferObject, const int numRgba, MappingMethod mapping );
 
  static void convertByteToBitSet(SoBufferObject* sourceBufferObject, SoBufferObject* targetBufferObject);
 
  static void convertBitSetToByte(SoBufferObject* sourceBufferObject, SoBufferObject* targetBufferObject);
 
  template <typename DataClassIn>
  static void cpuMapDataRangeToIndex(const void *srcData, void *dstData,
    const size_t bufferSize, const SbDataType::DataType dataTypeDst,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const double undefinedValue = std::numeric_limits<double>::quiet_NaN()
    );
 
  template <typename DataClassIn, typename DataClassOut>
  static void cpuMapDataRangeToIndexTempl(
    const void *src, void *dst, const size_t bufferSize,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const double undefinedValue = std::numeric_limits<double>::quiet_NaN()
    );
 
  template <typename DataClassIn, typename DataClassOut>
  static void cpuMapDataRangeToIndexTemplSSE(
    const void *src, void *dst, const size_t bufferSize,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap
    );
 
  template <typename DataClassIn>
  static void cpuMapDataRangeToRgba(
    const void *src, void *dst, const size_t bufferSize,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const unsigned int *rgba, const int numRgba, MappingMethod mapping
    );
 
  template <typename DataClassIn>
  static void cpuMapDataToIndex(const void *srcData, void *dstData,
    const size_t bufferSize, const SbDataType::DataType dataTypeDst,
    const int numSigBits
    );
 
  template <typename DataClassIn, typename DataClassOut>
  static void cpuMapDataToIndexTempl(
    const void *src, void *dst, const size_t bufferSize,
    const int numSigBits
    );
 
  template <typename DataClassIn>
  static void cpuMapDataToRgba(
    const void *src, void *dst, const size_t bufferSize,
    const int numSigBits,
    const unsigned int *rgba, const int numRgba, MappingMethod mapping
    );
 
private:
 
 // IN template CPU dataRangeToIndex version
  template <typename DataClassIn>
  static void cpuMapDataRangeToIndex(const void *srcData, void *dstData,
    const size_t bufferSize, const SbDataType::DataType dataTypeDst,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const int shift, const int offset
    );
 
 
  // IN/OUT template CPU version
  template <typename DataClassIn, typename DataClassOut>
  static void cpuMapDataRangeToIndexTempl(
    const void *src, void *dst, const size_t bufferSize,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const int shift, const int offset
    );
 
#ifdef HAS_SSE
  // IN/OUT template CPU SSE2 version
  template <typename DataClassIn, typename DataClassOut>
  static void cpuMapDataRangeToIndexTemplSSE(
    const void *src, void *dst, const size_t bufferSize,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const int shift, const int offset
    );
 
  template <typename DataClassIn>
  static void SSE_loadRegister( DataClassIn*& ptr, __m128& reg );
 
  template <typename DataClassOut>
  static void SSE_unloadRegister( __m128& regA, __m128& regB, DataClassOut*& ptr );
#endif
 
  // IN template CPU dataRangeToRgba version
  template <typename DataClassIn>
  static void cpuMapDataRangeToRgba(
    const void *src, void *dst, const size_t bufferSize,
    const double dataRangeMin, const double dataRangeMax, const bool dataRangeMap,
    const int shift, const int offset,
    const unsigned int *rgba, const int numRgba, MappingMethod mapping
    );
 
 
  // IN template CPU dataToIndex version
  template <typename DataClassIn>
  static void cpuMapDataToIndex(const void *srcData, void *dstData,
    const size_t bufferSize, const SbDataType::DataType dataTypeDst,
    const int numSigBits, const int shift, const int offset
    );
 
 
  // IN/OUT template CPU version
  template <typename DataClassIn, typename DataClassOut>
  static void cpuMapDataToIndexTempl(
    const void *src, void *dst, const size_t bufferSize,
    const int numSigBits, const int shift, const int offset
    );
 
 
  // IN template CPU dataToRgba version
  template <typename DataClassIn>
  static void cpuMapDataToRgba(
    const void *src, void *dst, const size_t bufferSize,
    const int numSigBits, const int shift, const int offset,
    const unsigned int *rgba, const int numRgba, MappingMethod mapping
    );
 
private:
#if defined(HAS_SSE)
  static void convertBitSetToByteSSE(unsigned char* packedTile, unsigned char* unpackedTile, uint64_t size);
#endif
  static void convertBitSetToByteStd(unsigned char* packedTile, unsigned char* unpackedTile, uint64_t size);
 
 
  static bool s_useSSE;
 
};
 
#endif //SOCONVERSION_H