[Bf-docboard-svn] bf-manual: [9062] trunk/blender_docs/manual: Tissue documentation update 03
Alessandro Zomparelli
noreply at blender.org
Tue Mar 1 16:47:18 CET 2022
Revision: 9062
https://developer.blender.org/rBM9062
Author: alessandrozompa
Date: 2022-03-01 16:47:18 +0100 (Tue, 01 Mar 2022)
Log Message:
-----------
Tissue documentation update 03
Modified Paths:
--------------
trunk/blender_docs/manual/addons/mesh/tissue.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/addons_mesh_tissue_color-tools.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_convert-to-curve-example.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-fan-mode.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-fill-modes.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-frame-mode.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-iterations.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-panel.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-patch-mode.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-quad-mode.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tessellate-weight-and-morphing.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_tissue-tools.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_weight-distance.jpg
trunk/blender_docs/manual/images/addons_mesh_tissue_weight-tools.jpg
Modified: trunk/blender_docs/manual/addons/mesh/tissue.rst
===================================================================
--- trunk/blender_docs/manual/addons/mesh/tissue.rst 2022-03-01 04:07:18 UTC (rev 9061)
+++ trunk/blender_docs/manual/addons/mesh/tissue.rst 2022-03-01 15:47:18 UTC (rev 9062)
@@ -3,15 +3,15 @@
Tissue
******
+
.. figure:: /images/addons_mesh_tissue_cover.jpg
Tissue is a collection of tools that facilitate the use of computational-design techniques inside Blender.
-It consists of different tools, visible in the right panel.
-According to the active mode, different tools are displayed:
+It consists of different tools, visible in the right panel. According to the active mode, different tools are displayed:
-- Tissue Tools (visible in Edit Mode and Object Mode)
-- Tissue Weight Tools (visible in Weight Paint Mode)
-- Tissue Color Tools (visible in Vertex Weight Mode)
+- :ref:`Tissue Tools <tissue tools>` (visible in Edit Mode and Object Mode)
+- :ref:`Tissue Weight Tools <tissue weight tools>` (visible in Weight Paint Mode)
+- :ref:`Tissue Color Tools <tissue color tools>` (visible in Vertex Weight Mode)
Activation
@@ -20,18 +20,21 @@
- Open Blender and go to Preferences then the Add-ons tab.
- Click Mesh then Tissue to enable the script.
+.. _tissue tools:
Tissue Tools
-============
+===========
+.. figure:: /images/addons_mesh_tissue_tissue-tools.jpg
+
Generators
----------
-*Generators* are non-destructive functions that generate new objects starting from input objects.
-They include **Tessellate**, **Dual Mesh** (a special Tessellate) and **Convert to Curve**.
-For all of them, a **Refresh** operator can be used in order to reload the changes from the input objects.
+*Generators* are non-destructive functions that generate new objects starting
+from input objects. They include **Tessellate**, **Dual Mesh** (a special
+Tessellate) and **Convert to Curve**. For all of them, a **Refresh** operator can be used in order to reload the
+changes from the input objects.
-
Tessellate
----------
@@ -43,9 +46,10 @@
.. figure:: /images/addons_mesh_tissue_tessellate-operator.jpg
-Later it will be possible to change them, together with more advanced settings
-from the *Object Data Panel* of the generated object.
+Later it will be possible to change them, together with more advanced settings from the *Object Data Panel* of the generated object.
+.. figure:: /images/addons_mesh_tissue_tessellate-panel.jpg
+
Use Modifiers
This option is available for both *Base* and *Component* objects and allows the use
the respective modifiers. If this option is disabled, then only the original object's
@@ -54,6 +58,8 @@
Fill Mode
Tessellation strategy used to map the Component's coordinates on the Base's faces.
+ .. figure:: /images/addons_mesh_tissue_tessellate-fill-modes.jpg
+
Tri
This options will automatically triangulate the Base object and will map the component
to the triangular faces. The input domain will be considered rectangular, but the
@@ -61,18 +67,30 @@
Quad (default)
This is the default method and will map the Component domain to each quad face of the Base object.
If an face has more than 4 vertices, then it will be automatically separated in quad or triangular faces.
+
+ .. figure:: /images/addons_mesh_tissue_tessellate-quad-mode.jpg
+
Fan
This option will split every face of the Base object in triangles connecting each side of the face
to its center.
+
+ .. figure:: /images/addons_mesh_tissue_tessellate-fan-mode.jpg
+
Patch
This option require the use of a Subdivision Surface modifier on the Base object.
It is similar to the *Quad* method, but it will allow to use curved domains, based on the Subdivided patches.
If more subdivision surfaces (or Multiresolution modifiers) are used, then only the last one will be used for
defining the target patches.
+
+ .. figure:: /images/addons_mesh_tissue_tessellate-patch-mode.jpg
+
Frame
Similarly to an Inset Face operator, this option will allow to apply the components along
offset faces of a given Thickness.
+ .. figure:: /images/addons_mesh_tissue_tessellate-frame-mode.jpg
+
+
Merge
Automatically merge together all the generated components.
@@ -86,15 +104,48 @@
Generate components with a fixed and uniform thickness in the normal direction.
Relative
Generate components with a thickness proportional to the target face dimension.
- This will produce components with an aspect ration similar to the original Component object.
+ This will produce components with an aspect ration similar to the original Component
+ object.
Scale
- Control the scaling factor of the components' Thickness.
+ control the scaling factor of the components' Thickness
Offset
Allows to control the alignment of the components in relation to the Base object surface.
+Weight and Morphing
+ Combine the Vertex Groups of the base object with the Shape Keys from the component, in order to generate morphing components.
+ .. figure:: /images/addons_mesh_tissue_tessellate-weight-and-morphing.jpg
+
+ Map Vertex Groups
+ Remap each Vertex Group from the base mesh to the generated geometry
+
+ Use Shape Keys
+ Transfer the Shape Keys from the component object to the generated object.
+ If the name of the base's vertex groups and the Shape Keys match, then they
+ will be automatically assigned in order to control their morphing behavior.
+
+Iterations
+ Automatically repeat the tessellation using as base the result of the previous iteration.
+
+ .. figure:: /images/addons_mesh_tissue_tessellate-iterations.jpg
+
+ Repeat
+ Number of iterations.
+
+ Combine iterations
+ Combine the resulting tessellation with part or all of the previous iteration:
+
+ Last
+ Ignore the previous iterations.
+
+ Unused
+ Combine the tessellation with the faces of the previous iteration that are not generating components.
+
+ All
+ Combine the tessellation with all the faces from the previous iteration.
+
Dual Mesh
----------
+----------
*Dual Mesh* modifies the selected meshes creating dual meshes.
Dual Mesh output is a polygonal mesh derived from the triangular mesh.
@@ -109,46 +160,43 @@
Preserve Borders
Prevent alteration of the open boundaries of the mesh.
-
Convert to Curve
-----------------
+----------
+Generate a Curve object from the *Loops*, *Edges* or *Particles* of the active object.
+
+.. figure:: /images/addons_mesh_tissue_convert-to-curve-example.jpg
+
(To Do)
-
Refresh
--------
+------
-The options for the *Update* tool are the same of *Tessellate*.
-Furthermore, it allows to change Generator object and Component object.
+Update the active object according to the changes in the base geometries.
+This operator works on the objects generated through *Tessellate* and *Convert to Curve*.
-
Rotate Faces
-------------
+------
(To Do)
-
Convert to Dual Mesh
---------------------
+------
(To Do)
-
Polyhedra Wireframe
--------------------
+------
(To Do)
-
Lattice Along Surface
----------------------
+------
(To Do)
-
UV to Mesh
-----------
+------
Convert the active UV-map to mesh trying to preserve the original 3D model total surface area.
@@ -156,28 +204,30 @@
Random Materials
-----------------
+------
(To Do)
-
Weight to Materials
--------------------
+------
(To Do)
-
Tissue Render Animation
------------------------
+------
(To Do)
+.. _tissue weight tools:
+
Tissue Weight Tools
-===================
+===========
+.. figure:: /images/addons_mesh_tissue_weight-tools.jpg
+
Area
-----
+------
Weight from Faces area (Automatic Bounds, Manual Bounds)
@@ -185,7 +235,7 @@
Curvature
----------
+------
Weight from Curvature (Based on Dirty Vertex Colors)
@@ -193,66 +243,58 @@
Weight Distance
----------------
+------
-(To Do)
+Generate a vertex group according to the distance from the selected vertices.
+Different methods can be used: *Geodesic*, *Euclidean* or *Topology* distance.
+.. figure:: /images/addons_mesh_tissue_weight-distance.jpg
Weight Formula
---------------
+------
-Weight based on Vertices parameters. Allows to use vertices coordinates and normals direction.
-Integer and Float sliders can be created in order to find the proper parameters more easily.
+Weight based on Vertices parameters. Allows to use vertices coordinates and normals direction. Integer and Float sliders can be created in order to find the proper parameters more easily.
.. figure:: /images/addons_mesh_tissue_weight-formula.jpg
-
Weight Laplacian
-----------------
+------
(To Do)
-
Harmonic
---------
+------
Harmonic function based on active Weight
.. figure:: /images/addons_mesh_tissue_weight-harmonic.jpg
-
Random
------
(To Do)
-
Edges Deformation
------------------
+------
-Generate a Vertex Group based on Edges Deformation evaluated on the Modifiers result
-(Deformation Modifiers and Simulations).
+Generate a Vertex Group based on Edges Deformation evaluated on the Modifiers result (Deformation Modifiers and Simulations)
.. figure:: /images/addons_mesh_tissue_weight-edges-deformation.jpg
-
Edges Bending
--------------
+------
-Generate a Vertex Group based on Edges Bending evaluated on the Modifiers result
-(Deformation Modifiers and Simulations).
+Generate a Vertex Group based on Edges Bending evaluated on the Modifiers result (Deformation Modifiers and Simulations)
.. figure:: /images/addons_mesh_tissue_weight-edges-bending.jpg
-
Streamlines Curves
-------------------
+------
(To Do)
-
Contour Curves
---------------
+------
Generates isocurves based on Active Weight.
@@ -260,7 +302,7 @@
Contour Displace
-----------------
+------
Cut the mesh according to active Weight in a variable number of isocurves and automatically add a Displace Modifier.
@@ -268,7 +310,7 @@
Contour Mask
-------------
+------
Trim the mesh according to active Weight.
@@ -276,25 +318,22 @@
Reaction Diffusion
-------------------
+------
(To Do)
-
Radom Materials
----------------
+------
(To Do)
-
Weight to Materials
--------------------
+------
(To Do)
-
Convert to Colors
------------------
+------
Convert To
Value Channel, Red Channel, Green Channel, Blue Channel, False Color
@@ -301,18 +340,21 @@
Invert
Invert the values read from vertex weight.
-
Convert to UV
--------------
+------
(To Do)
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list