yellows111
/
icondumper2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A PS2 Icon parsing library or client
25 Commits 1 Branch 0 Tags 107 KiB
JavaScript 67.9%
HTML 32.1%
Go to file
yellows111 5738fbb09c fix SPS/XPS crash, example icon 
fix sps/xps parser crash: apparently those 4 bytes were for a third part of metadata for those files. HTML client now shows this information if available.

example icon: id2_example_001 (12 vertices, 4 triangles)

I've saved and included this icon in the .PSU and .SPS formats. .PSV is a bit more complicated for a valid export.

Example icon shows vertex colours with no animation nor includes a texture (texture type 3).

was considering adding new formats, but its not one of the big five (translation: not MAX/PWS or CBS), and I can barely find any examples to test with. Oh well. adding them to gitignore already. If the demand comes up, I've made the related hexpat's for them anyway.

.xpo and .spo (assuming they're like .xpo files) files are out of scope for this project, if anyone asks. Reason being is that they usually exclude icon data, and even icon.sys. This makes it rather useless to me.
 		2023-12-03 17:32:26 +00:00
.github/workflows fix SPS/XPS crash, example icon 2023-12-03 17:32:26 +00:00
examples/example_001 fix SPS/XPS crash, example icon 2023-12-03 17:32:26 +00:00
.gitignore fix SPS/XPS crash, example icon 2023-12-03 17:32:26 +00:00
README.md Condense type forwarders into a class for less code reuse. 2023-11-29 13:25:58 +00:00
gltf-exporter.js DOS->Unix conversion 2023-11-08 10:07:57 +00:00
icon.js fix SPS/XPS crash, example icon 2023-12-03 17:32:26 +00:00
index.htm fix SPS/XPS crash, example icon 2023-12-03 17:32:26 +00:00
index.js DOS->Unix conversion 2023-11-08 10:07:57 +00:00

README.md

icondumper2 (working title)

A JavaScript library (sorta) to read PS2 icons, and their related formats.

What it supports

  • EMS Memory Adapter export files (.psu)
  • PS3 virtual memory card export files (.psv)
  • SharkPort export files (.sps)
  • X-Port export files (.xps)
  • PS2 icons (.ico, .icn)
  • PS2D format (icon.sys)

What can it do

  • Allow any file in a PSU's or SPS/XPS's virtual filesystem to be dumped.
  • Warn of invalid icon.sys display names.
  • Read and parse an EMS MA export file.
  • Export the icon model, with all seperate shapes included to a JavaScript Object.
  • Node.js compatible (CommonJS) exporting while still being compatible with other JavaScript implementations.
  • Convert a 128x128x16 BGR5A1 bitmap to a RGB5A1 format.
  • Convert an icon or a set of icons to glTF 2, with textures saved as PNG.

What it doesn't do

  • (Re)build save files.
  • Modify the original input files.
  • Use any Node.js-exclusive features.

Client compatibility

(todo: write this)

Why "icondumper2"?

Because it replaced what was left of icondumper (1).

Included files

File Description
icon.js The library itself.
index.js Node.js example client.
gltf-exporter.js Node.js client to export icons to glTF 2.
index.htm HTML reference client.