Merge pull request #2663 from nortikin/adaptive_polys_fan

Adaptive polygons: Frame / Fan mode

Merge pull request #2663 from nortikin/adaptive_polys_fan
Adaptive polygons: Frame / Fan mode
467a078f · Ilya V. Portnov · GitHub · 456e768c · 5941cc9e · 467a078f
--- a/docs/nodes/modifier_make/adaptive_polygons_mk2.rst
+++ b/docs/nodes/modifier_make/adaptive_polygons_mk2.rst
@@ -11,7 +11,12 @@ deformed (adapted) to match the shape and normals of recipient's face.
 This node works primarily with Quads and Tris; if you ask it to work with NGons
 (N > 4), it can produce weird resuls.

-One can pass recipient object through **Inset Special** node to achieve results
+As an option, the node can process NGons (and Quads / Tris, optionally) in so
+called "Frame / Fan" mode. In this mode, each face of recipient mesh is inset
+by some amount, so it is replaced with a number of either Quads or Tris. Each
+of such faces is then processed as usual.
+
+Or one can pass recipient object through **Inset Special** node to achieve results
 similar to Tissue's "Fan" or "Frame" modes.

 In many cases it is good idea to pass the output of this node through **Remove
@@ -37,6 +42,10 @@ This node has the following inputs:
 - **Width coeff**. Coefficient for donor object width (size along X,Y axis,
  usually). Default value is 1.0. The input expects one number per each
  recipient object face.
+- **Frame width**. Width of frame for "Frame / Fan" mode. Maximum value of 1.0
+  means that there will be no gap in the center of face, so this will be "Fan"
+  mode. Default value is 0.5. This input is available only if **Frame mode**
+  parameter is set to value other than **Do not use**.
 - **Z coeff**. Coefficient for donor object size along recipient object face
  normal. Exact meaning depends on **Z Scale** parameter (see below). The
  default value is 1.0. The input expects one number per each recipient object face.
@@ -146,6 +155,22 @@ This node has some number of parameters, and most of them are accessible only in

  The default value is **Bounds**.

+- **Frame mode**. This defines when to apply "Frame / Fan" mode. The available values are:
+
+  - **Do not use**. Frame / fan mode will not be used.
+  - **NGons only**. Frame / fan mode will be used for NGons (n > 4) only. Other
+    faces will be processed in simple replacement mode.
+  - **NGons and Quads**. Frame / fan mode will be used for NGons and Quads
+    (i.e. n >= 4) only. Tris will be processed in simple replacement mode.
+  - **Always**. Frame / fan mode will be used for all faces.
+
+  The default value is **Do not use**.
+
+  Note that "Frame / Fan" mode makes either several Quads (when FrameWidth <
+  1.0) or several Tris (when FrameWidth == 1.0) out of each recipient face. How
+  exactly these Quads and Tris will be processed is defined by **Faces mode**
+  parameter.
+
 - **Faces mode**. This defines how deformations of donor object will be
  calculated for Quad and Tris recipient faces. Available values are:

@@ -215,5 +240,13 @@ In some cases iterative application can give interesting results:

 .. image:: https://user-images.githubusercontent.com/284644/68075234-ee027080-fdc6-11e9-8192-61d0917d45f7.png

+An example of **Frame** mode:
+
+.. image:: https://user-images.githubusercontent.com/284644/68528852-d7ee3600-0319-11ea-81ba-14bdd6e36a8e.png
+
+The same setup with **FrameWidth** set to 1.0 - the processing switches to **Fan** mode:
+
+.. image:: https://user-images.githubusercontent.com/284644/68528834-b68d4a00-0319-11ea-89d7-5857c886d423.png
+
 You can also find some more examples `in the development thread <https://github.com/nortikin/sverchok/pull/2651>`_.

--- a/nodes/modifier_make/adaptive_polygons_mk2.py
+++ b/nodes/modifier_make/adaptive_polygons_mk2.py