Final Fantasy Inside - User contributions [en]

FF8

2023-03-29T13:00:50Z

Sebanisu: /* Battle files */ Link to list.

= Contents =
=== History ===
Final Fantasy VIII came after the mega hit [[FF7|Final Fantasy VII]], it in itself was a very successful game release for Square. For more on the [[FF8/HistoryOf|history of Final Fantasy VIII read here]]. The Game Engine
* [[FF8/Engine|Final Fantasy VIII's Engine]]
=== Engine constants ===
* [[FF8/Engine_const/BattleFiles|Array of Battle files]]
=== Details of the Game ===
* [[FF8/Kernel|Final Fantasy VIII's Kernel]]
* [[FF8/Variables|Game variables used in scripting]]
* [[FF8/Engine/WorldMapCamera|World map camera]]
* [[FF8/Encounter_Codes|Battle encounters list]]
* [[FF8/String_Encoding|String Encoding]]

=== Media Formats ===
* [[FF8/PlaystationMedia|Final Fantasy VIII PS1]] media information.
* [[FF8/PC_Media|Final Fantasy VIII PC]] media information.
* [[FF8/GameSaveFormat|Final Fantasy VIII Save data]]
 
= File Formats =
=== Movie Files ===
* [[FF8/FileFormat_PAK|[PAK]]] Movie Archives
=== Sound Files ===
* [[FF8/FileFormat_FMT|[FMT]]] Sound Archives
=== Battle files ===
* [[FF8/FileFormat_X|[X]]] Battle Fields
* [[FF8/BS_list|[X]]] Battle Field List.
* [[FF8/FileFormat_DAT|[DAT]]] Battle Models
* [[FF8/BattleStructure|Scene.out]] Battle encounter data
* [[FF8/FileFormat_r0win|r0win.dat]] Winning sequence
* [[FF8/FileFormat_b0wave|b0wave.dat]] Core battle data (Textures+Music+Font)
* [[FF8/FileFormat_TDW|a9btlfnt.bft]] Battle Font (Redirect to TDW)
* [[FF8/FileFormat_magfiles|.mag files]] - MAG files

=== Field files ===
* [[FF8/Field/Script/Opcodes|Opcodes]] Field script opcodes
* [[FF8/FileFormat_MCH|[MCH]]] Field Character Models
* [[FF8/FileFormat_ONE|[ONE]]] Field Character Models Container
* [[FF8/FileFormat_MIM|[MIM]]] Field Background Image Data
* [[FF8/FileFormat_MAP|[MAP]]] Field Background Tile Data
* [[FF8/FileFormat_JSM|[JSM]]] Field Scripts
* [[FF8/FileFormat_SYM|[SYM]]] Field Script names (unused)
* [[FF8/FileFormat_MSD|[MSD]]] Field Dialogs
* [[FF8/FileFormat_INF|[INF]]] Field Gateways
* [[FF7/Field/Walkmesh|[ID]]] Field Walkmesh (same format as FF7)
* [[FF8/FileFormat_CA|[CA]]] Field Camera
* [[FF8/FileFormat_TDW|[TDW]]] Extra font
* [[FF8/FileFormat_MSK|[MSK]]] Movie cam (?)
* [[FF8/FileFormat_RAT_MRT|[RAT]] & [MRT]] Battle related
* [[FF8/FileFormat_PMD|[PMD]]] Particle Info
* [[FF8/FileFormat_PMP|[PMP]]] Particle Image Data
* [[FF8/FileFormat_PVP|[PVP]]] Unknown (often 0x0c000000, sometimes 0x0a000000 or 0x0b000000)
* [[FF8/FileFormat_SFX|[SFX]]] Indexes to Sound Effects (?)

=== World map files ===
* [[FF8/WorldMap_music|music0.obj]]
* [[FF8/WorldMap_music|music1.obj]]
* [[FF8/WorldMap_music|music2.obj]]
* [[FF8/WorldMap_music|music3.obj]]
* [[FF8/WorldMap_music|music4.obj]]
* [[FF8/WorldMap_music|music5.obj]]
* [[FF8/WorldMap_rail|rail.obj]]
* [[FF8/WorldMap_texl|texl.obj]]
* [[FF8/WorldMap_wmset|wmset.obj]]
* [[FF8/WorldMap_wmsetxx|wmsetXX.obj]]
* [[FF8/WorldMap_wmx|wmx.obj]]
* [[FF8/WorldMap_charaone|chara.one]]

=== Main ===
* [[FF8/Main_wm2|wm2field.tbl]]
* [[FF8/Main_kernel|kernel.bin]]
* [[FF8/Main_harata|harata.cnf]]
* [[FF8/Main_init|init.out]]
* [[FF8/Main_namedic|namedic.bin]]
=== Menu ===
* [[FF8/Menu_sp2|*.sp1/*.sp2]]
* [[FF8/Menu_mngrphd_bin|mngrphd.bin]]
* [[FF8/Menu_mngrp_bin|mngrp.bin]]
* [[FF8/Menu_tkmnmes|tkmnmes*.bin]]
* [[Ff8/Menu_mag_textures|mag*.tex]]
* [[FF8/Menu_mngrp_strings_locations|mngrp strings]]
* [[FF8/Menu_mngrp_complex_strings|mngrp complex strings]]
* [[FF8/Menu_m000_m004|m00*.bin and m00*.msg]]
* [[FF8/Menu_areames_dc1|areames.dc1]]
* [[FF8/Menu_price_bin|price.bin]]

= Tools and Patches =
* [[FF8/Tools|Tools and Patches]]

FF8/FileFormat PAK

2020-12-31T17:38:42Z

Sebanisu: /* CAM files */ adding the bit about 3 unknown bytes in cam header.

Final Fantasy VIII's movie files are stored within pak files. This is for the CD 2000 version only. Steam 2013 version uses avi files. '''publish.pak''' contains the message "Published by Square Electronic Arts L.L.C.". '''disc1.pak''', '''disc2.pak''', '''disc3.pak''', and '''disc4.pak''' hold the rest of the FMV movies.

=PAK File Structure=
The PAK file has no header. Each movie usually contains a CAM file and two BINK videos. A PAK file can contain multiple movies. One BINK file is the low res the other is the high res.
{| class="wikitable"
|-
! Section !! Description
|-
| CAM - optional || Camera data
|-
| BINK - high res || FMV video
|-
| BINK - low res || FMV video
|}

===Existing projects you can use to extract the PAK files.===
* https://github.com/MaKiPL/OpenVIII-monogame/tree/master/PAK%20Extractor
* https://github.com/MaKiPL/FF8-Rinoa-s-Toolset/blob/master/SerahToolkit_SharpGL/FF8_Core/PlayMovie.cs
* https://github.com/Sebanisu/OpenVIII_CPP_WIP/tree/master/src/open_viii/pak

==BINK files==
* Start with 0x42494B "BIK"
* More info: https://wiki.multimedia.cx/index.php/Bink_Container

==CAM files==
* Each frame is 44 bytes long.
{| class="wikitable"
|-
! Offset !! Size !! Description
|-
| 0 || 3 bytes || 0x463850 "F8P"
|-
| 3 || 3 bytes || Unknown
|-
| 6 || 2 bytes (uint16) || Approx number of frames. There can be extra data.
|-
| 8 || 44 bytes * number of frames || Frame data. Each frame ends with "END"
|}

Extra info by Kaspar:
The number of frames is always equal to the "approx number" above + 1 (therefore we can consider that approx number as the last frame index if we start counting from 0 ).
The only exception to this is disc03_04 wich contains 3 extra frame data (wich is probably pointless since the whole file contains blank camera animation anyway.

Each Frame data sector is structured this way:

{| class="wikitable"
! Offset
! Size
! Description
|-
| 0
| 6 bytes
| Camera Vector X axis
|-
| 6
| 6 bytes
| Camera Vector Y axis
|-
| 12
| 6 bytes
| Camera Vector Z axis
|-
| 18
| 2 bytes
| Camera Vector Z.z (copy)
|-
| 20
| 4 bytes
| Camera Space X position
|-
| 24
| 4 bytes
| Camera Space Y position
|-
| 28
| 4 bytes
| Camera Space Z position
|-
| 32
| 2 bytes
| Camera Pan X
|-
| 34
| 2 bytes
| Camera Pan Y
|-
| 36
| 2 bytes
| Zoom
|-
| 38
| 2 bytes
| Zoom (Repeated)
|-
| 40
| 1 byte
| Render Mode ('08','10','11' or '50')
|-
| 41
| 3 bytes
| "END" marker
|}

The 4 Render mode seems to be these :

-8 ('08') = render characters over FMV and masks meshes over characters (hiding/masking them)

-16('10') = render characters over FMV (not masked)

-17('11') = don't render characters over FMV

-80('50) = End Transition? (not sure what's this exactly but for sure the character are not rendered with this on)

the 80 mode (when used) is active for the last 4 frame only and seems like it's not used when the fmv transition to the field at the end (eg. attack on Dollet landing or Galbadia Garden intro)

The camera data is really similar to the Field one contained in the .CA files.

Thanks to TrueOdin that bringed them to my attention it looks like beta PC version for FF7 had some cam files too but they were slightly different:

-each frame sector is 40byte size with no 'END' marker

-there is no header so if you want to know the frame count you have to divide the filesize by 40

-Zoom is not repeated

The structure for FF7 .cam sector is something like this :

{| class="wikitable"
! Offset
! Size
! Description
|-
| 0
| 6 bytes
| Camera Vector X axis
|-
| 6
| 6 bytes
| Camera Vector Y axis
|-
| 12
| 6 bytes
| Camera Vector Z axis
|-
| 18
| 2 bytes
| Camera Vector Z.z (copy)
|-
| 20
| 4 bytes
| Camera Space X position
|-
| 24
| 4 bytes
| Camera Space Y position
|-
| 28
| 4 bytes
| Camera Space Z position
|-
| 32
| 2 bytes
| Camera Pan X
|-
| 34
| 2 bytes
| Camera Pan Y
|-
| 36
| 2 bytes
| Zoom
|-
| 38
| 2 bytes
| Unknown (Xx Repeated? not sure, need check)
|}

If someone is willing to create a ff7 wiki page for this feel free to move this last part there.

== Pak File Details ==
The filenames are based on the 2013 name scheme. I am using '''h''' suffix for high res and '''l''' suffix for low res. Disc numbers go from 0-3. And 4 being for extra videos not fmv related.
===== disc1.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc00_00.cam||326||0||14352||F8P
|-
|disc00_00h.bik||326||3810||5759124||BIK
|-
|disc00_00l.bik||326||5818a4||2498748||BIK
|-
|disc00_01.cam||199||7e3960||8764||F8P
|-
|disc00_01h.bik||205||7e5b9c||3572420||BIK
|-
|disc00_01l.bik||205||b4de60||1522312||BIK
|-
|disc00_02.cam||161||cc18e8||7092||F8P
|-
|disc00_02h.bik||161||cc349c||2805776||BIK
|-
|disc00_02l.bik||161||f704ac||1410720||BIK
|-
|disc00_03.cam||1100||10c8b4c||48408||F8P
|-
|disc00_03h.bik||1100||10d4864||19654004||BIK
|-
|disc00_03l.bik||1100||2392dd8||8597316||BIK
|-
|disc00_04.cam||215||2bc5d1c||9468||F8P
|-
|disc00_04h.bik||215||2bc8218||3778948||BIK
|-
|disc00_04l.bik||215||2f62b9c||1628944||BIK
|-
|disc00_05.cam||1114||30f06ac||49024||F8P
|-
|disc00_05h.bik||1114||30fc62c||20063552||BIK
|-
|disc00_05l.bik||1114||441eb6c||8923620||BIK
|-
|disc00_06.cam||41||4ca1550||1812||F8P
|-
|disc00_06h.bik||41||4ca1c64||757108||BIK
|-
|disc00_06l.bik||41||4d5a9d8||347236||BIK
|-
|disc00_07.cam||1084||4daf63c||47704||F8P
|-
|disc00_07h.bik||1084||4dbb094||19696056||BIK
|-
|disc00_07l.bik||1084||6083a4c||8855428||BIK
|-
|disc00_08.cam||324||68f59d0||14264||F8P
|-
|disc00_08h.bik||324||68f9188||4736972||BIK
|-
|disc00_08l.bik||324||6d7d954||2073440||BIK
|-
|disc00_09.cam||1391||6f77cb4||61212||F8P
|-
|disc00_09h.bik||1391||6f86bd0||24180228||BIK
|-
|disc00_09l.bik||1391||86961d4||10270268||BIK
|-
|disc00_10.cam||393||9061810||17300||F8P
|-
|disc00_10h.bik||393||9065ba4||7195820||BIK
|-
|disc00_10l.bik||393||9742850||3265804||BIK
|-
|disc00_11.cam||465||9a5fd5c||20468||F8P
|-
|disc00_11h.bik||465||9a64d50||8496456||BIK
|-
|disc00_11l.bik||465||a27f298||3846440||BIK
|-
|disc00_12.cam||45||a62a3c0||1988||F8P
|-
|disc00_12h.bik||45||a62ab84||752040||BIK
|-
|disc00_12l.bik||45||a6e252c||300964||BIK
|-
|disc00_13.cam||15||a72bcd0||668||F8P
|-
|disc00_13h.bik||15||a72bf6c||249788||BIK
|-
|disc00_13l.bik||15||a768f28||99988||BIK
|-
|disc00_14.cam||360||a7815bc||15848||F8P
|-
|disc00_14h.bik||360||a7853a4||6369460||BIK
|-
|disc00_14l.bik||360||ad98458||2769344||BIK
|-
|disc00_15.cam||300||b03c618||13208||F8P
|-
|disc00_15h.bik||300||b03f9b0||5236916||BIK
|-
|disc00_15l.bik||300||b53e264||2236992||BIK
|-
|disc00_16.cam||150||b7604a4||6608||F8P
|-
|disc00_16h.bik||150||b761e74||2776716||BIK
|-
|disc00_16l.bik||150||ba07d00||1276724||BIK
|-
|disc00_17.cam||890||bb3f834||39168||F8P
|-
|disc00_17h.bik||890||bb49134||15823644||BIK
|-
|disc00_17l.bik||890||ca60450||8111120||BIK
|-
|disc00_18.cam||191||d21c860||8412||F8P
|-
|disc00_18h.bik||192||d21e93c||3436444||BIK
|-
|disc00_18l.bik||192||d5658d8||1772548||BIK
|-
|disc00_19.cam||121||d7164dc||5332||F8P
|-
|disc00_19h.bik||121||d7179b0||2155424||BIK
|-
|disc00_19l.bik||121||d925d50||944536||BIK
|-
|disc00_20.cam||401||da0c6e8||17652||F8P
|-
|disc00_20h.bik||401||da10bdc||7142436||BIK
|-
|disc00_20l.bik||401||e0e0800||3132744||BIK
|-
|disc00_21.cam||829||e3dd548||36484||F8P
|-
|disc00_21h.bik||829||e3e63cc||14983636||BIK
|-
|disc00_21l.bik||829||f2305a0||6743692||BIK
|-
|disc00_22.cam||141||f89ec2c||6212||F8P
|-
|disc00_22h.bik||141||f8a0470||2585084||BIK
|-
|disc00_22l.bik||141||fb1766c||1175040||BIK
|-
|disc00_23.cam||550||fc3646c||24208||F8P
|-
|disc00_23h.bik||550||fc3c2fc||9986472||BIK
|-
|disc00_23l.bik||550||105c24a4||4486592||BIK
|-
|disc00_24.cam||575||10a09a64||25308||F8P
|-
|disc00_24h.bik||575||10a0fd40||10441380||BIK
|-
|disc00_24l.bik||575||11404fe4||4692084||BIK
|-
|disc00_25.cam||130||1187e858||5728||F8P
|-
|disc00_25h.bik||130||1187feb8||2438880||BIK
|-
|disc00_25l.bik||130||11ad3598||1140268||BIK
|-
|disc00_26.cam||101||11be9bc4||4452||F8P
|-
|disc00_26h.bik||101||11bead28||1792576||BIK
|-
|disc00_26l.bik||101||11da0768||783064||BIK
|-
|disc00_27.cam||306||11e5fa40||13472||F8P
|-
|disc00_27h.bik||306||11e62ee0||5574568||BIK
|-
|disc00_27l.bik||306||123b3e88||2513668||BIK
|-
|disc00_28.cam||432||1261998c||19016||F8P
|-
|disc00_28h.bik||432||1261e3d4||7643824||BIK
|-
|disc00_28l.bik||432||12d68684||3323692||BIK
|-
|disc00_29.cam||750||13093db0||33008||F8P
|-
|disc00_29h.bik||750||1309bea0||13517424||BIK
|-
|disc00_29l.bik||750||13d80110||6015936||BIK
|-
|disc00_30.cam||2897||1433ccd0||127476||F8P
|-
|disc00_30h.bik||2925||1435bec4||49898052||BIK
|-
|disc00_30l.bik||2925||172f2108||22289504||BIK
|}
===== disc2.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc01_00.cam||453||0||19940||F8P
|-
|disc01_00h.bik||453||4de4||8128812||BIK
|-
|disc01_00l.bik||453||7c5710||3597828||BIK
|-
|disc01_01.cam||278||b33d14||12240||F8P
|-
|disc01_01h.bik||278||b36ce4||4869600||BIK
|-
|disc01_01l.bik||278||fdbac4||2060252||BIK
|-
|disc01_02.cam||330||11d2aa0||14528||F8P
|-
|disc01_02h.bik||330||11d6360||5962524||BIK
|-
|disc01_02l.bik||330||1785e7c||2662428||BIK
|-
|disc01_03.cam||450||1a0fe98||19808||F8P
|-
|disc01_03h.bik||450||1a14bf8||8227052||BIK
|-
|disc01_03l.bik||450||21ed4e4||3724748||BIK
|-
|disc01_04.cam||168||257aab0||7400||F8P
|-
|disc01_04h.bik||168||257c798||3036032||BIK
|-
|disc01_04l.bik||168||2861b18||1356172||BIK
|-
|disc01_05.cam||219||29acca4||9644||F8P
|-
|disc01_05h.bik||219||29af250||4033920||BIK
|-
|disc01_05l.bik||219||2d87fd0||1843800||BIK
|-
|disc01_06.cam||104||2f4a228||4584||F8P
|-
|disc01_06h.bik||104||2f4b410||1894044||BIK
|-
|disc01_06l.bik||104||3119aac||853980||BIK
|-
|disc01_07.cam||160||31ea288||7048||F8P
|-
|disc01_07h.bik||160||31ebe10||2909428||BIK
|-
|disc01_07l.bik||160||34b2304||1309396||BIK
|-
|disc01_08.cam||381||35f1dd8||16772||F8P
|-
|disc01_08h.bik||381||35f5f5c||6936652||BIK
|-
|disc01_08l.bik||381||3c937a8||3126604||BIK
|-
|disc01_09.cam||226||3f8ecf4||9952||F8P
|-
|disc01_09h.bik||226||3f913d4||4177224||BIK
|-
|disc01_09l.bik||226||438d11c||1917924||BIK
|-
|disc01_10.cam||416||4561500||18312||F8P
|-
|disc01_10h.bik||416||4565c88||7604492||BIK
|-
|disc01_10l.bik||416||4ca6594||3444452||BIK
|-
|disc01_11.cam||603||4fef478||26540||F8P
|-
|disc01_11h.bik||603||4ff5c24||10981628||BIK
|-
|disc01_11l.bik||603||5a6ed20||4951152||BIK
|-
|disc01_12.cam||335||5f27990||14748||F8P
|-
|disc01_12h.bik||335||5f2b32c||6173264||BIK
|-
|disc01_12l.bik||335||650e57c||2823184||BIK
|-
|disc01_13.cam||381||67bf98c||16772||F8P
|-
|disc01_13h.bik||381||67c3b10||6843600||BIK
|-
|disc01_13l.bik||381||6e4a7e0||3034044||BIK
|-
|disc01_14.cam||531||712f39c||23372||F8P
|-
|disc01_14h.bik||531||7134ee8||9498260||BIK
|-
|disc01_14l.bik||531||7a43d7c||4188788||BIK
|-
|disc01_15.cam||120||7e427f0||5288||F8P
|-
|disc01_15h.bik||120||7e43c98||2224344||BIK
|-
|disc01_15l.bik||120||8062d70||1024412||BIK
|-
|disc01_16.cam||149||815cf0c||6564||F8P
|-
|disc01_16h.bik||149||815e8b0||2754272||BIK
|-
|disc01_16l.bik||149||83fef90||1264204||BIK
|-
|disc01_17.cam||150||85339dc||6608||F8P
|-
|disc01_17h.bik||150||85353ac||2722300||BIK
|-
|disc01_17l.bik||150||87cdda8||1221752||BIK
|-
|disc01_18.cam||255||88f8220||11228||F8P
|-
|disc01_18h.bik||255||88fadfc||4656768||BIK
|-
|disc01_18l.bik||255||8d6bc7c||2106780||BIK
|-
|disc01_19.cam||428||8f6e218||18840||F8P
|-
|disc01_19h.bik||428||8f72bb0||7841392||BIK
|-
|disc01_19l.bik||428||96ed220||3561280||BIK
|-
|disc01_20.cam||150||9a52960||6608||F8P
|-
|disc01_20h.bik||150||9a54330||2667756||BIK
|-
|disc01_20l.bik||150||9cdf81c||1168116||BIK
|-
|disc01_21.cam||75||9dfcb10||3308||F8P
|-
|disc01_21h.bik||75||9dfd7fc||1396348||BIK
|-
|disc01_21l.bik||75||9f52678||646296||BIK
|-
|disc01_22.cam||120||9ff0310||5288||F8P
|-
|disc01_22h.bik||120||9ff17b8||2132696||BIK
|-
|disc01_22l.bik||120||a1fa290||932544||BIK
|-
|disc01_23.cam||285||a2ddd50||12548||F8P
|-
|disc01_23h.bik||285||a2e0e54||5164156||BIK
|-
|disc01_23l.bik||285||a7cdad0||2314168||BIK
|-
|disc01_24.cam||330||aa02a88||14528||F8P
|-
|disc01_24h.bik||330||aa06348||6084528||BIK
|-
|disc01_24l.bik||330||afd3af8||2784636||BIK
|-
|disc01_25.cam||300||b27b874||13208||F8P
|-
|disc01_25h.bik||300||b27ec0c||5413124||BIK
|-
|disc01_25l.bik||300||b7a8510||2413380||BIK
|-
|disc01_26.cam||120||b9f5854||5288||F8P
|-
|disc01_26h.bik||120||b9f6cfc||2180104||BIK
|-
|disc01_26l.bik||120||bc0b104||980208||BIK
|-
|disc01_27.cam||75||bcfa5f4||3308||F8P
|-
|disc01_27h.bik||75||bcfb2e0||1345552||BIK
|-
|disc01_27l.bik||75||be43af0||595492||BIK
|-
|disc01_28.cam||120||bed5114||5288||F8P
|-
|disc01_28h.bik||120||bed65bc||2180512||BIK
|-
|disc01_28l.bik||120||c0eab5c||980596||BIK
|-
|disc01_29.cam||692||c1da1d0||30456||F8P
|-
|disc01_29h.bik||692||c1e18c8||12448828||BIK
|-
|disc01_29l.bik||692||cdc0d04||5528956||BIK
|-
|disc01_30.cam||120||d306a80||5288||F8P
|-
|disc01_30h.bik||120||d307f28||2194876||BIK
|-
|disc01_30l.bik||120||d51fce4||994700||BIK
|-
|disc01_31.cam||135||d612a70||5948||F8P
|-
|disc01_31h.bik||135||d6141ac||2480668||BIK
|-
|disc01_31l.bik||135||d871bc8||1130648||BIK
|-
|disc01_32.cam||327||d985c60||14396||F8P
|-
|disc01_32h.bik||327||d98949c||5902052||BIK
|-
|disc01_32l.bik||327||df2a380||2628608||BIK
|-
|disc01_33.cam||1186||e1abf80||52192||F8P
|-
|disc01_33h.bik||1186||e1b8b60||21305376||BIK
|-
|disc01_33l.bik||1186||f60a380||9445316||BIK
|}
===== disc3.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc02_00.cam||197||0||8676||F8P
|-
|disc02_00h.bik||197||21e4||3641072||BIK
|-
|disc02_00l.bik||197||37b0d4||1670856||BIK
|-
|disc02_01.cam||472||512f9c||20776||F8P
|-
|disc02_01h.bik||472||5180c4||8222124||BIK
|-
|disc02_01l.bik||472||cef670||3725124||BIK
|-
|disc02_02.cam||105||107cdb4||4628||F8P
|-
|disc02_02h.bik||105||107dfc8||1970280||BIK
|-
|disc02_02l.bik||105||125f030||919644||BIK
|-
|disc02_03.cam||105||133f88c||4628||F8P
|-
|disc02_03h.bik||105||1340aa0||1958900||BIK
|-
|disc02_03l.bik||105||151ee94||909292||BIK
|-
|disc02_04.cam||106||15fce80||4672||F8P
|-
|disc02_04h.bik||106||15fe0c0||1887824||BIK
|-
|disc02_04l.bik||106||17caf10||827636||BIK
|-
|disc02_05.cam||106||1895004||4672||F8P
|-
|disc02_05h.bik||106||1896244||1887052||BIK
|-
|disc02_05l.bik||106||1a62d90||827048||BIK
|-
|disc02_06.cam||110||1b2cc38||4848||F8P
|-
|disc02_06h.bik||110||1b2df28||2008528||BIK
|-
|disc02_06l.bik||110||1d184f8||908540||BIK
|-
|disc02_07.cam||300||1df61f4||13208||F8P
|-
|disc02_07h.bik||300||1df958c||5197180||BIK
|-
|disc02_07l.bik||300||22ee308||2299856||BIK
|-
|disc02_08.cam||75||251fad8||3308||F8P
|-
|disc02_08h.bik||75||25207c4||1331060||BIK
|-
|disc02_08l.bik||75||2665738||580980||BIK
|-
|disc02_09.cam||728||26f34ac||32040||F8P
|-
|disc02_09h.bik||728||26fb1d4||13015424||BIK
|-
|disc02_09l.bik||728||3364b54||5734772||BIK
|-
|disc02_10.cam||120||38dccc8||5288||F8P
|-
|disc02_10h.bik||120||38de170||2201640||BIK
|-
|disc02_10l.bik||120||3af7998||1001672||BIK
|-
|disc02_11.cam||315||3bec260||13868||F8P
|-
|disc02_11h.bik||315||3bef88c||5698360||BIK
|-
|disc02_11l.bik||315||415ebc4||2548364||BIK
|-
|disc02_12.cam||226||43cce50||9952||F8P
|-
|disc02_12h.bik||226||43cf530||4078040||BIK
|-
|disc02_12l.bik||226||47b2f08||1818104||BIK
|-
|disc02_13.cam||611||496ed00||26892||F8P
|-
|disc02_13h.bik||611||497560c||10918000||BIK
|-
|disc02_13l.bik||611||53dee7c||4793772||BIK
|-
|disc02_14.cam||105||5871428||4628||F8P
|-
|disc02_14h.bik||105||587263c||1924220||BIK
|-
|disc02_14l.bik||105||5a482b8||874880||BIK
|-
|disc02_15.cam||255||5b1dc38||11228||F8P
|-
|disc02_15h.bik||255||5b20814||4525952||BIK
|-
|disc02_15l.bik||255||5f71794||2026736||BIK
|-
|disc02_16.cam||233||6160484||10260||F8P
|-
|disc02_16h.bik||233||6162c98||4248316||BIK
|-
|disc02_16l.bik||233||656ff94||1918400||BIK
|-
|disc02_17.cam||90||6744554||3968||F8P
|-
|disc02_17h.bik||90||67454d4||1628548||BIK
|-
|disc02_17l.bik||90||68d2e58||728508||BIK
|-
|disc02_18.cam||90||6984c14||3968||F8P
|-
|disc02_18h.bik||90||6985b94||1614036||BIK
|-
|disc02_18l.bik||90||6b0fc68||714012||BIK
|-
|disc02_19.cam||162||6bbe184||7136||F8P
|-
|disc02_19h.bik||162||6bbfd64||2733948||BIK
|-
|disc02_19l.bik||162||6e5b4e0||1195420||BIK
|-
|disc02_20.cam||275||6f7f27c||12108||F8P
|-
|disc02_20h.bik||275||6f821c8||4904472||BIK
|-
|disc02_20l.bik||275||742f7e0||2154376||BIK
|-
|disc02_21.cam||280||763d768||12328||F8P
|-
|disc02_21h.bik||280||7640790||4514208||BIK
|-
|disc02_21l.bik||280||7a8e930||1987908||BIK
|-
|disc02_22.cam||90||7c73e74||3968||F8P
|-
|disc02_22h.bik||90||7c74df4||1650640||BIK
|-
|disc02_22l.bik||90||7e07dc4||750740||BIK
|-
|disc02_23.cam||200||7ebf258||8808||F8P
|-
|disc02_23h.bik||200||7ec14c0||3558312||BIK
|-
|disc02_23l.bik||200||8226068||1558340||BIK
|-
|disc02_24.cam||600||83a27ac||26408||F8P
|-
|disc02_24h.bik||600||83a8ed4||10585392||BIK
|-
|disc02_24l.bik||600||8dc1404||4585408||BIK
|-
|disc02_25.cam||30||9220bc4||1328||F8P
|-
|disc02_25h.bik||30||92210f4||559944||BIK
|-
|disc02_25l.bik||30||92a9c3c||256904||BIK
|-
|disc02_26.cam||410||92e87c4||18048||F8P
|-
|disc02_26h.bik||410||92ece44||7479808||BIK
|-
|disc02_26l.bik||410||9a0f044||3401948||BIK
|-
|disc02_27.cam||130||9d4d920||5728||F8P
|-
|disc02_27h.bik||130||9d4ef80||2423808||BIK
|-
|disc02_27l.bik||130||9f9eb80||1123796||BIK
|-
|disc02_28.cam||376||a0b1154||16552||F8P
|-
|disc02_28h.bik||376||a0b51fc||6874028||BIK
|-
|disc02_28l.bik||376||a7435a8||3114128||BIK
|-
|disc02_29.cam||395||aa3ba38||17388||F8P
|-
|disc02_29h.bik||395||aa3fe24||7284036||BIK
|-
|disc02_29l.bik||395||b132368||3334088||BIK
|-
|disc02_30.cam||625||b460330||27508||F8P
|-
|disc02_30h.bik||625||b466ea4||11211932||BIK
|-
|disc02_30l.bik||625||bf18340||4961628||BIK
|-
|disc02_31.cam||995||c3d389c||43788||F8P
|-
|disc02_31h.bik||995||c3de3a8||17959496||BIK
|-
|disc02_31l.bik||995||d4fedf0||8009592||BIK
|}
===== disc4.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc03_00.cam||390||0||17168||F8P
|-
|disc03_00h.bik||390||4310||7076980||BIK
|-
|disc03_00l.bik||390||6c3f84||3177212||BIK
|-
|disc03_01.cam||1260||9cba80||55448||F8P
|-
|disc03_01h.bik||1260||9d9318||22713736||BIK
|-
|disc03_01l.bik||1260||1f828a0||10113788||BIK
|-
|disc03_02.cam||285||2927b9c||12548||F8P
|-
|disc03_02h.bik||285||292aca0||5103348||BIK
|-
|disc03_02l.bik||285||2e08b94||2252028||BIK
|-
|disc03_03.cam||225||302e890||9908||F8P
|-
|disc03_03h.bik||225||3030f44||4064732||BIK
|-
|disc03_03l.bik||225||3411520||1814904||BIK
|-
|disc03_04.cam||4348||35cc698||191320||F8P
|-
|disc03_04h.bik||4345||35fb1f0||75274524||BIK
|-
|disc03_04l.bik||4345||7dc4b0c||32520396||BIK
|-
|disc03_05.cam||3065||9cc83d8||134868||F8P
|-
|disc03_05h.bik||3065||9ce92ac||28030204||BIK
|-
|disc03_05l.bik||3065||b7a47a8||15064748||BIK
|-
|disc03_06.cam||7091||c602654||312012||F8P
|-
|disc03_06h.bik||7091||c64e920||124325396||BIK
|-
|disc03_06l.bik||7091||13cdf734||55224860||BIK
|}
===== publish.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc04_00h.bik||117||0||196276||BIK
|-
|disc04_00l.bik||117||2feb4||86240||BIK
|}

FF8/FileFormat X

2020-12-23T18:55:57Z

Sebanisu: /* 0 Default */ fix size of animation frame

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Pointers count. Fixed (02 00) '''[Unused in code]'''
|-
| 2
| uInt16
| Relative jump to CameraSetting. Should be (08 00)
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection. Should be (20 00)
|-
| 6
| uInt16
| Camera data size (starting from 0) '''[unused in code]'''
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
Seems to be 8 pointers in each set.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

== Camera Animation (WIP) ==
All this is based on best effort knowledge from reversing by Maki. I'm just trying to understand it.
=== Control Word ===
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t (bit varies)
| Main controller. If 0xFFFFU END
|}
==== FOV ====
Control Word & 0b0000'0000'1100'0000U
===== 1 Default =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| None
| None
| Start = 0x200
|-
| None
| None
| End = 0x200
|}
===== 2 Same =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| Padding
|-
| None
| None
| End = Start
|}
===== 2 Different =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| Padding
|-
| 4
| uint16_t
| End
|}

==== ROLL ====
Control Word & 0b0000'0011'0000'0000U
===== 0 Unknown =====
TODO
===== 1 Default =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| None
| None
| Start = 0x000
|-
| None
| None
| End = 0x000
|}
===== 2 Same =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| None
| None
| End = Start
|}
===== 2 Different =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| End
|}

==== LAYOUT ====
Control Word & 0b0000'0000'0000'0001U
===== 0 Default =====
You'll loop through the data till the first value is less than 0. pushing back to a variable length container.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| int16_t
| if < 0 break; could be related to time of frame.
|-
| 2
| 16 bytes
| Animation Frame
|}

===== 1 Other =====
TODO
===Time===
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.
=== Animation Frame ===
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| is frame durations shot
|-
| 2
| Vertice<uint16_t> (x,y,z)
| World
|-
| 8
| uint16_t
| is frame ending shot
|-
| 10
| Vertice<uint16_t> (x,y,z)
| Look At
|}

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-12-23T18:54:24Z

Sebanisu: /* Animation Frame */

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Pointers count. Fixed (02 00) '''[Unused in code]'''
|-
| 2
| uInt16
| Relative jump to CameraSetting. Should be (08 00)
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection. Should be (20 00)
|-
| 6
| uInt16
| Camera data size (starting from 0) '''[unused in code]'''
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
Seems to be 8 pointers in each set.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

== Camera Animation (WIP) ==
All this is based on best effort knowledge from reversing by Maki. I'm just trying to understand it.
=== Control Word ===
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t (bit varies)
| Main controller. If 0xFFFFU END
|}
==== FOV ====
Control Word & 0b0000'0000'1100'0000U
===== 1 Default =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| None
| None
| Start = 0x200
|-
| None
| None
| End = 0x200
|}
===== 2 Same =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| Padding
|-
| None
| None
| End = Start
|}
===== 2 Different =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| Padding
|-
| 4
| uint16_t
| End
|}

==== ROLL ====
Control Word & 0b0000'0011'0000'0000U
===== 0 Unknown =====
TODO
===== 1 Default =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| None
| None
| Start = 0x000
|-
| None
| None
| End = 0x000
|}
===== 2 Same =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| None
| None
| End = Start
|}
===== 2 Different =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| End
|}

==== LAYOUT ====
Control Word & 0b0000'0000'0000'0001U
===== 0 Default =====
You'll loop through the data till the first value is less than 0. pushing back to a variable length container.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| int16_t
| if < 0 break; could be related to time of frame.
|-
| 2
| 28 bytes
| Animation Frame
|}
===== 1 Other =====
TODO
===Time===
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.
=== Animation Frame ===
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| is frame durations shot
|-
| 2
| Vertice<uint16_t> (x,y,z)
| World
|-
| 8
| uint16_t
| is frame ending shot
|-
| 10
| Vertice<uint16_t> (x,y,z)
| Look At
|}

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-12-23T18:40:42Z

Sebanisu: /* Camera Animation (WIP) */ I'm trying to fix this.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Pointers count. Fixed (02 00) '''[Unused in code]'''
|-
| 2
| uInt16
| Relative jump to CameraSetting. Should be (08 00)
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection. Should be (20 00)
|-
| 6
| uInt16
| Camera data size (starting from 0) '''[unused in code]'''
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
Seems to be 8 pointers in each set.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

== Camera Animation (WIP) ==
All this is based on best effort knowledge from reversing by Maki. I'm just trying to understand it.
=== Control Word ===
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t (bit varies)
| Main controller. If 0xFFFFU END
|}
==== FOV ====
Control Word & 0b0000'0000'1100'0000U
===== 1 Default =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| None
| None
| Start = 0x200
|-
| None
| None
| End = 0x200
|}
===== 2 Same =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| Padding
|-
| None
| None
| End = Start
|}
===== 2 Different =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| Padding
|-
| 4
| uint16_t
| End
|}

==== ROLL ====
Control Word & 0b0000'0011'0000'0000U
===== 0 Unknown =====
TODO
===== 1 Default =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| None
| None
| Start = 0x000
|-
| None
| None
| End = 0x000
|}
===== 2 Same =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| None
| None
| End = Start
|}
===== 2 Different =====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16_t
| Start
|-
| 2
| uint16_t
| End
|}

==== LAYOUT ====
Control Word & 0b0000'0000'0000'0001U
===== 0 Default =====
You'll loop through the data till the first value is less than 0. pushing back to a variable length container.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| int16_t
| if < 0 break; could be related to time of frame.
|-
| 2
| 28 bytes
| Animation Frame
|}
===== 1 Other =====
TODO
===Time===
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.
=== Animation Frame ===
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| int16_t
| is frame durations shot
|-
| 2
| Vertice<uint16_t> (x,y,z)
| World
|-
| 8
| int16_t
| is frame ending shot
|-
| 10
| Vertice<uint16_t> (x,y,z)
| Look At
|}

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-12-16T17:16:02Z

Sebanisu: /* CameraAnimationSet */

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Pointers count. Fixed (02 00) '''[Unused in code]'''
|-
| 2
| uInt16
| Relative jump to CameraSetting. Should be (08 00)
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection. Should be (20 00)
|-
| 6
| uInt16
| Camera data size (starting from 0) '''[unused in code]'''
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
Seems to be 8 pointers in each set.
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-12-16T17:15:10Z

Sebanisu: /* CameraAnimationSet */

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Pointers count. Fixed (02 00) '''[Unused in code]'''
|-
| 2
| uInt16
| Relative jump to CameraSetting. Should be (08 00)
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection. Should be (20 00)
|-
| 6
| uInt16
| Camera data size (starting from 0) '''[unused in code]'''
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

Seems to be 8 pointers in each set.

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/Variables

2020-12-05T20:03:09Z

Sebanisu: Fixed the link to the cheat engine table and adjusted formatting of Notes

By [[User:Shard|Shard]].

Game variables can be accessed using the PSHM family of script functions, and can be written to by using the POPM family of functions. Which one you use depends on the size of the variable.
The variables are all stored in save files, with the save block starting at address 0xD10 on uncompressed PC saves. The parameter to access a variable in the game scripts is basically the offset from this point in the variable block. For example, getting main story progress (word 256, which is word 0x100 in hex) just gets the two bytes starting at address 0xD10 + 0x100 = 0xE10. The varmap is continuous in memory while the game is running as well. In the en-US version of the original and SE releases (and likely most other versions), the varblock begins at 0x18fe9b8. You can use this [https://www.mediafire.com/?ucolf65ewq1yoty Cheat Engine Table] to track them as you play.

Items in grey are unused by field scripts (some of them may be used in battle scripts).
{| class="wikitable"
|-
! Var type
! Var Number
! Description
|-
! Byte
| 0-3
| unused in fields (always "FF-8")
|-
! Long
| 4
| Steps (used to generate random encounters)
|-
! Long
| 8
| Payslip
|-
! Byte
| 12-15
| unused in fields
|-
! Signed Word
| 16
| SeeD rank points?
|-
! Byte
| 18-19
| unused in fields
|-
! Long
| 20
| Battles won. (Fun fact: this affects the basketball shot in Trabia.)
|-
! Byte
| 24-25
| unused in fields
|-
! Word
| 26
| Battles escaped.
|-
! Word
| 28
| Enemies killed by Squall
|-
! Word
| 30
| Enemies killed by Zell
|-
! Word
| 32
| Enemies killed by Irvine
|-
! Word
| 34
| Enemies killed by Quistis
|-
! Word
| 36
| Enemies killed by Rinoa
|-
! Word
| 38
| Enemies killed by Selphie
|-
! Word
| 40
| Enemies killed by Seifer
|-
! Word
| 42
| Enemies killed by Edea
|-
! Word
| 44
| Squall death count
|-
! Word
| 46
| Zell death count
|-
! Word
| 48
| Irvine death count
|-
! Word
| 50
| Quistis death count
|-
! Word
| 52
| Rinoa death count
|-
! Word
| 54
| Selphie death count
|-
! Word
| 56
| Seifer death count
|-
! Word
| 58
| Edea death count
|-
! Byte
| 60-67
| unused in fields
|-
! Long
| 68
| Enemies killed
|-
! Long
| 72
| Amount of Gil the party currently has
|-
! Long
| 76
| Amount of Gil Laguna's party has
|-
! Long
| 80
| Counts the number of frames since the current movie started playing.
|-
! Word
| 84
| Last area visited.
|-
! Signed Byte
| 86
| Current car rent.
|-
! Signed Byte
| 87
| Built-in engine variable. No idea what it does. Scripts always check if it's equal to 0 or 10. Related to music.
|-
! Signed Byte
| 88
| Built-in engine variable. Used exclusively on save points. Never written to with field scripts. Related to Siren's Move-Find ability.
|-
! Byte
| 89-103
| unused in fields
|-
! Long
| 104
| Seems related to SARALYDISPON/SARALYON/MUSICLOAD/PHSPOWER opcodes
|-
! Long
| 108
| Music related
|-
! Long
| 112
| unused in fields
|-
! Byte
| 116-147
| Draw points in field
|-
! Byte
| 148-179
| Draw points in worldmap
|-
! Byte
| 180-255
| unused in fields
|-
! Word
| 256
| Main Story quest progress.
|-
! Byte
| 258
| not investigated
|-
! Byte
| 259-260
| unused in fields
|-
! Byte
| 261
| not investigated
|-
! Byte
| 262-263
| unused in fields
|-
! Byte
| 264
| not investigated
|-
! Byte
| 265
| not investigated
|-
! Byte
| 266
| World map version? (3=Esthar locations unlocked)
|-
! Byte
| 267
| unused in fields
|-
! Byte
| 268
| not investigated
|-
! Byte
| 269
| not investigated
|-
! Byte
| 270
| not investigated
|-
! Byte
| 271
| unused in fields
|-
! Byte
| 272-299
| SO MANY F***ING CARD GAME VARIABLES
|-
! Byte
| 300
| Card Queen re-cards.
|-
! Byte
| 301-303
| unused in fields
|-
! Byte
| 304-305
| Timber Maniacs issues found.
|-
! Byte
| 306-319
| Reserved for Hacktuar / FF8Voice
|-
! Byte
| 320-332
| Ultimecia Gallery related (pictures viewed?)
|-
! Byte
| 333
| Ultimecia Armory chest flags
|-
! Byte
| 334
| Ultimecia Castle seals. See [[FF8/Field/Script/Opcodes/159_SEALEDOFF|SEALEDOFF]] for details.
|-
! Byte
| 335
| Card related
|-
! Byte
| 336
| Deling City bus related
|-
! Byte
| 338-340
| Deling Sewer gates opened
|-
! Byte
| 341
| Does lots of things.5
|-
! Byte
| 342
| Deling City bus system
|-
! Byte
| 343
| G-Garden door/event flags.
|-
! Byte
| 344
| B-Garden / G-Garden event flags (during GvG)
|-
! Byte
| 345
| G-Garden door/event flags.
|-
! Byte
| 346-349
| FH Instrument (346 Zell, 347 Irvine, 348 Selphie, 349 Quistis)
|-
! Word
| 350-356
| Health Bars (Garden mech fight)
|-
! Byte
| 358
| Space station talk flags, Centra ruins related (beat odin?).
|-
! Byte
| 359
| Centra ruins related (beat odin?).
|-
! Long
| 360
| Choice of FH music.
|-
! Byte
| 364-368
| Randomly generated code for Centra Ruins.
|-
! Byte
| 369-370
| Ultimecia Castle flags
|-
! Byte
| 371
| unused in fields
|-
! Byte
| 372-376
| Ultimecia boss/timer/item flags
|-
! Byte
| 377
| Ultimecia organ note controller
|-
! Byte
| 378
| Centra Ruins timer (controls blackout messages from Odin)
|-
! Byte
| 379
| unused in fields
|-
! Word
| 380
| Squall health during mech fight.
|-
! Byte
| 382-383
| unused in fields
|-
! Byte
| 384
| Something about Laguna's time periods and GFs.
|-
! Byte
| 385
| Laguna dialogue in pub. Only the +2 bit is ever set. Don't change the +1 bit.
|-
! Byte
| 387
| Winhill progress?
|-
! Byte
| 388
| Timber Maniacs HQ talk flags (main lobby)
|-
! Byte
| 389
| Timber Maniacs HQ talk flags (office room)
|-
! Byte
| 390
| Edea talk flags at her house
|-
! Byte
| 391
| Laguna talk flags (in his office, disc 3)
|-
! Byte
| 392
| unknown (used in Edea's house and in the Balamb Garden computer system)
|-
! Byte
| 393-399
| unused in fields
|-
! Long
| 400 and 404
| Related to monsters killed in Winhill, but I don't think it actually does anything. Will investigate.
|-
! Byte
| 408
| unused in fields
|-
! Byte
| 409
| Balamb Garden computer system
|-
! Byte
| 410-431
| unused in fields
|-
! Byte
| 432
| BG Main hall flags
|-
! Byte
| 433
| Flags. Switches are assigned all over BG. No idea what any of them control.
|-
! Byte
| 434
| Flags. Switches are assigned all over BG. No idea what any of them control.
|-
! Byte
| 435
| Flags. Switches are assigned all over BG. No idea what any of them control.
|-
! Byte
| 436
| Moomba friendship level in the prison? Some actions cause these flags to be set.
|-
! Byte
| 437
| In BG on Disc 2, keeps track of who's in your party. In the prison, it's the current floor you're on.
|-
! Byte
| 438
| Cid vs Norg event flags
|-
! Byte
| 439
| Cid vs Norg event flags
|-
! Byte
| 440
| Event flags. (+1 Quad ambush, +2 quad item giver, +4/+8 Infirmary helped, +16 Nida, +64 Kadowaki Elixir, +128 Training center)
|-
! Byte
| 441
| Cid vs Norg event flags
|-
! Byte
| 442
| Rinoa Garden tour flags
|-
! Word
| 443
| Zell Health in Prison (Hacktuar)
|-
! Byte
| 445-447
| Propagator defeated flags
|-
! Word
| 448
| Unknown
|-
! Byte
| 450-451
| Various magazine/talk flags
|-
! Byte
| 452
| Lunatic Pandora areas visited?
|-
! Byte
| 453-455
| Moomba teleport variables
|-
! Byte
| 456-457
| unused in fields
|-
! Byte
| 458-459
| Used with MUSICSKIP in some Balamb Garden areas
|-
! Byte
| 460
| Random flags (some used for Card Club)
|-
! Byte
| 461-473
| unused in fields
|-
! Byte
| 474
| Random flags (some used for Card Club)
|-
! Byte
| 475-478
| CC Group variables
|-
! Byte
| 479
| If set to 0, disables all random battles during area loading.
|-
! Byte
| 480
| State of students in classroom (what they're doing).
|-
! Byte
| 481
| Controls a conversation in the cafeteria.
|-
! Signed Word
| 482
| Error ratio of missiles
|-
! Byte
| 484
| Missile Base progression?
|-
! Byte
| 485
| ToUK Progression (initially 0b111010101, +2 on finish quest. No other pops)
|-
! Byte
| 486
| ToUK room? (used to control map jumps in the maze)
|-
! Byte
| 487
| Missile base progression (also does something in BG2F classroom)
|-
! Byte
| 488
| Alternate Party Flags. Irvine +1/+16, Quistis +2/+32, Rinoa +4/+64, Zell +8/+128.1
|-
! Byte
| 489
| Random talk flags?
|-
! Byte
| 490
| Cafeteria cutscene
|-
! Byte
| 491
| ToUK stuff
|-
! Byte
| 492
| I think this is a door opener for the missile base if you choose a short time limit.
|-
! Byte
| 493
| Missile base timer related?
|-
! Byte
| 494-527
| unused in fields
|-
! Signed Word
| 528
| Sub-story progression (it's a progression variable for individual segments of the game)
|-
! Byte
| 530
| X-ATM related (defeated it in battle?)
|-
! Byte
| 531
| Functionally unused. Read from at dollet, only manipulated in debug rooms.
|-
! Byte
| 532
| Controls footstep sounds at dollet (sand to concrete)
|-
! Byte
| 533
| not investigated
|-
! Byte
| 534
| not investigated
|-
! Byte
| 535
| not investigated
|-
! Byte
| 536
| not investigated
|-
! Byte
| 537
| not investigated
|-
! Byte
| 538
| not investigated
|-
! Byte
| 539
| not investigated
|-
! Byte
| 540-591
| unused in fields
|-
! Byte
| 592-593
| Seems to control angles and character facing.
|-
! Byte
| 594
| unused in fields
|-
! Byte
| 595
| not investigated
|-
! Byte
| 596
| not investigated
|-
! Byte
| 597
| not investigated
|-
! Byte
| 598
| not investigated
|-
! Byte
| 599
| not investigated
|-
! Byte
| 600
| not investigated
|-
! Byte
| 601
| not investigated
|-
! Byte
| 602
| not investigated
|-
! Byte
| 603
| not investigated
|-
! Byte
| 604
| not investigated
|-
! Byte
| 605
| not investigated
|-
! Byte
| 606
| not investigated
|-
! Byte
| 607
| not investigated
|-
! Byte
| 608
| not investigated
|-
! Byte
| 609
| not investigated
|-
! Byte
| 610
| not investigated
|-
! Byte
| 611
| not investigated
|-
! Byte
| 612
| not investigated
|-
! Byte
| 613
| not investigated
|-
! Byte
| 614
| not investigated
|-
! Byte
| 615
| not investigated
|-
! Byte
| 616
| not investigated
|-
! Byte
| 617
| not investigated
|-
! Byte
| 618
| not investigated
|-
! Byte
| 619
| not investigated
|-
! Byte
| 620
| not investigated
|-
! Byte
| 621
| not investigated
|-
! Byte
| 622
| not investigated
|-
! Byte
| 623
| not investigated
|-
! Byte
| 624
| not investigated
|-
! Byte
| 625
| Balamb visited flags (+8 Zell's room)
|-
! Byte
| 626
| not investigated
|-
! Byte
| 627
| not investigated
|-
! Byte
| 628
| unused in fields
|-
! Byte
| 629
| not investigated
|-
! Byte
| 630
| not investigated
|-
! Byte
| 631
| not investigated
|-
! Byte
| 632
| not investigated
|-
! Byte
| 633
| not investigated
|-
! Word
| 634
| not investigated
|-
! Byte
| 636
| not investigated
|-
! Byte
| 637
| unused in fields
|-
! Byte
| 638
| not investigated
|-
! Byte
| 639
| unused in fields
|-
! Byte
| 640
| not investigated
|-
! Byte
| 641
| not investigated
|-
! Byte
| 642
| not investigated
|-
! Byte
| 643
| not investigated
|-
! Byte
| 644
| not investigated
|-
! Byte
| 645
| not investigated
|-
! Byte
| 646
| not investigated
|-
! Byte
| 647
| not investigated
|-
! Byte
| 648
| not investigated
|-
! Byte
| 649
| not investigated
|-
! Byte
| 650-655
| unused in fields
|-
! Word
| 656
| not investigated
|-
! Byte
| 658
| not investigated
|-
! Byte
| 659
| not investigated
|-
! Byte
| 660
| not investigated
|-
! Byte
| 661
| not investigated
|-
! Byte
| 662
| not investigated
|-
! Byte
| 663
| not investigated
|-
! Byte
| 664
| not investigated
|-
! Byte
| 665
| not investigated
|-
! Word
| 666
| not investigated
|-
! Byte
| 668
| not investigated
|-
! Byte
| 669-671
| unused in fields
|-
! Word
| 672
| not investigated
|-
! Byte
| 674
| unused in fields
|-
! Byte
| 675
| not investigated
|-
! Byte
| 676
| unused in fields
|-
! Byte
| 677
| not investigated
|-
! Byte
| 678
| not investigated
|-
! Byte
| 679
| unused in fields
|-
! Byte
| 680
| not investigated
|-
! Byte
| 681
| not investigated
|-
! Byte
| 682
| not investigated
|-
! Byte
| 683
| not investigated
|-
! Byte
| 684
| not investigated
|-
! Byte
| 685
| not investigated
|-
! Byte
| 686
| not investigated
|-
! Byte
| 687
| not investigated
|-
! Byte
| 688
| not investigated
|-
! Byte
| 689
| not investigated
|-
! Byte
| 690
| not investigated
|-
! Byte
| 691
| not investigated
|-
! Byte
| 692-719
| unused in fields
|-
! Byte
| 720
| Squall's costume (0=normal, 1=student, 2=SeeD, 3=Bandage on forehead)
|-
! Byte
| 721
| Zell's Costume (0=normal, 1=student, 2=SeeD)
|-
! Byte
| 722
| Selphie's costume (0=normal, 1=student, 2=SeeD)
|-
! Byte
| 723
| Quistis' Costume (0=normal, 1=SeeD)
|-
! Word
| 724
| Dollet mission time
|-
! Word
| 726
| not investigated
|-
! Byte
| 728
| Does lots of things.3
|-
! Byte
| 729
| not investigated
|-
! Byte
| 730
| Flags (+1 Joined Garden Festival Committee, +4 Gave Selphie tour of BG, +16 Kadowaki asks for Cid, +32 and +64 Tomb of Unknown Kind hints?, +128 Beat all card people?)
|-
! Byte
| 731
| unused in fields
|-
! Word
| 732
| not investigated
|-
! Byte
| 734
| Split Party Flags (+1 Zell, +2 Irvine, +4 Rinoa, +8 Quistis, +16 Selphie).2
|-
! Byte
| 735
| not investigated
|-
! Byte
| 736-751
| unused in fields
|-
! Byte
| 752
| not investigated
|-
! Byte
| 753-1023
| unused in fields
|-
! Byte
| Above 1023
| Temporary variables used pretty much everywhere.
|}
= Notes =
# When the party splits in disc 2, each party member in the inactive party except Selphie has one of the eight bits changed for this variable. One member has a flag in the 4 most significant bits, and the other has a flag in the 4 least significant bits. It's done this way so that when the characters appear, they animate towards different locations in the field, rather than stacking on top of each other.
# This byte contains flags for which characters are in Squall's party when the party splits in disc 2.
# List of everything that 728 holds throughout the game:
## SeeD field exam "Conduct" score (lose points when you do something wrong at Dollet).
## Train job attempts (Timber)
## Tomb of the Unknown King student ID.
## Who you took to space in disc 3.
# The field controlling restriction unlocking in Ultimecia's Castle uses this to figure out where to jump the party after they've broken a seal. It's unknown how SETPLACE actually sets this, it's not always related to the field ID or the SETPLACE parameter. This variable is also set at Balamb Garden's front gate manually.:5. List of everything that 341 holds throughout the game:
## First flashback team
## Selphie's current action when escaping from Deling's mansion (changes the dialogue)
## FH Concert Crappiness
## Something in B-Garden classroom during the paratrooper attack.

FF8/FileFormat X

2020-12-01T14:59:26Z

Sebanisu: /* Camera data */ added expected values for CameraSetting and CameraAnimationCollection. Also reformatted some things.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Pointers count. Fixed (02 00) '''[Unused in code]'''
|-
| 2
| uInt16
| Relative jump to CameraSetting. Should be (08 00)
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection. Should be (20 00)
|-
| 6
| uInt16
| Camera data size (starting from 0) '''[unused in code]'''
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-30T08:08:48Z

Sebanisu: /* Info */ i was looking in the .x file and realized the first byte was flipped should be 10 not 01. added note about 8 bpp.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 10 00 00 00 09 (Always)
| Contains one .TIM texture, 8 BPP
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T17:15:02Z

Sebanisu: /* Texture page calculation */ Moved comments out of blocks so code examples are easier to read.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F;
Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64;
For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T17:13:04Z

Sebanisu: /* Example */ Moved the comment out of the block. And adjusted the wording.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64; //For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96
Unsure about this one. It could be 42.667 instead of 48. It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24-bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T17:10:45Z

Sebanisu: /* Texture page calculation */ Added examples per bit width. Corrected size of texture page at 16 bit. Adjusted formating.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===
Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 64; //For 16 bit TIM's, the texture page is 64 pixels wide

====Example====
For 24-bit TIM:
0xB2 byte is: 2*48 = 96 // Unsure about this one. It could be 42.667... It takes 1.5x the space of 16 bit. I haven't seen a file that uses 24 bit yet.

For 16-bit TIM:
0xB2 byte is: 2*64= 128

For 8-bit TIM:
0xB2 byte is: 2*128 = 256

For 4-bit TIM:
0xB2 byte is: 2*256 = 512

Each time you half the number of bits you double the amount of data you can store in the same space. So the calculated Texture Page is different.

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T15:56:55Z

Sebanisu: /* Dependency */ Changed this example to use wiki numbering and the headers.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

=====Example=====

a0stg006.x: 
0x5d8 -> 02 00 08 00 20 00
# Get EOF-> *(0x5d8 + 8) -> 32
# Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)
# Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c
# Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)
# Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!
## 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===

Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 128; //For 16 bit TIM's, the texture page is 128 sized

Example:
0xB2 byte is:
2*128 = 256

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T15:46:12Z

Sebanisu: /* Camera Animation (WIP) */ fixed spelling error and added comment.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Starting Time usually 0
|-
| 12
| uint16_t
| Current Time // I'm questioning if this is part of the struct.
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

Example:

a0stg006.x:

0x5d8 -> 02 00 08 00 20 00

1. Get EOF-> *(0x5d8 + 8) -> 32

2. Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)

3. Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c

4. Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)

5. Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!

5a. 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===

Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 128; //For 16 bit TIM's, the texture page is 128 sized

Example:
0xB2 byte is:
2*128 = 256

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T15:36:56Z

Sebanisu: /* Camera Animation (WIP) */ OpenVIII had some more up to date Camera Animation data. I tried to update the Table to Match. I copied the Time info from comments.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint8_t
| Animation ID
|-
| 1
| uint8_t
| Key Frame Count
|-
| 2
| uint16_t (bit varies)
| Main controller, if '''0xFFFF''' then return
|-
| 4
| uint16_t
| Starting FOV usually ~280
|-
| 6
| uint16_t
| Ending FOV ~006
|-
| 8
| uint16_t
| Starting Camera Roll usually 0
|-
| 10
| uint16_t
| Stating Time usually 0
|-
| 12
| uint16_t
| Time
|-
| 14
| array<uint8_t,20>
| unknown bytes
|-
| 34
| array<uint16_t,32>
| Start Frame Offsets
|-
| 98
| array<int16_t,32>
| Camera World Z
|-
| 162
| array<int16_t,32>
| Camera World X
|-
| 226
| array<int16_t,32>
| Camera World Y
|-
| 290
| array<uint8_t,32>
| Is Frame Durations Shot ~ bool?
|-
| 322
| array<int16_t,32>
| Camera Look At Z
|-
| 386
| array<int16_t,32>
| Camera Look At X
|-
| 450
| array<int16_t,32>
| Camera Look At Y
|-
| 514
| array<uint8_t,32>
| Is Frame Ending Shots ~ bool?
|-
| 546
| array<uint8_t,128>
| unknown bytes
|-
| 674
| array<uint8_t,128>
| unknown bytes
|-
| 802
| array<uint8_t,128>
| unknown bytes
|-
| 930
| array<uint8_t,128>
| unknown bytes
|-
| 1058
| array<uint8_t,34>
| unknown bytes
|}
Total bytes of struct is '''1092'''. Still much is unknown about this struct. I adjusted things from OpenVIII source code. Though some numbers weren't adding up. I know the total size. So I adjusted one of the unknown bytes arrays to fit in the span.
======Time======
Time is calculated from number of frames. You basically set starting position World+lookat and ending position, then mark number of frames to interpolate between them. Every frame is one draw call and it costs 16. Starting time needs to be equal or higher for next animation frame to be read; If next frame==0xFFFF then it's all done.

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

Example:

a0stg006.x:

0x5d8 -> 02 00 08 00 20 00

1. Get EOF-> *(0x5d8 + 8) -> 32

2. Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)

3. Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c

4. Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)

5. Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!

5a. 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===

Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 128; //For 16 bit TIM's, the texture page is 128 sized

Example:
0xB2 byte is:
2*128 = 256

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T14:25:54Z

Sebanisu: /* Face order / Translation/ triangulation */ Changed bold section titles to headings so they show in the table of contents.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| WORD (bit varies)
| Main controller, if 0xFFFF then return, stored into camera struct+2
|-
| 2
| WORD
| Unknown, stored into camera struct+4 (2nd controller?)
|-
| 4
| WORD
| Unknown, stored into camera struct+6 (3rd controller?)
|-
| 6
| WORD
| Unknown, stored into camera struct, varies by 4>>8&3 case switch
|-
| 8
| WORD
| Unknown
|-
| 10
| WORD
| Animation speed (confirmed)
|-
| 12
| WORD
| Word field related to camera index? crashed when 0x0070
|-
| ???
| ???
| ???
|}

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

Example:

a0stg006.x:

0x5d8 -> 02 00 08 00 20 00

1. Get EOF-> *(0x5d8 + 8) -> 32

2. Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)

3. Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c

4. Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)

5. Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!

5a. 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===

Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 128; //For 16 bit TIM's, the texture page is 128 sized

Example:
0xB2 byte is:
2*128 = 256

=== Face order / Translation/ triangulation ===

====Quad wing order====
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

====Quad triangulation face order====
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
====Triangles VT order====
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
====Example====
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T14:21:54Z

Sebanisu: /* How is this file handled by the engine? */ Changed the sections titles from bold to headings so they show in the table of contents

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

====Objects Group====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

=====Objects List=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

=====Settings 1=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| WORD (bit varies)
| Main controller, if 0xFFFF then return, stored into camera struct+2
|-
| 2
| WORD
| Unknown, stored into camera struct+4 (2nd controller?)
|-
| 4
| WORD
| Unknown, stored into camera struct+6 (3rd controller?)
|-
| 6
| WORD
| Unknown, stored into camera struct, varies by 4>>8&3 case switch
|-
| 8
| WORD
| Unknown
|-
| 10
| WORD
| Animation speed (confirmed)
|-
| 12
| WORD
| Word field related to camera index? crashed when 0x0070
|-
| ???
| ???
| ???
|}

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

Example:

a0stg006.x:

0x5d8 -> 02 00 08 00 20 00

1. Get EOF-> *(0x5d8 + 8) -> 32

2. Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)

3. Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c

4. Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)

5. Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!

5a. 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===

Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 128; //For 16 bit TIM's, the texture page is 128 sized

Example:
0xB2 byte is:
2*128 = 256

=== Face order / Translation/ triangulation ===

'''1.Quad wing order:'''
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

'''2.Quad triangulation face order'''
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
'''
3.Triangles VT order:'''
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
Example:
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat X

2020-11-18T14:15:43Z

Sebanisu: /* Camera data */ Changed the sections to Headings so they would show in the table of contents.

By MaKiPL. Thanks for help in research for: shakotay2 (XeNTaX), Halfer, Yagami Light.
Complete list of original battle stages by Kaspar01: [[FF8/BS_list|List of battle stages]]

== Info ==

.X file is uncompressed 3D stage model with texture embedeed. The file contains unused info (not used by FF8 engine), camera data, movement, translations and geometry data.

Battle stages '''DOES NOT''' contain pointers to next sections. All pointers are '''HARDCODED''' in FF8.EXE. [[FF8/BattleStage/Pointers|Click me for battle stage pointer list]]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Usually starting with:
! style="background:rgb(204,204,204)" | Description
|-
| PlayStation MIPS assembly
| E8 FF BD 27 01 00 02
| Used only in PS version; skipped in PC
|-
| Camera data + movement
| 02 00 08 00 20 00
| Camera animations, movement (pre-keyed)
|-
| Model section
| 06 00 00 00 (See geometry section info)
| Divides to object (group) and it's sub-objects + vert/triangle grouping
|-
| Texture
| 01 00 00 00 09 (Always)
| Contains one .TIM texture
|}

== How is this file handled by the engine? ==

FF8 loads specific file and reads it from hardcoded (written in FF8 code) position (or reads MIPS PlayStation assembly that contains battle stage load code). This hardcoded position points to camera data (in PC). Camera data has size uint16, which is calculated and relative jump is made. Just after camera, a typical section based file handling is made.

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Objects group #1
|-
| 8
| uint32
| Objects group #2
|-
| 12
| uint32
| Objects group #3
|-
| 16
| uint32
| Objects group #4
|-
| 20
| uint32
| Texture [unused in code]
|-
| 24
| uint32
| Texture
|-
| 28
| uint32
| Relative to EOF
|}

'''Objects group:'''
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of sections
|-
| 4
| uint32
| Pointer to Settings #1
|-
| 8
| uint32
| Pointer to ObjectsList
|-
| 12
| uint32
| Pointer to Settings #2
|-
| 16
| uint32
| Relative to end_of_group
|}

'''Objects list:'''
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint32
| Number of objects
|-
| Num_of_obj*4
| uint32
| Relative pointer to segment (one .obj file) [01 00 01 00]
|}

'''Settings 1:'''
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| Unknown, fixed 2?
|-
| 2
| sint16 (probably, or uint16)
| Scale (01 is the smallest)
|-
| 4
| 4 bytes
| PADDING
|-
| 8
| 4 bytes
| Nothing?
|-
| 12
| 4 bytes
| Nothing?
|-
| 16
| 2 bytes
| if not FF FF, then model vanishes
|-
| 18
| sint16
| X or Z Axis rot origin (Translation)
|-
| 20
| 44 bytes
| Left null for storing some engine data AFTER loaded in-game
|-
| 64
| 2 bytes
| if not FF FF or 00 00, then model vanishes
|-
| 66
| 2 bytes
| Nothing?
|-
| 68
| ...up to end
| Left null for storing some engine data AFTER loaded in-game
|}

This might look difficult, but it's like multi-pointer file that starts at different location given by executable. See list at the beginning of this wiki to see which stages camera starts at which position (where FF8.exe really starts to read file as BattleStage) [FF8 stores whole file, even with useless data before camera]
If this still makes trouble, see this video: TODO

== Camera data ==

Starts at ~0x5d4 (see How the engine handles this file?).
[.text:00509820]

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uInt16
| Fixed 02 00 (Unused in code)/ pointers count
|-
| 2
| uInt16
| Relative jump to CameraSetting
|-
| 4
| uInt16
| Relative jump to CameraAnimationCollection
|-
| 6
| uInt16
| Camera data size (starting from 0) [unused in code]
|-
| 8
| 24 bytes
| Camera Settings
|-
| 32
| ?? bytes
| Camera Animation Collection
|}

====Camera Setting====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| char (based on disassembly)
| CameraAnimMode?
|-
| 1
| byte?
| StopEnemyBeforeAnim?
|-
| 2
| Bitfield? (1B)
| UHM?
|-
| 3
| ???
| DefaultEndofCameraPosition_Zoom?
|-
| 4
| ???
| ???
|}

====Camera Animations Collection====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| uint16
| NumOfSets
|-
| 2 *(Set index)
| uint16
| Relative pointer to camera Animation Set
|-
| 2 *(Set index)+ 2
| uint16
| Camera EOF
|-
| CameraAnimationSetPointer
| CameraAnimationSet
| CameraAnimationSet
|}

=====CameraAnimationSet=====
{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
|0
|ushort
|AnimPointer*2
|-
|AnimPointer
|Varies 144-146-148 bytes usually
|CameraAnimation
|}

=====Camera Animation (WIP)=====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| WORD (bit varies)
| Main controller, if 0xFFFF then return, stored into camera struct+2
|-
| 2
| WORD
| Unknown, stored into camera struct+4 (2nd controller?)
|-
| 4
| WORD
| Unknown, stored into camera struct+6 (3rd controller?)
|-
| 6
| WORD
| Unknown, stored into camera struct, varies by 4>>8&3 case switch
|-
| 8
| WORD
| Unknown
|-
| 10
| WORD
| Animation speed (confirmed)
|-
| 12
| WORD
| Word field related to camera index? crashed when 0x0070
|-
| ???
| ???
| ???
|}

=====Dependency=====

CAMERA:
-Camera Settings
-Camera Animation Collection (even three collections in a0stg006.x and up to 7 in a0stg101.x!)
|
|
-Camera animation Set (Always 8 camera animations, may be empty (0xFFFF); look for example to a0stg127.x collectionId==1; there are 8 animations, but 7 of them are 0xFFFF (pointers increase by 2))
|
|
- Camera animation

Example:

a0stg006.x:

0x5d8 -> 02 00 08 00 20 00

1. Get EOF-> *(0x5d8 + 8) -> 32

2. Jump to EOF -> 0x5d8 + 32 = 0x5F8 (This is now Camera Animation Collection)

3. Get pointer to correct anim collection. In this case we will use AnimCollectionID == 0, so: *(0x5F8 + 0*2 + 2) -> 0x0c

4. Jump to Anim collection data: 0x5F8 + 0x0c = 0x604 (This is now Camera Animation Set)

5. Jump to Camera animation by cameraAnimSetID, let's take for example cameraAnimSetID == 7, so: *(0x604 + 7*2) -> 0x25E. Now carefully, jump by multiplying it by 2!

5a. 0x604 + (0x25E * 2) = 0xAC0

Therefore: a0stg006.x Camera animation 7 in camera collection 0 is at 0xAC0

== Geometry ==
Geometry contains groups, that contains Triangles and/or quads poligons. Models always stars at 01 00 01 00, and needs to be after camera data, either it's not model itself, but some other data.

==== Group ====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Offset
! style="background:rgb(204,204,204)" | Length
! style="background:rgb(204,204,204)" | Description
|-
| 0
| 4 bytes
| Always 01 00 01 00 / Header of object
|-
| 4
| 2 bytes
| Uint16 / number of vertices.
|-
| 6
| Number of vertices * 6
| Vertex data, short X; short Y; short Z;
|-
| 6 + (Number of vertices *6)
| (AbsolutePosition MOD 4) + 4
| Padding
|-
| varies (just after above)
| 2 bytes
| uint16 / number of triangles
|-
| varies (just after above)
| 2 bytes
| uint16 / number of quads
|-
| varies (just after above)
| 4 bytes
| padding
|-
| varies (just after above)
| number of triangles * 20
| Triangle data. If NumOfTriangles = 0, then instead of any triangle data, there's quad data.
|-
| varies (just after above)
| number of quads * 24
| Triangle data. If NumOfQuads = 0, then instead of any quad data, there's either next header 01 00 01 00, or end of group.
|}

===== Triangle =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| Special (see below / After QUAD table)
| 8 Byte
| See below (after QUAD table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

===== Quad =====

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Name
! style="background:rgb(204,204,204)" | Type
! style="background:rgb(204,204,204)" | Description
|-
| F1 (A)
| uint16
| A of face indice
|-
| F2 (B)
| uint16
| B of face indice
|-
| F3 (C)
| uint16
| C of face indice
|-
| F4 (D)
| uint16
| D of face indice
|-
| U1
| Byte
| U of first texture coordinate
|-
| V1
| Byte
| V of first texture coordinate
|-
| CLUT_ID
| UInt16 (BIT operated)*
| Index to CLUT_ID operated by BIT (see below)
|-
| U2
| Byte
| U of second texture coordinate
|-
| V2
| Byte
| V of second texture coordinate
|-
| Special (see below)
| 8 Byte
| See below (after table)
|-
| Hide
| Byte/Bool
| Bool. Hides or shows texture
|-
| U3
| Byte
| U of third texture coordinate
|-
| V3
| Byte
| V of third texture coordinate
|-
| U4
| Byte
| U of fourth texture coordinate
|-
| V4
| Byte
| V of fourth texture coordinate
|-
| Red
| Byte
| Texture colourization (Red)
|-
| Green
| Byte
| Texture colourization (Green)
|-
| Blue
| Byte
| Texture colourization (Blue)
|-
| PSone GPU related
| Byte
| PSOne instruction
|}

Special Byte:
This byte, needs to be divided to two bytes. So, for example, a 0xE5 needs to be treated like two bytes:
0x0E
0x05

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | Singular of char
! style="background:rgb(204,204,204)" | Example
! style="background:rgb(204,204,204)" | Description
|-
| First char/ 4 BIT
| B2 --> 0B
| Unknown
|-
| Second char / 4 BIT
| B2 --> 02
| Texture page number
|}

==== CLUT ID ====

The most important bit's are the first two on one byte, and last two on last byte. Example:
00000000 00111100 (00 3C)
should be read like this:
00111100 00000000 (3C 00)
And the CLUT ID is revealed by watching this four bits:
001111[00 00]000000

Same applies to reading CLUT colors (16bits) where they are: 1b-T, 5b-B, 5b-G, 5b-R (Or RGBT if reordered as shown above)

Complete list (without replacing bit order - as is in HEX editor/memory):

{| border="1" cellspacing="1" cellpadding="3" align="center" style="border: 1px solid black; border-collapse: collapse;"
! style="background:rgb(204,204,204)" | CLUT ID
! style="background:rgb(204,204,204)" | BIT
! style="background:rgb(204,204,204)" | HEX
|-
| #1
| 00000000 00111100
| 00 3C
|-
| #2
| 01000000 00111100
| 40 3C
|-
| #3
| 10000000 00111100
| 80 3C
|-
| #4
| 11000000 00111100
| C0 3C
|-
| #5
| 00000000 00111101
| 00 3D
|-
| #6
| 01000000 00111101
| 40 3D
|-
| #7
| 10000000 00111101
| 80 3D
|-
| #8
| 11000000 00111101
| C0 3D
|-
| #9
| 00000000 00111110
| 00 3E
|-
| #10
| 01000000 00111110
| 40 3E
|-
| #11
| 10000000 00111110
| 80 3E
|-
| #12
| 11000000 00111110
| C0 3E
|-
| #13
| 00000000 00111111
| 00 3F
|-
| #14
| 01000000 00111111
| 40 3F
|-
| #15
| 10000000 00111111
| 80 3F
|-
| #16
| 11000000 00111111
| C0 3F
|}

== Texture ==

Contains one [[PSX/TIM_format|TIMs]] with various size 512x256, 673x256, 768x256 (8BPP).

=== UV calculation algorithm ===

Float U = (float)U_Byte / (float)(TIM_Texture_Width * 2) + ((float)Texture_Page/(TIM_Texture_Width * 2));

=== Texture page calculation ===

Byte TPage = InputBytes[TexturePage_index] & 0F; //Bitwise TPage byte AND 0F, to delete first 4 bits
int TPageINT = TPage * 128; //For 16 bit TIM's, the texture page is 128 sized

Example:
0xB2 byte is:
2*128 = 256

=== Face order / Translation/ triangulation ===

'''1.Quad wing order:'''
ABCD ---> ABDC
example:
f 1 2 3 4
to:
f 1 2 4 3

'''2.Quad triangulation face order'''
ABDC > ABD
ACD (same for VT)
example:
f 1 2 4 3
to:
f 1 2 4
f 1 3 4
'''
3.Triangles VT order:'''
A/T1 > A/T2
B/T2 > B/T3
C/T3 > C/T1
Example:
(Also with quad triangulation face order!)
f 1/1 2/2 7/4 6/3
to:
f 1/1 2/2 7/4
f 1/1 6/3 7/4
where:
A=1 B=2 C=6 D=7

FF8/FileFormat PAK

2020-11-01T18:11:04Z

Sebanisu: /* Pak File Details */ added a paragraph about the naming scheme.

Final Fantasy VIII's movie files are stored within pak files. This is for the CD 2000 version only. Steam 2013 version uses avi files. '''publish.pak''' contains the message "Published by Square Electronic Arts L.L.C.". '''disc1.pak''', '''disc2.pak''', '''disc3.pak''', and '''disc4.pak''' hold the rest of the FMV movies.

=PAK File Structure=
The PAK file has no header. Each movie usually contains a CAM file and two BINK videos. A PAK file can contain multiple movies. One BINK file is the low res the other is the high res.
{| class="wikitable"
|-
! Section !! Description
|-
| CAM - optional || Camera data
|-
| BINK - high res || FMV video
|-
| BINK - low res || FMV video
|}

===Existing projects you can use to extract the PAK files.===
* https://github.com/MaKiPL/OpenVIII-monogame/tree/master/PAK%20Extractor
* https://github.com/MaKiPL/FF8-Rinoa-s-Toolset/blob/master/SerahToolkit_SharpGL/FF8_Core/PlayMovie.cs
* https://github.com/Sebanisu/OpenVIII_CPP_WIP/tree/master/src/open_viii/pak

==BINK files==
* Start with 0x42494B "BIK"
* More info: https://wiki.multimedia.cx/index.php/Bink_Container

==CAM files==
* Each frame is 44 bytes long.
{| class="wikitable"
|-
! Offset !! Size !! Description
|-
| 0 || 3 bytes || 0x463850 "F8P"
|-
| 6 || 2 bytes (uint16) || Approx number of frames. There can be extra data.
|-
| 8 || 44 bytes * number of frames || Frame data. Each frame ends with "END"
|}

== Pak File Details ==
The filenames are based on the 2013 name scheme. I am using '''h''' suffix for high res and '''l''' suffix for low res. Disc numbers go from 0-3. And 4 being for extra videos not fmv related.
===== disc1.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc00_00.cam||326||0||14352||F8P
|-
|disc00_00h.bik||326||3810||5759124||BIK
|-
|disc00_00l.bik||326||5818a4||2498748||BIK
|-
|disc00_01.cam||199||7e3960||8764||F8P
|-
|disc00_01h.bik||205||7e5b9c||3572420||BIK
|-
|disc00_01l.bik||205||b4de60||1522312||BIK
|-
|disc00_02.cam||161||cc18e8||7092||F8P
|-
|disc00_02h.bik||161||cc349c||2805776||BIK
|-
|disc00_02l.bik||161||f704ac||1410720||BIK
|-
|disc00_03.cam||1100||10c8b4c||48408||F8P
|-
|disc00_03h.bik||1100||10d4864||19654004||BIK
|-
|disc00_03l.bik||1100||2392dd8||8597316||BIK
|-
|disc00_04.cam||215||2bc5d1c||9468||F8P
|-
|disc00_04h.bik||215||2bc8218||3778948||BIK
|-
|disc00_04l.bik||215||2f62b9c||1628944||BIK
|-
|disc00_05.cam||1114||30f06ac||49024||F8P
|-
|disc00_05h.bik||1114||30fc62c||20063552||BIK
|-
|disc00_05l.bik||1114||441eb6c||8923620||BIK
|-
|disc00_06.cam||41||4ca1550||1812||F8P
|-
|disc00_06h.bik||41||4ca1c64||757108||BIK
|-
|disc00_06l.bik||41||4d5a9d8||347236||BIK
|-
|disc00_07.cam||1084||4daf63c||47704||F8P
|-
|disc00_07h.bik||1084||4dbb094||19696056||BIK
|-
|disc00_07l.bik||1084||6083a4c||8855428||BIK
|-
|disc00_08.cam||324||68f59d0||14264||F8P
|-
|disc00_08h.bik||324||68f9188||4736972||BIK
|-
|disc00_08l.bik||324||6d7d954||2073440||BIK
|-
|disc00_09.cam||1391||6f77cb4||61212||F8P
|-
|disc00_09h.bik||1391||6f86bd0||24180228||BIK
|-
|disc00_09l.bik||1391||86961d4||10270268||BIK
|-
|disc00_10.cam||393||9061810||17300||F8P
|-
|disc00_10h.bik||393||9065ba4||7195820||BIK
|-
|disc00_10l.bik||393||9742850||3265804||BIK
|-
|disc00_11.cam||465||9a5fd5c||20468||F8P
|-
|disc00_11h.bik||465||9a64d50||8496456||BIK
|-
|disc00_11l.bik||465||a27f298||3846440||BIK
|-
|disc00_12.cam||45||a62a3c0||1988||F8P
|-
|disc00_12h.bik||45||a62ab84||752040||BIK
|-
|disc00_12l.bik||45||a6e252c||300964||BIK
|-
|disc00_13.cam||15||a72bcd0||668||F8P
|-
|disc00_13h.bik||15||a72bf6c||249788||BIK
|-
|disc00_13l.bik||15||a768f28||99988||BIK
|-
|disc00_14.cam||360||a7815bc||15848||F8P
|-
|disc00_14h.bik||360||a7853a4||6369460||BIK
|-
|disc00_14l.bik||360||ad98458||2769344||BIK
|-
|disc00_15.cam||300||b03c618||13208||F8P
|-
|disc00_15h.bik||300||b03f9b0||5236916||BIK
|-
|disc00_15l.bik||300||b53e264||2236992||BIK
|-
|disc00_16.cam||150||b7604a4||6608||F8P
|-
|disc00_16h.bik||150||b761e74||2776716||BIK
|-
|disc00_16l.bik||150||ba07d00||1276724||BIK
|-
|disc00_17.cam||890||bb3f834||39168||F8P
|-
|disc00_17h.bik||890||bb49134||15823644||BIK
|-
|disc00_17l.bik||890||ca60450||8111120||BIK
|-
|disc00_18.cam||191||d21c860||8412||F8P
|-
|disc00_18h.bik||192||d21e93c||3436444||BIK
|-
|disc00_18l.bik||192||d5658d8||1772548||BIK
|-
|disc00_19.cam||121||d7164dc||5332||F8P
|-
|disc00_19h.bik||121||d7179b0||2155424||BIK
|-
|disc00_19l.bik||121||d925d50||944536||BIK
|-
|disc00_20.cam||401||da0c6e8||17652||F8P
|-
|disc00_20h.bik||401||da10bdc||7142436||BIK
|-
|disc00_20l.bik||401||e0e0800||3132744||BIK
|-
|disc00_21.cam||829||e3dd548||36484||F8P
|-
|disc00_21h.bik||829||e3e63cc||14983636||BIK
|-
|disc00_21l.bik||829||f2305a0||6743692||BIK
|-
|disc00_22.cam||141||f89ec2c||6212||F8P
|-
|disc00_22h.bik||141||f8a0470||2585084||BIK
|-
|disc00_22l.bik||141||fb1766c||1175040||BIK
|-
|disc00_23.cam||550||fc3646c||24208||F8P
|-
|disc00_23h.bik||550||fc3c2fc||9986472||BIK
|-
|disc00_23l.bik||550||105c24a4||4486592||BIK
|-
|disc00_24.cam||575||10a09a64||25308||F8P
|-
|disc00_24h.bik||575||10a0fd40||10441380||BIK
|-
|disc00_24l.bik||575||11404fe4||4692084||BIK
|-
|disc00_25.cam||130||1187e858||5728||F8P
|-
|disc00_25h.bik||130||1187feb8||2438880||BIK
|-
|disc00_25l.bik||130||11ad3598||1140268||BIK
|-
|disc00_26.cam||101||11be9bc4||4452||F8P
|-
|disc00_26h.bik||101||11bead28||1792576||BIK
|-
|disc00_26l.bik||101||11da0768||783064||BIK
|-
|disc00_27.cam||306||11e5fa40||13472||F8P
|-
|disc00_27h.bik||306||11e62ee0||5574568||BIK
|-
|disc00_27l.bik||306||123b3e88||2513668||BIK
|-
|disc00_28.cam||432||1261998c||19016||F8P
|-
|disc00_28h.bik||432||1261e3d4||7643824||BIK
|-
|disc00_28l.bik||432||12d68684||3323692||BIK
|-
|disc00_29.cam||750||13093db0||33008||F8P
|-
|disc00_29h.bik||750||1309bea0||13517424||BIK
|-
|disc00_29l.bik||750||13d80110||6015936||BIK
|-
|disc00_30.cam||2897||1433ccd0||127476||F8P
|-
|disc00_30h.bik||2925||1435bec4||49898052||BIK
|-
|disc00_30l.bik||2925||172f2108||22289504||BIK
|}
===== disc2.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc01_00.cam||453||0||19940||F8P
|-
|disc01_00h.bik||453||4de4||8128812||BIK
|-
|disc01_00l.bik||453||7c5710||3597828||BIK
|-
|disc01_01.cam||278||b33d14||12240||F8P
|-
|disc01_01h.bik||278||b36ce4||4869600||BIK
|-
|disc01_01l.bik||278||fdbac4||2060252||BIK
|-
|disc01_02.cam||330||11d2aa0||14528||F8P
|-
|disc01_02h.bik||330||11d6360||5962524||BIK
|-
|disc01_02l.bik||330||1785e7c||2662428||BIK
|-
|disc01_03.cam||450||1a0fe98||19808||F8P
|-
|disc01_03h.bik||450||1a14bf8||8227052||BIK
|-
|disc01_03l.bik||450||21ed4e4||3724748||BIK
|-
|disc01_04.cam||168||257aab0||7400||F8P
|-
|disc01_04h.bik||168||257c798||3036032||BIK
|-
|disc01_04l.bik||168||2861b18||1356172||BIK
|-
|disc01_05.cam||219||29acca4||9644||F8P
|-
|disc01_05h.bik||219||29af250||4033920||BIK
|-
|disc01_05l.bik||219||2d87fd0||1843800||BIK
|-
|disc01_06.cam||104||2f4a228||4584||F8P
|-
|disc01_06h.bik||104||2f4b410||1894044||BIK
|-
|disc01_06l.bik||104||3119aac||853980||BIK
|-
|disc01_07.cam||160||31ea288||7048||F8P
|-
|disc01_07h.bik||160||31ebe10||2909428||BIK
|-
|disc01_07l.bik||160||34b2304||1309396||BIK
|-
|disc01_08.cam||381||35f1dd8||16772||F8P
|-
|disc01_08h.bik||381||35f5f5c||6936652||BIK
|-
|disc01_08l.bik||381||3c937a8||3126604||BIK
|-
|disc01_09.cam||226||3f8ecf4||9952||F8P
|-
|disc01_09h.bik||226||3f913d4||4177224||BIK
|-
|disc01_09l.bik||226||438d11c||1917924||BIK
|-
|disc01_10.cam||416||4561500||18312||F8P
|-
|disc01_10h.bik||416||4565c88||7604492||BIK
|-
|disc01_10l.bik||416||4ca6594||3444452||BIK
|-
|disc01_11.cam||603||4fef478||26540||F8P
|-
|disc01_11h.bik||603||4ff5c24||10981628||BIK
|-
|disc01_11l.bik||603||5a6ed20||4951152||BIK
|-
|disc01_12.cam||335||5f27990||14748||F8P
|-
|disc01_12h.bik||335||5f2b32c||6173264||BIK
|-
|disc01_12l.bik||335||650e57c||2823184||BIK
|-
|disc01_13.cam||381||67bf98c||16772||F8P
|-
|disc01_13h.bik||381||67c3b10||6843600||BIK
|-
|disc01_13l.bik||381||6e4a7e0||3034044||BIK
|-
|disc01_14.cam||531||712f39c||23372||F8P
|-
|disc01_14h.bik||531||7134ee8||9498260||BIK
|-
|disc01_14l.bik||531||7a43d7c||4188788||BIK
|-
|disc01_15.cam||120||7e427f0||5288||F8P
|-
|disc01_15h.bik||120||7e43c98||2224344||BIK
|-
|disc01_15l.bik||120||8062d70||1024412||BIK
|-
|disc01_16.cam||149||815cf0c||6564||F8P
|-
|disc01_16h.bik||149||815e8b0||2754272||BIK
|-
|disc01_16l.bik||149||83fef90||1264204||BIK
|-
|disc01_17.cam||150||85339dc||6608||F8P
|-
|disc01_17h.bik||150||85353ac||2722300||BIK
|-
|disc01_17l.bik||150||87cdda8||1221752||BIK
|-
|disc01_18.cam||255||88f8220||11228||F8P
|-
|disc01_18h.bik||255||88fadfc||4656768||BIK
|-
|disc01_18l.bik||255||8d6bc7c||2106780||BIK
|-
|disc01_19.cam||428||8f6e218||18840||F8P
|-
|disc01_19h.bik||428||8f72bb0||7841392||BIK
|-
|disc01_19l.bik||428||96ed220||3561280||BIK
|-
|disc01_20.cam||150||9a52960||6608||F8P
|-
|disc01_20h.bik||150||9a54330||2667756||BIK
|-
|disc01_20l.bik||150||9cdf81c||1168116||BIK
|-
|disc01_21.cam||75||9dfcb10||3308||F8P
|-
|disc01_21h.bik||75||9dfd7fc||1396348||BIK
|-
|disc01_21l.bik||75||9f52678||646296||BIK
|-
|disc01_22.cam||120||9ff0310||5288||F8P
|-
|disc01_22h.bik||120||9ff17b8||2132696||BIK
|-
|disc01_22l.bik||120||a1fa290||932544||BIK
|-
|disc01_23.cam||285||a2ddd50||12548||F8P
|-
|disc01_23h.bik||285||a2e0e54||5164156||BIK
|-
|disc01_23l.bik||285||a7cdad0||2314168||BIK
|-
|disc01_24.cam||330||aa02a88||14528||F8P
|-
|disc01_24h.bik||330||aa06348||6084528||BIK
|-
|disc01_24l.bik||330||afd3af8||2784636||BIK
|-
|disc01_25.cam||300||b27b874||13208||F8P
|-
|disc01_25h.bik||300||b27ec0c||5413124||BIK
|-
|disc01_25l.bik||300||b7a8510||2413380||BIK
|-
|disc01_26.cam||120||b9f5854||5288||F8P
|-
|disc01_26h.bik||120||b9f6cfc||2180104||BIK
|-
|disc01_26l.bik||120||bc0b104||980208||BIK
|-
|disc01_27.cam||75||bcfa5f4||3308||F8P
|-
|disc01_27h.bik||75||bcfb2e0||1345552||BIK
|-
|disc01_27l.bik||75||be43af0||595492||BIK
|-
|disc01_28.cam||120||bed5114||5288||F8P
|-
|disc01_28h.bik||120||bed65bc||2180512||BIK
|-
|disc01_28l.bik||120||c0eab5c||980596||BIK
|-
|disc01_29.cam||692||c1da1d0||30456||F8P
|-
|disc01_29h.bik||692||c1e18c8||12448828||BIK
|-
|disc01_29l.bik||692||cdc0d04||5528956||BIK
|-
|disc01_30.cam||120||d306a80||5288||F8P
|-
|disc01_30h.bik||120||d307f28||2194876||BIK
|-
|disc01_30l.bik||120||d51fce4||994700||BIK
|-
|disc01_31.cam||135||d612a70||5948||F8P
|-
|disc01_31h.bik||135||d6141ac||2480668||BIK
|-
|disc01_31l.bik||135||d871bc8||1130648||BIK
|-
|disc01_32.cam||327||d985c60||14396||F8P
|-
|disc01_32h.bik||327||d98949c||5902052||BIK
|-
|disc01_32l.bik||327||df2a380||2628608||BIK
|-
|disc01_33.cam||1186||e1abf80||52192||F8P
|-
|disc01_33h.bik||1186||e1b8b60||21305376||BIK
|-
|disc01_33l.bik||1186||f60a380||9445316||BIK
|}
===== disc3.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc02_00.cam||197||0||8676||F8P
|-
|disc02_00h.bik||197||21e4||3641072||BIK
|-
|disc02_00l.bik||197||37b0d4||1670856||BIK
|-
|disc02_01.cam||472||512f9c||20776||F8P
|-
|disc02_01h.bik||472||5180c4||8222124||BIK
|-
|disc02_01l.bik||472||cef670||3725124||BIK
|-
|disc02_02.cam||105||107cdb4||4628||F8P
|-
|disc02_02h.bik||105||107dfc8||1970280||BIK
|-
|disc02_02l.bik||105||125f030||919644||BIK
|-
|disc02_03.cam||105||133f88c||4628||F8P
|-
|disc02_03h.bik||105||1340aa0||1958900||BIK
|-
|disc02_03l.bik||105||151ee94||909292||BIK
|-
|disc02_04.cam||106||15fce80||4672||F8P
|-
|disc02_04h.bik||106||15fe0c0||1887824||BIK
|-
|disc02_04l.bik||106||17caf10||827636||BIK
|-
|disc02_05.cam||106||1895004||4672||F8P
|-
|disc02_05h.bik||106||1896244||1887052||BIK
|-
|disc02_05l.bik||106||1a62d90||827048||BIK
|-
|disc02_06.cam||110||1b2cc38||4848||F8P
|-
|disc02_06h.bik||110||1b2df28||2008528||BIK
|-
|disc02_06l.bik||110||1d184f8||908540||BIK
|-
|disc02_07.cam||300||1df61f4||13208||F8P
|-
|disc02_07h.bik||300||1df958c||5197180||BIK
|-
|disc02_07l.bik||300||22ee308||2299856||BIK
|-
|disc02_08.cam||75||251fad8||3308||F8P
|-
|disc02_08h.bik||75||25207c4||1331060||BIK
|-
|disc02_08l.bik||75||2665738||580980||BIK
|-
|disc02_09.cam||728||26f34ac||32040||F8P
|-
|disc02_09h.bik||728||26fb1d4||13015424||BIK
|-
|disc02_09l.bik||728||3364b54||5734772||BIK
|-
|disc02_10.cam||120||38dccc8||5288||F8P
|-
|disc02_10h.bik||120||38de170||2201640||BIK
|-
|disc02_10l.bik||120||3af7998||1001672||BIK
|-
|disc02_11.cam||315||3bec260||13868||F8P
|-
|disc02_11h.bik||315||3bef88c||5698360||BIK
|-
|disc02_11l.bik||315||415ebc4||2548364||BIK
|-
|disc02_12.cam||226||43cce50||9952||F8P
|-
|disc02_12h.bik||226||43cf530||4078040||BIK
|-
|disc02_12l.bik||226||47b2f08||1818104||BIK
|-
|disc02_13.cam||611||496ed00||26892||F8P
|-
|disc02_13h.bik||611||497560c||10918000||BIK
|-
|disc02_13l.bik||611||53dee7c||4793772||BIK
|-
|disc02_14.cam||105||5871428||4628||F8P
|-
|disc02_14h.bik||105||587263c||1924220||BIK
|-
|disc02_14l.bik||105||5a482b8||874880||BIK
|-
|disc02_15.cam||255||5b1dc38||11228||F8P
|-
|disc02_15h.bik||255||5b20814||4525952||BIK
|-
|disc02_15l.bik||255||5f71794||2026736||BIK
|-
|disc02_16.cam||233||6160484||10260||F8P
|-
|disc02_16h.bik||233||6162c98||4248316||BIK
|-
|disc02_16l.bik||233||656ff94||1918400||BIK
|-
|disc02_17.cam||90||6744554||3968||F8P
|-
|disc02_17h.bik||90||67454d4||1628548||BIK
|-
|disc02_17l.bik||90||68d2e58||728508||BIK
|-
|disc02_18.cam||90||6984c14||3968||F8P
|-
|disc02_18h.bik||90||6985b94||1614036||BIK
|-
|disc02_18l.bik||90||6b0fc68||714012||BIK
|-
|disc02_19.cam||162||6bbe184||7136||F8P
|-
|disc02_19h.bik||162||6bbfd64||2733948||BIK
|-
|disc02_19l.bik||162||6e5b4e0||1195420||BIK
|-
|disc02_20.cam||275||6f7f27c||12108||F8P
|-
|disc02_20h.bik||275||6f821c8||4904472||BIK
|-
|disc02_20l.bik||275||742f7e0||2154376||BIK
|-
|disc02_21.cam||280||763d768||12328||F8P
|-
|disc02_21h.bik||280||7640790||4514208||BIK
|-
|disc02_21l.bik||280||7a8e930||1987908||BIK
|-
|disc02_22.cam||90||7c73e74||3968||F8P
|-
|disc02_22h.bik||90||7c74df4||1650640||BIK
|-
|disc02_22l.bik||90||7e07dc4||750740||BIK
|-
|disc02_23.cam||200||7ebf258||8808||F8P
|-
|disc02_23h.bik||200||7ec14c0||3558312||BIK
|-
|disc02_23l.bik||200||8226068||1558340||BIK
|-
|disc02_24.cam||600||83a27ac||26408||F8P
|-
|disc02_24h.bik||600||83a8ed4||10585392||BIK
|-
|disc02_24l.bik||600||8dc1404||4585408||BIK
|-
|disc02_25.cam||30||9220bc4||1328||F8P
|-
|disc02_25h.bik||30||92210f4||559944||BIK
|-
|disc02_25l.bik||30||92a9c3c||256904||BIK
|-
|disc02_26.cam||410||92e87c4||18048||F8P
|-
|disc02_26h.bik||410||92ece44||7479808||BIK
|-
|disc02_26l.bik||410||9a0f044||3401948||BIK
|-
|disc02_27.cam||130||9d4d920||5728||F8P
|-
|disc02_27h.bik||130||9d4ef80||2423808||BIK
|-
|disc02_27l.bik||130||9f9eb80||1123796||BIK
|-
|disc02_28.cam||376||a0b1154||16552||F8P
|-
|disc02_28h.bik||376||a0b51fc||6874028||BIK
|-
|disc02_28l.bik||376||a7435a8||3114128||BIK
|-
|disc02_29.cam||395||aa3ba38||17388||F8P
|-
|disc02_29h.bik||395||aa3fe24||7284036||BIK
|-
|disc02_29l.bik||395||b132368||3334088||BIK
|-
|disc02_30.cam||625||b460330||27508||F8P
|-
|disc02_30h.bik||625||b466ea4||11211932||BIK
|-
|disc02_30l.bik||625||bf18340||4961628||BIK
|-
|disc02_31.cam||995||c3d389c||43788||F8P
|-
|disc02_31h.bik||995||c3de3a8||17959496||BIK
|-
|disc02_31l.bik||995||d4fedf0||8009592||BIK
|}
===== disc4.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc03_00.cam||390||0||17168||F8P
|-
|disc03_00h.bik||390||4310||7076980||BIK
|-
|disc03_00l.bik||390||6c3f84||3177212||BIK
|-
|disc03_01.cam||1260||9cba80||55448||F8P
|-
|disc03_01h.bik||1260||9d9318||22713736||BIK
|-
|disc03_01l.bik||1260||1f828a0||10113788||BIK
|-
|disc03_02.cam||285||2927b9c||12548||F8P
|-
|disc03_02h.bik||285||292aca0||5103348||BIK
|-
|disc03_02l.bik||285||2e08b94||2252028||BIK
|-
|disc03_03.cam||225||302e890||9908||F8P
|-
|disc03_03h.bik||225||3030f44||4064732||BIK
|-
|disc03_03l.bik||225||3411520||1814904||BIK
|-
|disc03_04.cam||4348||35cc698||191320||F8P
|-
|disc03_04h.bik||4345||35fb1f0||75274524||BIK
|-
|disc03_04l.bik||4345||7dc4b0c||32520396||BIK
|-
|disc03_05.cam||3065||9cc83d8||134868||F8P
|-
|disc03_05h.bik||3065||9ce92ac||28030204||BIK
|-
|disc03_05l.bik||3065||b7a47a8||15064748||BIK
|-
|disc03_06.cam||7091||c602654||312012||F8P
|-
|disc03_06h.bik||7091||c64e920||124325396||BIK
|-
|disc03_06l.bik||7091||13cdf734||55224860||BIK
|}
===== publish.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc04_00h.bik||117||0||196276||BIK
|-
|disc04_00l.bik||117||2feb4||86240||BIK
|}

FF8/FileFormat PAK

2020-11-01T17:58:32Z

Sebanisu: /* PAK File Structure */ added tables breaking down the layout of the pak files.

Final Fantasy VIII's movie files are stored within pak files. This is for the CD 2000 version only. Steam 2013 version uses avi files. '''publish.pak''' contains the message "Published by Square Electronic Arts L.L.C.". '''disc1.pak''', '''disc2.pak''', '''disc3.pak''', and '''disc4.pak''' hold the rest of the FMV movies.

=PAK File Structure=
The PAK file has no header. Each movie usually contains a CAM file and two BINK videos. A PAK file can contain multiple movies. One BINK file is the low res the other is the high res.
{| class="wikitable"
|-
! Section !! Description
|-
| CAM - optional || Camera data
|-
| BINK - high res || FMV video
|-
| BINK - low res || FMV video
|}

===Existing projects you can use to extract the PAK files.===
* https://github.com/MaKiPL/OpenVIII-monogame/tree/master/PAK%20Extractor
* https://github.com/MaKiPL/FF8-Rinoa-s-Toolset/blob/master/SerahToolkit_SharpGL/FF8_Core/PlayMovie.cs
* https://github.com/Sebanisu/OpenVIII_CPP_WIP/tree/master/src/open_viii/pak

==BINK files==
* Start with 0x42494B "BIK"
* More info: https://wiki.multimedia.cx/index.php/Bink_Container

==CAM files==
* Each frame is 44 bytes long.
{| class="wikitable"
|-
! Offset !! Size !! Description
|-
| 0 || 3 bytes || 0x463850 "F8P"
|-
| 6 || 2 bytes (uint16) || Approx number of frames. There can be extra data.
|-
| 8 || 44 bytes * number of frames || Frame data. Each frame ends with "END"
|}

== Pak File Details ==
===== disc1.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc00_00.cam||326||0||14352||F8P
|-
|disc00_00h.bik||326||3810||5759124||BIK
|-
|disc00_00l.bik||326||5818a4||2498748||BIK
|-
|disc00_01.cam||199||7e3960||8764||F8P
|-
|disc00_01h.bik||205||7e5b9c||3572420||BIK
|-
|disc00_01l.bik||205||b4de60||1522312||BIK
|-
|disc00_02.cam||161||cc18e8||7092||F8P
|-
|disc00_02h.bik||161||cc349c||2805776||BIK
|-
|disc00_02l.bik||161||f704ac||1410720||BIK
|-
|disc00_03.cam||1100||10c8b4c||48408||F8P
|-
|disc00_03h.bik||1100||10d4864||19654004||BIK
|-
|disc00_03l.bik||1100||2392dd8||8597316||BIK
|-
|disc00_04.cam||215||2bc5d1c||9468||F8P
|-
|disc00_04h.bik||215||2bc8218||3778948||BIK
|-
|disc00_04l.bik||215||2f62b9c||1628944||BIK
|-
|disc00_05.cam||1114||30f06ac||49024||F8P
|-
|disc00_05h.bik||1114||30fc62c||20063552||BIK
|-
|disc00_05l.bik||1114||441eb6c||8923620||BIK
|-
|disc00_06.cam||41||4ca1550||1812||F8P
|-
|disc00_06h.bik||41||4ca1c64||757108||BIK
|-
|disc00_06l.bik||41||4d5a9d8||347236||BIK
|-
|disc00_07.cam||1084||4daf63c||47704||F8P
|-
|disc00_07h.bik||1084||4dbb094||19696056||BIK
|-
|disc00_07l.bik||1084||6083a4c||8855428||BIK
|-
|disc00_08.cam||324||68f59d0||14264||F8P
|-
|disc00_08h.bik||324||68f9188||4736972||BIK
|-
|disc00_08l.bik||324||6d7d954||2073440||BIK
|-
|disc00_09.cam||1391||6f77cb4||61212||F8P
|-
|disc00_09h.bik||1391||6f86bd0||24180228||BIK
|-
|disc00_09l.bik||1391||86961d4||10270268||BIK
|-
|disc00_10.cam||393||9061810||17300||F8P
|-
|disc00_10h.bik||393||9065ba4||7195820||BIK
|-
|disc00_10l.bik||393||9742850||3265804||BIK
|-
|disc00_11.cam||465||9a5fd5c||20468||F8P
|-
|disc00_11h.bik||465||9a64d50||8496456||BIK
|-
|disc00_11l.bik||465||a27f298||3846440||BIK
|-
|disc00_12.cam||45||a62a3c0||1988||F8P
|-
|disc00_12h.bik||45||a62ab84||752040||BIK
|-
|disc00_12l.bik||45||a6e252c||300964||BIK
|-
|disc00_13.cam||15||a72bcd0||668||F8P
|-
|disc00_13h.bik||15||a72bf6c||249788||BIK
|-
|disc00_13l.bik||15||a768f28||99988||BIK
|-
|disc00_14.cam||360||a7815bc||15848||F8P
|-
|disc00_14h.bik||360||a7853a4||6369460||BIK
|-
|disc00_14l.bik||360||ad98458||2769344||BIK
|-
|disc00_15.cam||300||b03c618||13208||F8P
|-
|disc00_15h.bik||300||b03f9b0||5236916||BIK
|-
|disc00_15l.bik||300||b53e264||2236992||BIK
|-
|disc00_16.cam||150||b7604a4||6608||F8P
|-
|disc00_16h.bik||150||b761e74||2776716||BIK
|-
|disc00_16l.bik||150||ba07d00||1276724||BIK
|-
|disc00_17.cam||890||bb3f834||39168||F8P
|-
|disc00_17h.bik||890||bb49134||15823644||BIK
|-
|disc00_17l.bik||890||ca60450||8111120||BIK
|-
|disc00_18.cam||191||d21c860||8412||F8P
|-
|disc00_18h.bik||192||d21e93c||3436444||BIK
|-
|disc00_18l.bik||192||d5658d8||1772548||BIK
|-
|disc00_19.cam||121||d7164dc||5332||F8P
|-
|disc00_19h.bik||121||d7179b0||2155424||BIK
|-
|disc00_19l.bik||121||d925d50||944536||BIK
|-
|disc00_20.cam||401||da0c6e8||17652||F8P
|-
|disc00_20h.bik||401||da10bdc||7142436||BIK
|-
|disc00_20l.bik||401||e0e0800||3132744||BIK
|-
|disc00_21.cam||829||e3dd548||36484||F8P
|-
|disc00_21h.bik||829||e3e63cc||14983636||BIK
|-
|disc00_21l.bik||829||f2305a0||6743692||BIK
|-
|disc00_22.cam||141||f89ec2c||6212||F8P
|-
|disc00_22h.bik||141||f8a0470||2585084||BIK
|-
|disc00_22l.bik||141||fb1766c||1175040||BIK
|-
|disc00_23.cam||550||fc3646c||24208||F8P
|-
|disc00_23h.bik||550||fc3c2fc||9986472||BIK
|-
|disc00_23l.bik||550||105c24a4||4486592||BIK
|-
|disc00_24.cam||575||10a09a64||25308||F8P
|-
|disc00_24h.bik||575||10a0fd40||10441380||BIK
|-
|disc00_24l.bik||575||11404fe4||4692084||BIK
|-
|disc00_25.cam||130||1187e858||5728||F8P
|-
|disc00_25h.bik||130||1187feb8||2438880||BIK
|-
|disc00_25l.bik||130||11ad3598||1140268||BIK
|-
|disc00_26.cam||101||11be9bc4||4452||F8P
|-
|disc00_26h.bik||101||11bead28||1792576||BIK
|-
|disc00_26l.bik||101||11da0768||783064||BIK
|-
|disc00_27.cam||306||11e5fa40||13472||F8P
|-
|disc00_27h.bik||306||11e62ee0||5574568||BIK
|-
|disc00_27l.bik||306||123b3e88||2513668||BIK
|-
|disc00_28.cam||432||1261998c||19016||F8P
|-
|disc00_28h.bik||432||1261e3d4||7643824||BIK
|-
|disc00_28l.bik||432||12d68684||3323692||BIK
|-
|disc00_29.cam||750||13093db0||33008||F8P
|-
|disc00_29h.bik||750||1309bea0||13517424||BIK
|-
|disc00_29l.bik||750||13d80110||6015936||BIK
|-
|disc00_30.cam||2897||1433ccd0||127476||F8P
|-
|disc00_30h.bik||2925||1435bec4||49898052||BIK
|-
|disc00_30l.bik||2925||172f2108||22289504||BIK
|}
===== disc2.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc01_00.cam||453||0||19940||F8P
|-
|disc01_00h.bik||453||4de4||8128812||BIK
|-
|disc01_00l.bik||453||7c5710||3597828||BIK
|-
|disc01_01.cam||278||b33d14||12240||F8P
|-
|disc01_01h.bik||278||b36ce4||4869600||BIK
|-
|disc01_01l.bik||278||fdbac4||2060252||BIK
|-
|disc01_02.cam||330||11d2aa0||14528||F8P
|-
|disc01_02h.bik||330||11d6360||5962524||BIK
|-
|disc01_02l.bik||330||1785e7c||2662428||BIK
|-
|disc01_03.cam||450||1a0fe98||19808||F8P
|-
|disc01_03h.bik||450||1a14bf8||8227052||BIK
|-
|disc01_03l.bik||450||21ed4e4||3724748||BIK
|-
|disc01_04.cam||168||257aab0||7400||F8P
|-
|disc01_04h.bik||168||257c798||3036032||BIK
|-
|disc01_04l.bik||168||2861b18||1356172||BIK
|-
|disc01_05.cam||219||29acca4||9644||F8P
|-
|disc01_05h.bik||219||29af250||4033920||BIK
|-
|disc01_05l.bik||219||2d87fd0||1843800||BIK
|-
|disc01_06.cam||104||2f4a228||4584||F8P
|-
|disc01_06h.bik||104||2f4b410||1894044||BIK
|-
|disc01_06l.bik||104||3119aac||853980||BIK
|-
|disc01_07.cam||160||31ea288||7048||F8P
|-
|disc01_07h.bik||160||31ebe10||2909428||BIK
|-
|disc01_07l.bik||160||34b2304||1309396||BIK
|-
|disc01_08.cam||381||35f1dd8||16772||F8P
|-
|disc01_08h.bik||381||35f5f5c||6936652||BIK
|-
|disc01_08l.bik||381||3c937a8||3126604||BIK
|-
|disc01_09.cam||226||3f8ecf4||9952||F8P
|-
|disc01_09h.bik||226||3f913d4||4177224||BIK
|-
|disc01_09l.bik||226||438d11c||1917924||BIK
|-
|disc01_10.cam||416||4561500||18312||F8P
|-
|disc01_10h.bik||416||4565c88||7604492||BIK
|-
|disc01_10l.bik||416||4ca6594||3444452||BIK
|-
|disc01_11.cam||603||4fef478||26540||F8P
|-
|disc01_11h.bik||603||4ff5c24||10981628||BIK
|-
|disc01_11l.bik||603||5a6ed20||4951152||BIK
|-
|disc01_12.cam||335||5f27990||14748||F8P
|-
|disc01_12h.bik||335||5f2b32c||6173264||BIK
|-
|disc01_12l.bik||335||650e57c||2823184||BIK
|-
|disc01_13.cam||381||67bf98c||16772||F8P
|-
|disc01_13h.bik||381||67c3b10||6843600||BIK
|-
|disc01_13l.bik||381||6e4a7e0||3034044||BIK
|-
|disc01_14.cam||531||712f39c||23372||F8P
|-
|disc01_14h.bik||531||7134ee8||9498260||BIK
|-
|disc01_14l.bik||531||7a43d7c||4188788||BIK
|-
|disc01_15.cam||120||7e427f0||5288||F8P
|-
|disc01_15h.bik||120||7e43c98||2224344||BIK
|-
|disc01_15l.bik||120||8062d70||1024412||BIK
|-
|disc01_16.cam||149||815cf0c||6564||F8P
|-
|disc01_16h.bik||149||815e8b0||2754272||BIK
|-
|disc01_16l.bik||149||83fef90||1264204||BIK
|-
|disc01_17.cam||150||85339dc||6608||F8P
|-
|disc01_17h.bik||150||85353ac||2722300||BIK
|-
|disc01_17l.bik||150||87cdda8||1221752||BIK
|-
|disc01_18.cam||255||88f8220||11228||F8P
|-
|disc01_18h.bik||255||88fadfc||4656768||BIK
|-
|disc01_18l.bik||255||8d6bc7c||2106780||BIK
|-
|disc01_19.cam||428||8f6e218||18840||F8P
|-
|disc01_19h.bik||428||8f72bb0||7841392||BIK
|-
|disc01_19l.bik||428||96ed220||3561280||BIK
|-
|disc01_20.cam||150||9a52960||6608||F8P
|-
|disc01_20h.bik||150||9a54330||2667756||BIK
|-
|disc01_20l.bik||150||9cdf81c||1168116||BIK
|-
|disc01_21.cam||75||9dfcb10||3308||F8P
|-
|disc01_21h.bik||75||9dfd7fc||1396348||BIK
|-
|disc01_21l.bik||75||9f52678||646296||BIK
|-
|disc01_22.cam||120||9ff0310||5288||F8P
|-
|disc01_22h.bik||120||9ff17b8||2132696||BIK
|-
|disc01_22l.bik||120||a1fa290||932544||BIK
|-
|disc01_23.cam||285||a2ddd50||12548||F8P
|-
|disc01_23h.bik||285||a2e0e54||5164156||BIK
|-
|disc01_23l.bik||285||a7cdad0||2314168||BIK
|-
|disc01_24.cam||330||aa02a88||14528||F8P
|-
|disc01_24h.bik||330||aa06348||6084528||BIK
|-
|disc01_24l.bik||330||afd3af8||2784636||BIK
|-
|disc01_25.cam||300||b27b874||13208||F8P
|-
|disc01_25h.bik||300||b27ec0c||5413124||BIK
|-
|disc01_25l.bik||300||b7a8510||2413380||BIK
|-
|disc01_26.cam||120||b9f5854||5288||F8P
|-
|disc01_26h.bik||120||b9f6cfc||2180104||BIK
|-
|disc01_26l.bik||120||bc0b104||980208||BIK
|-
|disc01_27.cam||75||bcfa5f4||3308||F8P
|-
|disc01_27h.bik||75||bcfb2e0||1345552||BIK
|-
|disc01_27l.bik||75||be43af0||595492||BIK
|-
|disc01_28.cam||120||bed5114||5288||F8P
|-
|disc01_28h.bik||120||bed65bc||2180512||BIK
|-
|disc01_28l.bik||120||c0eab5c||980596||BIK
|-
|disc01_29.cam||692||c1da1d0||30456||F8P
|-
|disc01_29h.bik||692||c1e18c8||12448828||BIK
|-
|disc01_29l.bik||692||cdc0d04||5528956||BIK
|-
|disc01_30.cam||120||d306a80||5288||F8P
|-
|disc01_30h.bik||120||d307f28||2194876||BIK
|-
|disc01_30l.bik||120||d51fce4||994700||BIK
|-
|disc01_31.cam||135||d612a70||5948||F8P
|-
|disc01_31h.bik||135||d6141ac||2480668||BIK
|-
|disc01_31l.bik||135||d871bc8||1130648||BIK
|-
|disc01_32.cam||327||d985c60||14396||F8P
|-
|disc01_32h.bik||327||d98949c||5902052||BIK
|-
|disc01_32l.bik||327||df2a380||2628608||BIK
|-
|disc01_33.cam||1186||e1abf80||52192||F8P
|-
|disc01_33h.bik||1186||e1b8b60||21305376||BIK
|-
|disc01_33l.bik||1186||f60a380||9445316||BIK
|}
===== disc3.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc02_00.cam||197||0||8676||F8P
|-
|disc02_00h.bik||197||21e4||3641072||BIK
|-
|disc02_00l.bik||197||37b0d4||1670856||BIK
|-
|disc02_01.cam||472||512f9c||20776||F8P
|-
|disc02_01h.bik||472||5180c4||8222124||BIK
|-
|disc02_01l.bik||472||cef670||3725124||BIK
|-
|disc02_02.cam||105||107cdb4||4628||F8P
|-
|disc02_02h.bik||105||107dfc8||1970280||BIK
|-
|disc02_02l.bik||105||125f030||919644||BIK
|-
|disc02_03.cam||105||133f88c||4628||F8P
|-
|disc02_03h.bik||105||1340aa0||1958900||BIK
|-
|disc02_03l.bik||105||151ee94||909292||BIK
|-
|disc02_04.cam||106||15fce80||4672||F8P
|-
|disc02_04h.bik||106||15fe0c0||1887824||BIK
|-
|disc02_04l.bik||106||17caf10||827636||BIK
|-
|disc02_05.cam||106||1895004||4672||F8P
|-
|disc02_05h.bik||106||1896244||1887052||BIK
|-
|disc02_05l.bik||106||1a62d90||827048||BIK
|-
|disc02_06.cam||110||1b2cc38||4848||F8P
|-
|disc02_06h.bik||110||1b2df28||2008528||BIK
|-
|disc02_06l.bik||110||1d184f8||908540||BIK
|-
|disc02_07.cam||300||1df61f4||13208||F8P
|-
|disc02_07h.bik||300||1df958c||5197180||BIK
|-
|disc02_07l.bik||300||22ee308||2299856||BIK
|-
|disc02_08.cam||75||251fad8||3308||F8P
|-
|disc02_08h.bik||75||25207c4||1331060||BIK
|-
|disc02_08l.bik||75||2665738||580980||BIK
|-
|disc02_09.cam||728||26f34ac||32040||F8P
|-
|disc02_09h.bik||728||26fb1d4||13015424||BIK
|-
|disc02_09l.bik||728||3364b54||5734772||BIK
|-
|disc02_10.cam||120||38dccc8||5288||F8P
|-
|disc02_10h.bik||120||38de170||2201640||BIK
|-
|disc02_10l.bik||120||3af7998||1001672||BIK
|-
|disc02_11.cam||315||3bec260||13868||F8P
|-
|disc02_11h.bik||315||3bef88c||5698360||BIK
|-
|disc02_11l.bik||315||415ebc4||2548364||BIK
|-
|disc02_12.cam||226||43cce50||9952||F8P
|-
|disc02_12h.bik||226||43cf530||4078040||BIK
|-
|disc02_12l.bik||226||47b2f08||1818104||BIK
|-
|disc02_13.cam||611||496ed00||26892||F8P
|-
|disc02_13h.bik||611||497560c||10918000||BIK
|-
|disc02_13l.bik||611||53dee7c||4793772||BIK
|-
|disc02_14.cam||105||5871428||4628||F8P
|-
|disc02_14h.bik||105||587263c||1924220||BIK
|-
|disc02_14l.bik||105||5a482b8||874880||BIK
|-
|disc02_15.cam||255||5b1dc38||11228||F8P
|-
|disc02_15h.bik||255||5b20814||4525952||BIK
|-
|disc02_15l.bik||255||5f71794||2026736||BIK
|-
|disc02_16.cam||233||6160484||10260||F8P
|-
|disc02_16h.bik||233||6162c98||4248316||BIK
|-
|disc02_16l.bik||233||656ff94||1918400||BIK
|-
|disc02_17.cam||90||6744554||3968||F8P
|-
|disc02_17h.bik||90||67454d4||1628548||BIK
|-
|disc02_17l.bik||90||68d2e58||728508||BIK
|-
|disc02_18.cam||90||6984c14||3968||F8P
|-
|disc02_18h.bik||90||6985b94||1614036||BIK
|-
|disc02_18l.bik||90||6b0fc68||714012||BIK
|-
|disc02_19.cam||162||6bbe184||7136||F8P
|-
|disc02_19h.bik||162||6bbfd64||2733948||BIK
|-
|disc02_19l.bik||162||6e5b4e0||1195420||BIK
|-
|disc02_20.cam||275||6f7f27c||12108||F8P
|-
|disc02_20h.bik||275||6f821c8||4904472||BIK
|-
|disc02_20l.bik||275||742f7e0||2154376||BIK
|-
|disc02_21.cam||280||763d768||12328||F8P
|-
|disc02_21h.bik||280||7640790||4514208||BIK
|-
|disc02_21l.bik||280||7a8e930||1987908||BIK
|-
|disc02_22.cam||90||7c73e74||3968||F8P
|-
|disc02_22h.bik||90||7c74df4||1650640||BIK
|-
|disc02_22l.bik||90||7e07dc4||750740||BIK
|-
|disc02_23.cam||200||7ebf258||8808||F8P
|-
|disc02_23h.bik||200||7ec14c0||3558312||BIK
|-
|disc02_23l.bik||200||8226068||1558340||BIK
|-
|disc02_24.cam||600||83a27ac||26408||F8P
|-
|disc02_24h.bik||600||83a8ed4||10585392||BIK
|-
|disc02_24l.bik||600||8dc1404||4585408||BIK
|-
|disc02_25.cam||30||9220bc4||1328||F8P
|-
|disc02_25h.bik||30||92210f4||559944||BIK
|-
|disc02_25l.bik||30||92a9c3c||256904||BIK
|-
|disc02_26.cam||410||92e87c4||18048||F8P
|-
|disc02_26h.bik||410||92ece44||7479808||BIK
|-
|disc02_26l.bik||410||9a0f044||3401948||BIK
|-
|disc02_27.cam||130||9d4d920||5728||F8P
|-
|disc02_27h.bik||130||9d4ef80||2423808||BIK
|-
|disc02_27l.bik||130||9f9eb80||1123796||BIK
|-
|disc02_28.cam||376||a0b1154||16552||F8P
|-
|disc02_28h.bik||376||a0b51fc||6874028||BIK
|-
|disc02_28l.bik||376||a7435a8||3114128||BIK
|-
|disc02_29.cam||395||aa3ba38||17388||F8P
|-
|disc02_29h.bik||395||aa3fe24||7284036||BIK
|-
|disc02_29l.bik||395||b132368||3334088||BIK
|-
|disc02_30.cam||625||b460330||27508||F8P
|-
|disc02_30h.bik||625||b466ea4||11211932||BIK
|-
|disc02_30l.bik||625||bf18340||4961628||BIK
|-
|disc02_31.cam||995||c3d389c||43788||F8P
|-
|disc02_31h.bik||995||c3de3a8||17959496||BIK
|-
|disc02_31l.bik||995||d4fedf0||8009592||BIK
|}
===== disc4.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc03_00.cam||390||0||17168||F8P
|-
|disc03_00h.bik||390||4310||7076980||BIK
|-
|disc03_00l.bik||390||6c3f84||3177212||BIK
|-
|disc03_01.cam||1260||9cba80||55448||F8P
|-
|disc03_01h.bik||1260||9d9318||22713736||BIK
|-
|disc03_01l.bik||1260||1f828a0||10113788||BIK
|-
|disc03_02.cam||285||2927b9c||12548||F8P
|-
|disc03_02h.bik||285||292aca0||5103348||BIK
|-
|disc03_02l.bik||285||2e08b94||2252028||BIK
|-
|disc03_03.cam||225||302e890||9908||F8P
|-
|disc03_03h.bik||225||3030f44||4064732||BIK
|-
|disc03_03l.bik||225||3411520||1814904||BIK
|-
|disc03_04.cam||4348||35cc698||191320||F8P
|-
|disc03_04h.bik||4345||35fb1f0||75274524||BIK
|-
|disc03_04l.bik||4345||7dc4b0c||32520396||BIK
|-
|disc03_05.cam||3065||9cc83d8||134868||F8P
|-
|disc03_05h.bik||3065||9ce92ac||28030204||BIK
|-
|disc03_05l.bik||3065||b7a47a8||15064748||BIK
|-
|disc03_06.cam||7091||c602654||312012||F8P
|-
|disc03_06h.bik||7091||c64e920||124325396||BIK
|-
|disc03_06l.bik||7091||13cdf734||55224860||BIK
|}
===== publish.pak =====
{| class="wikitable sortable"
! FileName !! Frames !! Offset !! Size !! Type
|-
|disc04_00h.bik||117||0||196276||BIK
|-
|disc04_00l.bik||117||2feb4||86240||BIK
|}

FF8/FileFormat PAK

2020-11-01T17:20:29Z

Sebanisu: updated message about publish.pak contents.

FF8/FileFormat PAK

2020-11-01T00:49:19Z

Sebanisu: /* CAM files */ minor change I noticed that each of the frames ends with "END"

Final Fantasy VIII's movie files are stored within pak files. This is for the CD 2000 version only. Steam 2013 version uses avi files. '''publish.pak''' contains the Eidos logo. '''disc1.pak''', '''disc2.pak''', '''disc3.pak''', and '''disc4.pak''' hold the rest of the FMV movies.

=PAK File Structure=
The PAK file has no header. Each movie usually contains a CAM file and two BINK videos. A PAK file can contain multiple movies. One BINK file is the low res the other is the high res.
{| class="wikitable"
|-
! Section !! Description
|-
| CAM - optional || Camera data
|-
| BINK - high res || FMV video
|-
| BINK - low res || FMV video
|}

Existing projects you can use to extract the PAK files.
* https://github.com/MaKiPL/OpenVIII-monogame/tree/master/PAK%20Extractor
* https://github.com/MaKiPL/FF8-Rinoa-s-Toolset/blob/master/SerahToolkit_SharpGL/FF8_Core/PlayMovie.cs
* https://github.com/Sebanisu/OpenVIII_CPP_WIP/tree/master/src/open_viii/pak

==BINK files==
* Start with 0x42494B "BIK"
* More info: https://wiki.multimedia.cx/index.php/Bink_Container

==CAM files==
* Each frame is 44 bytes long.
{| class="wikitable"
|-
! Offset !! Size !! Description
|-
| 0 || 3 bytes || 0x463850 "F8P"
|-
| 6 || 2 bytes (uint16) || Approx number of frames. There can be extra data.
|-
| 8 || 44 bytes * number of frames || Frame data. Each frame ends with "END"
|}

FF8/FileFormat PAK

2020-11-01T00:20:10Z

Sebanisu: /* PAK File Structure */ added a new table laying out the order of the data. and added a new link

FF8/FileFormat PAK

2020-10-31T02:09:02Z

Sebanisu: added note about which version of the game uses PAK files.

Final Fantasy VIII's movie files are stored within pak files. This is for the CD 2000 version only. Steam 2013 version uses avi files. '''publish.pak''' contains the Eidos logo. '''disc1.pak''', '''disc2.pak''', '''disc3.pak''', and '''disc4.pak''' hold the rest of the FMV movies.

=PAK File Structure=
The PAK file has no header. Each movie usually contains two BINK videos and a CAM file. A PAK file can contain multiple movies. One BINK file is the low res the other is the high res.

Existing projects you can use to extract the PAK files.
* https://github.com/MaKiPL/OpenVIII-monogame/tree/master/PAK%20Extractor
* https://github.com/MaKiPL/FF8-Rinoa-s-Toolset/blob/master/SerahToolkit_SharpGL/FF8_Core/PlayMovie.cs

==BINK files==
* Start with 0x42494B "BIK"
* More info: https://wiki.multimedia.cx/index.php/Bink_Container

==CAM files==

{| class="wikitable"
|-
! Offset !! Size !! Description
|-
| 0 || 3 bytes || 0x463850 "F8P"
|-
| 6 || 2 bytes (uint16) || Approx number of frames can be extra
|}

FF8/FileFormat PAK

2020-10-31T00:14:37Z

Sebanisu: WIP I got a start on the PAK article. As I figure more out of this file type i'll update this.

Final Fantasy 8's movie files are stored within pak files. The '''publish.pak''' contains the Eidos logo. '''disc1.pak''', '''disc2.pak''', '''disc3.pak''', and '''disc4.pak''' hold the rest of the fmv movies.

=PAK File Structure=
The PAK file has no header. Each movie usually contains two BINK videos and a CAM file. A PAK file can contain multiple movies. One BINK file is the low res the other is the high res.

Existing projects you can use to extract the PAK files.
* https://github.com/MaKiPL/OpenVIII-monogame/tree/master/PAK%20Extractor
* https://github.com/MaKiPL/FF8-Rinoa-s-Toolset/blob/master/SerahToolkit_SharpGL/FF8_Core/PlayMovie.cs

==BINK files==
* Start with 0x42494B "BIK"
* More info: https://wiki.multimedia.cx/index.php/Bink_Container

==CAM files==

{| class="wikitable"
|-
! Offset !! Size !! Description
|-
| 0 || 3 bytes || 0x463850 "F8P"
|-
| 6 || 2 bytes (uint16) || Approx number of frames can be extra
|}

FF8

2020-10-30T23:31:23Z

Sebanisu: /* File Formats */ adding info about Pak files used in ff8 2000 cd version of the game.

= Contents =
=== History ===
Final Fantasy VIII came after the mega hit [[FF7|Final Fantasy VII]], it in itself was a very successful game release for Square. For more on the [[FF8/HistoryOf|history of Final Fantasy VIII read here]]. The Game Engine
* [[FF8/Engine|Final Fantasy VIII's Engine]]
=== Engine constants ===
* [[FF8/Engine_const/BattleFiles|Array of Battle files]]
=== Details of the Game ===
* [[FF8/Kernel|Final Fantasy VIII's Kernel]]
* [[FF8/Variables|Game variables used in scripting]]
* [[FF8/Engine/WorldMapCamera|World map camera]]
* [[FF8/Encounter_Codes|Battle encounters list]]
* [[FF8/String_Encoding|String Encoding]]

=== Media Formats ===
* [[FF8/PlaystationMedia|Final Fantasy VIII PS1]] media information.
* [[FF8/PC_Media|Final Fantasy VIII PC]] media information.
* [[FF8/GameSaveFormat|Final Fantasy VIII Save data]]
 
= File Formats =
=== Movie Files ===
* [[FF8/FileFormat_PAK|[PAK]]] Movie Archives
=== Sound Files ===
* [[FF8/FileFormat_FMT|[FMT]]] Sound Archives
=== Battle files ===
* [[FF8/FileFormat_X|[X]]] Battle Fields
* [[FF8/FileFormat_DAT|[DAT]]] Battle Models
* [[FF8/BattleStructure|Scene.out]] Battle encounter data
* [[FF8/FileFormat_r0win|r0win.dat]] Winning sequence
* [[FF8/FileFormat_b0wave|b0wave.dat]] Core battle data (Textures+Music+Font)
* [[FF8/FileFormat_TDW|a9btlfnt.bft]] Battle Font (Redirect to TDW)
* [[FF8/FileFormat_magfiles|.mag files]] - MAG files
=== Field files ===
* [[FF8/Field/Script/Opcodes|Opcodes]] Field script opcodes
* [[FF8/FileFormat_MCH|[MCH]]] Field Character Models
* [[FF8/FileFormat_ONE|[ONE]]] Field Character Models Container
* [[FF8/FileFormat_MIM|[MIM]]] Field Background Image Data
* [[FF8/FileFormat_MAP|[MAP]]] Field Background Tile Data
* [[FF8/FileFormat_JSM|[JSM]]] Field Scripts
* [[FF8/FileFormat_SYM|[SYM]]] Field Script names (unused)
* [[FF8/FileFormat_MSD|[MSD]]] Field Dialogs
* [[FF8/FileFormat_INF|[INF]]] Field Gateways
* [[FF7/Field/Walkmesh|[ID]]] Field Walkmesh (same format as FF7)
* [[FF8/FileFormat_CA|[CA]]] Field Camera
* [[FF8/FileFormat_TDW|[TDW]]] Extra font
* [[FF8/FileFormat_MSK|[MSK]]] Movie cam (?)
* [[FF8/FileFormat_RAT_MRT|[RAT]] & [MRT]] Battle related
* [[FF8/FileFormat_PMD|[PMD]]] Particle Info
* [[FF8/FileFormat_PMP|[PMP]]] Particle Image Data
* [[FF8/FileFormat_PVP|[PVP]]] Unknown (often 0x0c000000, sometimes 0x0a000000 or 0x0b000000)
* [[FF8/FileFormat_SFX|[SFX]]] Indexes to Sound Effects (?)

=== World map files ===
* [[FF8/WorldMap_music|music0.obj]]
* [[FF8/WorldMap_music|music1.obj]]
* [[FF8/WorldMap_music|music2.obj]]
* [[FF8/WorldMap_music|music3.obj]]
* [[FF8/WorldMap_music|music4.obj]]
* [[FF8/WorldMap_music|music5.obj]]
* [[FF8/WorldMap_rail|rail.obj]]
* [[FF8/WorldMap_texl|texl.obj]]
* [[FF8/WorldMap_wmset|wmset.obj]]
* [[FF8/WorldMap_wmsetxx|wmsetXX.obj]]
* [[FF8/WorldMap_wmx|wmx.obj]]
* [[FF8/WorldMap_charaone|chara.one]]

=== Main ===
* [[FF8/Main_wm2|wm2field.tbl]]
* [[FF8/Main_kernel|kernel.bin]]
* [[FF8/Main_harata|harata.cnf]]
* [[FF8/Main_init|init.out]]
* [[FF8/Main_namedic|namedic.bin]]
=== Menu ===
* [[FF8/Menu_sp2|*.sp1/*.sp2]]
* [[FF8/Menu_mngrphd_bin|mngrphd.bin]]
* [[FF8/Menu_mngrp_bin|mngrp.bin]]
* [[FF8/Menu_tkmnmes|tkmnmes*.bin]]
* [[Ff8/Menu_mag_textures|mag*.tex]]
* [[FF8/Menu_mngrp_strings_locations|mngrp strings]]
* [[FF8/Menu_mngrp_complex_strings|mngrp complex strings]]
* [[FF8/Menu_m000_m004|m00*.bin and m00*.msg]]
* [[FF8/Menu_areames_dc1|areames.dc1]]

= Tools and Patches =
* [[FF8/Tools|Tools and Patches]]