notso-glb 0.1.0__py3-none-any.whl

notso_glb-0.1.0.dist-info/METADATA

@@ -0,0 +1,150 @@
+Metadata-Version: 2.3
+Name: notso-glb
+Version: 0.1.0
+Summary: GLB Export Optimizer for Mascot Models
+Keywords: 3d,blender,compression,draco,glb,gltf,mascot,optimization,webgl
+Author: Kaj Kowalski
+Author-email: Kaj Kowalski <info@kajkowalski.nl>
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Requires-Dist: bpy>=5,<6 ; python_full_version == '3.11.*'
+Requires-Dist: rich>=14.2.0
+Requires-Dist: typer>=0.20.1
+Requires-Dist: wasmtime>=41.0.0
+Requires-Python: ~=3.11.0
+Project-URL: Homepage, https://github.com/kjanat/notso-glb
+Project-URL: Issues, https://github.com/kjanat/notso-glb/issues
+Project-URL: Repository, https://github.com/kjanat/notso-glb.git
+Description-Content-Type: text/markdown
+
+# GLB Export Optimizer for Mascot Models
+
+> Cleans up Blender files and exports optimized GLB for web delivery.
+
+```bash
+uvx notso-glb [OPTIONS] FILE
+```
+
+<p align="center">
+  <a href="https://github.com/kjanat/notso-glb/blob/master/CLI.md" target="_blank" rel="noopener" title="View CLI Options">
+    <img alt="Screenshot with cli options" width="100%" src="https://raw.githubusercontent.com/kjanat/notso-glb/refs/heads/master/screenshot.webp">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/notso-glb/"><img src="https://img.shields.io/pypi/v/notso-glb" alt="PyPI"></a>
+  <a href="https://pypi.org/project/notso-glb/"><img src="https://img.shields.io/pypi/dm/notso-glb" alt="Downloads"></a>  <!--<a href="https://github.com/kjanat/notso-glb/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/kjanat/notso-glb/ci.yml?branch=master" alt="CI"></a>-->
+  <a href="https://github.com/kjanat/notso-glb/blob/master/LICENSE"><img src="https://img.shields.io/github/license/kjanat/notso-glb" alt="License"></a>  <!--<a href="https://notso-glb.kjanat.com"><img src="https://img.shields.io/badge/docs-mkdocs-blue" alt="Docs"></a>-->
+  <img src="https://img.shields.io/badge/python-3.11-blue" alt="Python 3.11">
+</p>
+
+## Install
+
+```bash
+uv tool install notso-glb
+```
+
+```bash
+# Or install directly from GitHub:
+uv tool install -p3.11 git+https://github.com/kjanat/notso-glb
+```
+
+then just run `notso-glb` from the command line.
+
+### Upgrade
+
+```bash
+uv tool upgrade notso-glb
+```
+
+## Features
+
+Optimizations:
+
+- Detects bloated props (high-vert non-skinned meshes, repetitive geometry)
+- Detects skinned meshes with non-root parents (glTF spec issue)
+- Detects unused UV maps (`TEXCOORD` bloat)
+- Detects duplicate names and sanitization collisions
+- Removes unused vertex groups (bone weight bloat)
+- Marks static bones as non-deform (animation bloat)
+- Removes bone shape objects (Icosphere artifacts)
+- Resizes textures to max 1024px (optional `POT` enforcement)
+- Exports with Draco mesh compression
+- Exports with WebP textures
+
+Bloat Detection:
+
+- CRITICAL: Props >2000 verts, repetitive detail (many islands with high verts)
+- WARNING: Props >1000 verts, scene total >15000 verts, non-root skinned meshes
+
+Experimental Auto-fix (`--autofix`):
+
+- BMesh cleanup (remove doubles, degenerate geometry, loose verts)
+- Decimate bloated props to ~1600 verts
+- Auto-rename duplicate objects/meshes/materials/actions (using pointer ID)
+- Remove unused UV maps
+
+## Usage
+
+See [CLI.md]
+
+## Requirements
+
+- Blender 5.0+
+- Python 3.11 (same as bundled with Blender)
+- uv (optional, for easy install/upgrade)
+- gltfpack (optional, for extra compression - WASM fallback included)
+
+## Development Setup
+
+For local development, download the gltfpack WASM binary:
+
+```bash
+# Download latest WASM from npm
+uv run scripts/update_wasm.py
+
+# Or check current version
+uv run scripts/update_wasm.py --show-version
+
+# Download specific version
+uv run scripts/update_wasm.py --version 1.0.0
+```
+
+The WASM binary (`src/notso_glb/wasm/gltfpack.wasm`) is not committed to git and
+must be downloaded locally. CI/CD pipelines handle this automatically.
+
+## Useful Links
+
+- [glTF 2.0 Specification]
+- [glTF 2.0 API Reference Guide]
+- [Khronos Resources]
+- [Blender 5.0 glTF 2.0]
+- [Blender 5.0 Python API Documentation]
+- [Blender 5.0 Reference Manual]
+
+## License
+
+This project is licensed under the GNU General Public License v3.0 - see the
+[LICENSE] file for details.
+
+This project uses [Blender] as a Python module (bpy), which is also GPL-3.0
+licensed.
+
+[Khronos Resources]: https://github.khronos.org/
+[glTF 2.0 Specification]: https://www.khronos.org/gltf/#gltf-spec
+[glTF 2.0 API Reference Guide]: https://www.khronos.org/files/gltf20-reference-guide.pdf
+[Blender 5.0 Reference Manual]: https://docs.blender.org/manual/en/latest
+[Blender 5.0 glTF 2.0]: https://docs.blender.org/manual/en/5.0/addons/import_export/scene_gltf2.html
+[Blender 5.0 Python API Documentation]: https://docs.blender.org/api/current/index.html
+[Blender]: https://www.blender.org/
+[CLI.md]: https://github.com/kjanat/notso-glb/blob/master/CLI.md
+[LICENSE]: https://github.com/kjanat/notso-glb/blob/master/LICENSE
+
+<!-- markdownlint-disable-file MD033 -->

notso_glb-0.1.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+notso_glb/__init__.py,sha256=wlZgQgpB-stUEc5VFq4C_pbnnSvOck5hr-hanytRbhw,1139
+notso_glb/__main__.py,sha256=quXpLTD85lDSE5G3diUB5s4ZX2FWEzmB6LombcP_r3g,115
+notso_glb/analyzers/__init__.py,sha256=GxoWKtHe-ChOfNY_iRRh-BHxKSYUeF4zbsT0yD0B0GI,678
+notso_glb/analyzers/bloat.py,sha256=l_5YEHtm3RC4FMIDaxeZN1U_bHqDvoqSxvgFp7UFF2I,3810
+notso_glb/analyzers/bones.py,sha256=nBjx4W7NxUEQdAIzimkFsMQWU_qk7QRBr3T8b0vtrmY,3372
+notso_glb/analyzers/duplicates.py,sha256=-mAlgwiGbArD3Y0PC_WUSgV_8f0S-joUCv1QdeqrJus,2437
+notso_glb/analyzers/skinned_mesh.py,sha256=iXXUcID-LSluK20R5Gl5S8KpKi1ui_rIJNUpQoKFCFo,1515
+notso_glb/analyzers/uv_maps.py,sha256=oaBgh_OqbcP6T5z_JFGhHwkti51WLX-BqTP7AiItLAk,1869
+notso_glb/cleaners/__init__.py,sha256=EWtJQXmivkqv4h7J46kOEaQk1zlLQrPDHKoyGOLs5FU,767
+notso_glb/cleaners/bones.py,sha256=NnowR9fyQy7VVrwr98x0GeB3mbzJX4OhC9vi3rJw1Cc,1468
+notso_glb/cleaners/duplicates.py,sha256=RgpoSqEkioKp4dAQVmFv0oIadLTMaZJgP8feuBZy5Ao,3307
+notso_glb/cleaners/mesh.py,sha256=bD3Z7ubf1HD2DPupdRzj7W30sl6i-zcpln53kZNozwM,5946
+notso_glb/cleaners/textures.py,sha256=HHeufOMDg_tj9SHFGjr-mHrSv4ejou6WbKEP5BVZbVY,3140
+notso_glb/cleaners/uv_maps.py,sha256=oqDxQjFH0hADqwIQ1FgCOZ0D-nWBFuEkjQ62rm2DoaA,819
+notso_glb/cleaners/vertex_groups.py,sha256=wlLdV-kCr3s6y90JbTARQvEDyrOvIRiL6KusWz1-uVM,887
+notso_glb/cli.py,sha256=Qa4QAArRNKz_ZjPxpPK82KtyVcm756ZFN0StW50rPmM,11430
+notso_glb/exporters/__init__.py,sha256=P9FYVID1CmUFt7ZYuB_cXP5-bF4D9Ry0OIVpq7nvjB0,165
+notso_glb/exporters/gltf.py,sha256=A9EpXqgDKMEjF7oGNZdDPhp2zMfgFGRpgkK2Zf77lnY,22951
+notso_glb/utils/__init__.py,sha256=eci6g39oZWaRm7EJpuhc4bknamY8_EHzwLvKYGYIW-Q,423
+notso_glb/utils/blender.py,sha256=60TXWvKCM6K7r6qSRE6z97n3z7KO5n5mTY1LhfmpTLY,1432
+notso_glb/utils/constants.py,sha256=yTuUF4FxqNHG9t00vMj1FtLtoTqw55oGT9ZmNMg3_tM,1452
+notso_glb/utils/gltfpack.py,sha256=2kgmQG71JoDToRwbGaCrE3viQbB0zSi45ISFbjehW0M,8343
+notso_glb/utils/logging.py,sha256=Z8LCe0Pt6vALAtpRg-VnzIUYqELFUTL_ifRy7Oau0CQ,11908
+notso_glb/utils/naming.py,sha256=ng7Jx6tXJPsYgDMZKgcwr7ZboTz1SvbJQXVii5xjJtc,669
+notso_glb/wasm/__init__.py,sha256=KGUHFCnP_eQFgwEyHUpJMP9JF-TMh7dE-ueXCLEQ3dI,720
+notso_glb/wasm/constants.py,sha256=Su3qEE3uxHYVJ3JhsGBW3wU5bA4FAC9j8rZQ8GgoElQ,163
+notso_glb/wasm/gltfpack.version,sha256=WYVJhIUxBN9cNT4vaBoV_HkkdC-aLkaMKa8kjc5FzgM,6
+notso_glb/wasm/gltfpack.wasm,sha256=QAedo3M_6rZNJsfyraI_08RtAHsnShaz7bsuZ1l16R4,314093
+notso_glb/wasm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+notso_glb/wasm/runner.py,sha256=6GTWk0JPlaqi_ggIcwtHfGdWX7hGOA7Z4q7yuVFtjgA,4150
+notso_glb/wasm/runtime.py,sha256=RyQ7VTdE3n8edDa3PC_JfXaA9PNsjDkAhllutTBCBAY,7160
+notso_glb/wasm/wasi.py,sha256=PHq0wMsTZbxmlznt-RTWfL-NB2p1lRMlaUc1NQoMtOU,12023
+notso_glb-0.1.0.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
+notso_glb-0.1.0.dist-info/entry_points.txt,sha256=W9U3aSH3ks2M_d5WEBTOKwCUPWQKbPELi2C5GgeENwQ,46
+notso_glb-0.1.0.dist-info/METADATA,sha256=_vsaPMbl95ZNdexudvrnXmBN-USWvgzgoTB0L-q0eUs,5380
+notso_glb-0.1.0.dist-info/RECORD,,

notso_glb-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.29
+Root-Is-Purelib: true
+Tag: py3-none-any

notso_glb-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+notso-glb = notso_glb:main
+