Breakdown swizzled 8bpp paletted texture data about sh3redux HOT 3 OPEN

//Convert the TIM2Picture's palette to linear 32-bit True Color.
Color[] ConvertPicturePaletteToRGBA(TIM2Picture tPicture)
{
	//If there is no palette, return an empty palette.
	if (tPicture.paletteBytes == null || tPicture.paletteBytes.Length == 0)
		return null;

	//Otherwise, we're going to have to figure out which palette we're using based on the paletteColorSize.
	Color[] tPalette;
	if (tPicture.bitsPerPixel <= 8)
	{
		//We'll infer which palette type we're using based on the size of each individual palette entry.
		switch (tPicture.colorSize)
		{
			case 2://16 BIT LE_ABGR_1555?
				{
					tPalette = FromBufferABGR1555(tPicture.paletteBytes, tPicture.paletteSize);
				}
				break;
			case 3://24 BIT RGB?
				{
					tPalette = FromBufferRGB24Bit(tPicture.paletteBytes, tPicture.paletteSize);
				}
				break;
			case 4://32 BIT RGBA?
				{
					tPalette = FromBufferRGBA32Bit(tPicture.paletteBytes, tPicture.paletteSize);
				}
				break;
			default://Invalid data.
				return null;
		}

		//If the palette is interleaved, we need to unpack that into something linear.
		if (tPicture.isLinearPalette == false)
		{
			//The TIM2 palettes always have these fixed values.
			const int nBlockCount = 2;
			const int nStripeCount = 2;
			const int nColorCount = 8;

			//Some calculations for unpacking the palette.
			int nPartCount = tPalette.Length / 32;
			int nPartStride = nColorCount * nStripeCount * nBlockCount;
			int nStripeStride = nStripeCount * nColorCount;

			//This next part was ripped wholesale from the xentax references. I couldn't tell you exactly what's going on, but it appears to work.
			//If I had to guess, TIM2 has a very particular kind of interleave using blocks instead of straight stripes.
			int i = 0;
			Color[] tUnpackedColors = new Color[tPalette.Length];
			for (int part = 0; part < nPartCount; part++)
			{
				for (int block = 0; block < nBlockCount; block++)
				{
					for (int stripe = 0; stripe < nStripeCount; stripe++)
					{
						for (int color = 0; color < nColorCount; color++)
						{
							tUnpackedColors[i++] = tPalette[(part * nPartStride) + (block * nColorCount) + (stripe * nStripeStride) + color];
						}
					}
				}
			}

			//overwrite the original palette, as we don't need it anymore.
			tPalette = tUnpackedColors;
		}
	}
	return tPalette;
}