Editing Graphic Image Map (GIM)

{{wikify}}

=Description=
'''G'''raphic '''I'''mage '''M'''ap ? ('''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 ('''G'''raphic '''I'''mage '''M'''ap) 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 <!-- no luck on facebook https://www.facebook.com/hhhhhyuk? -->

=Structure=

*Overview
 Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
 
 00000000  <span style="background:#666666; color:#ffffff;">2E 47 49 4D</span> <span style="background:#666666; color:#ffffff;">31 2E 30 30</span> <span style="background:#666666; color:#ffffff;">00 50 53 50</span> <span style="background:#666666; color:#ffffff;">00 00 00 00</span>  .GIM1.00.PSP....     <- GIM header
 00000010  <span style="background:#ff9933; color:#ffffff;">00 02</span> <span style="background:#FF4444;">00 00</span> <span style="background:#ffff00;">00 00 00 EC</span> <span style="background:#ffff99;">00 00 00 10</span> <span style="background:#FF4444;">00 00 00 10</span>  .......ì........     <- Block 0x02 header
 00000020  <span style="background:#ff9933; color:#ffffff;">00 03</span> <span style="background:#FF4444;">00 00</span> <span style="background:#ffff00;">00 00 00 80</span> <span style="background:#ffff99;">00 00 00 10</span> <span style="background:#FF4444;">00 00 00 10</span>  .......€........        <- Block 0x03 header
 00000030  <span style="background:#ff9933; color:#ffffff;">00 04</span> <span style="background:#FF4444;">00 00</span> <span style="background:#ffff00;">00 00 00 70</span> <span style="background:#ffff99;">00 00 00 70</span> <span style="background:#FF4444;">00 00 00 10</span>  .......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 <span style="background:#aaaaaa;">00 00 00 00 00 00 00 00 00 00 00 00</span>  ...@............              <- Block 0x04 Info
 00000080  <span style="background:#CA5E24;">CA 5E 11 00 CA 5E 12 00 CA 5E 13 00 CA 5E 14 00</span>  Ê^..Ê^..Ê^..Ê^..              <- Block 0x04 Frame
 00000090  <span style="background:#CA5E24;">CA 5E 21 00 CA 5E 22 00 CA 5E 23 00 CA 5E 24 00</span>  Ê^!.Ê^".Ê^#.Ê^$.              <- Block 0x04 Frame
 000000A0  <span style="background:#ff9933; color:#ffffff;">00 FF</span> <span style="background:#FF4444;">00 00</span> <span style="background:#ffff00;">00 00 00 5C</span> <span style="background:#ffff99;">00 00 00 5C</span> <span style="background:#FF4444;">00 00 00 10</span>  .ÿ.....\...\....        <- Block 0xFF header
 000000B0  <span style="background:#ccaa88;">34 78 32 5F 43 41 35 45 78 79 5F 33 32 62 69 74</span>  4x2_CA5Exy_32bit           <- Block 0xFF Strings
 000000C0  <span style="background:#ccaa88;">73 2E 62 6D 70 00</span> <span style="background:#ddbb99;">41 64 6D 69 6E 69 73 74 72 61</span>  s.bmp.Administra           <- Block 0xFF Strings
 000000D0  <span style="background:#ddbb99;">74 6F 72 00</span> <span style="background:#eeccaa;">53 75 6E 20 41 70 72 20 31 35 20 30</span>  tor.Sun Apr 15 0           <- Block 0xFF Strings
 000000E0  <span style="background:#eeccaa;">31 3A 32 35 3A 30 32 20 32 30 31 38 00</span> <span style="background:#ffddbb;">47 69 6D</span>  1:25:02 2018.Gim           <- Block 0xFF Strings
 000000F0  <span style="background:#ffddbb;">43 6F 6E 76 20 31 2E 32 30 68 00</span> <span style="background:#aaaaaa;">00</span>              Conv 1.20h..               <- Block 0xFF Strings

*Intermediate blocks are aligned to 16 bytes, last block is aligned to 4 bytes

==GIM header==

{| class="wikitable" style="font-size:small;"
|-
! Offset !! Length !! Example !! Name !! Description !! Notes
|-
| 0x00 || 0x04 || 2E 47 49 4D || {{cellcolors|#666666|#ffffff}} '''gim_signature''' || .GIM || 
|-
| 0x04 || 0x04 || 31 2E 30 30 || {{cellcolors|#666666|#ffffff}} '''gim_version''' || 1.00 || 
|-
| 0x08 || 0x04 || 00 50 53 50 || {{cellcolors|#666666|#ffffff}} <abbr title="this is named format_style in gimconv.exe with only 3 options available: std, psp, ps3">'''gim_style'''</abbr> || PSP || 
|-
| 0x0C || 0x04 || 00 00 00 00 || {{cellcolors|#666666|#ffffff}} <abbr title="Always 0x00 ?">''gim_unk''</abbr> || Unknown || 
|}

==Block headers (generic)==

{| class="wikitable" style="font-size:small;"
|-
! Offset !! Length !! Example !! Name !! Description !! Notes
|-
| 0x00 || 0x02 || 00 02 || {{cellcolors|#ff9933|#ffffff}} '''block_id''' || Block identifyer || 0x02 = Root ? (first level)<br>0x03 = Picture (second level)<br>0x04 = Image (third level)<br>0x05 = Palette (third level)<br>0xFF = Fileinfo (second level)
|-
| 0x02 || 0x02 || 00 00 || {{cellcolors|#FF4444}} <abbr title="unknown">''block_unk1''</abbr> || Unknown || 0x00 = ?<br>0x10 = ?
|-
| 0x04 || 0x04 || 00 00 01 0C || {{cellcolors|#ffff00}} '''block_size''' || Size of this block + children blocks || 
|-
| 0x08 || 0x04 || 00 00 00 10 || {{cellcolors|#ffff99}} '''block_next''' || Next block relative offset || 
|-
| 0x0C || 0x04 || 00 00 00 10 || {{cellcolors|#FF4444}} <abbr title="block_data_offset">''block_unk2''</abbr> || Block data relative offset ? || 
|}

==Block data (by block ID)==

===0x02 (Root)===
Empty/unknown. Is the parent of 0x03 and 0x0FF

===0x03 (Picture)===
Empty/unknown. Is the parent of 0x05 and 0x04 (in this order, the palette goes first)

This block is repeated when using the option '''merge_mode picture'''

===0x04 (Image)===
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)

This block is repeated when using the option '''merge_mode image'''

 Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
 
 00000040  <span style="background:#FF4444;">00 30</span> <span style="background:#FF4444;">00 00</span> <span style="background:#3333ff; color:#ffffff;">00 03</span> <span style="background:#6666ff; color:#ffffff;">00 00</span> <span style="background:#0077b3;">00 04</span> <span style="background:#0077b3;">00 02</span> <span style="background:#00aaff;">00 20</span> <span style="background:#ddddff;">00 10</span>  .0........... ..
 00000050  <span style="background:#ddddff;">00 01</span> <span style="background:#FF4444;">00 02</span> <span style="background:#FF4444;">00 00 00 00</span> <span style="background:#cc00cc;">00 00 00 30</span> <span style="background:#cc00cc;">00 00 00 40</span>  ...........0...@
 00000060  <span style="background:#cc00cc;">00 00 00 60</span> <span style="background:#009933;">00 00 00 00</span> <span style="background:#33cc33; color:#ffffff;">00 01</span> <span style="background:#33cc33;">00 01</span> <span style="background:#4dff4d; color:#ffffff;">00 03</span> <span style="background:#4dff4d;">00 01</span>  ...`............
 00000070  <span style="background:#000000; color:#ffffff;">00 00 00 40</span> <span style="background:#aaaaaa;">00 00 00 00 00 00 00 00 00 00 00 00</span>  ...@............

{| class="wikitable" style="font-size:small;"
|-
! Offset !! Length !! Example !! Name !! Description !! Notes
|-
| 0x00 || 0x02 || 00 30 || {{cellcolors|#FF4444}} <abbr title="block 0x04 unknown 1">''b4_unk1''</abbr> || ? || 
|-
| 0x02 || 0x02 || 00 00 || {{cellcolors|#FF4444}} <abbr title="block 0x04 unknown 2">''b4_unk2''</abbr> || ? || 
|-
| colspan="6" {{cellcolors|lightgrey}}
|-
| 0x04 || 0x02 || 00 03 || {{cellcolors|#3333ff|#ffffff}} '''image_format''' || 0x00 = rgba5650<br>0x01 = rgba5551<br>0x02 = rgba4444<br>0x03 = rgba8888<br>0x04 = index4<br>0x05 = index8<br>0x06 = index16<br>0x07 = index32<br>0x08 = dxt1<br>0x09 = dxt3<br>0x0A = dxt5<br>0x108 = dxt1ext<br>0x109 = dxt3ext<br>0x10A = dxt5ext || '''image_format''' in [[GimConv]].cfg<br>'''Format''' in the GIS
|-
| 0x06 || 0x02 || 00 00 || {{cellcolors|#6666ff|#ffffff}} '''pixel_order''' || 0x00 = normal<br>0x01 = faster || '''pixel_order''' in [[GimConv]].cfg with values: normal (default) or faster<br>'''Order''' in the GIS with values: NORMAL or PSPIMAGE
|-
| 0x08 || 0x02 || 00 04 || {{cellcolors|#0077b3}} '''width''' || Image/palette width in pixels || '''Width''' in the GIS
|-
| 0x0A || 0x02 || 00 02 || {{cellcolors|#0077b3}} '''height''' || Image/palette height in pixels || '''Height''' in the GIS
|-
| 0x0C || 0x02 || 00 20 || {{cellcolors|#00aaff}} '''bpp_align''' || Image/palette bits per pixel <abbr title="this value is used tto navigate the GIM structure, doesnt represents the color depth of the image, for indexed colors is used as a counter to know how many color ID there are in the palette">alignment</abbr> || 
|-
| 0x0E || 0x02 || 00 10 || {{cellcolors|#ddddff}} '''pitch_align''' || Image/palette X alignment || '''PitchAlign''' in the GIS
|-
| 0x10 || 0x02 || 00 01 || {{cellcolors|#ddddff}} '''height_align''' || Image/palette Y alignment || '''HeightAlign''' in the GIS
|-
| 0x12 || 0x02 || 00 02 || {{cellcolors|#FF4444}} <abbr title="block 0x04 unknown 3">''b4_unk3''</abbr> ||  || Image/palette '''something''' alignment ?
|-
| 0x14 || 0x04 || 00 00 00 00 || {{cellcolors|#FF4444}} <abbr title="block 0x04 unknown 4">''b4_unk4''</abbr> ||  || Bitmap Prev relative offset ?
|-
| 0x18 || 0x04 || 00 00 00 30 || {{cellcolors|#cc00cc}} '''index_start''' || Index relative start offset || 
|-
| 0x1C || 0x04 || 00 00 00 40 || {{cellcolors|#cc00cc}} '''pixels_start''' || First plane/level/frame relative start offset || 
|-
| 0x20 || 0x04 || 00 00 00 60 || {{cellcolors|#cc00cc}} '''pixels_end''' || Last plane/level/frame relative end offset || 
|-
| colspan="6" {{cellcolors|lightgrey}}
|-
| 0x24 || 0x04 || 00 00 00 00 || {{cellcolors|#009933}} '''plane_mask''' ||  || '''PlaneMask''' in the GIS
|-
| 0x28 || 0x02 || 00 01 || {{cellcolors|#33cc33|#ffffff}} '''level_type''' || 0x01 = MIPMAP<br>0x02 = MIPMAP2 || '''LevelType''' in the GIS
|-
| 0x2A || 0x02 || 00 01 || {{cellcolors|#33cc33}} '''level_count''' || Number of mipmaps (max 8) || '''LevelCount''' in the GIS
|-
| 0x2C || 0x02 || 00 03 || {{cellcolors|#4dff4d|#ffffff}} '''frame_type''' || 0x00 = Illegal ?<br>0x01 = Illegal ?<br>0x02 = Illegal ?<br>0x03 = SEQUENCE || '''FrameType''' in the GIS
|-
| 0x2E || 0x02 || 00 01 || {{cellcolors|#4dff4d}} '''frame_count''' || Number of frames || '''FrameCount''' in the GIS
|-
| colspan="6" {{cellcolors|lightgrey}}
|-
| 0x30 || ''<abbr title="max lenght not confirmed">''any''</abbr>'' || {{cellcolors|lightgrey|#000000|center}} ''N/A'' || {{cellcolors|#aa8866}} '''user_data''' || Optional User Data area || Stores the contents of '''<filename>.dat''' by using the setting '''update_userdata = on'''
|-{{cellcolors|lightgrey}}
| 0x30 || ''<abbr title="0 up to 3">''varies''</abbr>'' || {{cellcolors|lightgrey|#000000|center}} ''N/A'' || {{cellcolors|#aaaaaa}} ''padding''  || Optional padding || To align '''user_data''' to 4 bytes
|}


{| class="wikitable" style="font-size:small;"
|+IMAGE_INDEX (contains IMAGE_PLANE/IMAGE_LEVEL/IMAGE_FRAME) ?<br>PALETTE_INDEX (contains PALETTE_LEVEL/PALETTE_FRAME) ?
! Offset !! Length !! Example !! Name !! Description !! Notes
|-
| 0x30 || 0x04 || 00 00 00 40 || {{cellcolors|#000000|#ffffff}} '''frame_n_offset''' || Where <n> is the frame number || This entry is repeated one time for every '''level_count''' or '''frame_count'''
|-{{cellcolors|lightgrey}}
| 0x34 || 0x0C || <abbr title="00 00 00 00 00 00 00 00 00 00 00 00">00 00 00 ...</abbr> || {{cellcolors|#aaaaaa}} ''padding''  || Optional padding || To align the block to 16 bytes
|}

After this index comes the planes/levels/frames (the bytes with pixels color info), are one or several images concatenated when using the option '''merge_mode level''' or '''merge_mode frame'''. And probably "planes" with the option '''merge_mode = plane'''

 IMAGE_INDEX
 IMAGE_PLANE
 IMAGE_LEVEL
 IMAGE_FRAME
 
 PALETTE_INDEX
 PALETTE_LEVEL
 PALETTE_FRAME

===0x05 (Palette)===
Only used when converting to indexed color formats (index4 index8 index16 index32), to create a GIM with a palette is needed to use as input an image that already contains a palette (so is already indexed), it seems GimConv.exe cant create the palette by itself

By default the palette frame (located most at bottom of the palette), is stored in rgba888 (i guess this can be changed with '''palette_format''' = default // default rgba8888 rgba4444 rgba5551 rgba5650), it has a fixed reserved size of 0x400 (to store a max of 256 colors?), and the "unused" color slots are filled with zeroes <!--and uses LevelType MIPMAP2-->

The palette frame (or lookup table) is stored as an image with 1 pixel height, so by default it has 256x1 pixels size (image_width = 0x100 image_height = 0x1)

===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  <span style="background:#ccaa88;">34 78 32 5F 43 41 35 45 78 79 5F 33 32 62 69 74</span>  4x2_CA5Exy_32bit
 000000C0  <span style="background:#ccaa88;">73 2E 62 6D 70 00</span> <span style="background:#ddbb99;">41 64 6D 69 6E 69 73 74 72 61</span>  s.bmp.Administra
 000000D0  <span style="background:#ddbb99;">74 6F 72 00</span> <span style="background:#eeccaa;">53 75 6E 20 41 70 72 20 31 35 20 30</span>  tor.Sun Apr 15 0
 000000E0  <span style="background:#eeccaa;">31 3A 32 35 3A 30 32 20 32 30 31 38 00</span> <span style="background:#ffddbb;">47 69 6D</span>  1:25:02 2018.Gim
 000000F0  <span style="background:#ffddbb;">43 6F 6E 76 20 31 2E 32 30 68 00</span> <span style="background:#aaaaaa;">00</span>              Conv 1.20h..

{| class="wikitable" style="font-size:small;"
|-
! 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 || {{cellcolors|#ccaa88}} '''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 || {{cellcolors|#ddbb99}} '''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 || {{cellcolors|#eeccaa}} '''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 || {{cellcolors|#ffddbb}} '''originator''' || GimConv 1.20h || '''Originator''' in the GIS
|-{{cellcolors|lightgrey}}
| 0x4B || 0x01 || 00 || {{cellcolors|#aaaaaa}} ''padding'' ||  || Optional padding to align the block to 4 bytes
|}

=Links=
*http://www.pujia8.com/articles/34/
*https://tieba.baidu.com/p/1733245285

{{File Formats}}
<noinclude>[[Category:Main]]</noinclude>