add blender script

MANIFEST.in

@@ -1,2 +1,2 @@
-recursive-include kiui/lights *
+recursive-include kiui/assets *
 recursive-include kiui/gridencoder/src *

docs/source/blender.md

@@ -0,0 +1,14 @@
+# Blender
+
+To render complex 3D models (specifically with multiple submeshes), the only choice is to use `blender` and `bpy`.
+
+We provide an example code for rendering with blender:
+
+```bash
+python -m kiui.cli.blender_render --help
+```
+
+Its features include:
+* Set which GPU to use with `--gpu 0`.
+* Render with random HDRI environment texture (check `assets/blender_lights`).
+* Empirical cleaning of the scene (remove the annoying plane under the object).

docs/source/index.md

@@ -41,4 +41,5 @@ pip install -U git+https://github.com/ashawkey/kiuikit.git
    :titlesonly:
 
    ./render.md
+   ./blender.md
    ./misc.md

kiui/assets/blender_lights/license.txt

@@ -0,0 +1,6 @@
+All HDRIs are licenses as CC0.
+
+These were created by Greg Zaal (HDRI Haven https://hdrihaven.com).
+
+NOTE: extracted from blender 2.93
+ref: https://blender.stackexchange.com/questions/128499/how-to-use-built-in-default-hdris-in-renders