2017-12-08 10:33:10 +01:00
|
|
|
YOGA - Yummy Optimizer for Gorgeous Assets
|
|
|
|
==========================================
|
|
|
|
|
2018-02-19 16:27:55 +01:00
|
|
|
.. figure:: https://github.com/wanadev/yoga/raw/master/logo.png
|
2018-01-15 17:11:24 +01:00
|
|
|
:alt:
|
|
|
|
|
|
|
|
**YOGA** is a command-line tool and a library that can:
|
2018-01-15 16:55:57 +01:00
|
|
|
|
|
|
|
* convert and optimize images from various format to JPEG and PNG,
|
2018-02-19 16:27:55 +01:00
|
|
|
* convert and optimize 3D models from various formats to `GLB`_.
|
2018-01-15 16:55:57 +01:00
|
|
|
|
2018-01-15 17:22:07 +01:00
|
|
|
**Images** are opened using Pillow_ and optimized using Guetzli_ (for JPEGs) and
|
|
|
|
Zopflipng_ (for PNGs).
|
2018-01-15 16:55:57 +01:00
|
|
|
|
2018-01-15 17:22:07 +01:00
|
|
|
**3D Models** are converted and optimized using assimp_. If models contain or
|
2018-01-15 16:55:57 +01:00
|
|
|
reference images, they are processed by YOGA's image optimizer.
|
|
|
|
|
|
|
|
Convert and optimize an image from CLI::
|
|
|
|
|
2018-01-15 17:11:24 +01:00
|
|
|
yoga image input.png output.png
|
2018-01-15 16:55:57 +01:00
|
|
|
yoga image --output-format=jpeg --jpeg-quality=84 input.png output.jpg
|
|
|
|
yoga image --help
|
|
|
|
|
|
|
|
Convert and optimize a 3D model from CLI::
|
|
|
|
|
2018-02-19 16:27:55 +01:00
|
|
|
yoga model input.fbx output.glb
|
|
|
|
yoga model --no-graph-optimization --no-meshes-optimization --image-output-format=jpeg --image-jpeg-quality=84 input.fbx output.glb
|
2018-01-15 16:55:57 +01:00
|
|
|
yoga model --help
|
2018-01-15 17:22:07 +01:00
|
|
|
|
2018-02-21 09:24:00 +01:00
|
|
|
.. _GLB: https://www.khronos.org/gltf/
|
2018-01-15 17:22:07 +01:00
|
|
|
.. _Pillow: https://github.com/python-pillow/Pillow
|
|
|
|
.. _Guetzli: https://github.com/google/guetzli
|
|
|
|
.. _Zopflipng: https://github.com/google/zopfli
|
|
|
|
.. _assimp: https://github.com/assimp/assimp
|
2018-02-19 16:10:09 +01:00
|
|
|
|
|
|
|
|
|
|
|
Changelog
|
|
|
|
---------
|
|
|
|
|
2018-04-05 14:41:21 +02:00
|
|
|
* **0.9.1b1:**
|
2018-04-05 14:50:13 +02:00
|
|
|
|
2018-04-05 14:41:21 +02:00
|
|
|
* Automatic selection of the output format (png or jpeg),
|
|
|
|
* Prevent duplication of textures that are shared between materials,
|
|
|
|
* Fixes Windows paths of textures.
|
2018-04-05 14:50:13 +02:00
|
|
|
|
2018-04-05 14:41:21 +02:00
|
|
|
* **0.9.0b1:** First release (only GLB output for models, no image auto
|
2018-02-19 16:10:09 +01:00
|
|
|
output format)
|