feat: implement unit scaling for SoulWorker models and update related file import processes

Author: sawich

README.md

@@ -60,8 +60,3 @@ Press N *(keyboard button)* -> SoulWorker *(tab)*:
 
 - Some models use materials that are not in the root folder.
   Please unpack the game resources **keeping the original structure**.
-- The scale of the models in the game is **very large**. If you can't see anything but the object appears in the **Outliner**, increase the draw distance.
-
-  Press N *(keyboard)* -> View *(tab)* -> End *(input)*.
-
-  I set it to **30_000 m**.

io_soulworker/chunks/vmsh_chunk.py

@@ -3,6 +3,7 @@
 from io_soulworker.core.binary_reader import BinaryReader
 from io_soulworker.core.binary_writer import BinaryWriter
 from io_soulworker.core.data_exchange import DataExchange_cl
+from io_soulworker.unit_scale import BLENDER_TO_GAME, GAME_TO_BLENDER
 from io_soulworker.core.utility import indices_to_face
 from io_soulworker.core.vis_chunk_id import VisChunkId
 from io_soulworker.core.vis_index_format import VisIndexFormat
@@ -126,7 +127,13 @@ def read(self, reader: BinaryReader) -> None:
                 reader.seek(t + off)
 
                 pos = reader.read_vector3()
-                self.vertices.append([pos.x, pos.y, pos.z])
+                self.vertices.append(
+                    [
+                        pos.x * GAME_TO_BLENDER,
+                        pos.y * GAME_TO_BLENDER,
+                        pos.z * GAME_TO_BLENDER,
+                    ]
+                )
 
             if self.descriptor.has_component(self.descriptor.normal_offset):
 
@@ -279,7 +286,14 @@ def __write_vertices(self, writer: BinaryWriter, vertex_count: int) -> None:
 
                 off = self.descriptor.offset_of(self.descriptor.pos_offset)
                 x, y, z = self.__vector3_at(self.vertices, index)
-                pack_into("<fff", raw, off, x, y, z)
+                pack_into(
+                    "<fff",
+                    raw,
+                    off,
+                    x * BLENDER_TO_GAME,
+                    y * BLENDER_TO_GAME,
+                    z * BLENDER_TO_GAME,
+                )
 
             if self.descriptor.has_component(self.descriptor.normal_offset):
 

io_soulworker/file_import/animation/file_reader.py

@@ -13,6 +13,7 @@
 from io_soulworker.chunks.skel_chunk import VisSkeletonChunk_cl
 from io_soulworker.file_import.animation.action_builder import group_keyframes_by_bone
 from io_soulworker.file_import.animation.chunk_reader import AnimationFileChunkReader
+from io_soulworker.unit_scale import GAME_TO_BLENDER
 
 
 @dataclass(frozen=True)
@@ -236,7 +237,7 @@ def _add_transform_curves(
             pose_bone.rotation_mode = 'QUATERNION'
             positions_by_bone[bone_name] = {
                 frame: self._remap_translation(
-                    position,
+                    position * GAME_TO_BLENDER,
                     source_ref,
                     target_ref
                 )
@@ -315,6 +316,9 @@ def _add_transform_curves(
                 4,
             )
 
+        action.frame_start = int(key_frames[0])
+        action.frame_end = int(key_frames[-1])
+
     def _source_skeleton_refs(self, fallback_bone_names: list[str]) -> list[SkeletonBoneRef]:
         skeleton = self._skeleton_at_index(self.skeleton_index)
 
@@ -339,7 +343,7 @@ def _bone_refs_from_chunk(chunk: VisSkeletonChunk_cl) -> list[SkeletonBoneRef]:
             SkeletonBoneRef(
                 name=bone.name,
                 parent_name=bone_names_by_id.get(bone.parent_id),
-                local_position=bone.local_space_position.copy(),
+                local_position=bone.local_space_position * GAME_TO_BLENDER,
                 local_orientation=bone.local_space_orientation.copy(),
             )
             for bone in chunk.bones

io_soulworker/file_import/armature_builder.py

@@ -7,6 +7,7 @@
 from io_soulworker.chunks.skel_chunk import VisSkeletalBone_cl
 from io_soulworker.chunks.skel_chunk import VisSkeletonChunk_cl
 from io_soulworker.file_import.model.skeleton_builder import build_bone_transforms
+from io_soulworker.unit_scale import GAME_TO_BLENDER
 
 
 class NameHelper:
@@ -99,7 +100,7 @@ def build_armature_from_skeleton(
 
     def bone_local_matrix(bone):
         matrix = bone.local_space_orientation.to_matrix().to_4x4()
-        matrix.translation = bone.local_space_position
+        matrix.translation = bone.local_space_position * GAME_TO_BLENDER
 
         return matrix
 
@@ -132,7 +133,7 @@ def bone_local_matrix(bone):
         {
             "name": bone.name,
             "parent_id": bone.parent_id,
-            "local_position": _vector_to_list(bone.local_space_position),
+            "local_position": _vector_to_list(bone.local_space_position * GAME_TO_BLENDER),
             "local_orientation": _quaternion_to_list(bone.local_space_orientation),
         }
         for bone in chunk.bones

io_soulworker/unit_scale.py

@@ -0,0 +1,2 @@
+GAME_TO_BLENDER = 0.01
+BLENDER_TO_GAME = 100.0