Graphic Image Map (GIM)

Description

Graphic Image Map ? (GIM) is an image format, allows for tenths of different storage settings and by combining settings results in hundreds (or thousands) of different GIM files that are structurally different, to simplify concepts people is naming this different GIM files as "GIM formats" but strictly speaking the GIM format is always the same, the amount of GIM formats used in PlayStation consoles is limited though (restricted by the graphic enviroment, libraries, etc...). GIM files was found used in PSP and PS3 firmwares inside Resource Container (RCO) files, PlayStation 3 Theme (P3T) files, etc... See GimConv and Multimedia Formats and Tools#GIM

The acronym of GIM used in this wiki (Graphic Image Map) is an speculative unnofficial name based in how the data is stored in the internal GIM structure, if someone finds the official codename somewhere please report back and we will change it

Structure

• Overview

Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000000  2E 47 49 4D 31 2E 30 30 00 50 53 50 00 00 00 00  .GIM1.00.PSP....     <- GIM header
00000010  00 02 00 00 00 00 00 EC 00 00 00 10 00 00 00 10  .......ì........     <- Block 0x02 header
00000020  00 03 00 00 00 00 00 80 00 00 00 10 00 00 00 10  .......€........     <- Block 0x03 header
00000030  00 04 00 00 00 00 00 70 00 00 00 70 00 00 00 10  .......p...p....     <- Block 0x04 header
00000040  00 30 00 00 00 03 00 00 00 04 00 02 00 20 00 10  .0........... ..     <- Block 0x04 Info
00000050  00 01 00 02 00 00 00 00 00 00 00 30 00 00 00 40  ...........0...@     <- Block 0x04 Info
00000060  00 00 00 60 00 00 00 00 00 01 00 01 00 03 00 01  ...`............     <- Block 0x04 Info
00000070  00 00 00 40 00 00 00 00 00 00 00 00 00 00 00 00  ...@............     <- Block 0x04 Info
00000080  CA 5E 11 00 CA 5E 12 00 CA 5E 13 00 CA 5E 14 00  Ê^..Ê^..Ê^..Ê^..     <- Block 0x04 Pixels
00000090  CA 5E 21 00 CA 5E 22 00 CA 5E 23 00 CA 5E 24 00  Ê^!.Ê^".Ê^#.Ê^$.     <- Block 0x04 Pixels
000000A0  00 FF 00 00 00 00 00 5C 00 00 00 5C 00 00 00 10  .ÿ.....\...\....     <- Block 0xFF header
000000B0  34 78 32 5F 43 41 35 45 78 79 5F 33 32 62 69 74  4x2_CA5Exy_32bit     <- Block 0xFF Data
000000C0  73 2E 62 6D 70 00 41 64 6D 69 6E 69 73 74 72 61  s.bmp.Administra     <- Block 0xFF Data
000000D0  74 6F 72 00 53 75 6E 20 41 70 72 20 31 35 20 30  tor.Sun Apr 15 0     <- Block 0xFF Data
000000E0  31 3A 32 35 3A 30 32 20 32 30 31 38 00 47 69 6D  1:25:02 2018.Gim     <- Block 0xFF Data
000000F0  43 6F 6E 76 20 31 2E 32 30 68 00 00              Conv 1.20h..         <- Block 0xFF Data

• Blocks are aligned to 4 bytes boundary, the byte at the end in the example is padding

GIM header

Offset	Length	Example	Name	Description	Notes
0x00	0x04	2E 47 49 4D	gim_signature	.GIM
0x04	0x04	31 2E 30 30	gim_version	1.00
0x08	0x04	00 50 53 50	gim_style	PSP
0x0C	0x04	00 00 00 00	gim_unk	Unknown

Block headers (generic)

Offset	Length	Example	Name	Description	Notes
0x00	0x02	00 02	block_id	Block identifyer	0x02 = Root ? (first level) 0x03 = ? (second level) 0x04 = ? (third level) 0xFF = Fileinfo (second level)
0x02	0x02	00 00	block_unk1	Unknown	0x00 = ? 0x10 = ?
0x04	0x04	00 00 01 0C	block_size	Size of this block + children blocks
0x08	0x04	00 00 00 10	block_next	Next block relative offset
0x0C	0x04	00 00 00 10	block_unk2	Block data relative offset ?

This is a representation of the block hierarchy in the example:

-0x02
  -0x03
    -0x04
  -0xFF

Block data (by block ID)

0x02 (root)

Empty/unknown. Is the parent of 0x03 and 0x0FF

0x03

Empty/unknown. Is the parent of 0x04

0x04 (bitmap)

Some of the values on this area are the same than in the GIS file. Also are directly related with the available settings on GimConv.cfg (the configuration file of GimConv.exe)

Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

00000040  00 30 00 00 00 03 00 00 00 04 00 02 00 20 00 10  .0........... ..     <- Block 0x04 Info
00000050  00 01 00 02 00 00 00 00 00 00 00 30 00 00 00 40  ...........0...@     <- Block 0x04 Info
00000060  00 00 00 60 00 00 00 00 00 01 00 01 00 03 00 01  ...`............     <- Block 0x04 Info
00000070  00 00 00 40 00 00 00 00 00 00 00 00 00 00 00 00  ...@............     <- Block 0x04 Info

Offset	Length	Example	Name	Description	Notes
0x00	0x02	00 30	b4_unk1	?
0x02	0x02	00 00	b4_unk2	?
0x04	0x02	00 03	image_format	0x00 = rgba5650 0x01 = rgba5551 0x02 = rgba4444 0x03 = rgba8888 0x04 = index4 0x05 = index8 0x06 = index16 0x07 = index32 0x08 = dxt1 0x09 = dxt3 0x0A = dxt5 0x108 = dxt1ext 0x109 = dxt3ext 0x10A = dxt5ext	image_format in GimConv.cfg Format in the GIS
0x06	0x02	00 00	pixel_order	0x00 = normal 0x10 = faster	pixel_order in GimConv.cfg with values: normal (default) or faster Order in the GIS with values: NORMAL or PSPIMAGE
0x08	0x02	00 04	image_width	Image width in pixels	Width in the GIS
0x0A	0x02	00 02	image_height	Image height in pixels	Height in the GIS
0x0C	0x02	00 20	image_bpp	Bits per pixel
0x0E	0x02	00 10	pitch_align	?	PitchAlign in the GIS
0x10	0x02	00 01	height_align	?	HeightAlign in the GIS
0x12	0x02	00 02
0x14	0x04	00 00 00 00
0x18	0x04	00 00 00 30			AddressStart ?
0x1C	0x04	00 00 00 40			BitmapStart ?
0x20	0x04	00 00 00 60			BitmapEnd ?
0x24	0x04	00 00 00 00			From the GIS ? PlaneMask ?
0x28	0x02	00 01			From the GIS ? LevelType ? (1 = MIPMAP)
0x2A	0x02	00 01			From the GIS ? LevelCount ?
0x2C	0x02	00 03			From the GIS ? FrameType ? (3 = SEQUENCE)
0x2E	0x02	00 01			From the GIS ? FrameCount ?
0x30	varies	any			optional area to store the contents of <filename>.dat when using the option update_userdata = on
0x30	0x04	00 00 00 40			BitmapAddress ?
0x34	0x04	00 00 00 00
0x38	0x04	00 00 00 00
0x3C	0x04	00 00 00 00

0x05

Related with this setting in GimConvert.cfg ?

palette_format = default	// default rgba8888 rgba4444 rgba5551 rgba5650

0xFF (fileinfo)

This block only exists if the GIM was build using the option update_fileinfo = on. Initially in old PS3 firmwares all the GIM files was made using this option, eventually they stopped using this option and GIM files was updated/replaced by new ones without this area. But there are many GIM files inside latest PS3 4.82 firmware that contains this area (because was made lot of time ago and never was updated), this can be seen in the timestamps stored here, all this GIM files that was build using update_fileinfo = on was made around 2005/2006/2007

Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

000000B0  34 78 32 5F 43 41 35 45 78 79 5F 33 32 62 69 74  4x2_CA5Exy_32bit     <- Block 0xFF Data
000000C0  73 2E 62 6D 70 00 41 64 6D 69 6E 69 73 74 72 61  s.bmp.Administra     <- Block 0xFF Data
000000D0  74 6F 72 00 53 75 6E 20 41 70 72 20 31 35 20 30  tor.Sun Apr 15 0     <- Block 0xFF Data
000000E0  31 3A 32 35 3A 30 32 20 32 30 31 38 00 47 69 6D  1:25:02 2018.Gim     <- Block 0xFF Data
000000F0  43 6F 6E 76 20 31 2E 32 30 68 00 00              Conv 1.20h..         <- Block 0xFF Data

Offset	Length	Example	Name	Description	Notes
0x00	0x16	34 78 32 5F 43 41 35 45 78 79 5F 33 32 62 69 74 73 2E 62 6D 70 00	project_name	4x2_CA5Exy_32bits.bmp	ProjectName in the GIS
0x16	0x0E	41 64 6D 69 6E 69 73 74 72 61 74 6F 72 00	user_name	Administrator	UserName in the GIS
0x24	0x19	53 75 6E 20 41 70 72 20 31 35 20 30 31 3A 32 35 3A 30 32 20 32 30 31 38 00	saved_date	Sun Apr 15 01:25:02 2018	SavedDate in the GIS
0x3D	0x0E	47 69 6D 43 6F 6E 76 20 31 2E 32 30 68 00	originator	GimConv 1.20h	Originator in the GIS
0x4B	0x01	00	padding		Aligned to 4 bytes

Links

• http://www.pujia8.com/articles/34/
• https://tieba.baidu.com/p/1733245285