2025-12-01

2026-03-17 14:58:51 -06:00
parent 183e865f8b
commit 4b82b57113
6846 changed files with 954887 additions and 162606 deletions
@@ -0,0 +1,64 @@
+# BToon
+
+Blender addon for toon rendering.
+
+![](./docs/teaser.jpg)
+
+## Toon Shading
+
+### BToon Skin Material
+
+#### Description
+
+This is a simple toon material designed for skins. It has controllable rim lighting, SSS, and specular effects. This material only works with EEVEE.
+
+![](./docs/btoon-skin.png)
+
+#### Usage
+
+- Select target objects
+- `3D Viewport` > `Object` > `BToon Utilities` > `Append Skin Material`
+
+## Contour Rendering
+
+### Approach 1: Mesh Displacement and Culling
+
+![](./docs/contour-before.png)
+![](./docs/contour-after.png)
+
+#### Description
+
+This is a mesh-based technique to rendering contours, where meshes are duplicated, flipped, and then displaced outside.
+
+- Pros
+  - Thickness can be controlled using textures.
+  - Contours can be displaced in the viewport.
+  - The same effect can be easily reproduced in other real-time rendering environment such as Unity.
+  - ...
+- Cons
+  - Ridges, valleys, and suggestive contours are not supported.
+  - ...
+
+#### Usage
+
+- Select target objects
+- `3D Viewport` > `Object` > `BToon Utilities` > `Set Contours`
+
+#### Implementation
+
+- It applies `Solidify` and `Displace` modifiers to the selected objects.
+- An emission-based material with backface culling enabled is created and set to contours.
+
+### Future Work
+
+- Utilities for composition-based contour rendering
+- Utilities for FreeStyle-based contour rendering
+
+## How to Install
+
+(TODO)
+
+## License
+
+- The Python codes (using Blender Python APIs) are licensed under GPLv3.
+- The `.blend` library files are licensed under CC BY 4.0. (However, you do not need the BY credit when using the libraries through this addon.)