jracek/secretsplash
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated Splashpack structure, added imhex project

Browse Source
This commit is contained in:
jracek
2025-04-03 17:52:14 +02:00
parent 6c1a0854c7
commit fa747ad786
5 changed files with 115 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

90
Runtime/PSXSceneExporter.cs
View File

@@ -62,13 +62,17 @@ namespace SplashEdit.RuntimeCode
int totalFaces = 0;
// Lists for mesh data offsets.
List<long> offsetPlaceholderPositions = new List<long>();
List<long> meshOffsetPlaceholderPositions = new List<long>();
List<long> meshDataOffsets = new List<long>();
// Lists for atlas data offsets.
List<long> atlasOffsetPlaceholderPositions = new List<long>();
List<long> atlasDataOffsets = new List<long>();
// Lists for clut data offsets.
List<long> clutOffsetPlaceholderPositions = new List<long>();
List<long> clutDataOffsets = new List<long>();
int clutCount = 0;
// Cluts
@@ -86,18 +90,21 @@ namespace SplashEdit.RuntimeCode
using (BinaryWriter writer = new BinaryWriter(File.Open(path, FileMode.Create)))
{
// Header
writer.Write('S');
writer.Write('P');
writer.Write((ushort)1);
writer.Write((ushort)_exporters.Length);
writer.Write((ushort)_atlases.Length);
writer.Write((ushort)clutCount);
writer.Write((ushort)0);
// Start of Metadata section
writer.Write('S'); // 1 byte
writer.Write('P'); // 1 byte
writer.Write((ushort)1); // 2 bytes - version
writer.Write((ushort)_exporters.Length); // 2 bytes
writer.Write((ushort)_atlases.Length); // 2 bytes
writer.Write((ushort)clutCount); // 2 bytes
for (int i = 0; i < 3; i++) writer.Write((ushort)0);
// GameObject section (exporters)
foreach (PSXObjectExporter exporter in _exporters)
{
// Write placeholder for mesh data offset and record its position.
meshOffsetPlaceholderPositions.Add(writer.BaseStream.Position);
writer.Write((int)0); // 4-byte placeholder for mesh data offset.
// Write object's transform
writer.Write((int)PSXTrig.ConvertCoordinateToPSX(exporter.transform.localToWorldMatrix.GetPosition().x, GTEScaling));
writer.Write((int)PSXTrig.ConvertCoordinateToPSX(-exporter.transform.localToWorldMatrix.GetPosition().y, GTEScaling));
@@ -114,12 +121,8 @@ namespace SplashEdit.RuntimeCode
writer.Write((int)rotationMatrix[2, 1]);
writer.Write((int)rotationMatrix[2, 2]);
// Write placeholder for mesh data offset and record its position.
offsetPlaceholderPositions.Add(writer.BaseStream.Position);
writer.Write((int)0); // 4-byte placeholder for mesh data offset.
writer.Write((int)exporter.Mesh.Triangles.Count);
writer.Write((ushort)exporter.Mesh.Triangles.Count);
writer.Write((ushort) 0);
}
// Atlas metadata section
@@ -142,18 +145,12 @@ namespace SplashEdit.RuntimeCode
{
if (texture.ColorPalette != null)
{
foreach (VRAMPixel clutPixel in texture.ColorPalette)
{
writer.Write((ushort)clutPixel.Pack());
}
for (int i = texture.ColorPalette.Count; i < 256; i++)
{
writer.Write((ushort)0);
}
writer.Write((ushort)texture.ClutPackingX);
writer.Write((ushort)texture.ClutPackingY);
writer.Write((ushort)texture.ColorPalette.Count);
writer.Write((ushort)0);
clutOffsetPlaceholderPositions.Add(writer.BaseStream.Position);
writer.Write((int)0); // 4-byte placeholder for clut data offset.
writer.Write((ushort)texture.ClutPackingX); // 2 bytes
writer.Write((ushort)texture.ClutPackingY); // 2 bytes
writer.Write((ushort)texture.ColorPalette.Count); // 2 bytes
writer.Write((ushort) 0); // 2 bytes
}
}
}
@@ -249,12 +246,31 @@ namespace SplashEdit.RuntimeCode
}
}
// Clut data section
foreach (TextureAtlas atlas in _atlases)
{
foreach (var texture in atlas.ContainedTextures)
{
if (texture.ColorPalette != null)
{
AlignToFourBytes(writer);
long clutDataOffset = writer.BaseStream.Position;
clutDataOffsets.Add(clutDataOffset);
foreach(VRAMPixel color in texture.ColorPalette) {
writer.Write((ushort) color.Pack());
}
}
}
}
// Backfill the mesh data offsets into the metadata section.
if (offsetPlaceholderPositions.Count == meshDataOffsets.Count)
if (meshOffsetPlaceholderPositions.Count == meshDataOffsets.Count)
{
for (int i = 0; i < offsetPlaceholderPositions.Count; i++)
for (int i = 0; i < meshOffsetPlaceholderPositions.Count; i++)
{
writer.Seek((int)offsetPlaceholderPositions[i], SeekOrigin.Begin);
writer.Seek((int)meshOffsetPlaceholderPositions[i], SeekOrigin.Begin);
writer.Write((int)meshDataOffsets[i]);
}
}
@@ -276,6 +292,20 @@ namespace SplashEdit.RuntimeCode
{
Debug.LogError("Mismatch between atlas offset placeholders and atlas data blocks!");
}
// Backfill the clut data offsets into the metadata section.
if (clutOffsetPlaceholderPositions.Count == clutDataOffsets.Count)
{
for (int i = 0; i < clutOffsetPlaceholderPositions.Count; i++)
{
writer.Seek((int)clutOffsetPlaceholderPositions[i], SeekOrigin.Begin);
writer.Write((int)clutDataOffsets[i]);
}
}
else
{
Debug.LogError("Mismatch between clut offset placeholders and clut data blocks!");
}
}
Debug.Log(totalFaces);
}

52
doc/splashbundle.md
View File

@@ -4,7 +4,7 @@ All numeric values are stored in little‐endian format. All offsets are counted
---
## 1. File Header (12 bytes)
## 1. File Header (16 bytes)
| Offset | Size | Type | Description |
| ------ | ---- | ------ | ----------------------------------- |
@@ -13,7 +13,7 @@ All numeric values are stored in little‐endian format. All offsets are counted
| 0x04 | 2 | uint16 | Number of Exporter descriptors |
| 0x06 | 2 | uint16 | Number of Texture Atlas descriptors |
| 0x08 | 2 | uint16 | Number of CLUT descriptors |
| 0x0A | 2 | uint16 | Reserved (always 0) |
| 0x0A | 3*2 | uint16 | Reserved (always 0) |
---
@@ -21,18 +21,19 @@ All numeric values are stored in little‐endian format. All offsets are counted
The metadata section comprises three groups of descriptors.
### 2.1 Exporter Descriptors (56 bytes each)
### 2.1 GameObject Descriptors (56 bytes each)
Each exporter descriptor stores the transform and mesh metadata for one GameObject.
Each gameobject descriptor stores the transform and mesh metadata for one GameObject.
| Offset (per entry) | Size | Type | Description |
| ------------------ | ---- | ------ | --------------------------------- |
| 0x00 | 4 | int | X coordinate (Fixed-point) |
| 0x04 | 4 | int | Y coordinate (Fixed-point) |
| 0x08 | 4 | int | Z coordinate (Fixed-point) |
| 0x0C | 36 | int[9] | 3×3 Rotation matrix (Fixed-point) |
| 0x30 | 4 | int | **Mesh Data Offset Placeholder** |
| 0x34 | 4 | int | Triangle count in the mesh |
| 0x00 | 4 | int | **Mesh Data Offset** |
| 0x04 | 4 | int | X coordinate (Fixed-point) |
| 0x08 | 4 | int | Y coordinate (Fixed-point) |
| 0x0C | 4 | int | Z coordinate (Fixed-point) |
| 0x10 | 36 | int[9] | 3×3 Rotation matrix (Fixed-point) |
| 0x28 | 4 | uint16 | Triangle count in the mesh |
| 0x2A | 2 | uint16 | Reserved |
### 2.2 Texture Atlas Descriptors (12 bytes each)
@@ -46,18 +47,18 @@ Each texture atlas descriptor holds atlas layout data and a placeholder for the
| 0x08 | 2 | uint16 | Atlas position X – relative to VRAM origin |
| 0x0A | 2 | uint16 | Atlas position Y – relative to VRAM origin |
### 2.3 CLUT Descriptors (520 bytes each)
### 2.3 CLUT Descriptors (12 bytes each)
CLUTs are the only data which is stored in the Metadata section.
For each CLUT (Color Lookup Table) associated with an atlas texture that has a palette:
| Offset (per entry) | Size | Type | Description |
| ------------------ | ---- | ----------- | --------------------------------------------------------------------------------- |
| 0x00 | 512 | uint16[256] | Color palette entries (each entry is 2 bytes 16bpp). If unused, entries are zero. |
| 0x200 | 2 | uint16 | CLUT packing X coordinate - already in 16 pixel steps |
| 0x202 | 2 | uint16 | CLUT packing Y coordinate |
| 0x204 | 2 | uint16 | Palette count (number of valid palette entries) |
| 0x206 | 2 | uint16 | Reserved (always 0) |
| ------------------ | ---- | ------ | ----------------------------------------------------- |
| 0x00 | 4 | int | **Clut Data Offset Placeholder** |
| 0x04 | 2 | uint16 | CLUT packing X coordinate - already in 16 pixel steps |
| 0x06 | 2 | uint16 | CLUT packing Y coordinate |
| 0x08 | 2 | uint16 | Palette count (number of valid palette entries) |
| 0x0A | 2 | uint16 | Reserved (always 0) |
---
@@ -72,22 +73,31 @@ For each exporter, a mesh data block is written at the offset specified in its d
#### **Triangle Data Layout (per triangle – 52 bytes total):**
| Field | Size | Description |
| ----------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ----------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Vertex Coordinates** | 3 vertices × 3 × 2 bytes = 18 bytes | For each vertex (v0, v1, v2): X, Y, Z coordinates (int16) |
| **Vertex Normal** | 3 × 2 bytes = 6 bytes | Normal vector for vertex v0 (int16: nx, ny, nz) |
| **Vertex Colors** | 3 vertices × (3 bytes color + 1 byte padding) = 12 bytes | For each vertex (v0, v1, v2): Red, Green, Blue (uint8) plus 1 byte padding |
| **Texture Coordinates (UVs)** | 3 vertices × 2 bytes = 6 bytes | For each vertex (v0, v1, v2): U and V coordinates (uint8), adjusted by texture packing factors |
| **UV Padding** | 2 bytes | Padding (uint16, set to zero) |
| **Texture Attributes** | 2 + 2 + 2 + 2 = 8 bytes | Contains: <br> • Texture page attributes (uint16 – encoded from page X/Y, bit depth, dithering)<br> • Texture CLUT packing X (uint16)<br> • Texture CLUT packing Y (uint16)<br> • Reserved (uint16, set to zero) |
| **Texture Attributes** | 2 bytes | The TPage attribute for the given polygon |
| **Clut X** | 2 bytes | Clut position within VRAM (already predivided by 16) |
| **Clut Y** | 2 bytes | Clut position within VRAM |
| **Padding** | 2 bytes | |
*Triangles are written sequentially. Prior to writing each mesh data block, the file pointer is aligned to a 4-byte boundary.*
### 3.2 Atlas Data Blocks
For each atlas, a raw texture data block is written at the offset specified in its descriptor. Before writing, the file pointer is aligned to a 4-byte boundary.
For each atlas, a raw texture data block is written at the offset specified in its descriptor
- **Raw Texture Data:**
The atlas data is written pixel by pixel as returned by the pixel packing function. The total size equals
*(Atlas Width × Atlas Height)* The data is prepared for a DMA transfer to the VRAM.
### 3.3 Clut Data Blocks
For each clut, a raw pixel data block is written at the offset specified in its descriptor as an array of `uint16` colors already formatted for the VRAM.
---

8
tools.meta Normal file
View File

@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: cf7149f85c29d3f4d9a7f968d8825ffa
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

BIN
tools/imhex.hexproj Normal file
View File

Binary file not shown.

7
tools/imhex.hexproj.meta Normal file
View File

@@ -0,0 +1,7 @@
fileFormatVersion: 2
guid: 871e1f08910e9f329ad3fce5d77c8785
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant: