mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-07-31 09:49:53 -04:00
7bc9fa556f
Parse $FSD animation events from M2 models (WotLK per-sequence arrays and vanilla/TBC global-timeline bucketing) and trigger player/mount footsteps on the authored foot-strike keyframes, with a synthetic gallop fallback for models without events. Mount families now route to proper sample banks: horse/ram hooves, kodo huge thuds, softened padded paws, and mounted water steps get the splash treatment.
97 lines
3.6 KiB
C++
97 lines
3.6 KiB
C++
#include <catch_amalgamated.hpp>
|
|
|
|
#include "pipeline/m2_loader.hpp"
|
|
|
|
#include <filesystem>
|
|
#include <fstream>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
// M2 models embed $FSD (footfall) animation events — the keyframes the game
|
|
// client uses to sync footstep sounds to feet striking the ground. The loader
|
|
// collects them into M2Model::footstepEventTimes, one sorted ms-list per
|
|
// sequence index. WotLK (v264) stores per-sequence timestamp arrays; vanilla
|
|
// (v256) stores one flat global-timeline array that must be bucketed by each
|
|
// sequence's [start, end) window. Expected values below were extracted from
|
|
// the raw files with an independent Python parser.
|
|
|
|
using wowee::pipeline::M2Loader;
|
|
using wowee::pipeline::M2Model;
|
|
|
|
namespace {
|
|
|
|
std::vector<uint8_t> readFile(const std::string& relPath) {
|
|
const auto path = std::filesystem::path(WOWEE_SOURCE_DIR) / relPath;
|
|
std::ifstream in(path, std::ios::binary);
|
|
if (!in) return {};
|
|
return std::vector<uint8_t>(std::istreambuf_iterator<char>(in),
|
|
std::istreambuf_iterator<char>());
|
|
}
|
|
|
|
// Sequence index of the first sequence with the given animation ID and
|
|
// variation 0, or -1.
|
|
int findSequenceIndex(const M2Model& model, uint32_t animId) {
|
|
for (size_t i = 0; i < model.sequences.size(); i++) {
|
|
if (model.sequences[i].id == animId && model.sequences[i].variationIndex == 0) {
|
|
return static_cast<int>(i);
|
|
}
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
} // namespace
|
|
|
|
TEST_CASE("WotLK riding horse has 4-beat gallop footfall events", "[m2][footstep]") {
|
|
auto data = readFile("Data/creature/ridinghorse/ridinghorse.m2");
|
|
if (data.empty()) {
|
|
SUCCEED("model asset not extracted; optional real-asset coverage skipped");
|
|
return;
|
|
}
|
|
M2Model model = M2Loader::load(data);
|
|
REQUIRE(model.version >= 264);
|
|
REQUIRE(model.footstepEventTimes.size() == model.sequences.size());
|
|
|
|
const int walkIdx = findSequenceIndex(model, 4);
|
|
REQUIRE(walkIdx >= 0);
|
|
CHECK(model.footstepEventTimes[walkIdx] == std::vector<uint32_t>{67, 333, 467, 733});
|
|
|
|
const int runIdx = findSequenceIndex(model, 5);
|
|
REQUIRE(runIdx >= 0);
|
|
// Gallop: four hoofbeats clustered in the front of the 800ms stride,
|
|
// then airborne suspension.
|
|
CHECK(model.footstepEventTimes[runIdx] == std::vector<uint32_t>{134, 234, 334, 500});
|
|
}
|
|
|
|
TEST_CASE("WotLK human male has alternating biped footfall events", "[m2][footstep]") {
|
|
auto data = readFile("Data/character/human/male/humanmale.m2");
|
|
if (data.empty()) {
|
|
SUCCEED("model asset not extracted; optional real-asset coverage skipped");
|
|
return;
|
|
}
|
|
M2Model model = M2Loader::load(data);
|
|
REQUIRE(model.version >= 264);
|
|
|
|
const int runIdx = findSequenceIndex(model, 5);
|
|
REQUIRE(runIdx >= 0);
|
|
CHECK(model.footstepEventTimes[runIdx] == std::vector<uint32_t>{267, 600});
|
|
}
|
|
|
|
TEST_CASE("Vanilla model buckets global-timeline footfall events per sequence", "[m2][footstep]") {
|
|
auto data = readFile("Data/expansions/turtle/overlay/creature/orcmalewarriorlight/OrcMaleWarriorLight.m2");
|
|
if (data.empty()) {
|
|
SUCCEED("model asset not extracted; optional real-asset coverage skipped");
|
|
return;
|
|
}
|
|
M2Model model = M2Loader::load(data);
|
|
REQUIRE(model.version < 264);
|
|
REQUIRE(model.footstepEventTimes.size() == model.sequences.size());
|
|
|
|
const int walkIdx = findSequenceIndex(model, 4);
|
|
REQUIRE(walkIdx >= 0);
|
|
CHECK(model.footstepEventTimes[walkIdx] == std::vector<uint32_t>{266, 800});
|
|
|
|
const int runIdx = findSequenceIndex(model, 5);
|
|
REQUIRE(runIdx >= 0);
|
|
CHECK(model.footstepEventTimes[runIdx] == std::vector<uint32_t>{233, 567});
|
|
}
|