tilemap-parser 3.1.4__tar.gz → 3.1.6__tar.gz

{tilemap_parser-3.1.4 → tilemap_parser-3.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 3.1.4
+Version: 3.1.6
 Summary: Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and collision detection runtime.
 Author: tilemap parser contributors
 License:                     GNU GENERAL PUBLIC LICENSE

{tilemap_parser-3.1.4 → tilemap_parser-3.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tilemap-parser"
-version = "3.1.4"
+version = "3.1.6"
 description = "Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and collision detection runtime."
 readme = "README.md"
 requires-python = ">=3.10"

{tilemap_parser-3.1.4 → tilemap_parser-3.1.6}/src/tilemap_parser/parser/animation.py

@@ -97,6 +97,8 @@ class AnimationLibrary:
     animations: Dict[str, AnimationClip] = field(default_factory=dict)
     spritesheet_path: Optional[str] = None
     tile_size: Tuple[int, int] = (32, 32)
+    grid_offset: Tuple[int, int] = (0, 0)
+    trim_transparent: bool = False
 
     def get(self, name: str) -> Optional[AnimationClip]:
         return self.animations.get(name)
@@ -153,13 +155,23 @@ def parse_animation_dict(data: Dict[str, Any]) -> AnimationLibrary:
     if tw < 1 or th < 1:
         raise AnimationParseError("tile_size: width and height must be >= 1")
 
+    grid_offset_raw = root.get("grid_offset", [0, 0])
+    if not isinstance(grid_offset_raw, (list, tuple)) or len(grid_offset_raw) != 2:
+        raise AnimationParseError("grid_offset: expected [x, y]")
+    gox = _coerce_int(grid_offset_raw[0], "grid_offset[0]")
+    goy = _coerce_int(grid_offset_raw[1], "grid_offset[1]")
+    if gox < 0 or goy < 0:
+        raise AnimationParseError("grid_offset: values must be >= 0")
+
     animations_raw = _req_dict(root.get("animations", {}), "animations")
     animations: Dict[str, AnimationClip] = {}
     for key, value in animations_raw.items():
         k = str(key)
         animations[k] = _parse_animation(k, _req_dict(value, f"animations[{k!r}]"), f"animations[{k!r}]")
 
-    return AnimationLibrary(animations=animations, spritesheet_path=spritesheet_path, tile_size=(tw, th))
+    trim_transparent = bool(root.get("trim_transparent", False))
+
+    return AnimationLibrary(animations=animations, spritesheet_path=spritesheet_path, tile_size=(tw, th), grid_offset=(gox, goy), trim_transparent=trim_transparent)
 
 
 def parse_animation_json(text: str) -> AnimationLibrary:

{tilemap_parser-3.1.4 → tilemap_parser-3.1.6}/src/tilemap_parser/runtime/animation_player.py

@@ -59,7 +59,14 @@ class SpriteAnimationSet:
         except pygame.error as e:
             raise AnimationParseError(f"Failed to load image {image_path}: {e}") from e
 
-        return cls(library=library, surface=surface, warnings=warnings, json_path=path)
+        return cls(
+            library=library,
+            surface=surface,
+            warnings=warnings,
+            json_path=path,
+            grid_offset_x=library.grid_offset[0],
+            grid_offset_y=library.grid_offset[1],
+        )
 
     def get_image(self, variant_id: int, *, copy_surface: bool = True) -> Optional[Surface]:
         tw, th = self.library.tile_size
@@ -76,6 +83,10 @@ class SpriteAnimationSet:
         if not self.surface.get_rect().contains(src):
             return None
         cel = self.surface.subsurface(src)
+        if self.library.trim_transparent:
+            brect = cel.get_bounding_rect()
+            if brect:
+                cel = cel.subsurface(brect)
         return cel.copy() if copy_surface else cel
 
 

{tilemap_parser-3.1.4 → tilemap_parser-3.1.6}/src/tilemap_parser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tilemap-parser
-Version: 3.1.4
+Version: 3.1.6
 Summary: Standalone parser/loader for tilemap-editor JSON maps, sprite animations, and collision detection runtime.
 Author: tilemap parser contributors
 License:                     GNU GENERAL PUBLIC LICENSE