Some RW info (PS2)

Ниже немного полезной (по крайней мере, для меня) инфы по RW PS2.

Некоторые особенности Texture Native:

• Секция 0 (Struct):
  1. Первые 4 байта - это сигнатура PS2 и нуль-байт, т.е., скорее всего это строка. Ничего интересного, разве что в PC-аналогичном формате (XBOX тоже) здесь значение из RwPlatformID.
     То есть, по логике, здесь должно быть 0x04 (DWORD).
  2. Вторые 4 байта - это флаги, обычно равны 0x1102 (0x00001102), реже - 0x1106, ещё реже - 0x106.
     Особенность состоит в том, что 0x106 встречается только в RW 0x304, и все такие текстуры на данный момент НЕ рендерятся.
     Текстуры 0x1106 часто встречаются в GTA 3, и, как правило, рендерятся (но не всегда).
     Текстуры 0x1102 вроде как всегда рендерятся нормально.
     
  3. Вот список текстур GTA3, имеющих флаг 0x106:
     BOMBER.TXD, BUSKER1.TXD, BUSKER2.TXD, BUSKER3.TXD, BUSKER4.TXD, G.TXD, PLASTER.TXD, ROBBER.TXD, STU_MAN.TXD, STU_WOM.TXD
     Списки остальных текстур по флагам я здесь приводить не буду.
• Далее идут две строки, длина которых, теоретически не превышает 32 байт, т.к. хотя конечный TXD и позволяет привысить этот лимит, на предыдущих этапах использовался лимит 32.
• Секция 3 (Struct):
  Содержит кучу инфы о растре.
  
  • Секция 0 (Struct):
    Интересная секция, имеет дофига непонятных (на данный момент) полей.
    Достовернейше известно, что первые три поля DWORD (или UINT32, или, скорее всего, RwInt32) - ширина, высота, и глубина цвета (количество бит на пиксель).
    Тут должно быть поле, отвечающее за swizzling как таковой и, возможно, есть такие поля как stride, nOffsetX, nOffsetY, cType, cFlags, privateFlags, cFormat (см. структуры внизу).
    
  • Секция 1 (Struct):
    Здесь содержится сам растр [и палитра], а также мипмапы, если они есть.
    
    1. Помимо этого, перед растром и палитрой есть блок информации, по-видимому, общий для каких-то объекстов RW (т.к. содержит кучу нулей). В этом блоке есть необходимая инфа для отрисовки изображения: разрешение и размер смещённый на 4 бита (ну, или, размер/(2^4) = размер/16). Скорее всего, это не непосредственные данные, а информация о количестве каких-то блоков, на которое поделено изображение.
    2. Что интересно - по этим данным можно определить swizzling: если он есть, то длина и ширина поделены на два.

1. The pixel color format corresponding to one of the following values:-
   • rwRASTERFORMAT1555
   • rwRASTERFORMAT565
   • rwRASTERFORMAT4444
   • rwRASTERFORMATLUM8
   • rwRASTERFORMAT8888
   • rwRASTERFORMAT888
   • rwRASTERFORMAT16
   • rwRASTERFORMAT24
   • rwRASTERFORMAT32
   • rwRASTERFORMAT555
   This value may be masked out of the raster format using rwRASTERFORMATPIXELFORMATMASK.
2. The palette depth if the raster is palettized:-
   • rwRASTERFORMATPAL4
   • rwRASTERFORMATPAL8
   In these cases, the color format refers to that of the palette.
3. Flag rwRASTERFORMATMIPMAP. Set if the raster contains mipmap levels.
4. Flag rwRASTERFORMATAUTOMIPMAP. Set if the mipmap levels were generated automatically by RenderWare.

enum RwRasterFormat {
    rwRASTERFORMATDEFAULT = 0x0000, /* Whatever the hardware likes best */

    rwRASTERFORMAT1555 = 0x0100,    /**<l16 bits - 1 bit alpha, 5 bits red, green and blue */
    rwRASTERFORMAT565 = 0x0200,     /**<16 bits - 5 bits red and blue, 6 bits green */
    rwRASTERFORMAT4444 = 0x0300,    /**<16 bits - 4 bits per component */
    rwRASTERFORMATLUM8 = 0x0400,    /**<Gray scale */
    rwRASTERFORMAT8888 = 0x0500,    /**<32 bits - 8 bits per component */
    rwRASTERFORMAT888 = 0x0600,     /**<24 bits - 8 bits per component */
    rwRASTERFORMAT16 = 0x0700,      /**<16 bits - undefined: useful for things like Z buffers */
    rwRASTERFORMAT24 = 0x0800,      /**<24 bits - undefined: useful for things like Z buffers */
    rwRASTERFORMAT32 = 0x0900,      /**<32 bits - undefined: useful for things like Z buffers */
    rwRASTERFORMAT555 = 0x0a00,     /**<16 bits - 5 bits red, green and blue */

    rwRASTERFORMATAUTOMIPMAP = 0x1000, /**<RenderWare generated the mip levels */

    rwRASTERFORMATPAL8 = 0x2000,    /**<8 bit palettised */
    rwRASTERFORMATPAL4 = 0x4000,    /**<4 bit palettised */

    rwRASTERFORMATMIPMAP = 0x8000,  /**<Mip mapping on */

    rwRASTERFORMATPIXELFORMATMASK = 0x0f00, /**<The pixel color format 
                                             *  (excluding palettised bits) */
    rwRASTERFORMATMASK = 0xff00     /**<The whole format */ ,
    rwRASTERFORMATFORCEENUMSIZEINT = RWFORCEENUMSIZEINT
};

enum RwRasterPrivateFlag {
    rwRASTERGAMMACORRECTED = 0x01,
    rwRASTERPIXELLOCKEDREAD = 0x02, /* pixels are locked for reading */
    rwRASTERPIXELLOCKEDWRITE = 0x04, /* pixels are locked for writing */
    rwRASTERPALETTELOCKEDREAD = 0x08, /* palette is locked for reading */
    rwRASTERPALETTELOCKEDWRITE = 0x10, /* palette is locked for writing */
    rwRASTERPIXELLOCKEDRAW = 0x20, /* the pixels are in platform specific
                                      format, used in combination with
                                      rwRASTERPIXELLOCKEDREAD &
                                      rwRASTERPIXELLOCKEDWRITE */
    rwRASTERPRIVATEFLAGFORCEENUMSIZEINT = RWFORCEENUMSIZEINT
};

struct RwRaster {
    RwRaster           *parent; /* Top level raster if a sub raster */
    RwUInt8            *cpPixels; /* Pixel pointer when locked */
    RwUInt8            *palette; /* Raster palette */
    RwInt32             width, height, depth; /* Dimensions of raster */
    RwInt32             stride; /* Lines bytes of raster */
    RwInt16             nOffsetX, nOffsetY; /* Sub raster offset */
    RwUInt8             cType;  /* Type of raster */
    RwUInt8             cFlags; /* Raster flags */
    RwUInt8             privateFlags; /* Raster private flags */
    RwUInt8             cFormat; /* Raster format */

    RwUInt8            *originalPixels;
    RwInt32             originalWidth;
    RwInt32             originalHeight;
    RwInt32             originalStride;
};

enum RwImageFlag {
    rwNAIMAGEFLAG = 0x00,
    rwIMAGEALLOCATED = 0x1,
    rwIMAGEGAMMACORRECTED = 0x2,
    rwIMAGEFLAGFORCEENUMSIZEINT = RWFORCEENUMSIZEINT
};

struct RwRGBA {
    RwUInt8 red;    /**< red component */
    RwUInt8 green;  /**< green component */
    RwUInt8 blue;   /**< blue component */
    RwUInt8 alpha;  /**< alpha component */
};

enum RwTextureAddressMode {
    rwTEXTUREADDRESSNATEXTUREADDRESS = 0,
    rwTEXTUREADDRESSWRAP,      /**<UV wraps (tiles) */
    rwTEXTUREADDRESSMIRROR,    /**<Alternate UV is flipped */
    rwTEXTUREADDRESSCLAMP,     /**<UV is clamped to 0-1 */
    rwTEXTUREADDRESSBORDER,    /**<Border color takes effect outside of 0-1 */
    rwTEXTUREADDRESSMODEFORCEENUMSIZEINT = RWFORCEENUMSIZEINT
};

enum RwPlatformID {
    rwID_PCD3D7 = 1,
    rwID_PCOGL,
    rwID_MAC,
    rwID_PS2,
    rwID_XBOX,
    rwID_GAMECUBE,
    rwID_SOFTRAS,
    rwID_PCD3D8,
    rwPLATFROMIDFORCEENUMSIZEINT = RWFORCEENUMSIZEINT
};