OpenRCT2-ObjectCommon 0.2.2__tar.gz → 0.2.4__tar.gz

{openrct2_objectcommon-0.2.2 → openrct2_objectcommon-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenRCT2-ObjectCommon
-Version: 0.2.2
+Version: 0.2.4
 Summary: Shared config, CLI, .parkobj, and object.json scaffolding for OpenRCT2 object generators.
 Project-URL: Homepage, https://github.com/alex-parisi/OpenRCT2-ObjectCommon
 Project-URL: Repository, https://github.com/alex-parisi/OpenRCT2-ObjectCommon
@@ -9,7 +9,7 @@ License-Expression: GPL-3.0-or-later
 License-File: LICENSE
 Requires-Python: >=3.11
 Requires-Dist: numpy>=1.26
-Requires-Dist: openrct2-x7-renderer>=0.3.7
+Requires-Dist: openrct2-x7-renderer>=0.3.9
 Requires-Dist: pillow>=10.0
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: blender

{openrct2_objectcommon-0.2.2 → openrct2_objectcommon-0.2.4}/openrct2_object_common/blender/props.py

@@ -46,6 +46,33 @@ def scale_preset_update(self, _context):
         self.units_per_tile = value
 
 
+# Palette dithering modes. Identifiers match the strings the renderer's
+# ``Context`` / ``make_context`` accept. Floyd–Steinberg is the historical
+# default (highest fidelity); Bayer is screen-anchored so its pattern stays
+# stable across an animation's frames, avoiding the per-frame "swimming" of
+# error diffusion.
+DITHER_MODE_ITEMS = [
+    (
+        "floyd_steinberg",
+        "Floyd–Steinberg",
+        "Highest fidelity, but the dither pattern shifts between animation frames",
+    ),
+    (
+        "bayer",
+        "Bayer (frame-stable)",
+        "Ordered dither locked to screen position; stable across animation frames",
+    ),
+    (
+        "blue_noise",
+        "Blue noise (frame-stable)",
+        "Like Bayer but a blue-noise mask; less perceptible residual motion under rotation",
+    ),
+    ("none", "None", "No dithering; flat palette quantisation"),
+]
+
+DEFAULT_DITHER_MODE = "floyd_steinberg"
+
+
 LIGHT_TYPE_ITEMS = [
     ("diffuse", "Diffuse", "Directional diffuse light"),
     ("specular", "Specular", "Specular highlight light"),

{openrct2_objectcommon-0.2.2 → openrct2_objectcommon-0.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "OpenRCT2-ObjectCommon"
-version = "0.2.2"
+version = "0.2.4"
 description = "Shared config, CLI, .parkobj, and object.json scaffolding for OpenRCT2 object generators."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -9,7 +9,7 @@ authors = [
     { name = "Alex Parisi", email = "alex@atparisi.com" }
 ]
 dependencies = [
-    "openrct2-x7-renderer>=0.3.7",
+    "openrct2-x7-renderer>=0.3.9",
     "numpy>=1.26",
     "pillow>=10.0",
     "pyyaml>=6.0",

{openrct2_objectcommon-0.2.2 → openrct2_objectcommon-0.2.4}/tests/test_blender_shared.py

@@ -47,6 +47,16 @@ def test_shared_light_propertygroup_defined():
     )
 
 
+def test_dither_mode_items_match_renderer_modes():
+    # The add-on enum identifiers must be exactly the strings make_context /
+    # Context accept, and the default must be one of them.
+    from openrct2_x7_renderer.ray_trace import DITHER_MODES
+
+    ids = {ident for ident, _label, _desc in props.DITHER_MODE_ITEMS}
+    assert ids == set(DITHER_MODES)
+    assert props.DEFAULT_DITHER_MODE in ids
+
+
 # ===========================================================================
 # mesh_extract.base_color
 # ===========================================================================