IMG/IMG_FileTypes.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Mark Elendt
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        IMG_Types.h ( IMG Library, C++)
 *
 * COMMENTS:    IMG data types
 */

#ifndef __IMG_FILE_TYPES__
#define __IMG_FILE_TYPES__

#include <PXL/PXL_Common.h>

enum IMG_DataType
{
    // Allow bit masking of types so formats can specify which types they
    // support.
    IMG_DT_ANY  = 0x00,
    
    // All integer data types are unsigned.
    IMG_UCHAR   = 0x01,  IMG_INT8    = 0x01,
    IMG_USHORT  = 0x02,  IMG_INT16   = 0x02, 
    IMG_UINT    = 0x04,  IMG_INT32   = 0x04,

    IMG_FLOAT   = 0x08,  IMG_FLOAT32 = 0x08,
    IMG_HALF    = 0x10,  IMG_FLOAT16 = 0x10 
};

enum IMG_ColorModel
{
    IMG_CM_ANY  = 0,

    // basic channel configurations
    IMG_1CHAN   = 0x01,
    IMG_2CHAN   = 0x02,
    IMG_RGB     = 0x04,
    IMG_RGBA    = 0x08,

    // extension bits
    IMG_CM_REVERSED = 0x10,

    // commonly reversed formats
    IMG_BGR     = (IMG_RGB  | IMG_CM_REVERSED),
    IMG_ABGR    = (IMG_RGBA | IMG_CM_REVERSED)
};

enum IMG_Interleave
{
    IMG_INTERLEAVE_AS_IS,
    IMG_INTERLEAVED,
    IMG_NON_INTERLEAVED
};

enum IMG_ComponentOrder
{
    IMG_COMPONENT_AS_IS,
    IMG_COMPONENT_RGBA,
    IMG_COMPONENT_ABGR
};

#define IMG_DT_ALL ((IMG_DataType)0x1F)

static inline int IMGbyteSize(IMG_DataType dt)
   {
       if(dt == IMG_INT16 || dt == IMG_FLOAT16)
           return 2;
       else if(dt == IMG_FLOAT32 || dt == IMG_INT32)
           return 4;
       return 1;
   }

static inline PXL_DataFormat IMGformatToPXL(IMG_DataType dt)
{
    switch(dt)
    {
    case IMG_INT8:      return PXL_INT8;
    case IMG_INT16:     return PXL_INT16;
    case IMG_INT32:     return PXL_INT32;
    case IMG_FLOAT32:   return PXL_FLOAT32;
    case IMG_FLOAT16:   return PXL_FLOAT16;
    default:            return PXL_MAX_DATA_FORMAT;
    }
    // unknown format.
    return PXL_MAX_DATA_FORMAT;
}

static inline IMG_DataType IMGformatFromPXL(PXL_DataFormat dt)
{
    switch(dt)
    {
    case PXL_INT8:      return IMG_INT8;
    case PXL_INT16:     return IMG_INT16;
    case PXL_INT32:     return IMG_INT32;
    case PXL_FLOAT32:   return IMG_FLOAT32;
    case PXL_FLOAT16:   return IMG_FLOAT16;
    default:            return IMG_DT_ANY;
    }
    // unknown format.
    return IMG_DT_ANY;
}

static inline IMG_ColorModel IMGcolorModelFromPXL(PXL_Packing pack)
{
    switch(pack)
    {
    case PACK_SINGLE:       return IMG_1CHAN;
    case PACK_DUAL:
    case PACK_DUAL_NI:      return IMG_2CHAN;
    case PACK_RGB:
    case PACK_RGB_NI:       return IMG_RGB;
    case PACK_RGBA:
    case PACK_RGBA_NI:      return IMG_RGBA;
    default:                return IMG_CM_ANY;
    }
}

static inline IMG_Interleave IMGinterleaveFromPXL(PXL_Packing pack)
{
    switch(pack)
    {
    case PACK_DUAL:
    case PACK_RGB:
    case PACK_RGBA:     return IMG_INTERLEAVED;
    case PACK_DUAL_NI:
    case PACK_RGB_NI:
    case PACK_RGBA_NI:  return IMG_NON_INTERLEAVED;
    default:            return IMG_INTERLEAVE_AS_IS;
    }
}

// 
// ------------------------------------------------------------------------
//

// size mask
#define IMG_CM_SIZE 0x0F
#define IMG_CM_ALL  ((IMG_ColorModel)0x0F)

static inline int IMGvectorSize(IMG_ColorModel cm)
   {
       int num;
       int sb = (cm & IMG_CM_SIZE);
       
       if(sb == IMG_1CHAN)
           num=1;
       else if(sb == IMG_2CHAN)
           num=2;
       else if(sb == IMG_RGB)
           num=3;
       else if(sb == IMG_RGBA)
           num=4;
       else
           num=0;
       return num;
   }

static inline bool IMGisReversed(IMG_ColorModel cm)
   { return ((bool)(cm & IMG_CM_REVERSED)); }

//
// ------------------------------------------------------------------------
//

// Image Orientation enums. 
enum IMG_XOrientation
{
    IMG_ORIENT_X_NONE,
    IMG_ORIENT_LEFT_FIRST,
    IMG_ORIENT_RIGHT_FIRST
};
    
enum IMG_YOrientation
{
    IMG_ORIENT_Y_NONE,
    IMG_ORIENT_TOP_FIRST,
    IMG_ORIENT_BOTTOM_FIRST
};

// Deep Raster RGBA preference
enum IMG_DeepRasterColor
{
    IMG_DEEP_RGBA_SPLIT,
    IMG_DEEP_RGBA_COMBINED,
    IMG_DEEP_RGBA_DONT_CARE
};

// return enum for the IMG_File::getAlphaInfo() method, triggered by
// IMG_FileParms::detectTrivialAlpha()
enum IMG_FileAlphaInfo
{
    IMG_ALPHA_OPAQUE,           // constant 1
    IMG_ALPHA_CONSTANT,         // constant valued
    IMG_ALPHA_CUTOUT,           // either 1.0 or 0.0
    IMG_ALPHA_VARYING,          // 
    IMG_ALPHA_OUT_OF_BOUNDS,    // < 0.0 or > 1.0
    IMG_ALPHA_NONE              // no alpha channel
};

#endif

---