第二人生的源码分析(五十二) 纹理图片的格式之LLImageFormatted类

前面介绍了图片的基类，现在来介绍一下图片的格式化表示LLImageFormatted类。那么为什么需要设计这个格式化类呢？而不是直接从图片的基类继承到JPEG2000或者TGA呢？其实，这个类LLImageFormatted只是一个接口，让不同压缩方式的图片数据转换为中间表示方式，也就是原始数据表示方式。它的类声明如下：
#001 class LLImageFormatted : public LLImageBase
#002 {
#003 public:
#004 static LLImageFormatted* createFromType(S8 codec);
#005 static LLImageFormatted* createFromExtension(const LLString& instring);
#006
#007 protected:
#008 /*virtual*/ ~LLImageFormatted();
#009
#010 public:

设置采用什么方式压缩数据。
#011 LLImageFormatted(S8 codec);
#012
#013 // LLImageBase
#014 public:

分配内存。
#015 /*virtual*/ void deleteData();
#016 /*virtual*/ U8* allocateData(S32 size = -1);
#017 /*virtual*/ U8* reallocateData(S32 size);
#018
#019 /*virtual*/ void dump();
#020 /*virtual*/ void sanityCheck();
#021
#022 // New methods
#023 public:

计算文件头数据大小。
#024 // calcHeaderSize() returns the maximum size of header;
#025 // 0 indicates we don't know have a header and have to lead the entire file
#026 virtual S32 calcHeaderSize() { return 0; };

计算文件数据占用的大小。
#027 // calcDataSize() returns how many bytes to read to load discard_level (including header)
#028 virtual S32 calcDataSize(S32 discard_level);
#029 // calcDiscardLevelBytes() returns the smallest valid discard level based on the number of input bytes
#030 virtual S32 calcDiscardLevelBytes(S32 bytes);
#031 // getRawDiscardLevel()by default returns mDiscardLevel, but may be overridden (LLImageJ2C)
#032 virtual S8 getRawDiscardLevel() { return mDiscardLevel; }
#033

下面从文件里加载数据和保存压缩的数据到文件里。
#034 BOOL load(const LLString& filename);
#035 BOOL save(const LLString& filename);
#036
#037 virtual BOOL updateData() = 0; // pure virtual
#038 void setData(U8 *data, S32 size);
#039 void appendData(U8 *data, S32 size);
#040

下面函数是解压图片数据的接口。
#041 // Loads first 4 channels.
#042 virtual BOOL decode(LLImageRaw* raw_image, F32 decode_time=0.0) = 0;
#043 // Subclasses that can handle more than 4 channels should override this function.
#044 virtual BOOL decode(LLImageRaw* raw_image, F32 decode_time, S32 first_channel, S32 max_channel);
#045

下面函数是压缩数据的接口。
#046 virtual BOOL encode(const LLImageRaw* raw_image, F32 encode_time=0.0) = 0;
#047
#048 S8 getCodec() const;
#049 BOOL isDecoding() const { return mDecoding ? TRUE : FALSE; }
#050 BOOL isDecoded() const { return mDecoded ? TRUE : FALSE; }
#051 void setDiscardLevel(S8 discard_level) { mDiscardLevel = discard_level; }
#052 S8 getDiscardLevel() const { return mDiscardLevel; }
#053
#054 protected:
#055 BOOL copyData(U8 *data, S32 size); // calls updateData()
#056
#057 protected:
#058 S8 mCodec;
#059 S8 mDecoding;
#060 S8 mDecoded;
#061 S8 mDiscardLevel;
#062
#063 public:
#064 static S32 sGlobalFormattedMemory;
#065 };

有了这个中间表示，就可以把不同压缩的文件格式统一到一种操作方式了。