structura-render 0.2.0__tar.gz → 0.2.2__tar.gz

{structura_render-0.2.0 → structura_render-0.2.2}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: structura-render
-Version: 0.2.0
+Version: 0.2.2
 Summary: Minecraft block-model resolution, image rendering and 3D export (USDZ/glTF/OBJ/STL)
 Project-URL: Repository, https://github.com/kirimba1024/structura-render
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: structura-core<0.2,>=0.1.0
+Requires-Dist: structura-core<0.3,>=0.2.0
 Requires-Dist: numpy<3,>=1.26
 Requires-Dist: Pillow<12,>=11
 Requires-Dist: scipy<2,>=1.13
@@ -27,7 +27,7 @@ Requires-Dist: pyvista<0.47,>=0.46; extra == "stl"
 Requires-Dist: trimesh<5,>=4.5; extra == "stl"
 Requires-Dist: networkx<4,>=3.2; extra == "stl"
 Provides-Extra: legacy
-Requires-Dist: structura-core[legacy]<0.2,>=0.1.0; extra == "legacy"
+Requires-Dist: structura-core[legacy]<0.3,>=0.2.0; extra == "legacy"
 
 # structura-render
 
@@ -35,8 +35,8 @@ Requires-Dist: structura-core[legacy]<0.2,>=0.1.0; extra == "legacy"
 your own game's actual textures and block shapes, not guesses.**
 
 No fake textures, no hardcoded block shapes, no bundled game files. Point
-it at your own Minecraft client and get pixel-accurate PNGs and USDZ out
-the other end.
+it at your own Minecraft client and get pixel-accurate PNGs and a 3D file
+(USDZ, glTF/GLB, OBJ or STL) out the other end.
 
 **This isn't a lookup table of ~50 common blocks with guessed shapes.**
 The resolver walks the same blockstate → multipart/variant → model → element
@@ -57,8 +57,8 @@ portals and fluids) share a compact textured compound-model layer.
   blockstate/model data and PNGs as the game. Dynamic blocks use their real
   entity textures on compact state-aware compound geometry.
 - **One mesh, every output.** Geometry is resolved once and shared between
-  PNG renders and USDZ export, so what you preview is exactly what you get
-  in 3D — nothing drifts between formats.
+  PNG renders and every 3D export (USDZ, glTF, OBJ, STL), so what you
+  preview is exactly what you get in 3D — nothing drifts between formats.
 - **Clean by design.** Zero Mojang assets in this repo or its releases —
   can't, EULA forbids it. You always supply your own client, so there's no
   legal grey area to worry about.
@@ -67,8 +67,8 @@ portals and fluids) share a compact textured compound-model layer.
   1.21.1 and the newest 26.2. New blocks resolve automatically; no waiting
   on us to add support.
 - **Light by default.** Core install is just NumPy, Pillow and SciPy.
-  PyVista/USD only get pulled in if you actually ask for hero renders or
-  USDZ export.
+  PyVista and the format-specific libraries (USD, trimesh) only get pulled
+  in if you actually ask for hero renders or a given 3D export.
 - **Self-updating classification.** Which blocks are solid cubes (for
   occlusion) is computed from real model geometry, not a hand-maintained
   name list — it doesn't go stale as new blocks ship.
@@ -86,8 +86,15 @@ portals and fluids) share a compact textured compound-model layer.
   QA rather than looks.
 - **`hero.py`** (`hero` extra) — one real-textured, real-lit PyVista render
   of the finished structure — the kind of shot above.
-- **`usdz.py`** (`usdz` extra) — a textured 3D mesh for AR Quick Look or
-  any USDZ viewer, from the same mesh builder as the hero renderer.
+- **`usdz.py`** (`usdz` extra) — a textured USDZ mesh for AR Quick Look,
+  from the same mesh builder as the hero renderer.
+- **`gltf.py`** (`gltf` extra) — a textured `.glb`, for the web
+  (`<model-viewer>`, three.js), Android AR Scene Viewer, Blender and every
+  other glTF-reading tool.
+- **`obj.py`** (`obj` extra) — textured Wavefront OBJ + MTL, for Blender,
+  MeshLab and any classic 3D tool.
+- **`stl.py`** (`stl` extra) — binary STL geometry (no color/texture — the
+  format doesn't have one), for 3D printing or any STL reader.
 - **`build_full_cube_list.py` / `build_opaque_blocks.py`** — data-derived
   block classification, described above.
 - **`docs/block-render-audit-26.2.md`** — one row for every vanilla
@@ -99,17 +106,17 @@ portals and fluids) share a compact textured compound-model layer.
 
 ## Quick start
 
-No clone needed for either package, but `structura-core` isn't on PyPI yet,
-so `pip` can't resolve it as a transitive dependency — install it
-explicitly first, then `structura-render`:
-
 ```bash
 export STRUCTURA_MINECRAFT_ASSETS="$HOME/Library/Application Support/minecraft/versions/1.21.1/1.21.1.jar"
-pip install 'git+https://github.com/kirimba1024/structura-core.git'
-pip install "structura-render[usdz] @ git+https://github.com/kirimba1024/structura-render.git"
+pip install "structura-render[usdz]"
 structura-render-hero structure.nbt preview.png
+structura-export-usdz structure.nbt model.usdz
 ```
 
+Swap `[usdz]` for `[gltf]`, `[obj]` or `[stl]` (or several, comma-separated)
+for the other 3D formats — `structura-export-gltf`, `structura-export-obj`,
+`structura-export-stl` follow the same `src dst` signature.
+
 Have a legacy `.schematic`/`.schem`/`.litematic` instead of Structure NBT?
 Add the `legacy` extra (`[usdz,legacy]`) and pass it straight in — no
 separate conversion step:
@@ -134,5 +141,6 @@ and isn't supported. On load, the package checks for `heavy_core` (added
 in 1.21) and warns on stderr if it's missing, as a cheap signal that the
 pointed-at client predates 1.21 — not exhaustive, just a sanity check.
 
-Use the lighter `hero` extra when USDZ export isn't needed; plain
-projection rendering skips PyVista and OpenUSD entirely.
+Use the lighter `hero` extra when no 3D export is needed; plain projection
+rendering (`structura-render-projections`, no extra) skips PyVista and
+every format-specific library entirely.

{structura_render-0.2.0 → structura_render-0.2.2}/README.md

@@ -4,8 +4,8 @@
 your own game's actual textures and block shapes, not guesses.**
 
 No fake textures, no hardcoded block shapes, no bundled game files. Point
-it at your own Minecraft client and get pixel-accurate PNGs and USDZ out
-the other end.
+it at your own Minecraft client and get pixel-accurate PNGs and a 3D file
+(USDZ, glTF/GLB, OBJ or STL) out the other end.
 
 **This isn't a lookup table of ~50 common blocks with guessed shapes.**
 The resolver walks the same blockstate → multipart/variant → model → element
@@ -26,8 +26,8 @@ portals and fluids) share a compact textured compound-model layer.
   blockstate/model data and PNGs as the game. Dynamic blocks use their real
   entity textures on compact state-aware compound geometry.
 - **One mesh, every output.** Geometry is resolved once and shared between
-  PNG renders and USDZ export, so what you preview is exactly what you get
-  in 3D — nothing drifts between formats.
+  PNG renders and every 3D export (USDZ, glTF, OBJ, STL), so what you
+  preview is exactly what you get in 3D — nothing drifts between formats.
 - **Clean by design.** Zero Mojang assets in this repo or its releases —
   can't, EULA forbids it. You always supply your own client, so there's no
   legal grey area to worry about.
@@ -36,8 +36,8 @@ portals and fluids) share a compact textured compound-model layer.
   1.21.1 and the newest 26.2. New blocks resolve automatically; no waiting
   on us to add support.
 - **Light by default.** Core install is just NumPy, Pillow and SciPy.
-  PyVista/USD only get pulled in if you actually ask for hero renders or
-  USDZ export.
+  PyVista and the format-specific libraries (USD, trimesh) only get pulled
+  in if you actually ask for hero renders or a given 3D export.
 - **Self-updating classification.** Which blocks are solid cubes (for
   occlusion) is computed from real model geometry, not a hand-maintained
   name list — it doesn't go stale as new blocks ship.
@@ -55,8 +55,15 @@ portals and fluids) share a compact textured compound-model layer.
   QA rather than looks.
 - **`hero.py`** (`hero` extra) — one real-textured, real-lit PyVista render
   of the finished structure — the kind of shot above.
-- **`usdz.py`** (`usdz` extra) — a textured 3D mesh for AR Quick Look or
-  any USDZ viewer, from the same mesh builder as the hero renderer.
+- **`usdz.py`** (`usdz` extra) — a textured USDZ mesh for AR Quick Look,
+  from the same mesh builder as the hero renderer.
+- **`gltf.py`** (`gltf` extra) — a textured `.glb`, for the web
+  (`<model-viewer>`, three.js), Android AR Scene Viewer, Blender and every
+  other glTF-reading tool.
+- **`obj.py`** (`obj` extra) — textured Wavefront OBJ + MTL, for Blender,
+  MeshLab and any classic 3D tool.
+- **`stl.py`** (`stl` extra) — binary STL geometry (no color/texture — the
+  format doesn't have one), for 3D printing or any STL reader.
 - **`build_full_cube_list.py` / `build_opaque_blocks.py`** — data-derived
   block classification, described above.
 - **`docs/block-render-audit-26.2.md`** — one row for every vanilla
@@ -68,17 +75,17 @@ portals and fluids) share a compact textured compound-model layer.
 
 ## Quick start
 
-No clone needed for either package, but `structura-core` isn't on PyPI yet,
-so `pip` can't resolve it as a transitive dependency — install it
-explicitly first, then `structura-render`:
-
 ```bash
 export STRUCTURA_MINECRAFT_ASSETS="$HOME/Library/Application Support/minecraft/versions/1.21.1/1.21.1.jar"
-pip install 'git+https://github.com/kirimba1024/structura-core.git'
-pip install "structura-render[usdz] @ git+https://github.com/kirimba1024/structura-render.git"
+pip install "structura-render[usdz]"
 structura-render-hero structure.nbt preview.png
+structura-export-usdz structure.nbt model.usdz
 ```
 
+Swap `[usdz]` for `[gltf]`, `[obj]` or `[stl]` (or several, comma-separated)
+for the other 3D formats — `structura-export-gltf`, `structura-export-obj`,
+`structura-export-stl` follow the same `src dst` signature.
+
 Have a legacy `.schematic`/`.schem`/`.litematic` instead of Structure NBT?
 Add the `legacy` extra (`[usdz,legacy]`) and pass it straight in — no
 separate conversion step:
@@ -103,5 +110,6 @@ and isn't supported. On load, the package checks for `heavy_core` (added
 in 1.21) and warns on stderr if it's missing, as a cheap signal that the
 pointed-at client predates 1.21 — not exhaustive, just a sanity check.
 
-Use the lighter `hero` extra when USDZ export isn't needed; plain
-projection rendering skips PyVista and OpenUSD entirely.
+Use the lighter `hero` extra when no 3D export is needed; plain projection
+rendering (`structura-render-projections`, no extra) skips PyVista and
+every format-specific library entirely.

{structura_render-0.2.0 → structura_render-0.2.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "structura-render"
-version = "0.2.0"
+version = "0.2.2"
 description = "Minecraft block-model resolution, image rendering and 3D export (USDZ/glTF/OBJ/STL)"
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [
-  "structura-core>=0.1.0,<0.2",
+  "structura-core>=0.2.0,<0.3",
   "numpy>=1.26,<3",
   "Pillow>=11,<12",
   "scipy>=1.13,<2",
@@ -21,7 +21,7 @@ usdz = ["pyvista>=0.46,<0.47", "usd-core>=26,<27"]
 gltf = ["pyvista>=0.46,<0.47", "trimesh>=4.5,<5", "networkx>=3.2,<4"]
 obj = ["pyvista>=0.46,<0.47", "trimesh>=4.5,<5", "networkx>=3.2,<4"]
 stl = ["pyvista>=0.46,<0.47", "trimesh>=4.5,<5", "networkx>=3.2,<4"]
-legacy = ["structura-core[legacy]>=0.1.0,<0.2"]
+legacy = ["structura-core[legacy]>=0.2.0,<0.3"]
 
 [project.scripts]
 structura-render-projections = "structura_render.projections:main"

{structura_render-0.2.0 → structura_render-0.2.2}/src/structura_render/obj.py

@@ -1,4 +1,5 @@
 import argparse
+import re
 from pathlib import Path
 
 import numpy as np
@@ -11,6 +12,19 @@ from .mesh import build_textured_meshes, export_parts, flat_block_groups, voxel_
 from .textures import TextureBank
 
 
+def add_alpha_maps(obj_path):
+    obj_text = obj_path.read_text()
+    mtllib = re.search(r"^mtllib (.+)$", obj_text, re.MULTILINE)
+    if not mtllib:
+        return
+    mtl_path = obj_path.parent / mtllib.group(1)
+    mtl_text = mtl_path.read_text()
+    mtl_text = re.sub(
+        r"^(map_Kd (.+))$", r"\1\nmap_d \2", mtl_text, flags=re.MULTILINE,
+    )
+    mtl_path.write_text(mtl_text)
+
+
 def main():
     parser = argparse.ArgumentParser()
     parser.add_argument("src")
@@ -40,6 +54,7 @@ def main():
     out_path.parent.mkdir(parents=True, exist_ok=True)
     resolver = trimesh.resolvers.FilePathResolver(str(out_path.parent))
     scene.export(str(out_path), resolver=resolver, write_texture=True)
+    add_alpha_maps(out_path)
     print(f"{out_path} parts={len(parts)}")
 
 

{structura_render-0.2.0 → structura_render-0.2.2}/src/structura_render.egg-info/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: structura-render
-Version: 0.2.0
+Version: 0.2.2
 Summary: Minecraft block-model resolution, image rendering and 3D export (USDZ/glTF/OBJ/STL)
 Project-URL: Repository, https://github.com/kirimba1024/structura-render
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: structura-core<0.2,>=0.1.0
+Requires-Dist: structura-core<0.3,>=0.2.0
 Requires-Dist: numpy<3,>=1.26
 Requires-Dist: Pillow<12,>=11
 Requires-Dist: scipy<2,>=1.13
@@ -27,7 +27,7 @@ Requires-Dist: pyvista<0.47,>=0.46; extra == "stl"
 Requires-Dist: trimesh<5,>=4.5; extra == "stl"
 Requires-Dist: networkx<4,>=3.2; extra == "stl"
 Provides-Extra: legacy
-Requires-Dist: structura-core[legacy]<0.2,>=0.1.0; extra == "legacy"
+Requires-Dist: structura-core[legacy]<0.3,>=0.2.0; extra == "legacy"
 
 # structura-render
 
@@ -35,8 +35,8 @@ Requires-Dist: structura-core[legacy]<0.2,>=0.1.0; extra == "legacy"
 your own game's actual textures and block shapes, not guesses.**
 
 No fake textures, no hardcoded block shapes, no bundled game files. Point
-it at your own Minecraft client and get pixel-accurate PNGs and USDZ out
-the other end.
+it at your own Minecraft client and get pixel-accurate PNGs and a 3D file
+(USDZ, glTF/GLB, OBJ or STL) out the other end.
 
 **This isn't a lookup table of ~50 common blocks with guessed shapes.**
 The resolver walks the same blockstate → multipart/variant → model → element
@@ -57,8 +57,8 @@ portals and fluids) share a compact textured compound-model layer.
   blockstate/model data and PNGs as the game. Dynamic blocks use their real
   entity textures on compact state-aware compound geometry.
 - **One mesh, every output.** Geometry is resolved once and shared between
-  PNG renders and USDZ export, so what you preview is exactly what you get
-  in 3D — nothing drifts between formats.
+  PNG renders and every 3D export (USDZ, glTF, OBJ, STL), so what you
+  preview is exactly what you get in 3D — nothing drifts between formats.
 - **Clean by design.** Zero Mojang assets in this repo or its releases —
   can't, EULA forbids it. You always supply your own client, so there's no
   legal grey area to worry about.
@@ -67,8 +67,8 @@ portals and fluids) share a compact textured compound-model layer.
   1.21.1 and the newest 26.2. New blocks resolve automatically; no waiting
   on us to add support.
 - **Light by default.** Core install is just NumPy, Pillow and SciPy.
-  PyVista/USD only get pulled in if you actually ask for hero renders or
-  USDZ export.
+  PyVista and the format-specific libraries (USD, trimesh) only get pulled
+  in if you actually ask for hero renders or a given 3D export.
 - **Self-updating classification.** Which blocks are solid cubes (for
   occlusion) is computed from real model geometry, not a hand-maintained
   name list — it doesn't go stale as new blocks ship.
@@ -86,8 +86,15 @@ portals and fluids) share a compact textured compound-model layer.
   QA rather than looks.
 - **`hero.py`** (`hero` extra) — one real-textured, real-lit PyVista render
   of the finished structure — the kind of shot above.
-- **`usdz.py`** (`usdz` extra) — a textured 3D mesh for AR Quick Look or
-  any USDZ viewer, from the same mesh builder as the hero renderer.
+- **`usdz.py`** (`usdz` extra) — a textured USDZ mesh for AR Quick Look,
+  from the same mesh builder as the hero renderer.
+- **`gltf.py`** (`gltf` extra) — a textured `.glb`, for the web
+  (`<model-viewer>`, three.js), Android AR Scene Viewer, Blender and every
+  other glTF-reading tool.
+- **`obj.py`** (`obj` extra) — textured Wavefront OBJ + MTL, for Blender,
+  MeshLab and any classic 3D tool.
+- **`stl.py`** (`stl` extra) — binary STL geometry (no color/texture — the
+  format doesn't have one), for 3D printing or any STL reader.
 - **`build_full_cube_list.py` / `build_opaque_blocks.py`** — data-derived
   block classification, described above.
 - **`docs/block-render-audit-26.2.md`** — one row for every vanilla
@@ -99,17 +106,17 @@ portals and fluids) share a compact textured compound-model layer.
 
 ## Quick start
 
-No clone needed for either package, but `structura-core` isn't on PyPI yet,
-so `pip` can't resolve it as a transitive dependency — install it
-explicitly first, then `structura-render`:
-
 ```bash
 export STRUCTURA_MINECRAFT_ASSETS="$HOME/Library/Application Support/minecraft/versions/1.21.1/1.21.1.jar"
-pip install 'git+https://github.com/kirimba1024/structura-core.git'
-pip install "structura-render[usdz] @ git+https://github.com/kirimba1024/structura-render.git"
+pip install "structura-render[usdz]"
 structura-render-hero structure.nbt preview.png
+structura-export-usdz structure.nbt model.usdz
 ```
 
+Swap `[usdz]` for `[gltf]`, `[obj]` or `[stl]` (or several, comma-separated)
+for the other 3D formats — `structura-export-gltf`, `structura-export-obj`,
+`structura-export-stl` follow the same `src dst` signature.
+
 Have a legacy `.schematic`/`.schem`/`.litematic` instead of Structure NBT?
 Add the `legacy` extra (`[usdz,legacy]`) and pass it straight in — no
 separate conversion step:
@@ -134,5 +141,6 @@ and isn't supported. On load, the package checks for `heavy_core` (added
 in 1.21) and warns on stderr if it's missing, as a cheap signal that the
 pointed-at client predates 1.21 — not exhaustive, just a sanity check.
 
-Use the lighter `hero` extra when USDZ export isn't needed; plain
-projection rendering skips PyVista and OpenUSD entirely.
+Use the lighter `hero` extra when no 3D export is needed; plain projection
+rendering (`structura-render-projections`, no extra) skips PyVista and
+every format-specific library entirely.

{structura_render-0.2.0 → structura_render-0.2.2}/src/structura_render.egg-info/requires.txt

@@ -1,4 +1,4 @@
-structura-core<0.2,>=0.1.0
+structura-core<0.3,>=0.2.0
 numpy<3,>=1.26
 Pillow<12,>=11
 scipy<2,>=1.13
@@ -12,7 +12,7 @@ networkx<4,>=3.2
 pyvista<0.47,>=0.46
 
 [legacy]
-structura-core[legacy]<0.2,>=0.1.0
+structura-core[legacy]<0.3,>=0.2.0
 
 [obj]
 pyvista<0.47,>=0.46