Load Dark Cloud's models from glTF, and add Enhanced cloth - #234

Summary

Dark Cloud's models, motions, skin weights and bind poses are converted to glTF 2.0 at extraction, through Kazarov's model converter as Dark Cloud 2's are, and the game loads them from there. Cloth gets an optional Enhanced mode that keeps it out of the body. The design, the measurements and what is left for later are in docs/MODEL_FRAMEWORK.md.

Depends on the Kazarov pull request from SirFancyBacon:chronicle-models-on-master (a game profile for the model converter). The submodule pins that branch's head, two commits on top of the current pin.

Models

• Extraction. dcdata extract converts the models with the textures. convert-models writes a conversion to a folder of its own, bake-assets publishes one into extracted data, and strip-models empties the converted originals. The character configuration (.cfg, .clo) is read word for word as the game reads it (tools/dcdata/character_profile.hpp) and handed to Kazarov as a profile reader. Each KEY becomes a named glTF action that keeps its source frames, because Dark Cloud's hit windows compare absolute motion frames. Dark Cloud adds 2,293 names to Kazarov's motion name table.
• Loading. The game's loaders stay as they are. As DataReadLoadFile reads a file, port/src/data/model_gltf.cpp rebuilds every published source inside it (pack members, nested packs, scenes at offsets) and writes it where the disc has it.
• Parity. Models, weights, bind poses and motions come back byte for byte. A source goes in only over the bytes it was converted from, and only if it matches their CRC-32; otherwise the file keeps what it read. Stripped data refuses to start, with a message to rebake, rather than hand the game zeros.
• On the PAL disc, 11,949 sources convert in about four and a half minutes.

Enhanced cloth

Display → Cloth: Original (the default) or Enhanced (video.cloth). Enhanced runs the PS2's step unchanged, then pushes the cloth out of the body the way the step pushes it out of the .clo boxes:

• Arms and legs: a capsule along each joint. Each point keeps the clearance it had when the cloth settled, so cloth authored against an arm stays there, while an arm raised through it pushes it.
• Chest and pelvis: fitted to the character's skinned mesh when the cloth settles, so Toan's deep chest and shallow back are both right.
  • Cloth authored inside the chest, like Toan's collar, goes no deeper than it rests.
  • A limb pressing cloth towards the torso stops it at the surface.

Measured against Original in scripted headless runs:

• Running and turning give the same tick-to-tick motion, neck stretch and hem.
• A quick about-turn swings the poncho round Toan's chest instead of through it.
• In the attract movie, the deepest overlap of his arms and the poncho falls from 0.74 to 0.34.

The clipping left in the attract movie is retail's: the collar is authored inside his chest, and Original shows the same.

Testing

• Unit tests:
  • CharacterProfile.*, on fixtures made in code.
  • ClothEnhanced.*, 14 cases on synthetic skeletons and meshes.
  • ModelGltf.*, opt-in through DC_MODEL_DATA, DC_MODEL_RAW and DC_MODEL_STRIPPED, sharded with DC_MODEL_PART.
• Whole PAL disc:
  • Every model, weight, bind pose and motion rebuilds byte for byte.
  • Every motion keeps its poses in every action.
  • Every motion spliced into its pack matches the disc.
  • Stripped data reads back as the disc's.
• Full suite on lavapipe in the Flatpak SDK: 704 of 709 pass. The five failures are all in Kazarov's graphics tests, which this PR doesn't change:
  • the two GfxValidation cases, because the SDK has no validation layer;
  • GfxMisc.PipelineCache;
  • the two GfxGpuColorWriteMask cases.
• Headless runs of the attract movie (Original and Enhanced) and Norune, from glTF.
• In play: Norune and the attract movie, with both cloth modes.
• Not tested:
  • the NTSC disc;
  • Windows, macOS and Switch builds.