Two parametric cycles authored at 30 fps instead of hand-keyed poses, so the loop closes by construction: GigLine_Idle (60 f, breathing sway, feet planted) and GigLine_Walk (30 f, one stride, hip 0.45 rad / knee 0.55 / arm 0.32, arms counter-phased, torso counter-rotation). The limb axes were measured, not assumed: a probe rotated upperleg01.L by 0.5 rad on each axis and read foot.L, which moved -0.022 -> +0.362 in Y on X, twisted on Y and abducted on Z. Using the wrong axis here would have produced a character scissoring sideways, which no import error would have caught. The character export preset now bakes animation. Without bake_anim the exporter writes a static bind pose and Unreal imports a mesh with no AnimSequence and no error, so the importer asserts a clip exists and prints VERDICT: PASS/FAIL. Verified in /Game/Test/Character: Idle 1.967 s and Walk 0.967 s, both AnimSequences, skeleton intact. Playback on a possessed pawn is not yet verified: the demo pawn has no visible body, so that check belongs with the third-person camera item.
89 lines
3.4 KiB
Python
89 lines
3.4 KiB
Python
"""Tests for Tools/fbx_export_preset.py.
|
|
|
|
The preset module keeps its argument set in plain dicts and builds it in
|
|
`preset_kwargs()`, so the export contract can be checked without starting
|
|
Blender. Only `export_static`/`export_character` import `bpy`.
|
|
"""
|
|
|
|
import os
|
|
import sys
|
|
import unittest
|
|
|
|
ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
|
|
sys.path.insert(0, os.path.join(ROOT, "Tools"))
|
|
|
|
import fbx_export_preset as preset # noqa: E402
|
|
|
|
|
|
class MetricPresetTest(unittest.TestCase):
|
|
def test_scale_and_axis_contract(self):
|
|
# These three are the project's recorded conversion contract: metres ->
|
|
# centimetres by a factor of exactly 100, east +X, north -Y, up +Z.
|
|
kwargs = preset.preset_kwargs()
|
|
self.assertTrue(kwargs["apply_unit_scale"])
|
|
self.assertEqual(kwargs["apply_scale_options"], "FBX_SCALE_NONE")
|
|
self.assertEqual(kwargs["axis_forward"], "-Y")
|
|
self.assertEqual(kwargs["axis_up"], "Z")
|
|
|
|
def test_smoothing_groups_are_exported(self):
|
|
# "OFF" (the pre-refactor value) drops smoothing groups and every Unreal
|
|
# import warns about it, with round parts faceted.
|
|
self.assertEqual(preset.preset_kwargs()["mesh_smooth_type"], "FACE")
|
|
|
|
def test_selection_flag(self):
|
|
self.assertFalse(preset.preset_kwargs()["use_selection"])
|
|
self.assertTrue(preset.preset_kwargs(selection=True)["use_selection"])
|
|
|
|
def test_object_types_are_meshes_only(self):
|
|
self.assertEqual(preset.preset_kwargs()["object_types"], {"MESH"})
|
|
|
|
|
|
class CharacterPresetTest(unittest.TestCase):
|
|
def test_character_exports_armature_and_mesh(self):
|
|
kwargs = preset.preset_kwargs("ue_character_v1")
|
|
self.assertEqual(kwargs["object_types"], {"ARMATURE", "MESH"})
|
|
self.assertFalse(kwargs["add_leaf_bones"])
|
|
self.assertEqual(kwargs["path_mode"], "COPY")
|
|
self.assertFalse(kwargs["embed_textures"])
|
|
|
|
def test_character_keeps_the_scale_contract(self):
|
|
kwargs = preset.preset_kwargs("ue_character_v1")
|
|
self.assertEqual(kwargs["apply_scale_options"], "FBX_SCALE_NONE")
|
|
self.assertEqual(kwargs["mesh_smooth_type"], "FACE")
|
|
|
|
|
|
class CharacterAnimationTest(unittest.TestCase):
|
|
"""The animation flags are the difference between a clip and a silent bind pose."""
|
|
|
|
def test_bakes_animation(self):
|
|
kwargs = preset.preset_kwargs("ue_character_v1")
|
|
self.assertTrue(kwargs["bake_anim"], "without bake_anim Unreal imports no AnimSequence")
|
|
self.assertTrue(kwargs["bake_anim_use_all_actions"])
|
|
self.assertFalse(kwargs["bake_anim_use_nla_strips"])
|
|
|
|
def test_does_not_simplify_authored_keys(self):
|
|
kwargs = preset.preset_kwargs("ue_character_v1")
|
|
self.assertEqual(kwargs["bake_anim_simplify_factor"], 0.0)
|
|
|
|
def test_static_preset_stays_animation_free(self):
|
|
kwargs = preset.preset_kwargs("ue_metric_v1")
|
|
self.assertNotIn("bake_anim", kwargs)
|
|
|
|
|
|
class OverrideTest(unittest.TestCase):
|
|
def test_overrides_win(self):
|
|
kwargs = preset.preset_kwargs(mesh_smooth_type="OFF")
|
|
self.assertEqual(kwargs["mesh_smooth_type"], "OFF")
|
|
|
|
def test_unknown_preset_raises(self):
|
|
with self.assertRaises(KeyError):
|
|
preset.preset_kwargs("ue_imperial_v9")
|
|
|
|
def test_filepath_must_not_be_an_override(self):
|
|
with self.assertRaises(ValueError):
|
|
preset.preset_kwargs(filepath="/tmp/x.fbx")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|