OgrePixelFormat.h

Go to the documentation of this file.

/*
-----------------------------------------------------------------------------
This source file is part of OGRE
    (Object-oriented Graphics Rendering Engine)
For the latest info, see http://www.ogre3d.org/

Copyright (c) 2000-2013 Torus Knot Software Ltd

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
-----------------------------------------------------------------------------
*/
#ifndef _PixelFormat_H__
#define _PixelFormat_H__

#include "OgrePrerequisites.h"
#include "OgreCommon.h"
#include "OgreHeaderPrefix.h"

namespace Ogre {
    enum PixelFormat
    {
        PF_UNKNOWN = 0,
        PF_L8 = 1,
        PF_BYTE_L = PF_L8,
        PF_L16 = 2,
        PF_SHORT_L = PF_L16,
        PF_A8 = 3,
        PF_BYTE_A = PF_A8,
        PF_A4L4 = 4,
        PF_BYTE_LA = 5,
        PF_R5G6B5 = 6,
        PF_B5G6R5 = 7,
        PF_R3G3B2 = 31,
        PF_A4R4G4B4 = 8,
        PF_A1R5G5B5 = 9,
        PF_R8G8B8 = 10,
        PF_B8G8R8 = 11,
        PF_A8R8G8B8 = 12,
        PF_A8B8G8R8 = 13,
        PF_B8G8R8A8 = 14,
        PF_R8G8B8A8 = 28,
        PF_X8R8G8B8 = 26,
        PF_X8B8G8R8 = 27,
#if OGRE_ENDIAN == OGRE_ENDIAN_BIG

        PF_BYTE_RGB = PF_R8G8B8,
        PF_BYTE_BGR = PF_B8G8R8,
        PF_BYTE_BGRA = PF_B8G8R8A8,
        PF_BYTE_RGBA = PF_R8G8B8A8,
#else

        PF_BYTE_RGB = PF_B8G8R8,
        PF_BYTE_BGR = PF_R8G8B8,
        PF_BYTE_BGRA = PF_A8R8G8B8,
        PF_BYTE_RGBA = PF_A8B8G8R8,
#endif        

        PF_A2R10G10B10 = 15,
        PF_A2B10G10R10 = 16,
        PF_DXT1 = 17,
        PF_DXT2 = 18,
        PF_DXT3 = 19,
        PF_DXT4 = 20,
        PF_DXT5 = 21,
        PF_FLOAT16_R = 32,
        PF_FLOAT16_RGB = 22,
        PF_FLOAT16_RGBA = 23,
        // 32-bit pixel format, 32 bits (float) for red
        PF_FLOAT32_R = 33,
        PF_FLOAT32_RGB = 24,
        PF_FLOAT32_RGBA = 25,
        PF_FLOAT16_GR = 35,
        PF_FLOAT32_GR = 36,
        PF_DEPTH = 29,
        PF_SHORT_RGBA = 30,
        PF_SHORT_GR = 34,
        PF_SHORT_RGB = 37,
        PF_PVRTC_RGB2 = 38,
        PF_PVRTC_RGBA2 = 39,
        PF_PVRTC_RGB4 = 40,
        PF_PVRTC_RGBA4 = 41,
        PF_PVRTC2_2BPP = 42,
        PF_PVRTC2_4BPP = 43,
        PF_R11G11B10_FLOAT = 44,
        PF_R8_UINT = 45,
        PF_R8G8_UINT = 46,
        PF_R8G8B8_UINT = 47,
        PF_R8G8B8A8_UINT = 48,
        PF_R16_UINT = 49,
        PF_R16G16_UINT = 50,
        PF_R16G16B16_UINT = 51,
        PF_R16G16B16A16_UINT = 52,
        PF_R32_UINT = 53,
        PF_R32G32_UINT = 54,
        PF_R32G32B32_UINT = 55,
        PF_R32G32B32A32_UINT = 56,
        PF_R8_SINT = 57,
        PF_R8G8_SINT = 58,
        PF_R8G8B8_SINT = 59,
        PF_R8G8B8A8_SINT = 60,
        PF_R16_SINT = 61,
        PF_R16G16_SINT = 62,
        PF_R16G16B16_SINT = 63,
        PF_R16G16B16A16_SINT = 64,
        PF_R32_SINT = 65,
        PF_R32G32_SINT = 66,
        PF_R32G32B32_SINT = 67,
        PF_R32G32B32A32_SINT = 68,
        PF_R9G9B9E5_SHAREDEXP = 69,
        PF_BC4_UNORM = 70,
        PF_BC4_SNORM = 71,
        PF_BC5_UNORM = 72,
        PF_BC5_SNORM = 73,
        PF_BC6H_UF16 = 74,
        PF_BC6H_SF16 = 75,
        PF_BC7_UNORM = 76,
        PF_BC7_UNORM_SRGB = 77,
        PF_R8 = 78,
        PF_RG8 = 79,
        PF_R8_SNORM = 80,
        PF_R8G8_SNORM = 81,
        PF_R8G8B8_SNORM = 82,
        PF_R8G8B8A8_SNORM = 83,
        PF_R16_SNORM = 84,
        PF_R16G16_SNORM = 85,
        PF_R16G16B16_SNORM = 86,
        PF_R16G16B16A16_SNORM = 87,
        PF_ETC1_RGB8 = 88,
        PF_ETC2_RGB8 = 89,
        PF_ETC2_RGBA8 = 90,
        PF_ETC2_RGB8A1 = 91,
        PF_ATC_RGB = 92,
        PF_ATC_RGBA_EXPLICIT_ALPHA = 93,
        PF_ATC_RGBA_INTERPOLATED_ALPHA = 94,
        // Number of pixel formats currently defined
        PF_COUNT = 95
    };
    typedef vector<PixelFormat>::type PixelFormatList;

    enum PixelFormatFlags {
        PFF_HASALPHA        = 0x00000001,      
        PFF_COMPRESSED    = 0x00000002,
        PFF_FLOAT           = 0x00000004,         
        PFF_DEPTH           = 0x00000008,
        PFF_NATIVEENDIAN    = 0x00000010,
        PFF_LUMINANCE       = 0x00000020,
        PFF_INTEGER         = 0x00000040
    };
    
    enum PixelComponentType
    {
        PCT_BYTE = 0,    
        PCT_SHORT = 1,   
        PCT_FLOAT16 = 2, 
        PCT_FLOAT32 = 3, 
        PCT_SINT = 4,   
        PCT_UINT = 5,   
        PCT_COUNT = 6    
    };
    
    class _OgreExport PixelBox: public Box, public ImageAlloc {
    public:
        PixelBox() {}
        ~PixelBox() {}
        PixelBox(const Box &extents, PixelFormat pixelFormat, void *pixelData=0):
            Box(extents), data(pixelData), format(pixelFormat)
        {
            setConsecutive();
        }
        PixelBox(uint32 width, uint32 height, uint32 depth, PixelFormat pixelFormat, void *pixelData=0):
            Box(0, 0, 0, width, height, depth),
            data(pixelData), format(pixelFormat)
        {
            setConsecutive();
        }
        
        void *data;
        PixelFormat format;
        size_t rowPitch;
        size_t slicePitch;
        
        void setConsecutive()
        {
            rowPitch = getWidth();
            slicePitch = getWidth()*getHeight();
        }
        size_t getRowSkip() const { return rowPitch - getWidth(); }
        size_t getSliceSkip() const { return slicePitch - (getHeight() * rowPitch); }

        bool isConsecutive() const 
        { 
            return rowPitch == getWidth() && slicePitch == getWidth()*getHeight(); 
        }
        size_t getConsecutiveSize() const;
        PixelBox getSubVolume(const Box &def) const;
        
        void* getTopLeftFrontPixelPtr() const;
        
        ColourValue getColourAt(size_t x, size_t y, size_t z);

        void setColourAt(ColourValue const &cv, size_t x, size_t y, size_t z);
    };
    

    class _OgreExport PixelUtil {
    public:
        static size_t getNumElemBytes( PixelFormat format );

        static size_t getNumElemBits( PixelFormat format );

        static size_t getMemorySize(uint32 width, uint32 height, uint32 depth, PixelFormat format);
        
        static unsigned int getFlags( PixelFormat format );

        static bool hasAlpha(PixelFormat format);
        static bool isFloatingPoint(PixelFormat format);
        static bool isInteger(PixelFormat format);
        static bool isCompressed(PixelFormat format);
        static bool isDepth(PixelFormat format);
        static bool isNativeEndian(PixelFormat format);
        static bool isLuminance(PixelFormat format);
        
        static bool isValidExtent(size_t width, size_t height, size_t depth, PixelFormat format);

        static void getBitDepths(PixelFormat format, int rgba[4]);

        static void getBitMasks(PixelFormat format, uint64 rgba[4]);

        static void getBitShifts(PixelFormat format, unsigned char rgba[4]);

        static String getFormatName(PixelFormat srcformat);

        static bool isAccessible(PixelFormat srcformat);
        
        static PixelComponentType getComponentType(PixelFormat fmt);
        
        static size_t getComponentCount(PixelFormat fmt);

        static PixelFormat getFormatFromName(const String& name, bool accessibleOnly = false, bool caseSensitive = false);

        static String getBNFExpressionOfPixelFormats(bool accessibleOnly = false);

        static PixelFormat getFormatForBitDepths(PixelFormat fmt, ushort integerBits, ushort floatBits);

        static void packColour(const ColourValue &colour, const PixelFormat pf,  void* dest);
        static void packColour(const uint8 r, const uint8 g, const uint8 b, const uint8 a, const PixelFormat pf,  void* dest);
        static void packColour(const float r, const float g, const float b, const float a, const PixelFormat pf,  void* dest);

        static void unpackColour(ColourValue *colour, PixelFormat pf,  const void* src);
        static void unpackColour(uint8 *r, uint8 *g, uint8 *b, uint8 *a, PixelFormat pf,  const void* src);
        static void unpackColour(float *r, float *g, float *b, float *a, PixelFormat pf,  const void* src); 
        
        static void bulkPixelConversion(void *src, PixelFormat srcFormat, void *dst, PixelFormat dstFormat, unsigned int count);

        static void bulkPixelConversion(const PixelBox &src, const PixelBox &dst);

        static void bulkPixelVerticalFlip(const PixelBox &box);
    };
}

#include "OgreHeaderSuffix.h"

#endif