diff --git a/docs/nodes/CAD/crop_mesh_2d.rst b/docs/nodes/CAD/crop_mesh_2d.rst index 13c6a437cec1a81a0d0991ab93bdea89b80d1a42..84e8ef60551460ac36b79750c88e772bdba8fd41 100644 --- a/docs/nodes/CAD/crop_mesh_2d.rst +++ b/docs/nodes/CAD/crop_mesh_2d.rst @@ -138,11 +138,10 @@ Creating something like sewer grate: * Generator-> :doc:`Line ` * Generator-> :doc:`Plane ` -* Modifier->Modifier Change-> :doc:`Bevel ` -* Modifier->Modifier Change-> :doc:`Mesh Join ` -* Modifier->Modifier Change-> :doc:`Delete Loose ` -* Modifier->Modifier Make-> :doc:`Contour 2D ` -* CAD-> :doc:`Contour 2D ` +* Modifiers->Modifier Change-> :doc:`Bevel ` +* Modifiers->Modifier Change-> :doc:`Mesh Join ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` +* Modifiers->Modifier Make-> :doc:`Contour 2D ` * Modifier Make-> :doc:`Solidify ` * Vector-> :doc:`Vector Polar Input ` * ADD, Scale: Vector-> :doc:`Vector Math ` diff --git a/docs/nodes/CAD/edges_intersect_mk3.rst b/docs/nodes/CAD/edges_intersect_mk3.rst index b49fbac78c56924bb027d812868a960bcf5e498d..c654f784b82078958d36e354b129c77dcd85b2da 100644 --- a/docs/nodes/CAD/edges_intersect_mk3.rst +++ b/docs/nodes/CAD/edges_intersect_mk3.rst @@ -142,7 +142,7 @@ Examples * Generator-> :doc:`Line ` * Generator->Generatots Extended-> :doc:`Hilbert ` -* Modifier->Modifier Change-> :doc:`Mesh Join ` +* Modifiers->Modifier Change-> :doc:`Mesh Join ` * Vector-> :doc:`Vector Polar Input ` * List->List Main-> :doc:`List Join ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/analyzer/inscribed_circle.rst b/docs/nodes/analyzer/inscribed_circle.rst index a4c7a4fa9604484b7683486b365595fc67d02880..200c17386f10ebf5b37603060adfb17ce29e80db 100644 --- a/docs/nodes/analyzer/inscribed_circle.rst +++ b/docs/nodes/analyzer/inscribed_circle.rst @@ -91,7 +91,7 @@ Inscribed circles for (triangulated) Suzanne: * Generator-> :doc:`Circle ` * Generator-> :doc:`Suzanne ` -* Modifier->Modifier Change-> :doc:`Triangulate Mesh ` +* Modifiers->Modifier Change-> :doc:`Triangulate Mesh ` * Number-> :doc:`Number Range ` * Color-> :doc:`Color In ` * List->List Struct-> :doc:`List Length ` \ No newline at end of file diff --git a/docs/nodes/analyzer/mesh_filter.rst b/docs/nodes/analyzer/mesh_filter.rst index 4b7ed58b27a03b01d35a8cc46e6ff8df9a1ae963..6ce79095e5f9c51958e82cfc3488b53757a7f569 100644 --- a/docs/nodes/analyzer/mesh_filter.rst +++ b/docs/nodes/analyzer/mesh_filter.rst @@ -134,7 +134,7 @@ Bevel only concave edges: * Generator-> :doc:`IcoSphere ` * Transform-> :doc:`Move ` * Transform-> :doc:`Scale ` -* Modifier->Modifier Change-> :doc:`Extrude Separate Faces ` +* Modifiers->Modifier Change-> :doc:`Extrude Separate Faces ` * CAD-> :doc:`Bevel ` * Number-> :doc:`A Number ` * Matrix-> :doc:`Matrix In ` @@ -152,7 +152,7 @@ Extrude only boundary faces: :target: https://user-images.githubusercontent.com/14288520/196672202-23b0fc30-8d97-46de-9a72-7b1be48293d3.png * Generator->Generators Extended-> :doc:`Bricks Grid ` -* Modifier->Modifier Change-> :doc:`Extrude Separate Faces ` +* Modifiers->Modifier Change-> :doc:`Extrude Separate Faces ` * Matrix-> :doc:`Matrix In ` * Color-> :doc:`Color Input ` * Logic-> :doc:`Switch ` diff --git a/docs/nodes/analyzer/normals_mk2.rst b/docs/nodes/analyzer/normals_mk2.rst index 6657fdc7a1acce4f541d1c6dd63554e4188b80f1..7e6abb34f31884db9d81c5b499206759bd0d5c17 100644 --- a/docs/nodes/analyzer/normals_mk2.rst +++ b/docs/nodes/analyzer/normals_mk2.rst @@ -55,7 +55,7 @@ Move each face of cube along its normal: * Generator-> :doc:`Segment ` * Transform-> :doc:`Move ` * Analyzers-> :doc:`Origins ` -* Modifier->Modifier Change-> :doc:`Polygon Boom ` +* Modifiers->Modifier Change-> :doc:`Polygon Boom ` * Viz-> :doc:`Viewer Draw ` .. image:: https://user-images.githubusercontent.com/14288520/195851616-d5b47ede-2a96-42f1-8de2-f1283386778e.gif diff --git a/docs/nodes/analyzer/points_inside_mesh.rst b/docs/nodes/analyzer/points_inside_mesh.rst index 3c59481149585a6fb261d8ec37a5bf409d7a4d50..87017f8c0def5b6563957972ad440051825f9e6c 100644 --- a/docs/nodes/analyzer/points_inside_mesh.rst +++ b/docs/nodes/analyzer/points_inside_mesh.rst @@ -84,7 +84,7 @@ Examples of use * Generator-> :doc:`Plane ` * Generator-> :doc:`NGon ` * Analyzers-> :ref:`Component Analyzer/Faces/Center ` -* Modifier->Modifier Change-> :doc:`Inset Faces ` +* Modifiers->Modifier Change-> :doc:`Inset Faces ` * Matrix-> :doc:`Matrix In ` * List-> :doc:`List Mask (Out) ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/analyzer/project_point_to_line.rst b/docs/nodes/analyzer/project_point_to_line.rst index 625220915ea3d758dfa43dc41b86481c91fc3f36..dc9555d0decbe88da7a991a3f9cbbda4ac649ccb 100644 --- a/docs/nodes/analyzer/project_point_to_line.rst +++ b/docs/nodes/analyzer/project_point_to_line.rst @@ -122,7 +122,7 @@ Examples * Generator-> :doc:`NGon ` * Transform-> :doc:`Rotate ` * Transform-> :doc:`Rotate ` -* Remove Doubles (OLD Node). Use: Modifier->Modifier Change-> :doc:`Merge by Distance ` +* Remove Doubles (OLD Node). Use: Modifiers->Modifier Change-> :doc:`Merge by Distance ` * Vector-> :doc:`Vector In ` * ADD: Vector-> :doc:`Vector Math ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/analyzer/proportional.rst b/docs/nodes/analyzer/proportional.rst index 35ee91ff536b09bbc277756c7ed409a8a9efad10..c0907c7607e9c02ac7378f5053f78bfdd7e205b3 100644 --- a/docs/nodes/analyzer/proportional.rst +++ b/docs/nodes/analyzer/proportional.rst @@ -44,6 +44,13 @@ Outputs This node has one output: **Coeffs**. It contains one real value for each input vertex. All values are between 0.0 and 1.0. +**See also**: + +See also +-------- + +* Vector-> :doc:`Vector Attraction ` + Examples of usage ----------------- @@ -79,7 +86,7 @@ Example of usage with Extrude Separate node: * Analyzers-> :doc:`Origins ` * Analyzers-> :doc:`Select Mesh Elements ` * Analyzers-> :doc:`Points Inside Mesh ` -* Modifier->Modifier Change-> :doc:`Extrude Separate Faces ` +* Modifiers->Modifier Change-> :doc:`Extrude Separate Faces ` * Number-> :doc:`A Number ` * SCALAR: Number-> :doc:`Scalar Math ` * Vector-> :doc:`Vector In ` diff --git a/docs/nodes/analyzer/raycaster_lite.rst b/docs/nodes/analyzer/raycaster_lite.rst index c3077bffd8591f864735cf295185fc8cc1dd914c..f7a8f14cecf4eda2cb111b95fa68ba447cda9766 100644 --- a/docs/nodes/analyzer/raycaster_lite.rst +++ b/docs/nodes/analyzer/raycaster_lite.rst @@ -87,7 +87,7 @@ Usage * CAD-> :doc:`Intersect Edges ` * CAD-> :doc:`Planar Edgenet to Faces ` * Analyzer-> :doc:`Mesh Filter ` -* Modifier->Modifier Change-> :doc:`Delete Loose ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` * Analyzers-> :doc:`Distance Point Plane ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/analyzer/steiner_ellipse.rst b/docs/nodes/analyzer/steiner_ellipse.rst index 2ecfc3fe8e1bfc7d23c29e8851d7631846ffc8f6..732b4829f2d9416af17c0b10c9c0fe1d72631961 100644 --- a/docs/nodes/analyzer/steiner_ellipse.rst +++ b/docs/nodes/analyzer/steiner_ellipse.rst @@ -118,7 +118,7 @@ Inscribed ellipses for triangulated Suzanne: * Generator-> :doc:`Suzanne ` * Generator->Generator Extended-> :doc:`Ellipse ` -* Modifier->Modifier Change-> :doc:`Triangulate Mesh ` +* Modifiers->Modifier Change-> :doc:`Triangulate Mesh ` * Matrix-> :doc:`Matrix In ` * Matrix-> :doc:`Matrix In ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/color/texture_evaluate_mk2.rst b/docs/nodes/color/texture_evaluate_mk2.rst index 48eaa44cb94b0e45c37925f6fcb016ea59b2413b..2b580128794b9574d33481a538652edf7b094e0f 100644 --- a/docs/nodes/color/texture_evaluate_mk2.rst +++ b/docs/nodes/color/texture_evaluate_mk2.rst @@ -47,7 +47,7 @@ Mixing 3 textures * Generator-> :doc:`Plane ` * Logic-> :doc:`Logic Functions ` -* Modifier->Modifier Change-> :doc:`Mask Vertices ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * Viz-> :doc:`Viewer Draw ` Masking mesh with texture diff --git a/docs/nodes/generators_extended/conic_section.rst b/docs/nodes/generators_extended/conic_section.rst index 27d9c4e5b5d5028bce55d721cef52c61c9719af0..1d3c5681a509e96de4934c766e9686e76cdcede5 100644 --- a/docs/nodes/generators_extended/conic_section.rst +++ b/docs/nodes/generators_extended/conic_section.rst @@ -123,7 +123,7 @@ One can generate a hyperbola (2-branched curve) and then use it to generate 1-sh .. image:: https://user-images.githubusercontent.com/14288520/191035609-4353b6d8-f1f8-4c60-8cb6-f9b5ba25103f.png :target: https://user-images.githubusercontent.com/14288520/191035609-4353b6d8-f1f8-4c60-8cb6-f9b5ba25103f.png -* Modifier->Modifier Change-> :doc:`Mask Vertices ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * CAD-> :doc:`Lathe ` * Viz-> :doc:`Viewer Draw ` @@ -132,7 +132,7 @@ or 2-sheet hyperboloid .. image:: https://user-images.githubusercontent.com/14288520/191035963-1cb09de2-dc4f-426a-b70a-faa3ad1dc263.png :target: https://user-images.githubusercontent.com/14288520/191035963-1cb09de2-dc4f-426a-b70a-faa3ad1dc263.png -* Modifier->Modifier Change-> :doc:`Mask Vertices ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * CAD-> :doc:`Lathe ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/generators_extended/polygon_grid.rst b/docs/nodes/generators_extended/polygon_grid.rst index f4c688fdef86770a10177eff4bda2ef936307d99..752af611c65398deb464309cd3514327796f2011 100644 --- a/docs/nodes/generators_extended/polygon_grid.rst +++ b/docs/nodes/generators_extended/polygon_grid.rst @@ -102,7 +102,7 @@ Example of usage * Vector-> :doc:`Vector Attraction ` * Transform-> :doc:`Matrix Apply (verts) ` -* Modifier->Modifier Change-> :doc:`Delete Loose ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` * Modifiers->Modifier Make-> :doc:`Wireframe ` * Number-> :doc:`Random Num Gen ` * ADD: Vector-> :doc:`Vector Math ` @@ -115,9 +115,9 @@ Example of usage .. image:: https://user-images.githubusercontent.com/14288520/190918897-10e98029-4367-4f44-895d-cab694f9b6b6.png :target: https://user-images.githubusercontent.com/14288520/190918897-10e98029-4367-4f44-895d-cab694f9b6b6.png -* Modifier->Modifier Change-> :doc:`Delete Loose ` * CAD-> :doc:`Bevel ` -* Modifier->Modifier Change-> :doc:`Polygon to Edges ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` +* Modifiers->Modifier Change-> :doc:`Polygon to Edges ` * Beta Nodes-> :doc:`Extrude Separate Faces Light ` * Number-> :doc:`Random Num Gen ` * MUL X, Y: Number-> :doc:`Scalar Math ` diff --git a/docs/nodes/generators_extended/torus_knot_mk2.rst b/docs/nodes/generators_extended/torus_knot_mk2.rst index c95c4a2ba58e1d6043d6f9672a9294116b950a26..77965f41407133f9237270fbd4771f1679f97c2b 100644 --- a/docs/nodes/generators_extended/torus_knot_mk2.rst +++ b/docs/nodes/generators_extended/torus_knot_mk2.rst @@ -109,7 +109,7 @@ A set of extra parameters are available on the property panel. These parameters Notes: * **[1]** : Used only when the Adaptive Resolution is on -* **[2]** : Used without adaptive resolution these allow to create aliased torus knots resulting in all sorts of interesting shaped knots. +* **[2]** : Used without adaptive resolution these allow to create aliased torus knots resulting in all sorts of interesting shaped knots. See: https://github.com/nortikin/sverchok/issues/4746#issuecomment-1304820037 * **[3]** : Turn off normalization to save computation whenever the output vectors do not need to be normalized. Outputs diff --git a/docs/nodes/list_masks/mask_convert.rst b/docs/nodes/list_masks/mask_convert.rst index 65a0a8ecf85889ec76de0c2f3942e494a2a8e029..ad2618681354619bbe7bebdc22078afa55879bdc 100644 --- a/docs/nodes/list_masks/mask_convert.rst +++ b/docs/nodes/list_masks/mask_convert.rst @@ -61,7 +61,7 @@ Examples of usage * Number-> :doc:`List Input ` * Generator-> :doc:`Box ` -* Modifier->Modifier Change-> :doc:`Mask Vertices ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * Matrix-> :doc:`Matrix In ` * Viz-> :doc:`Viewer Draw ` * Viz-> :doc:`Viewer Index+ ` @@ -76,7 +76,7 @@ Examples of usage * Number-> :doc:`List Input ` * Generator-> :doc:`Box ` -* Modifier->Modifier Change-> :doc:`Extrude Region ` +* Modifiers->Modifier Change-> :doc:`Extrude Region ` * Matrix-> :doc:`Matrix In ` * Viz-> :doc:`Viewer Draw ` * Viz-> :doc:`Viewer Index+ ` @@ -104,11 +104,11 @@ Filter vertices and edges if some faces hided: :target: https://user-images.githubusercontent.com/14288520/188969070-a084e68a-a657-4106-b9bf-a538f218a16c.png * Generator-> :doc:`Box ` -* List->List Main-> :doc:`List Length ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` +* Number-> :doc:`Random Num Gen ` * List-> :doc:`List Mask (Out) ` +* List->List Main-> :doc:`List Length ` * Logic-> :doc:`Logic Functions (Not) ` -* Modifier->Modifier Change-> :doc:`Mask Vertices ` -* Number-> :doc:`Random Num Gen ` .. image:: https://user-images.githubusercontent.com/14288520/188969187-0dafea41-0015-4eda-ae8d-ae8384b7f060.gif :target: https://user-images.githubusercontent.com/14288520/188969187-0dafea41-0015-4eda-ae8d-ae8384b7f060.gif \ No newline at end of file diff --git a/docs/nodes/list_struct/repeater.rst b/docs/nodes/list_struct/repeater.rst index 1c7cce70bd1610d42f3800729e22e44c4d4bc6a3..31ad969e8cc083070cc2cd43160aa72aa86fe3ae 100644 --- a/docs/nodes/list_struct/repeater.rst +++ b/docs/nodes/list_struct/repeater.rst @@ -70,6 +70,6 @@ A practical reason to use the node is when you need a series of copies of edge o * Matrix-> :doc:`Matrix In ` * Transforms-> :doc:`Matrix Apply (verts) ` * List->List Main-> :doc:`List Length ` -* Modifier->Modifier Change :doc:`Mesh Join ` +* Modifiers->Modifier Change :doc:`Mesh Join ` * Text-> :doc:`Stethoscope ` * Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/logic/loop_in.rst b/docs/nodes/logic/loop_in.rst index 7de95a6dde0cc626d9b22a791624dc22bd1a98bc..aaced5a946cdca75ca9342de078c73e1a905d826 100644 --- a/docs/nodes/logic/loop_in.rst +++ b/docs/nodes/logic/loop_in.rst @@ -85,7 +85,7 @@ You can change the socket labels in the N-Panel * CAD-> :doc:`Inset Special ` * CA: Faces Area: Analyzers-> :doc:`Component Analyzer ` * CA: Faces Center: Analyzers-> :doc:`Component Analyzer ` -* Modifier->Modifier Change-> :doc:`Smooth Vertices ` +* Modifiers->Modifier Change-> :doc:`Smooth Vertices ` * Number-> :doc:`Random Num Gen ` * MUL X Number-> :doc:`Scalar Math ` * Vector-> :doc:`Vector Noise ` diff --git a/docs/nodes/matrix/apply_and_join.rst b/docs/nodes/matrix/apply_and_join.rst index 2a05f48cae1c14eb8035eeed9a75eff316c87c73..8709d23fc2da3a9ed0d34c9627ffa0cefd868704 100644 --- a/docs/nodes/matrix/apply_and_join.rst +++ b/docs/nodes/matrix/apply_and_join.rst @@ -60,7 +60,7 @@ In this mode and with numpy implementation mode you will get numpy output for ve See also -------- -* Modifier->Modifier Change-> :doc:`Mesh Join ` +* Modifiers->Modifier Change-> :doc:`Mesh Join ` Examples -------- diff --git a/docs/nodes/modifier_change/edge_split.rst b/docs/nodes/modifier_change/edge_split.rst index 1a2c2644ba3ac713c0b67c0ba3a0c997685230c5..03b68be8976e2d44d4f49b2faae7c285d9e5a420 100644 --- a/docs/nodes/modifier_change/edge_split.rst +++ b/docs/nodes/modifier_change/edge_split.rst @@ -62,14 +62,14 @@ This node has the following parameter: The default option is **Simple**. -.. image:: https://user-images.githubusercontent.com/14288520/200128715-5db73e69-f2a0-4c3b-bb95-289aeb38c82d.png - :target: https://user-images.githubusercontent.com/14288520/200128715-5db73e69-f2a0-4c3b-bb95-289aeb38c82d.png +.. image:: https://user-images.githubusercontent.com/14288520/201472654-55398ec8-d437-44be-8d77-1f023695b0e2.png + :target: https://user-images.githubusercontent.com/14288520/201472654-55398ec8-d437-44be-8d77-1f023695b0e2.png -.. image:: https://user-images.githubusercontent.com/14288520/200128842-f5f37c89-7fb2-4227-bf58-696eaf52e649.png - :target: https://user-images.githubusercontent.com/14288520/200128842-f5f37c89-7fb2-4227-bf58-696eaf52e649.png +.. image:: https://user-images.githubusercontent.com/14288520/201472763-44e8782e-50ae-4b0b-9aa4-7c75e1bcfab6.png + :target: https://user-images.githubusercontent.com/14288520/201472763-44e8782e-50ae-4b0b-9aa4-7c75e1bcfab6.png -.. image:: https://user-images.githubusercontent.com/14288520/200128962-59ed9fb4-09b4-4f98-b76e-0109f3f21afb.png - :target: https://user-images.githubusercontent.com/14288520/200128962-59ed9fb4-09b4-4f98-b76e-0109f3f21afb.png +.. image:: https://user-images.githubusercontent.com/14288520/201472839-2662621f-f2d6-4fb5-aa04-d48108d30e2c.png + :target: https://user-images.githubusercontent.com/14288520/201472839-2662621f-f2d6-4fb5-aa04-d48108d30e2c.png Outputs ------- diff --git a/docs/nodes/modifier_change/edgenet_to_paths.rst b/docs/nodes/modifier_change/edgenet_to_paths.rst index 39341735cb682eba5b4ef6097969efba4b120f80..b006456d8f879900a1d1d2f7f30b1f51ebd1aff2 100644 --- a/docs/nodes/modifier_change/edgenet_to_paths.rst +++ b/docs/nodes/modifier_change/edgenet_to_paths.rst @@ -42,7 +42,7 @@ Examples of usage :target: https://user-images.githubusercontent.com/14288520/199548730-05e2c86a-4b2e-447e-b75e-cf7999f485dc.png * Generator->Generator Extended-> :doc:`Polygon Grid ` -* Modifier->Modifier Change-> :doc:`Mask Vertices ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * Number-> :doc:`List Input ` * Number-> :doc:`Random Num Gen ` * Number-> :doc:`Number Range ` diff --git a/docs/nodes/modifier_change/extrude_region.rst b/docs/nodes/modifier_change/extrude_region.rst index 59bcff884c94fc512e24dd36d701ab80e79fd887..39712c0457235880a433dbdd42f05893b2228370 100644 --- a/docs/nodes/modifier_change/extrude_region.rst +++ b/docs/nodes/modifier_change/extrude_region.rst @@ -180,7 +180,7 @@ replay with new nodes: * Number-> :doc:`Map Range ` * List->List Main-> :doc:`List Math ` * Color-> :doc:`Color In ` -* Modifier->Modifier Change-> :doc:`Extrude Separate Faces ` +* Modifiers->Modifier Change-> :doc:`Extrude Separate Faces ` * Viz-> :doc:`Viewer Draw ` * BPY Date-> Vertex Color MK3 (No docs) diff --git a/docs/nodes/modifier_change/inset_faces.rst b/docs/nodes/modifier_change/inset_faces.rst index e8caff2b4cc430e60cb6a40187914f9f0d65e80c..58228f7470d9a0678844cfdb9443d4d1ac3d0d3d 100644 --- a/docs/nodes/modifier_change/inset_faces.rst +++ b/docs/nodes/modifier_change/inset_faces.rst @@ -52,8 +52,8 @@ Parameters | Individual / Region | switch | Switch between to modes | +--------------------------+--------+--------------------------------------------------------------------------------+ -.. image:: https://user-images.githubusercontent.com/14288520/198690674-3f61a1eb-686d-42ea-b573-d77852221cde.png - :target: https://user-images.githubusercontent.com/14288520/198690674-3f61a1eb-686d-42ea-b573-d77852221cde.png +.. image:: https://user-images.githubusercontent.com/14288520/201482623-51d72d35-db63-4d5d-8a65-52e102249d2c.png + :target: https://user-images.githubusercontent.com/14288520/201482623-51d72d35-db63-4d5d-8a65-52e102249d2c.png N panel ------- diff --git a/docs/nodes/modifier_change/merge_by_distance.rst b/docs/nodes/modifier_change/merge_by_distance.rst index cb7cf20e06dd1e85c38b0d31884284bbabd94927..a3f4a3e3e4c7bf77ff25b592b1f0900eef7b5d1b 100644 --- a/docs/nodes/modifier_change/merge_by_distance.rst +++ b/docs/nodes/modifier_change/merge_by_distance.rst @@ -79,7 +79,7 @@ Examples of usage * Generator-> :doc:`Torus ` * Analyzers-> :doc:`Select Mesh Elements ` * Analyzers-> :doc:`Proportional Edit Falloff ` -* Modifier->Modifier Change-> :doc:`Smooth Vertices ` +* Modifiers->Modifier Change-> :doc:`Smooth Vertices ` * Number-> :doc:`A Number ` * Vector-> :doc:`Vector Lerp ` * Vector-> :doc:`Vector Polar Input ` diff --git a/docs/nodes/modifier_change/mesh_separate.rst b/docs/nodes/modifier_change/mesh_separate.rst index 2dcc68355ae6fa895e478ee659e961a402bae1f0..be9a10ea56cb03a1e099378172f441ac5b10dfc7 100644 --- a/docs/nodes/modifier_change/mesh_separate.rst +++ b/docs/nodes/modifier_change/mesh_separate.rst @@ -37,7 +37,7 @@ Examples * Generator-> :doc:`Line ` * Generator-> :doc:`Plane ` * List->List Main-> :doc:`List Join ` -* Modifier->Modifier Change-> :doc:`Mesh Join ` +* Modifiers->Modifier Change-> :doc:`Mesh Join ` * Viz-> :doc:`Viewer Draw ` --------- @@ -47,10 +47,10 @@ Examples * Generator-> :doc:`Cylinder ` * Analyzers-> :doc:`Select Mesh Elements ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * List-> :doc:`List Mask (Out) ` -* NOT: Logic-> :doc:`Logic Functions ` -* Modifier->Modifier Change-> :doc:`Mask Vertices ` * List->List Main-> :doc:`List Decompose ` +* NOT: Logic-> :doc:`Logic Functions ` * Viz-> :doc:`Viewer Draw ` Notes diff --git a/docs/nodes/modifier_change/objects_along_edge.rst b/docs/nodes/modifier_change/objects_along_edge.rst index 10d97e8e7b322526594abf195732c03631286881..0093e27097db66e6094851719521ac47e429730b 100644 --- a/docs/nodes/modifier_change/objects_along_edge.rst +++ b/docs/nodes/modifier_change/objects_along_edge.rst @@ -1,6 +1,9 @@ Duplicate Objects Along Edge ============================ +.. image:: https://user-images.githubusercontent.com/14288520/201220460-0bd7d0b2-dcf7-4c93-91b5-a928d266b9ef.png + :target: https://user-images.githubusercontent.com/14288520/201220460-0bd7d0b2-dcf7-4c93-91b5-a928d266b9ef.png + Functionality ------------- @@ -25,6 +28,9 @@ donor object to be aligned along recipient edge. By default, this node already applies that matrices to donor object; but you can turn this off, and apply matrices to donor object in another node, or apply them to different objects. +.. image:: https://user-images.githubusercontent.com/14288520/201313387-af1ecff3-b4c1-46df-8e14-2f2a5128df58.png + :target: https://user-images.githubusercontent.com/14288520/201313387-af1ecff3-b4c1-46df-8e14-2f2a5128df58.png + Inputs ------ @@ -34,80 +40,138 @@ This node has the following inputs: this input is not connected. - **Edges**. Edges of the donor mesh. - **Polygons**. Faces of the donor mesh. + +.. image:: https://user-images.githubusercontent.com/14288520/201330888-49b42b2e-fd4f-49a3-91d5-6c08863a9bd6.png + :target: https://user-images.githubusercontent.com/14288520/201330888-49b42b2e-fd4f-49a3-91d5-6c08863a9bd6.png + - **Vertex1**. First vertex of recipient edge. This input is used only when "Fixed" input mode is used (see description of ``Input mode`` parameter below). - **Vertex2**. Second vertex of recipient edge. This input is used only when "Fixed" input mode is used. + +.. image:: https://user-images.githubusercontent.com/14288520/201330149-7ccb866a-38be-4f61-87d9-18df92ccac3d.png + :target: https://user-images.githubusercontent.com/14288520/201330149-7ccb866a-38be-4f61-87d9-18df92ccac3d.png + - **VerticesR**. Vertices of the recipient mesh. This input is used only when "Edges" input mode is used. - **EdgesR**. Edges of the recipient mesh. These edges will be actually used as recipient edges. This input is used only when "Edges" input mode is used. + +.. image:: https://user-images.githubusercontent.com/14288520/201318700-6bed15f8-471a-41a1-820f-92c37bcd9630.png + :target: https://user-images.githubusercontent.com/14288520/201318700-6bed15f8-471a-41a1-820f-92c37bcd9630.png + - **Count**. Number of objects in array. This input is used only in "Count" - scaling mode (see description of ``Scale mode`` parameter below). + scaling mode (see description of ``Scale mode`` parameter below). Number-> :doc:`List Input ` allowed to connect to count socket. + +.. image:: https://user-images.githubusercontent.com/14288520/201315561-08dcae28-9277-44c0-8763-ed3260406482.png + :target: https://user-images.githubusercontent.com/14288520/201315561-08dcae28-9277-44c0-8763-ed3260406482.png + +.. image:: https://user-images.githubusercontent.com/14288520/201333288-53c3d8db-5822-47e7-875f-8e71e4c364f6.png + :target: https://user-images.githubusercontent.com/14288520/201333288-53c3d8db-5822-47e7-875f-8e71e4c364f6.png + - **Padding**. Portion of the recipient edge length that should be left empty from both sides. Default value of zero means fill whole available length. +.. image:: https://user-images.githubusercontent.com/14288520/201314412-8f420136-b4a3-4ca6-9431-7b441d3f0cfc.png + :target: https://user-images.githubusercontent.com/14288520/201314412-8f420136-b4a3-4ca6-9431-7b441d3f0cfc.png + Parameters ---------- This node has the following parameters: -+------------------+----------------+-------------+------------------------------------------------------------------+ -| Parameter | Type | Default | Description | -+==================+================+=============+==================================================================+ -| **Scaling mode** | Count or Up | Count | * Count: specify number of objects in array. Objects scale will | -| | | | be calculated so that copies will fill length of recipient | -| | | | edge. | -| | or Down or | | * Up: count is determined automatically from length of recipient | -| | | | edge and size of donor mesh, and meshes are scaled only up | -| | | | (for example, if donor mesh is 1 unit long, and recipient edge | -| | | | is 3.6 units, then there will be 3 meshes scaled to be 1.2 | -| | | | units long each). | -| | Off | | * Down: the same as Up, but meshes are scaled only down. | -| | | | * Off: the same as Up, but meshes are not scaled, so there will | -| | | | be some empty space between copies. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Orientation** | X or Y or Z | X | Which axis of donor object should be aligned to direction of the | -| | | | recipient edge. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Algorithm** | Householder | Householder | * Householder: calculate rotation by using Householder's | -| | | | reflection matrix (see Wikipedia_ article). | -| | or Tracking | | * Tracking: use the same algorithm as in Blender's "TrackTo" | -| | | | kinematic constraint. This algorithm gives you a bit more | -| | | | flexibility comparing to other, by allowing to select the Up | -| | | | axis. | -| | or Rotation | | * Rotation difference: calculate rotation as rotation difference | -| | Difference | | between two vertices. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Up axis** | X or Y or Z | Z | Axis of donor object that should point up in result. This | -| | | | parameter is available only when Tracking algorithm is selected. | -| | | | Value of this parameter must differ from **Orientation** | -| | | | parameter, otherwise you will get an error. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Input mode** | Edges or Fixed | Edges | * Edges: recipient edges will be determined as all edges from | -| | | | the ``EdgesR`` input between vertices from ``VerticesR`` | -| | | | input. | -| | | | * Fixed: recipient edge will be determied as an edge between the | -| | | | edge from ``Vertex1`` input and the vertex from ``Vertex2`` | -| | | | input. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Scale all | Bool | False | If False, then donor object will be scaled only along axis | -| axes** | | | is aligned with recipient edge direction. If True, objects will | -| | | | be scaled along all axes (by the same factor). | -| | | | This parameter is available only in the N panel. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Apply | Bool | True | Whether to apply calculated matrices to created objects. | -| matrces** | | | This parameter is available only in the N panel. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Count** | Int | 3 | Number of objects in array. This parameter can be determined | -| | | | from the corresponding input. It is used only in "Count" scaling | -| | | | mode. | -+------------------+----------------+-------------+------------------------------------------------------------------+ -| **Padding** | Float | 0.0 | Portion of the recipient edge length that should be left empty | -| | | | from both sides. Default value of zero means fill whole length | -| | | | available. Maximum value 0.49 means use only central 1% of edge. | -+------------------+----------------+-------------+------------------------------------------------------------------+ ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| Parameter | Type | Default | Description | ++==================+================+=============+====================================================================+ +| **Scaling** | Count | Count | **Count**: specify number of objects in array. Objects scale | +| | | | | +| **mode** | Up | | will be calculated so that copies will fill length of | +| | | | | +| | | | recipient edge. | +| | | | | +| | Down | | **Up**: count is determined automatically from length of | +| | | | | +| | | | recipient edge and size of donor mesh, and meshes are | +| | | | | +| | | | scaled only up (for example, if donor mesh is 1 unit long, | +| | | | | +| | | | and recipient edge is 3.6 units, then there will be 3 | +| | | | | +| | | | meshes scaled to be 1.2 units long each). | +| | | | | +| | Off | | **Down**: the same as Up, but meshes are scaled only down. | +| | | | | +| | | | **Off**: the same as Up, but meshes are not scaled, so there | +| | | | | +| | | | will be some empty space between copies. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Orientation** | X / Y / Z | X | Which axis of donor object should be aligned to direction | +| | | | | +| | | | of the recipient edge. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Algorithm** | Householder | House | **Householder**: calculate rotation by using Householder's | +| | | | | +| | | holder | reflection matrix (see Wikipedia_ article). | +| | | | | +| | or Tracking | | **Tracking**: use the same algorithm as in Blender's "TrackTo" | +| | | | | +| | | | kinematic constraint. This algorithm gives you a bit more | +| | | | | +| | | | flexibility comparing to other, by allowing to select the Up | +| | | | | +| | | | axis. | +| | | | | +| | or Rotation | | **Rotation difference**: calculate rotation as rotation | +| | | | | +| | Difference | | difference between two vertices. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Up axis** | X / Y / Z | Z | Axis of donor object that should point up in result. This | +| | | | | +| | | | parameter is available only when Tracking algorithm is | +| | | | | +| | | | selected. Value of this parameter must differ from | +| | | | | +| | | | **Orientation** parameter, otherwise you will get an error. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Input** | Edges | Edges | **Edges**: recipient edges will be determined as all edges | +| | | | | +| **mode** | or | | from the ``EdgesR`` input between vertices from | +| | | | | +| | Fixed | | ``VerticesR`` input. | +| | | | | +| | | | **Fixed**: recipient edge will be determied as an edge | +| | | | | +| | | | between the edge from ``Vertex1`` input and the vertex | +| | | | | +| | | | from ``Vertex2`` input. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Scale all** | Bool | False | If False, then donor object will be scaled only along axis | +| | | | | +| **axes** | | | is aligned with recipient edge direction. If True, objects | +| | | | | +| | | | will be scaled along all axes (by the same factor). | +| | | | | +| | | | This parameter is available only in the N panel. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Apply** | Bool | True | Whether to apply calculated matrices to created objects. | +| | | | | +| **matrices** | | | This parameter is available only in the N panel. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Count** | Int | 3 | Number of objects in array. This parameter can be | +| | | | | +| | | | determined from the corresponding input. It is used only | +| | | | | +| | | | in "Count" scaling mode. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ +| **Padding** | Float | 0.0 | Portion of the recipient edge length that should be | +| | | | | +| | | | left empty from both sides. Default value of zero means | +| | | | | +| | | | fill whole length available. Maximum value 0.49 means | +| | | | | +| | | | use only central 1% of edge. | ++------------------+----------------+-------------+--------------------------------------------------------------------+ .. _Wikipedia: https://en.wikipedia.org/wiki/QR_decomposition#Using_Householder_reflections @@ -123,26 +187,61 @@ This node has the following outputs: them along recipient edge. By default, this node already applies these matrices, so you do not need to do it second time. +.. image:: https://user-images.githubusercontent.com/14288520/201331535-cab0d823-8dac-42bf-bbe3-de480356612a.png + :target: https://user-images.githubusercontent.com/14288520/201331535-cab0d823-8dac-42bf-bbe3-de480356612a.png + This node will output something only when ``Vertices`` or ``Matrices`` output is connected. Examples of usage ----------------- -Cylinders duplicated along the segment between two specified points: +.. image:: https://user-images.githubusercontent.com/14288520/201381243-2d7a2132-2473-49cf-abfa-b4a7070b861d.png + :target: https://user-images.githubusercontent.com/14288520/201381243-2d7a2132-2473-49cf-abfa-b4a7070b861d.png + +* Generator-> :doc:`Suzanne ` +* Generator->Generators Extended :doc:`Torus Knot ` +* Number-> :doc:`Number Range ` +* List->List Struct-> :doc:`List Length ` +* Color-> :doc:`Color Ramp ` +* Viz-> :doc:`Viewer Draw ` +* Text-> :doc:`Stethoscope ` + +--------- -.. image:: https://user-images.githubusercontent.com/284644/33512207-00a41ef2-d74d-11e7-9ce2-e8f21b6342c8.png +Suzanne duplicated along the segment between two specified points: + +.. image:: https://user-images.githubusercontent.com/14288520/201382773-7fdb06b4-8361-442f-bbda-d61ad9da9dff.png + :target: https://user-images.githubusercontent.com/14288520/201382773-7fdb06b4-8361-442f-bbda-d61ad9da9dff.png + +* Generator-> :doc:`Suzanne ` +* Generator-> :doc:`Segment ` +* Viz-> :doc:`Viewer Draw ` + +--------- Suzannes duplicated along the edges of Box: -.. image:: https://user-images.githubusercontent.com/284644/33512211-066ab80a-d74d-11e7-9907-3c2cf7c4894e.png +.. image:: https://user-images.githubusercontent.com/14288520/201384581-6f1bcd4a-ff14-4aaa-bf02-459b090e2d6c.png + :target: https://user-images.githubusercontent.com/14288520/201384581-6f1bcd4a-ff14-4aaa-bf02-459b090e2d6c.png + +* Generator-> :doc:`Box ` +* Generator-> :doc:`Suzanne ` +* Viz-> :doc:`Viewer Draw ` + +--------- -Complex object duplicated along circle, with Householder algorithm: +Complex object duplicated along circle: -.. image:: https://user-images.githubusercontent.com/284644/33388133-e9a1c4b4-d550-11e7-9df2-e5c7899d6ca1.png +.. image:: https://user-images.githubusercontent.com/14288520/201387261-bad089f0-ea89-4d96-b895-00555ed3458c.png + :target: https://user-images.githubusercontent.com/14288520/201387261-bad089f0-ea89-4d96-b895-00555ed3458c.png -The same setup, but with Tracking algorithm: +* Generator-> :doc:`Box ` +* Generator->Generators Extended :doc:`Torus Knot ` +* Number-> :doc:`List Input ` +* List->List Struct-> :doc:`List Length ` +* List-> :doc:`Index To Mask ` +* Viz-> :doc:`Viewer Draw ` -.. image:: https://user-images.githubusercontent.com/284644/33388143-f1740dbe-d550-11e7-8d05-82cc8fa95934.png You can also find more examples and some discussion `in the development thread `_. diff --git a/docs/nodes/modifier_change/opensubdivision.rst b/docs/nodes/modifier_change/opensubdivision.rst index 58386187ee220e4114af44b8f045b27e80046e64..e7ce5164f2004c84a61858c7ce9f00ac2f1cf030 100644 --- a/docs/nodes/modifier_change/opensubdivision.rst +++ b/docs/nodes/modifier_change/opensubdivision.rst @@ -1,11 +1,17 @@ Catmull-Clark Subdivision Node ============================== +.. image:: https://user-images.githubusercontent.com/14288520/200193808-718aef11-b7cf-4684-a0c7-b0139f4f4e95.png + :target: https://user-images.githubusercontent.com/14288520/200193808-718aef11-b7cf-4684-a0c7-b0139f4f4e95.png + Functionality ------------- This node applies [Catmull-Clark subdivision](https://en.wikipedia.org/wiki/Catmull%E2%80%93Clark_subdivision_surface) (as implemented by the [OpenSubdiv](https://github.com/PixarAnimationStudios/OpenSubdiv)) to the input mesh at the specified number of levels. +.. image:: https://user-images.githubusercontent.com/14288520/200194195-da41fd97-423b-4d5b-bef0-f752665201be.png + :target: https://user-images.githubusercontent.com/14288520/200194195-da41fd97-423b-4d5b-bef0-f752665201be.png + Inputs ------ @@ -21,6 +27,9 @@ This node has the following parameters: - **Levels**. Maximum subdivision level to be applied to input mesh. +.. image:: https://user-images.githubusercontent.com/14288520/200194321-70f2da21-691d-4293-8965-6d16d1fd402e.png + :target: https://user-images.githubusercontent.com/14288520/200194321-70f2da21-691d-4293-8965-6d16d1fd402e.png + Outputs ------- @@ -37,16 +46,88 @@ Unexpected behavior may occur if using Faces from one mesh with Vertices from an Examples of usage ----------------- (Old) + .. image:: https://user-images.githubusercontent.com/79929629/180858417-dc585075-486a-443b-a618-ae04e281cd90.png + :target: https://user-images.githubusercontent.com/79929629/180858417-dc585075-486a-443b-a618-ae04e281cd90.png + +* Generator-> :doc:`Box ` +* Number-> :doc:`Number Range ` +* MUL: Number-> :doc:`Scalar Math ` +* Vector-> :doc:`Vector In ` +* Matrix-> :doc:`Matrix In ` +* Matrix Multiply: Matrix-> :doc:`Matrix Math ` +* Matrix Apply: Matrix-> :doc:`Matrix Apply to Mesh ` +* Viz-> :doc:`Viewer Draw ` + +--------- (Old) + .. image:: https://user-images.githubusercontent.com/79929629/180858569-40b684c8-bdc7-4690-9e74-f0733dd21210.png + :target: https://user-images.githubusercontent.com/79929629/180858569-40b684c8-bdc7-4690-9e74-f0733dd21210.png + +* Generator-> :doc:`Box ` +* Number-> :doc:`A Number ` +* Number-> :doc:`Number Range ` +* Transform-> :doc:`Randomize ` +* MUL: Number-> :doc:`Scalar Math ` +* Vector-> :doc:`Vector In ` +* Matrix-> :doc:`Matrix In ` +* Matrix Apply: Matrix-> :doc:`Matrix Apply to Mesh ` +* Viz-> :doc:`Viewer Draw ` + +--------- + +Vector Test: + +.. image:: https://user-images.githubusercontent.com/14288520/200194455-5b73d35f-12ff-45d7-b486-5fe2505adc11.png + :target: https://user-images.githubusercontent.com/14288520/200194455-5b73d35f-12ff-45d7-b486-5fe2505adc11.png + +* Generator-> :doc:`Box ` +* Number-> :doc:`A Number ` +* MUL: Number-> :doc:`Scalar Math ` +* Vector-> :doc:`Vector In ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +--------- + +Many Bodies: + +.. image:: https://user-images.githubusercontent.com/14288520/200195224-cecce757-8b4f-4e18-ba75-4597a88c1916.png + :target: https://user-images.githubusercontent.com/14288520/200195224-cecce757-8b4f-4e18-ba75-4597a88c1916.png + +* Generator-> :doc:`Box ` +* Number-> :doc:`A Number ` +* MUL, DIV: Number-> :doc:`Scalar Math ` +* Vector-> :doc:`Vector In ` +* Matrix-> :doc:`Matrix In ` +* List->List Struct-> :doc:`List Length ` +* Color-> :doc:`Color In ` +* Color-> :doc:`Color Ramp ` +* Viz-> :doc:`Viewer Draw ` + +--------- + +Level 0 Catmul-Clark Subdivision of NGons: + +.. image:: https://user-images.githubusercontent.com/14288520/200195960-49322096-3aad-4138-baac-398b185c63eb.png + :target: https://user-images.githubusercontent.com/14288520/200195960-49322096-3aad-4138-baac-398b185c63eb.png +* Generator-> :doc:`Box ` +* MUL, ADD: Number-> :doc:`Scalar Math ` +* Vector-> :doc:`Vector In ` +* Matrix-> :doc:`Matrix In ` +* Matrix-> :doc:`Matrix Apply to Mesh ` +* Viz-> :doc:`Viewer Draw ` -.. image:: https://raw.githubusercontent.com/GeneralPancakeMSTR/pyOpenSubdivision/main/attachments/README/sverchok_OSD_vector_test.png +--------- -.. image:: https://raw.githubusercontent.com/GeneralPancakeMSTR/pyOpenSubdivision/main/attachments/README/sverchok_OSD_many_bodies.png +Node Mute: -.. image:: https://raw.githubusercontent.com/GeneralPancakeMSTR/pyOpenSubdivision/main/attachments/README/sverchok_OSD_level0_ngons.png +.. image:: https://user-images.githubusercontent.com/14288520/200196279-c757b430-4bc8-4820-8ee4-7514c6f6712a.png + :target: https://user-images.githubusercontent.com/14288520/200196279-c757b430-4bc8-4820-8ee4-7514c6f6712a.png -.. image:: https://raw.githubusercontent.com/GeneralPancakeMSTR/pyOpenSubdivision/main/attachments/README/sverchok_OSD_node_mute.png +* Generator-> :doc:`Box ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_change/polygons_to_edges_mk2.rst b/docs/nodes/modifier_change/polygons_to_edges_mk2.rst index 172fc5153d0be9ccbb0e22d46860cd9deab819b8..8f58139e0ac64b8e81ad3bd0de83ccc515448fa4 100644 --- a/docs/nodes/modifier_change/polygons_to_edges_mk2.rst +++ b/docs/nodes/modifier_change/polygons_to_edges_mk2.rst @@ -36,8 +36,8 @@ In the N-Panel (and on the right-click menu) you can find: Examples -------- -.. image:: https://user-images.githubusercontent.com/14288520/200010424-48acc8ef-1522-471f-9b2d-cd7009e8bb49.png - :target: https://user-images.githubusercontent.com/14288520/200010424-48acc8ef-1522-471f-9b2d-cd7009e8bb49.png +.. image:: https://user-images.githubusercontent.com/14288520/201473890-64aad2fc-bae9-4dc8-a792-70530a34f444.png + :target: https://user-images.githubusercontent.com/14288520/201473890-64aad2fc-bae9-4dc8-a792-70530a34f444.png * Generator-> :doc:`Box ` * CAD-> :doc:`Inset Special ` diff --git a/docs/nodes/modifier_change/split_faces.rst b/docs/nodes/modifier_change/split_faces.rst index a78501bc2d938c9cf64b36169d120ed13fd683d9..a37ac49f6c5d62bb8ecd5403d2e08425aaee442f 100644 --- a/docs/nodes/modifier_change/split_faces.rst +++ b/docs/nodes/modifier_change/split_faces.rst @@ -61,7 +61,7 @@ This node has the following outputs: See also -------- -* Modifier->Modifier Change-> :doc:`Triangulate Mesh ` +* Modifiers->Modifier Change-> :doc:`Triangulate Mesh ` Examples of usage ----------------- diff --git a/docs/nodes/modifier_change/subdivide_mk2.rst b/docs/nodes/modifier_change/subdivide_mk2.rst index 22fa6ee4ff525b6635964d5bf9932e9dcb838c5e..5af7ddb75ca3b4b105f3e608f441acc1907ae695 100644 --- a/docs/nodes/modifier_change/subdivide_mk2.rst +++ b/docs/nodes/modifier_change/subdivide_mk2.rst @@ -1,10 +1,21 @@ Subdivide ========= +.. image:: https://user-images.githubusercontent.com/14288520/200410871-b8a74be8-67a1-42e2-b325-c11ef8265324.png + :target: https://user-images.githubusercontent.com/14288520/200410871-b8a74be8-67a1-42e2-b325-c11ef8265324.png + Functionality ------------- -This node applies Blender's Subdivide operation to the input mesh. Please note that of options available differs from usual editing operator. +This node applies Blender's Subdivide operation to the input mesh. + +.. image:: https://user-images.githubusercontent.com/14288520/200410895-0fc85b34-903f-474f-9dac-5576005c3be2.png + :target: https://user-images.githubusercontent.com/14288520/200410895-0fc85b34-903f-474f-9dac-5576005c3be2.png + +Please note that of options available differs from usual editing operator. + +.. image:: https://user-images.githubusercontent.com/14288520/200531018-022c07da-27dc-4c69-acbc-b3e6bc978aac.png + :target: https://user-images.githubusercontent.com/14288520/200531018-022c07da-27dc-4c69-acbc-b3e6bc978aac.png Inputs ------ @@ -18,11 +29,11 @@ This node has the following inputs: mesh. For example, this may be used to provide material indexes of input mesh faces. Optional input. - **EdgeMask**. Selected edges to be subdivided. Faces surrounded by subdivided edges can optionally be subdivided too. -- **Number of Cuts** -- **Smooth** -- **Fractal** -- **Along normal** -- **Seed** +- **Number of Cuts**. Number of cuts per edge to make +- **Smooth**. Displaces subdivisions to maintain approximate curvature +- **Fractal**. Displaces the vertices in random directions after the mesh is subdivided +- **Along normal**. Causes the vertices to move along the their normals, instead of random directions +- **Seed**. Random seed Parameters ---------- @@ -33,12 +44,13 @@ This node has the following parameters: - **Show New**. If checked, then outputs with newly created geometry will be shown. By default not checked. - **Show Options**. If checked, then following parameters will be shown on the node itself. Otherwise, they will be available only in the N panel. By default not checked. - **Falloff**. Smooth falloff type. Please refer to examples below for demonstration. -- **Corner cut type**. This controls the way quads with only two adjacent selected edges are subdivided. Available values are: +- **Corner cut type**. This controls the way quads with only two adjacent selected edges are subdivided (see Blender docs https://docs.blender.org/manual/en/latest/modeling/meshes/editing/edge/subdivide.html ). Available values are: + + - **Inner vertices**. The selected edges are subdivided, then an edge is created between the two new vertices, creating a small triangle. This edge is also subdivided, and the “inner vertex” thus created is linked by another edge to the one opposite to the original selected edges. All this results in a quad subdivided in a triangle and two quads + - **Path**. First an edge is created between the two opposite ends of the selected edges, dividing the quad in two triangles. Then, the same goes for the involved triangle as described above + - **Fan**. The quad is subdivided in a fan of four triangles, the common vertex being the one opposite to the selected edges. + - **Straight Cut**. The selected edges are subdivided, then an edge is created between the two new vertices, creating a small triangle and n-gon - - **Inner vertices** - - **Path** - - **Fan** - - **Straight Cut** - **Grid fill**. If checked, then fully-selected faces will be filled with a grid (subdivided). Otherwise, only edges will be subdivided, not faces. Checked by default. - **Only Quads**. If checked, then only quad faces will be subdivided, other will not. By default not checked. - **Single edge**. If checked, tessellate the case of one edge selected in a quad or triangle. By default not checked. @@ -49,6 +61,35 @@ This node has the following parameters: - **Along normal**. If set to 1, causes the vertices to move along the their normals, instead of random directions. Values between 0 and 1 lead to intermediate results. This parameter can be also provided as input. - **Seed**. Random seed. This parameter can be also provided as input. +* **Smooth Falloff**: + +.. image:: https://user-images.githubusercontent.com/14288520/200430940-5b98cb7f-f150-4d4b-af7d-1611395b6746.png + :target: https://user-images.githubusercontent.com/14288520/200430940-5b98cb7f-f150-4d4b-af7d-1611395b6746.png + +* **Corner Type** (red color - selected edges): + +.. image:: https://user-images.githubusercontent.com/14288520/200433213-506ae4fa-d1ee-40dc-ab82-fafc0f7083d4.gif + :target: https://user-images.githubusercontent.com/14288520/200433213-506ae4fa-d1ee-40dc-ab82-fafc0f7083d4.gif + +* **Options**: + +.. image:: https://user-images.githubusercontent.com/14288520/200429430-f89ef07a-cbd6-4320-9647-96429eed4043.png + :target: https://user-images.githubusercontent.com/14288520/200429430-f89ef07a-cbd6-4320-9647-96429eed4043.png + +* **Options/ Even Smooth**: + +.. image:: https://user-images.githubusercontent.com/14288520/200432453-57adb7d4-5c7d-4f03-b14d-8b5d27e1cb40.gif + :target: https://user-images.githubusercontent.com/14288520/200432453-57adb7d4-5c7d-4f03-b14d-8b5d27e1cb40.gif + +* **Smooth**: + +.. image:: https://user-images.githubusercontent.com/14288520/200430007-b3cf9622-650e-4b49-8d7a-ef4a96d4c478.png + :target: https://user-images.githubusercontent.com/14288520/200430007-b3cf9622-650e-4b49-8d7a-ef4a96d4c478.png + +* **Fractal, Along Normal**: + +.. image:: https://user-images.githubusercontent.com/14288520/200431682-b58f900b-0aad-4323-973f-b6ee40c42f17.png + :target: https://user-images.githubusercontent.com/14288520/200431682-b58f900b-0aad-4323-973f-b6ee40c42f17.png Advanced parameters ------------------- @@ -76,21 +117,41 @@ This node has the following outputs: **Note**: Indicies in **NewEdges**, **NewFaces**, **OldEdges**, **OldFaces** outputs relate to vertices in **Vertices** output. +.. image:: https://user-images.githubusercontent.com/14288520/200675164-539055af-62a4-4faf-9c54-6756b42144e2.png + :target: https://user-images.githubusercontent.com/14288520/200675164-539055af-62a4-4faf-9c54-6756b42144e2.png + Examples of usage ----------------- The simplest example, subdivide a cube: -.. image:: https://cloud.githubusercontent.com/assets/284644/25096716/476682dc-23c3-11e7-8788-624be2573d3b.png +.. image:: https://user-images.githubusercontent.com/14288520/200676196-fee3e1da-6bfe-4751-96dc-45e72be95680.png + :target: https://user-images.githubusercontent.com/14288520/200676196-fee3e1da-6bfe-4751-96dc-45e72be95680.png + +* Generator-> :doc:`Box ` +* Viz-> :doc:`Viewer Draw ` Subdivide one face of a cube, with smoothing: -.. image:: https://cloud.githubusercontent.com/assets/284644/25096718/47976654-23c3-11e7-8da8-87ea420d8355.png +.. image:: https://user-images.githubusercontent.com/14288520/200689133-d01920a5-b01e-4b9f-bd75-de5350b7ae0b.png + :target: https://user-images.githubusercontent.com/14288520/200689133-d01920a5-b01e-4b9f-bd75-de5350b7ae0b.png + +* Generator-> :doc:`Box ` +* Analyzers-> :ref:`Select Mesh Elements (By normal and direction)` +* Viz-> :doc:`Viewer Draw ` Subdivide a cube, with smooth falloff type = Smooth: -.. image:: https://cloud.githubusercontent.com/assets/284644/25096717/4794fed2-23c3-11e7-8c53-28fb1d18b69d.png +.. image:: https://user-images.githubusercontent.com/14288520/200689719-998f9cf7-efcb-4a38-93a7-a4228a466b18.png + :target: https://user-images.githubusercontent.com/14288520/200689719-998f9cf7-efcb-4a38-93a7-a4228a466b18.png + +* Generator-> :doc:`Box ` +* Viz-> :doc:`Viewer Draw ` Subdivide a torus, with smooth falloff type = Sphere: -.. image:: https://cloud.githubusercontent.com/assets/284644/25096721/479a2c72-23c3-11e7-9012-612ce3fd1039.png +.. image:: https://user-images.githubusercontent.com/14288520/200691209-82cced0a-5977-46bf-aa2a-0646ebb08bf6.png + :target: https://user-images.githubusercontent.com/14288520/200691209-82cced0a-5977-46bf-aa2a-0646ebb08bf6.png + +* Generator-> :doc:`Torus ` +* Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/modifier_change/subdivide_to_quads.rst b/docs/nodes/modifier_change/subdivide_to_quads.rst index 53188825bf8709ea93fb43e0df904b47907b197b..c0f9873ccd451d4f9f5c7723cbb2ed3286c7c50e 100644 --- a/docs/nodes/modifier_change/subdivide_to_quads.rst +++ b/docs/nodes/modifier_change/subdivide_to_quads.rst @@ -1,11 +1,17 @@ Subdivide to Quads ================== +.. image:: https://user-images.githubusercontent.com/14288520/200833247-ddbf8af4-f07c-4875-b83b-213a39039cb1.png + :target: https://user-images.githubusercontent.com/14288520/200833247-ddbf8af4-f07c-4875-b83b-213a39039cb1.png + Functionality ------------- Subdivide polygon faces to quads, similar to subdivision surface modifier. +.. image:: https://user-images.githubusercontent.com/14288520/200833257-e495d5c0-d487-4576-a8a9-85c36a35b273.png + :target: https://user-images.githubusercontent.com/14288520/200833257-e495d5c0-d487-4576-a8a9-85c36a35b273.png + Inputs ------ @@ -57,16 +63,54 @@ Examples of usage Use of Vert Map output: -.. image:: https://user-images.githubusercontent.com/10011941/116822057-19614980-ab7d-11eb-8e97-4b2b3c453656.png +.. image:: https://user-images.githubusercontent.com/14288520/200837135-49f33107-a43b-4f22-9e65-e1c0006853e1.png + :target: https://user-images.githubusercontent.com/14288520/200837135-49f33107-a43b-4f22-9e65-e1c0006853e1.png + +* Generator-> :doc:`Box ` +* Number-> :doc:`Map Range ` +* Viz-> :doc:`Viewer Draw ` +* Viz-> :doc:`Viewer Index+ ` + +--------- Use of Vert Data Dict: -.. image:: https://user-images.githubusercontent.com/10011941/116845901-7560b800-abe7-11eb-9a20-9a53ddeb8c5f.png +.. image:: https://user-images.githubusercontent.com/14288520/200840362-c165eb8e-5299-4614-bd9a-c1d138656788.png + :target: https://user-images.githubusercontent.com/14288520/200840362-c165eb8e-5299-4614-bd9a-c1d138656788.png + +* Generator-> :doc:`Line ` +* Generator-> :doc:`NGon ` +* Transform-> :doc:`Move ` +* Number-> :doc:`List Input ` +* Dictionary-> :doc:`Dictionary In ` +* Dictionary-> :doc:`Dictionary Out ` +* Viz-> :doc:`Viewer Draw ` +* Text-> :doc:`Stethoscope ` + +.. image:: https://user-images.githubusercontent.com/14288520/200840853-558388e1-06fa-4505-8f11-4a5eb4c936a4.gif + :target: https://user-images.githubusercontent.com/14288520/200840853-558388e1-06fa-4505-8f11-4a5eb4c936a4.gif + +--------- Use of Face Data Dict: -.. image:: https://user-images.githubusercontent.com/10011941/116822473-3434bd80-ab7f-11eb-8c2a-d228b4168d17.png +.. image:: https://user-images.githubusercontent.com/14288520/200843415-40ac8f8f-83d7-4d06-93c0-b66a50a8457e.png + :target: https://user-images.githubusercontent.com/14288520/200843415-40ac8f8f-83d7-4d06-93c0-b66a50a8457e.png + +* Generator-> :doc:`Box ` +* Analyzers-> :ref:`Component Analyzer/Faces/Center ` +* Number-> :doc:`Random Num Gen ` +* Dictionary-> :doc:`Dictionary In ` +* Dictionary-> :doc:`Dictionary Out ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +--------- Rock from a Tetrahedron: -.. image:: https://user-images.githubusercontent.com/10011941/116846820-81e61000-abe9-11eb-9ce1-c323c1e1915f.png +.. image:: https://user-images.githubusercontent.com/14288520/200844999-33c31262-2588-4513-ab31-dafac43ef354.png + :target: https://user-images.githubusercontent.com/14288520/200844999-33c31262-2588-4513-ab31-dafac43ef354.png + +.. image:: https://user-images.githubusercontent.com/14288520/200845710-6b7de6a0-de15-415f-986d-5dd339817cc1.gif + :target: https://user-images.githubusercontent.com/14288520/200845710-6b7de6a0-de15-415f-986d-5dd339817cc1.gif \ No newline at end of file diff --git a/docs/nodes/modifier_make/adaptive_polygons_mk3.rst b/docs/nodes/modifier_make/adaptive_polygons_mk3.rst index 892c6c79134bdae3ca8586d51dc8a1cf52bffa7c..4f1203fd255f7dd7628c7edd97618a340804b4ee 100644 --- a/docs/nodes/modifier_make/adaptive_polygons_mk3.rst +++ b/docs/nodes/modifier_make/adaptive_polygons_mk3.rst @@ -1,6 +1,9 @@ Adaptive Polygons Mk2 ===================== +.. image:: https://user-images.githubusercontent.com/14288520/201205493-73992390-e046-405a-8a51-c2946588b294.png + :target: https://user-images.githubusercontent.com/14288520/201205493-73992390-e046-405a-8a51-c2946588b294.png + Functionality ------------- diff --git a/docs/nodes/modifier_make/bevel_curve.rst b/docs/nodes/modifier_make/bevel_curve.rst index 55aa88bfe96e78d2e71e5674169ce4666abcfbdf..62043ddce7428a3f21e55e7e358e9b38c96dd32d 100644 --- a/docs/nodes/modifier_make/bevel_curve.rst +++ b/docs/nodes/modifier_make/bevel_curve.rst @@ -1,6 +1,9 @@ Bevel a Curve (Mesh) ==================== +.. image:: https://user-images.githubusercontent.com/14288520/201133942-b9452f69-db06-4b11-bbd3-d71a092d64b5.png + :target: https://user-images.githubusercontent.com/14288520/201133942-b9452f69-db06-4b11-bbd3-d71a092d64b5.png + Functionality ------------- @@ -28,12 +31,18 @@ one of coordinate planes (XY, YZ or XZ). This plane defines the so-called "orientation axis" - a coordinate axis, which is perpendicular to "bevel object"; during extrusion, bevel object will be moved along orientation axis. +.. image:: https://user-images.githubusercontent.com/14288520/201149971-b1be42ab-9af1-4b28-bab4-3de660a5a58b.png + :target: https://user-images.githubusercontent.com/14288520/201149971-b1be42ab-9af1-4b28-bab4-3de660a5a58b.png + **Note 2**: "Taper object" is supposed to be an open curve, elongated along one of coordinate axes (X, Y or Z). That must be the orientation axis, i.e. the axis perpendicular to the plane of bevel object. In the most common case, "bevel object" will lay in XY plane, so that orientation axis will be Z. +.. image:: https://user-images.githubusercontent.com/14288520/201141743-1e1d5d68-8e2a-4cb5-b564-bc0e82eb1b0f.png + :target: https://user-images.githubusercontent.com/14288520/201141743-1e1d5d68-8e2a-4cb5-b564-bc0e82eb1b0f.png + Inputs ------ @@ -42,8 +51,12 @@ This node has the following inputs: * **Curve**. List of vertices, which define the curve, along which the bevel will be made. Order of vertices in this input must be the same as the order of vertices on the curve being defined. If you are using an "Object In" node - to provide this curve, you may want to use "Vector Sort" node in + to provide this curve, you may want to use "Vector Sort" (Vector-> :doc:`Vector sort `) node in "connections" mode to sort vertices properly. This input is mandatory. + +.. image:: https://user-images.githubusercontent.com/14288520/201154479-ed3f8639-a190-444e-bdac-205585fb8519.png + :target: https://user-images.githubusercontent.com/14288520/201154479-ed3f8639-a190-444e-bdac-205585fb8519.png + * **BevelVerts**. List of vertices, which define the "bevel object". This input is mandatory. * **BevelEdges**. List of edges of "bevel object". You may not connect this input if you connected the **BevelFaces** input: in such a case, edges will be @@ -86,6 +99,12 @@ This node has the following parameters: - **Orientation**. The axis of "bevel object", which should be oriented along the path. Default value is Z (which means that bevel object should lay in XY plane). + +.. image:: https://user-images.githubusercontent.com/14288520/201473253-bb38b5df-7530-49f2-8859-5416722f8d47.png + :target: https://user-images.githubusercontent.com/14288520/201473253-bb38b5df-7530-49f2-8859-5416722f8d47.png + +.. _BEVEL_A_CURVE_ALGORITHM: + - **Algorithm**. Rotation calculation algorithm. Available values are: * Householder: calculate rotation by using Householder's reflection matrix @@ -98,14 +117,30 @@ This node has the following parameters: Default value is Householder. +.. image:: https://user-images.githubusercontent.com/14288520/201160245-5feb3321-3eda-49b8-baef-a8d63e5903ca.png + :target: https://user-images.githubusercontent.com/14288520/201160245-5feb3321-3eda-49b8-baef-a8d63e5903ca.png + + - **Up axis**. Axis of donor object that should point up in result. This parameter is available only when Tracking algorithm is selected. Value of this parameter must differ from **Orientation** parameter, otherwise you will get an error. Default value is X. + +.. image:: https://user-images.githubusercontent.com/14288520/201162989-e220a054-0212-4d22-87cf-997287799fe4.png + :target: https://user-images.githubusercontent.com/14288520/201162989-e220a054-0212-4d22-87cf-997287799fe4.png + - **Curve Mode**. Path interpolation mode. Available values are Linear and Cubic. Default value is Cubic. + +.. image:: https://user-images.githubusercontent.com/14288520/201161693-e2ec96be-2581-4b44-8de2-81ceb92ada84.png + :target: https://user-images.githubusercontent.com/14288520/201161693-e2ec96be-2581-4b44-8de2-81ceb92ada84.png + - **Taper Mode**. Taper curve interpolation mode. Available values are Linear and Cubic. Default value is Cubic. + +.. image:: https://user-images.githubusercontent.com/14288520/201176240-be53841b-d4b8-4751-bd5e-c31dd5cec127.png + :target: https://user-images.githubusercontent.com/14288520/201176240-be53841b-d4b8-4751-bd5e-c31dd5cec127.png + - **Twist Mode**. Twist angles interpolation mode. Available values are Linear and Cubic. Default value is Linear. - **Cyclic**. Indicate whether the path is cyclic. Default value is false. @@ -126,10 +161,17 @@ This node has the following parameters: Unchecked by default. +.. image:: https://user-images.githubusercontent.com/14288520/201172816-feaa4498-0642-4154-ad0a-cbc0977321db.png + :target: https://user-images.githubusercontent.com/14288520/201172816-feaa4498-0642-4154-ad0a-cbc0977321db.png + - **Cap Start**. Whether to create a cap faces at the beginning of curve. Unchecked by default. - **Cap End**. Whether to create a cap faces at the end of curve. Unchecked by default. + +.. image:: https://user-images.githubusercontent.com/14288520/201157034-8ea2b896-8172-459f-af86-2e9f73d5992e.png + :target: https://user-images.githubusercontent.com/14288520/201157034-8ea2b896-8172-459f-af86-2e9f73d5992e.png + - **Flip Curve**. This parameter is available only in the N panel. If checked, then direction of the curve is inverted comparing to the order of path vertices provided. Unchecked by default. @@ -171,6 +213,16 @@ This node has the following outputs: * **Edges** * **Faces** +Advice +------ + +To better practice you should orient start direction of curve and taper as axis in Bevel node: + +.. image:: https://user-images.githubusercontent.com/14288520/201178116-cd3bed6b-fef2-43c5-9604-c5198d3db244.png + :target: https://user-images.githubusercontent.com/14288520/201178116-cd3bed6b-fef2-43c5-9604-c5198d3db244.png + +A behavior in other directions is not obvious. + Examples of usage ----------------- diff --git a/docs/nodes/modifier_make/clip_verts.rst b/docs/nodes/modifier_make/clip_verts.rst index 93189cfec19a32bc24044e3df076d87f97320ae7..49ef3f761daef2c61d0b5d8eb246bff0045f06f9 100644 --- a/docs/nodes/modifier_make/clip_verts.rst +++ b/docs/nodes/modifier_make/clip_verts.rst @@ -1,6 +1,9 @@ Clip Vertices ============= +.. image:: https://user-images.githubusercontent.com/14288520/200960985-def2d5c6-85cf-422c-9617-3bb3d916a417.png + :target: https://user-images.githubusercontent.com/14288520/200960985-def2d5c6-85cf-422c-9617-3bb3d916a417.png + Functionality ------------- @@ -13,6 +16,9 @@ This can give interesting topology, especially in combination with "dual mesh" and/or "triangulate" and/or "join triangles" and/or "limited dissolve" nodes. +.. image:: https://user-images.githubusercontent.com/14288520/201035921-1bb5ab23-7f33-430c-9be4-590d3dc227f7.png + :target: https://user-images.githubusercontent.com/14288520/201035921-1bb5ab23-7f33-430c-9be4-590d3dc227f7.png + Inputs ------ @@ -36,18 +42,38 @@ Examples of Usage Clip a simple plane / grid: -.. image:: https://user-images.githubusercontent.com/284644/74450509-fb3bfa80-4e9f-11ea-9acb-f40c44ae2f3d.png +.. image:: https://user-images.githubusercontent.com/14288520/201036656-26edc580-2810-4794-99ce-6376b9891f56.png + :target: https://user-images.githubusercontent.com/14288520/201036656-26edc580-2810-4794-99ce-6376b9891f56.png + +* Generator-> :doc:`Plane ` +* Viz-> :doc:`Viewer Draw ` + +--------- Clip vertices of a cube: -.. image:: https://user-images.githubusercontent.com/284644/74450490-f6774680-4e9f-11ea-8504-85d9a7902b52.png +.. image:: https://user-images.githubusercontent.com/14288520/201037590-83643a05-f856-4db0-b80d-29bd6ae98415.png + :target: https://user-images.githubusercontent.com/14288520/201037590-83643a05-f856-4db0-b80d-29bd6ae98415.png + +* Generator-> :doc:`Box ` +* Viz-> :doc:`Viewer Draw ` + +--------- Applied to a cylinder: -.. image:: https://user-images.githubusercontent.com/284644/74450506-faa36400-4e9f-11ea-85c5-6899bcaef782.png +.. image:: https://user-images.githubusercontent.com/14288520/201038962-4e65f478-cf6f-4171-934a-fe7e96b0c108.png + :target: https://user-images.githubusercontent.com/14288520/201038962-4e65f478-cf6f-4171-934a-fe7e96b0c108.png + +* Generator-> :doc:`Cylinder ` +* Viz-> :doc:`Viewer Draw ` +--------- Applied to Suzanne: -.. image:: https://user-images.githubusercontent.com/284644/74450498-f8d9a080-4e9f-11ea-9ee2-dbbb0914eb53.png +.. image:: https://user-images.githubusercontent.com/14288520/201039845-46541257-eb9c-4a8f-b3e0-9ea94eaafda2.png + :target: https://user-images.githubusercontent.com/14288520/201039845-46541257-eb9c-4a8f-b3e0-9ea94eaafda2.png +* Generator-> :doc:`Suzanne ` +* Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/modifier_make/contour2D.rst b/docs/nodes/modifier_make/contour2D.rst index 203f43b68e1860c7f343feb34a13d8cde5185466..d9f4c1d29741fef3add2c4d7c0c69b9969b8c73c 100644 --- a/docs/nodes/modifier_make/contour2D.rst +++ b/docs/nodes/modifier_make/contour2D.rst @@ -1,16 +1,19 @@ Contour 2D ========== +.. image:: https://user-images.githubusercontent.com/14288520/200914294-d50fef6e-77cc-465d-92d8-24fc1986e1bc.png + :target: https://user-images.githubusercontent.com/14288520/200914294-d50fef6e-77cc-465d-92d8-24fc1986e1bc.png + Functionality ------------- -.. image:: https://user-images.githubusercontent.com/10011941/34644861-37e4c430-f33f-11e7-92e0-d89080effc4b.png - This node creates one or many contours at specified distance. - It is fed by sets of vertices and edges. - Every set of vertices needs to share the Z coordinate in order to create a valid contour. +.. image:: https://user-images.githubusercontent.com/14288520/200941341-4713e599-b1e4-4b9c-818d-ae099ca0c7ed.png + :target: https://user-images.githubusercontent.com/14288520/200941341-4713e599-b1e4-4b9c-818d-ae099ca0c7ed.png Inputs ------ @@ -31,6 +34,7 @@ Parameters | Parameter | Type | Default | Description | +==================+===============+=============+=============================================================+ |**Mode** | Menu | Constant |**Constant**: Constant distances on each perimeter. | +| | | | | | | | |**Weighted**: Different distances per vertex. | +------------------+---------------+-------------+-------------------------------------------------------------+ |**Remove Doubles**| Float | 1.0 | Remove doubled vertices under this distance. | @@ -45,12 +49,16 @@ Parameters +------------------+---------------+-------------+-------------------------------------------------------------+ |In the N-Panel | +------------------+---------------+-------------+-------------------------------------------------------------+ -|**Mask Tolerance**| Float | 1.0e-5 | Tolerance on masking (for low Nº Vertices or small values) | +|**Mask Tolerance**| Float | 1.0e-5 | Tolerance on masking (for low Nº Vertices | +| | | | | +| | | | or small values) | +------------------+---------------+-------------+-------------------------------------------------------------+ |**Inters. Mode** | Menu | Circular |**Circular**: Intersection based on circles (Slower). | +| | | | | | | | |**Polygonal**: Intersection based on polygons (Faster). | +------------------+---------------+-------------+-------------------------------------------------------------+ |**List Match** | Menu | Long Cycle |**Long Repeat**: After shortest list repeat last value. | +| | | | | | | | |**Long Cycle**: After shortest list got to first last value. | +------------------+---------------+-------------+-------------------------------------------------------------+ |**Remove Caps** | Boolean | False | Remove arcs in the vertices with only one edge. | @@ -68,39 +76,107 @@ This node has the following outputs: Examples of usage ----------------- +.. image:: https://user-images.githubusercontent.com/10011941/34644861-37e4c430-f33f-11e7-92e0-d89080effc4b.png + :target: https://user-images.githubusercontent.com/10011941/34644861-37e4c430-f33f-11e7-92e0-d89080effc4b.png + +* Number-> :doc:`List Input ` +* Scene-> :doc:`Objects In Lite ` +* Viz-> :doc:`Viewer Draw ` + +--------- + - When you input different distances: In constant mode independent contours will be created (one per distance) In Weighted mode will apply each distance to a vertex creating independent contours when there are more distances than vertices .. image:: https://user-images.githubusercontent.com/10011941/34644863-41eabfde-f33f-11e7-8ed6-6e8fa7a1e6df.png + :target: https://user-images.githubusercontent.com/10011941/34644863-41eabfde-f33f-11e7-8ed6-6e8fa7a1e6df.png + +* Generator-> :doc:`Line ` +* Range Float: Number-> :doc:`Number Range ` +* Matrix-> :doc:`Matrix In ` +* List->List Struct-> :doc:`List Repeater ` +* Viz-> :doc:`Viewer Draw ` +* Text-> :doc:`Stethoscope ` + +--------- - When you input different objects independent contours will be created: .. image:: https://user-images.githubusercontent.com/10011941/34644864-46463d24-f33f-11e7-80c1-bb0718d9966b.png + :target: https://user-images.githubusercontent.com/10011941/34644864-46463d24-f33f-11e7-80c1-bb0718d9966b.png +* Modifiers->Modifier Change-> :doc:`Mesh Join ` +* Scene-> :doc:`Objects In Lite ` +* Viz-> :doc:`Viewer Draw ` + +--------- - With the intersection mode on "Circular" the intersection points will be placed as if we were using perfect circles. This will change the edges angles, but the distance between the intersection point and the original points will be maintained. On "Polygonal" the edges angles are preserved but the distance to original vertex will depend on the number of vertices. .. image:: https://user-images.githubusercontent.com/10011941/35116834-027e2f8c-fc8d-11e7-9cff-35465e3e5e17.png + :target: https://user-images.githubusercontent.com/10011941/35116834-027e2f8c-fc8d-11e7-9cff-35465e3e5e17.png + +* Generator-> :doc:`Line ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +--------- - Integrated list match function can lead to different results: .. image:: https://user-images.githubusercontent.com/10011941/34644870-5935b1ee-f33f-11e7-99ba-0c536bf67f91.png + :target: https://user-images.githubusercontent.com/10011941/34644870-5935b1ee-f33f-11e7-99ba-0c536bf67f91.png + +* Generator-> :doc:`Line ` +* Number-> :doc:`List Input ` +* Range Float: Number-> :doc:`Number Range ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +--------- - Different ranges can be used to create a complex contour. .. image:: https://user-images.githubusercontent.com/10011941/35116835-029ea8de-fc8d-11e7-9df0-f044677c059a.png + :target: https://user-images.githubusercontent.com/10011941/35116835-029ea8de-fc8d-11e7-9df0-f044677c059a.png + +* Generator-> :doc:`NGon ` +* Modifiers->Modifier Change-> :doc:`Smooth Vertices ` +* Modifiers->Modifier Change-> :doc:`Triangulate Mesh ` +* Modifiers->Modifier Make-> :doc:`UV Connection ` +* Number-> :doc:`A Number ` +* Range Float: Number-> :doc:`Number Range ` +* Vector-> :doc:`Vector In ` +* ADD: Vector-> :doc:`Vector Math ` +* Vector-> :doc:`Vector Interpolation ` +* List->List Main-> :doc:`List Join ` +* List->List Struct-> :doc:`List Flip ` +* List->List Struct-> :doc:`List Split ` +* Viz-> :doc:`Viewer Draw ` + +--------- - When using text meshes it can get very slow but also interesting .. image:: https://user-images.githubusercontent.com/10011941/35116836-02b9cc36-fc8d-11e7-9526-259c18c8556f.png - + :target: https://user-images.githubusercontent.com/10011941/35116836-02b9cc36-fc8d-11e7-9526-259c18c8556f.png + +* Transform-> :doc:`Matrix Apply (verts) ` +* Analyzer-> :doc:`Mesh Filter ` +* Analyzer-> :doc:`Mesh Filter ` +* Number-> :doc:`A Number ` +* ADD: Number-> :doc:`Scalar Math ` +* Range Float: Number-> :doc:`Number Range ` +* Matrix-> :doc:`Matrix In ` +* List->List Main-> :doc:`List Join ` +* Scene-> :doc:`Objects In Lite ` +* Viz-> :doc:`Curve Viewer ` +* Viz-> :doc:`Viewer Draw ` Notes ----- - This implementation can get very slow when working with hundreds of inputs and different distances, handle it with patience. - - If the node does not create a closed contour try increasing the vertices number or rising the mask tolerance slowly - - This is the pull request where this node was added https://github.com/nortikin/sverchok/pull/2001 diff --git a/docs/nodes/modifier_make/diamond_mesh.rst b/docs/nodes/modifier_make/diamond_mesh.rst index 4c77733127e878a741482208d290abbd291902b7..1b692cb1495f3a65a38ed4cfa1eb64d2da06b202 100644 --- a/docs/nodes/modifier_make/diamond_mesh.rst +++ b/docs/nodes/modifier_make/diamond_mesh.rst @@ -1,6 +1,9 @@ Diamond Mesh ============ +.. image:: https://user-images.githubusercontent.com/14288520/200949333-22865d83-ab99-4e1b-afa6-ec87666565b8.png + :target: https://user-images.githubusercontent.com/14288520/200949333-22865d83-ab99-4e1b-afa6-ec87666565b8.png + Functionality ------------- @@ -10,6 +13,9 @@ faces). This can give interesting topology, especially in combination with "dual mesh" and/or "triangulate" and/or "join triangles" and/or "limited dissolve" nodes. +.. image:: https://user-images.githubusercontent.com/14288520/200955270-c6cbac0c-e512-4c67-987e-f0cf7dae0a98.png + :target: https://user-images.githubusercontent.com/14288520/200955270-c6cbac0c-e512-4c67-987e-f0cf7dae0a98.png + Inputs ------ @@ -33,17 +39,42 @@ Examples of Usage The simplest example — diamond mesh for a plane / grid: -.. image:: https://user-images.githubusercontent.com/284644/74258086-92c21180-4d17-11ea-8837-d57c52a4c7dd.png +.. image:: https://user-images.githubusercontent.com/14288520/200955808-7c0d5780-dce8-4354-92a7-ee4b8c0b5375.png + :target: https://user-images.githubusercontent.com/14288520/200955808-7c0d5780-dce8-4354-92a7-ee4b8c0b5375.png + +* Generator-> :doc:`Plane ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +--------- Diamond mesh for a cube: -.. image:: https://user-images.githubusercontent.com/284644/74258156-b1c0a380-4d17-11ea-8fec-9e6f03ea7932.png +.. image:: https://user-images.githubusercontent.com/14288520/200957358-c69b7738-4f6a-4594-b390-f7f8396d5633.png + :target: https://user-images.githubusercontent.com/14288520/200957358-c69b7738-4f6a-4594-b390-f7f8396d5633.png + +* Generator-> :doc:`Box ` +* Modifiers->Modifier Change-> :doc:`Split Faces ` +* Viz-> :doc:`Viewer Draw ` + +--------- In combination with "dual mesh" node: -.. image:: https://user-images.githubusercontent.com/284644/74258160-b2f1d080-4d17-11ea-87ac-578ce4d2f3ca.png +.. image:: https://user-images.githubusercontent.com/14288520/200959724-5f9f906f-4583-40de-90ed-8ba931349e84.png + :target: https://user-images.githubusercontent.com/14288520/200959724-5f9f906f-4583-40de-90ed-8ba931349e84.png + +* Generator-> :doc:`IcoSphere ` +* Modifiers->Modifier Make-> :doc:`Dual Mesh ` +* Viz-> :doc:`Viewer Draw ` + +--------- In another combination with "dual mesh" node: -.. image:: https://user-images.githubusercontent.com/284644/74258165-b38a6700-4d17-11ea-8041-5e58351c1c17.png +.. image:: https://user-images.githubusercontent.com/14288520/200960269-25907776-a6fd-426a-8034-38822f6c6c84.png + :target: https://user-images.githubusercontent.com/14288520/200960269-25907776-a6fd-426a-8034-38822f6c6c84.png +* Generator-> :doc:`IcoSphere ` +* Modifiers->Modifier Make-> :doc:`Dual Mesh ` +* Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/modifier_make/dual_mesh.rst b/docs/nodes/modifier_make/dual_mesh.rst index 4aaf52dd7969e1e505c6c84d6c687542fe2337f5..f4eb5508ada158c58324a3dea0853c334c5fdc28 100644 --- a/docs/nodes/modifier_make/dual_mesh.rst +++ b/docs/nodes/modifier_make/dual_mesh.rst @@ -1,6 +1,9 @@ Dual Mesh ========= +.. image:: https://user-images.githubusercontent.com/14288520/200945022-5dce027f-28ce-4370-8783-f02c358ac76b.png + :target: https://user-images.githubusercontent.com/14288520/200945022-5dce027f-28ce-4370-8783-f02c358ac76b.png + Functionality ------------- @@ -14,6 +17,9 @@ consisting to NGons, or backwards. Note that the volume of dual mesh is always a bit smaller than that of original mesh. +.. image:: https://user-images.githubusercontent.com/14288520/200946357-32156894-b4dd-43f3-b1af-918c920a619d.png + :target: https://user-images.githubusercontent.com/14288520/200946357-32156894-b4dd-43f3-b1af-918c920a619d.png + Inputs ------ @@ -37,8 +43,20 @@ Examples of Usage Dual mesh for cube is an octahedron: .. image:: https://user-images.githubusercontent.com/284644/68086032-278bb800-fe69-11e9-80d5-5b46bde8d9b0.png + :target: https://user-images.githubusercontent.com/284644/68086032-278bb800-fe69-11e9-80d5-5b46bde8d9b0.png + +* Generator-> :doc:`Box ` +* Viz-> :doc:`Viewer Draw ` + +--------- Dual mesh for Voronoi diagram is Delaunay triangulation: -.. image:: https://user-images.githubusercontent.com/284644/68086114-fcee2f00-fe69-11e9-95f5-d57f03dbbf0f.png +.. image:: https://user-images.githubusercontent.com/14288520/200948444-d01e794a-b3df-4422-bb72-c75434326422.png + :target: https://user-images.githubusercontent.com/14288520/200948444-d01e794a-b3df-4422-bb72-c75434326422.png +* Generator-> :doc:`Plane ` +* Transform-> :doc:`Randomize ` +* Modifiers->Modifier Change-> :doc:`Voronoi 2D ` +* Modifiers->Modifier Change-> :doc:`Fill Holes ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/edges_adaptative.rst b/docs/nodes/modifier_make/edges_adaptative.rst index 6cfe018ef487163b5a5a2c575150a40886a7fa2b..ad8a9a08135aded84b5cff405e9a0ebdf285af22 100644 --- a/docs/nodes/modifier_make/edges_adaptative.rst +++ b/docs/nodes/modifier_make/edges_adaptative.rst @@ -1,2 +1,21 @@ Adaptative Edges -================ \ No newline at end of file +================ + +.. image:: https://user-images.githubusercontent.com/14288520/201197929-f788a921-448e-4f13-a04c-15c763820840.png + :target: https://user-images.githubusercontent.com/14288520/201197929-f788a921-448e-4f13-a04c-15c763820840.png + + +Examples: + +.. image:: https://user-images.githubusercontent.com/14288520/201199410-17cf12ff-a2f0-4f17-822c-ab23ee07128e.png + :target: https://user-images.githubusercontent.com/14288520/201199410-17cf12ff-a2f0-4f17-822c-ab23ee07128e.png + +* Generator-> :doc:`NGon ` +* Generator->Generatots Extended-> :doc:`Hilbert ` +* Transform-> :doc:`Rotate ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +.. image:: https://user-images.githubusercontent.com/14288520/201199136-18820783-fe1b-40d3-b197-34ea5aacd529.gif + :target: https://user-images.githubusercontent.com/14288520/201199136-18820783-fe1b-40d3-b197-34ea5aacd529.gif + diff --git a/docs/nodes/modifier_make/fractal_curve.rst b/docs/nodes/modifier_make/fractal_curve.rst index 1584eb6c7ab12d8f79ba7a290dd65a810d5e46ac..91f7b9c3dcedad97ea170705b60a9a5419a3ab71 100644 --- a/docs/nodes/modifier_make/fractal_curve.rst +++ b/docs/nodes/modifier_make/fractal_curve.rst @@ -1,17 +1,29 @@ Fractal Curve ============= +.. image:: https://user-images.githubusercontent.com/14288520/201398869-b97cd996-708d-45c5-8bc7-a0b712244774.png + :target: https://user-images.githubusercontent.com/14288520/201398869-b97cd996-708d-45c5-8bc7-a0b712244774.png + Functionality ------------- This node generates a fractal curve, by replacing each edge of input curve with a copy of that curve, several times. +.. image:: https://user-images.githubusercontent.com/14288520/201400256-9234b87a-312d-4859-b95e-c8695f73126f.png + :target: https://user-images.githubusercontent.com/14288520/201400256-9234b87a-312d-4859-b95e-c8695f73126f.png + NB 1: Number of vertices in the output curve grows exponentially with number of iterations. +.. image:: https://user-images.githubusercontent.com/14288520/201401867-3387e615-cdde-451a-b37f-2e181feccc01.png + :target: https://user-images.githubusercontent.com/14288520/201401867-3387e615-cdde-451a-b37f-2e181feccc01.png + NB 2: Usually you will want to use curves, for which diameter (distance between to most distant vertices) is less than distance from the first vertex to the last. Otherwise, the output curve can grow very large. +.. image:: https://user-images.githubusercontent.com/14288520/201426832-5b90bb43-d6a0-472a-8aa7-be66f154dd71.png + :target: https://user-images.githubusercontent.com/14288520/201426832-5b90bb43-d6a0-472a-8aa7-be66f154dd71.png + NB 3: Usually you will want to use curves, edges of which have nearly the same length. Inputs @@ -51,17 +63,44 @@ Examples of usage Classical example: -.. image:: https://user-images.githubusercontent.com/284644/57985244-96718200-7a7e-11e9-8559-61a6feb78882.png +.. image:: https://user-images.githubusercontent.com/14288520/201405917-6ea4f7cd-3b0d-4fc7-a20b-82164649e0d3.png + :target: https://user-images.githubusercontent.com/14288520/201405917-6ea4f7cd-3b0d-4fc7-a20b-82164649e0d3.png + +* Number-> :doc:`List Input ` +* Analyzers-> :doc:`Bounding Box ` +* Transform-> :doc:`Move ` +* Modifiers->Modifier Make-> :doc:`UV Connection ` +* Viz-> :doc:`Viewer Draw ` + +--------- Another example: -.. image:: https://user-images.githubusercontent.com/284644/57985245-970a1880-7a7e-11e9-82ab-f69d61bd5e1d.png +.. image:: https://user-images.githubusercontent.com/14288520/201408641-ac592164-9872-423f-9575-a0dffac8c370.png + :target: https://user-images.githubusercontent.com/14288520/201408641-ac592164-9872-423f-9575-a0dffac8c370.png + +* Number-> :doc:`List Input ` +* Analyzers-> :doc:`Bounding Box ` +* Transform-> :doc:`Move ` +* Modifiers->Modifier Make-> :doc:`UV Connection ` +* Viz-> :doc:`Viewer Draw ` + +--------- This node can process 3D curves as well: .. image:: https://user-images.githubusercontent.com/284644/57985246-970a1880-7a7e-11e9-84f3-198244d92df0.png + :target: https://user-images.githubusercontent.com/284644/57985246-970a1880-7a7e-11e9-84f3-198244d92df0.png + +--------- Vectorization example: -.. image:: https://user-images.githubusercontent.com/284644/58745914-074a6e00-8471-11e9-889d-f41f416fb744.png +.. image:: https://user-images.githubusercontent.com/14288520/201425422-bb60a043-84e1-4d3f-96b0-9c663356f958.png + :target: https://user-images.githubusercontent.com/14288520/201425422-bb60a043-84e1-4d3f-96b0-9c663356f958.png +* Number-> :doc:`List Input ` +* Modifiers->Modifier Make-> :doc:`UV Connection ` +* Vector-> :doc:`Vector sort ` +* Scene-> :doc:`Get Objects Data ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/framework.rst b/docs/nodes/modifier_make/framework.rst index 6b27adf53a7083a0dbb2b561a849a62f40c69f85..280e85b4c5d6701e07a3992246f4030c6b5e4ad7 100644 --- a/docs/nodes/modifier_make/framework.rst +++ b/docs/nodes/modifier_make/framework.rst @@ -1,6 +1,9 @@ Framework ========= +.. image:: https://user-images.githubusercontent.com/14288520/201439954-33c69bea-0b49-4e51-883f-ce02036de0f0.png + :target: https://user-images.githubusercontent.com/14288520/201439954-33c69bea-0b49-4e51-883f-ce02036de0f0.png + Functionality ------------- diff --git a/docs/nodes/modifier_make/join_tris.rst b/docs/nodes/modifier_make/join_tris.rst index 8dc6cd51e5622a74b9769b7f45149f1a73af852a..1103ea69e62887f2e0d3fc40929e7baddb99242c 100644 --- a/docs/nodes/modifier_make/join_tris.rst +++ b/docs/nodes/modifier_make/join_tris.rst @@ -57,6 +57,6 @@ Examples :target: https://user-images.githubusercontent.com/14288520/199772606-ca5afd88-096d-430b-a4a7-4e1e812c5280.png * Generator-> :doc:`Plane ` -* Modifier->Modifier Change-> :doc:`Triangulate Mesh ` +* Modifiers->Modifier Change-> :doc:`Triangulate Mesh ` * Transform-> :doc:`Noise Displace ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/modifier_make/matrix_tube.rst b/docs/nodes/modifier_make/matrix_tube.rst index 20e6e3d59ff77d3faf786955ca4e3aa93c2d8696..6805b0ad2121d31065f5c35a530185efe382b4f1 100644 --- a/docs/nodes/modifier_make/matrix_tube.rst +++ b/docs/nodes/modifier_make/matrix_tube.rst @@ -1,6 +1,9 @@ Matrix Tube ============ +.. image:: https://user-images.githubusercontent.com/14288520/201468347-0efebe3f-4554-4308-81fc-e9f0cce9fb17.png + :target: https://user-images.githubusercontent.com/14288520/201468347-0efebe3f-4554-4308-81fc-e9f0cce9fb17.png + *destination after Beta: Modifier Make* Functionality @@ -8,12 +11,14 @@ Functionality Makes a tube or pipe from a list of matrices. This node takes a list of matrices and a list of vertices as input. The vertices are joined together to form a ring. This ring is transformed by each matrix to form a new ring. Each ring is joined to the previous ring to form a tube. +.. image:: https://user-images.githubusercontent.com/14288520/201468943-0b3de332-16fa-4bf1-a2fc-187758c7041e.png + :target: https://user-images.githubusercontent.com/14288520/201468943-0b3de332-16fa-4bf1-a2fc-187758c7041e.png + Inputs ------ -**Matrices** - List of transform matrices. - -**Vertices** - Vertices of ring. Usually from a "Circle" or "NGon" node +* **Matrices** - List of transform matrices. +* **Vertices** - Vertices of ring. Usually from a "Circle" or "NGon" node Outputs ------- @@ -23,6 +28,25 @@ Outputs Example of usage ------------------ -.. image:: https://cloud.githubusercontent.com/assets/7930130/7645410/e7ce60f4-fb08-11e4-827e-f856e1874fec.png - :alt: matrix tube example +.. image:: https://user-images.githubusercontent.com/14288520/201469603-49ffbc9c-c7d9-41c3-b503-35dd27687a90.png + :target: https://user-images.githubusercontent.com/14288520/201469603-49ffbc9c-c7d9-41c3-b503-35dd27687a90.png + +* Generator-> :doc:`Plane ` +* Number-> :doc:`A Number ` +* Number-> :doc:`Number Range ` +* Vector-> :doc:`Vector In ` +* Vector-> :doc:`Vector sort ` +* Matrix-> :doc:`Matrix In ` +* Vector-> :doc:`Vector sort ` +* Viz-> :doc:`Viewer Draw ` + +--------- + +.. image:: https://user-images.githubusercontent.com/14288520/201470303-d76a5344-6098-4839-91c2-09b90573a7d1.png + :target: https://user-images.githubusercontent.com/14288520/201470303-d76a5344-6098-4839-91c2-09b90573a7d1.png +* Generator-> :doc:`Circle ` +* Vector-> :doc:`Vector In ` +* Matrix-> :doc:`Matrix Euler ` +* Matrix-> :doc:`Matrix Matrix Transform ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/offset_line.rst b/docs/nodes/modifier_make/offset_line.rst index a74ed545fde1952753e50af58f8812c33a87bda4..583f49dcb427f66318aa55fb6fe65dd5dfd48511 100644 --- a/docs/nodes/modifier_make/offset_line.rst +++ b/docs/nodes/modifier_make/offset_line.rst @@ -1,6 +1,9 @@ Offset Line =========== +.. image:: https://user-images.githubusercontent.com/14288520/200897605-00613b3c-10ba-4e23-8d32-cfa51dec461d.png + :target: https://user-images.githubusercontent.com/14288520/200897605-00613b3c-10ba-4e23-8d32-cfa51dec461d.png + Functionality ------------- @@ -12,6 +15,9 @@ This node works only in XY surface. It takes X and Y coordinate from vectors inp Use ``delete loose`` node before if your input mesh has points without edges. You will receive surface along an input mesh edges with width equal offset value. It is also available to receive outer edges and mask of new and old points. +.. image:: https://user-images.githubusercontent.com/14288520/200904381-29e18316-91d6-4cb0-ad7a-a3e3190f1bf6.png + :target: https://user-images.githubusercontent.com/14288520/200904381-29e18316-91d6-4cb0-ad7a-a3e3190f1bf6.png + Inputs ------ @@ -19,7 +25,7 @@ This node has the following inputs: - **Vers** - vertices of objects. - **Edgs** - polygons of objects. -- **offset** - offset values - available multiple value per object. +- **offset** - offset values - available multiple value per object (greater than 0. 0 will replace by 0.001). Parameters ---------- @@ -43,25 +49,62 @@ This node has the following outputs: - **OuterEdges** - get outer edges, use together with ``delete loose`` node after or ``mask verts``. The list of edges is unordered. - **VersMask** - 0 for new points and 1 for old. +.. image:: https://user-images.githubusercontent.com/14288520/200906483-088c0f6c-c5de-4718-8f25-31dbba173e97.png + :target: https://user-images.githubusercontent.com/14288520/200906483-088c0f6c-c5de-4718-8f25-31dbba173e97.png + Examples of usage ----------------- To receive offset from input object from scene: .. image:: https://user-images.githubusercontent.com/28003269/34199193-5e1281a4-e586-11e7-97b8-f1984facdfcb.png + :target: https://user-images.githubusercontent.com/28003269/34199193-5e1281a4-e586-11e7-97b8-f1984facdfcb.png + +* Scene-> :doc:`Objects In Lite ` +* Viz-> :doc:`Viewer Draw ` + +--------- Using of outer edges: .. image:: https://user-images.githubusercontent.com/28003269/34199326-dadbf508-e586-11e7-9542-7b7ff4a9521f.png + :target: https://user-images.githubusercontent.com/28003269/34199326-dadbf508-e586-11e7-9542-7b7ff4a9521f.png + +* Scene-> :doc:`Objects In Lite ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` +* Viz-> :doc:`Viewer Draw ` + +--------- Using of vertices mask with ``transform select`` node: .. image:: https://user-images.githubusercontent.com/28003269/34199698-125ed63e-e588-11e7-9e34-83c5eb33cde9.png + :target: https://user-images.githubusercontent.com/28003269/34199698-125ed63e-e588-11e7-9e34-83c5eb33cde9.png + +* Scene-> :doc:`Objects In Lite ` +* Transform-> :doc:`Transform Select ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` + +--------- Different values for each object and each point: .. image:: https://user-images.githubusercontent.com/28003269/34353407-47f2d918-ea41-11e7-92c0-f0f9751e4cab.png + :target: https://user-images.githubusercontent.com/28003269/34353407-47f2d918-ea41-11e7-92c0-f0f9751e4cab.png + +* Generator-> :doc:`Line ` +* Number-> :doc:`Number Range ` +* List->List Main-> :doc:`List Join ` +* Viz-> :doc:`Viewer Draw ` + +--------- Using of Z coordinate: -.. image:: https://user-images.githubusercontent.com/28003269/34353545-3e4c0a6e-ea42-11e7-9b63-da65bd45f07a.png +.. image:: https://user-images.githubusercontent.com/14288520/200909050-34199e42-54aa-41cf-9efb-abef230afdf7.png + :target: https://user-images.githubusercontent.com/14288520/200909050-34199e42-54aa-41cf-9efb-abef230afdf7.png + +* Scene-> :doc:`Get Objects Data ` +* Matrix-> :doc:`Matrix In ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/pipe_tubes.rst b/docs/nodes/modifier_make/pipe_tubes.rst index 522e558db64f2e3a53411da116de58a6c7a223ce..4c26e09459609583b0d40005f3e6edadef0a0510 100644 --- a/docs/nodes/modifier_make/pipe_tubes.rst +++ b/docs/nodes/modifier_make/pipe_tubes.rst @@ -1,43 +1,67 @@ Pipe ==== +.. image:: https://user-images.githubusercontent.com/14288520/201471088-81a81e4f-c550-41cc-b8dc-e0b3928ea082.png + :target: https://user-images.githubusercontent.com/14288520/201471088-81a81e4f-c550-41cc-b8dc-e0b3928ea082.png + Functionality ------------- Making pipes from edges. +.. image:: https://user-images.githubusercontent.com/14288520/201471091-8d941abe-eed5-4579-a601-2f912ae443f3.png + :target: https://user-images.githubusercontent.com/14288520/201471091-8d941abe-eed5-4579-a601-2f912ae443f3.png + Inputs ------ -**Vers** - Vertices of piped object. - -**Edgs** - Edges of piped object. - -**diameter** - Diameter of pipe. - -**nsides** - Number of sides of pipe. - -**offset** - Offset on length to avoid self intersection. - -**extrude** - Scale the pipe on local X direction. +* **Vers** - Vertices of piped object. +* **Edgs** - Edges of piped object. +* **diameter** - Diameter of pipe. +* **nsides** - Number of sides of pipe. +* **offset** - Offset on length to avoid self intersection. +* **extrude** - Scale the pipe on local X direction. Properties ---------- -**close** - Close pipes between each other to make complete topology of united mesh. +* **close** - Close pipes between each other to make complete topology of united mesh. Outputs ------- -**Vers** - Vertices of output. +* **Vers** - Vertices of output. +* **Pols** - Polygons of output. -**Pols** - Polygons of output. +See also +-------- +* Modifiers->Modifier Make-> :ref:`Bevel a Curve ` Examples -------- +.. image:: https://user-images.githubusercontent.com/14288520/201471241-581c2b5b-821a-4868-aeae-952f0b704fc6.png + :target: https://user-images.githubusercontent.com/14288520/201471241-581c2b5b-821a-4868-aeae-952f0b704fc6.png + +* Generator->Generatots Extended-> :doc:`Hilbert ` +* Number-> :doc:`Number Range ` +* Vector-> :doc:`Vector Interpolation ` +* Modifiers->Modifier Make-> :doc:`UV Connection ` +* List->List Struct-> :doc:`List Length ` +* Color-> :doc:`Color Ramp ` +* Viz-> :doc:`Viewer Draw ` + +--------- + .. image:: https://cloud.githubusercontent.com/assets/5783432/5291188/cf0f6eb8-7b57-11e4-9adf-025bbd1d74eb.png + :target: https://cloud.githubusercontent.com/assets/5783432/5291188/cf0f6eb8-7b57-11e4-9adf-025bbd1d74eb.png :alt: noalt + +* Text-> :doc:`Note ` +* Float Series: Number-> :doc:`Number Range ` +* Vector-> :doc:`Vector Interpolation ` +* Modifiers->Modifier Make-> :doc:`UV Connection ` +* Bmesh Viewer Draw: Viz-> :doc:`Mesh Viewer ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/solidify_mk2.rst b/docs/nodes/modifier_make/solidify_mk2.rst index 32eea2465e40a511b206f70f112b078e94240c3c..e4f373b5a5fe508b435b913439378d1b1b98d1bd 100644 --- a/docs/nodes/modifier_make/solidify_mk2.rst +++ b/docs/nodes/modifier_make/solidify_mk2.rst @@ -1,56 +1,83 @@ Solidify ======== +.. image:: https://user-images.githubusercontent.com/14288520/201440855-0564d90d-6654-42d9-980c-2f856b57d4f0.png + :target: https://user-images.githubusercontent.com/14288520/201440855-0564d90d-6654-42d9-980c-2f856b57d4f0.png + Extrudes a mesh along its normal. Used usually to get a thick mesh from a planar mesh. +.. image:: https://user-images.githubusercontent.com/14288520/201441550-c1a3bb63-693d-48b3-a8f1-8144296f4c12.png + :target: https://user-images.githubusercontent.com/14288520/201441550-c1a3bb63-693d-48b3-a8f1-8144296f4c12.png + Inputs ------ -**Vertices**: Mesh Vertices (mandatory) +* **Vertices**: Mesh Vertices (mandatory) +* **Edges**: Mesh Edges (optional, if you want to output edges makes the algorithm faster) +* **Polygons**: Mesh Polygons (mandatory) +* **Thickness**: Distance to extrude -**Edges**: Mesh Edges (optional, if you want to output edges makes the algorithm faster) +.. image:: https://user-images.githubusercontent.com/14288520/201442046-b93db529-8e17-47b7-995b-82acf469f27c.gif + :target: https://user-images.githubusercontent.com/14288520/201442046-b93db529-8e17-47b7-995b-82acf469f27c.gif -**Polygons**: Mesh Polygons (mandatory) +* **Offset**: Relative offset from original mesh [-1.0; 1.0] -**Thickness**: Distance to extrude - -**Offset**: Relative offset from original mesh +.. image:: https://user-images.githubusercontent.com/14288520/201442148-7ef38073-ee87-48a1-98ed-6a247687a0db.gif + :target: https://user-images.githubusercontent.com/14288520/201442148-7ef38073-ee87-48a1-98ed-6a247687a0db.gif Options ------- -**Even**: adjust thickness in sharp corners to have a even thickness. +* **Even**: adjust thickness in sharp corners to have a even thickness. + +.. image:: https://user-images.githubusercontent.com/14288520/201442415-7e840cc4-af94-43b0-b4ee-0cf93c715832.gif + :target: https://user-images.githubusercontent.com/14288520/201442415-7e840cc4-af94-43b0-b4ee-0cf93c715832.gif + +* **Implementation**: Algorithm used to compute. -**Implementation**: Algorithm used to compute. - Sverchok: Faster all with more options - Blender: Old method, left because it may differ in some corner cases Outputs ------- -**Vertices**, **Edges**, **Polygons**: Modified mesh - -**New Pols**: New opposite polygons (in the same order as the originals) +* **Vertices**, **Edges**, **Polygons**: Modified mesh +* **New Pols**: New opposite polygons (in the same order as the originals) +* **Rim Pols**: Side Polygons created in the boundaries of the mesh +* **Pols Group**: Outputs a list to mask polygons from the modified mesh, -**Rim Pols**: Side Polygons created in the boundaries of the mesh + - 0 = Original Polygon + - 1 = New Polygon + - 2 = Rim Polygon -**Pols Group**: Outputs a list to mask polygons from the modified mesh, - 0 = Original Polygon - 1 = New Polygon - 2 = Rim Polygon +* **New Verts Mask**: To split old vertices form new vertices -**New Verts Mask**: To split old vertices form new vertices +.. image:: https://user-images.githubusercontent.com/14288520/201444252-0c1d3bef-78c5-4527-8870-32c3ae2cb30e.png + :target: https://user-images.githubusercontent.com/14288520/201444252-0c1d3bef-78c5-4527-8870-32c3ae2cb30e.png +* Text-> :doc:`Stethoscope ` Examples -------- Using variable thickness: -.. image:: https://user-images.githubusercontent.com/10011941/105902112-80bbaa80-601e-11eb-902b-5bd3797f257d.png +.. image:: https://user-images.githubusercontent.com/14288520/201444780-ff1a1ac7-c6ec-4215-8638-6f40bd38db81.png + :target: https://user-images.githubusercontent.com/14288520/201444780-ff1a1ac7-c6ec-4215-8638-6f40bd38db81.png +* Generator-> :doc:`Box ` +* Vector-> :doc:`Vector Noise ` +* Number-> :doc:`Map Range ` +* Viz-> :doc:`Viewer Draw ` + +--------- Splitting Data: New Vertices in white, Old vertices in black, New Polys in grey, Rim Polys in white... -.. image:: https://user-images.githubusercontent.com/10011941/106249827-1fa8f800-6213-11eb-9e77-770f12d65e03.png +.. image:: https://user-images.githubusercontent.com/14288520/201445261-ebbee6d5-8e1a-4f85-a9fa-f05123d5efcd.png + :target: https://user-images.githubusercontent.com/14288520/201445261-ebbee6d5-8e1a-4f85-a9fa-f05123d5efcd.png + +* Generator-> :doc:`Cylinder ` +* DIV: Number-> :doc:`Scalar Math ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/subdivide_lite.rst b/docs/nodes/modifier_make/subdivide_lite.rst index bc8c50052f7c68406fd3b9ab427ad4d7db917511..68fb916acfabd25e8e1a1f2b06487be21879947a 100644 --- a/docs/nodes/modifier_make/subdivide_lite.rst +++ b/docs/nodes/modifier_make/subdivide_lite.rst @@ -1,11 +1,19 @@ Subdivide Lite Node =================== +.. image:: https://user-images.githubusercontent.com/14288520/200693616-08d9cb48-d5a1-4998-a9df-adc4fa3b6bf3.png + :target: https://user-images.githubusercontent.com/14288520/200693616-08d9cb48-d5a1-4998-a9df-adc4fa3b6bf3.png + Functionality ------------- This node applies Blender's Subvidide operation to the input mesh. Please note that of options available differs from usual editing operator. +.. image:: https://user-images.githubusercontent.com/14288520/200693965-1f1a23d2-3203-4ab0-8e8e-b9d70a00b10e.png + :target: https://user-images.githubusercontent.com/14288520/200693965-1f1a23d2-3203-4ab0-8e8e-b9d70a00b10e.png + +For more info see: Modifiers->Modifier Make-> :doc:`Subdivide ` + Inputs ------ diff --git a/docs/nodes/modifier_make/unsubdivide.rst b/docs/nodes/modifier_make/unsubdivide.rst index 97d2828396082d970ce3afcc5a670211bd5e234a..d1044aa1645876116124b2d5c5c4c2d7bc151750 100644 --- a/docs/nodes/modifier_make/unsubdivide.rst +++ b/docs/nodes/modifier_make/unsubdivide.rst @@ -1,9 +1,24 @@ Unsubdivide node ================ +.. image:: https://user-images.githubusercontent.com/14288520/200894325-805455f6-8493-430b-a772-ff91564802b5.png + :target: https://user-images.githubusercontent.com/14288520/200894325-805455f6-8493-430b-a772-ff91564802b5.png + Functionality ------------- +Reduce detail in geometry containing grids. + +See also +-------- + +Blender doc: https://docs.blender.org/api/current/bmesh.ops.html#bmesh.ops.unsubdivide + Example of usage ---------------- -.. image:: https://user-images.githubusercontent.com/22656834/38300761-17c6615a-3817-11e8-8c8b-e94f1d62cc5a.png + +.. image:: https://user-images.githubusercontent.com/14288520/200895518-6d0e8f21-e327-4b9d-8555-57629bb10d0d.png + :target: https://user-images.githubusercontent.com/14288520/200895518-6d0e8f21-e327-4b9d-8555-57629bb10d0d.png + +* Generator-> :doc:`Box ` +* Viz-> :doc:`Viewer Draw ` \ No newline at end of file diff --git a/docs/nodes/modifier_make/uv_connect.rst b/docs/nodes/modifier_make/uv_connect.rst index 03e068c2604890766b33505aa9f28c2d046fe38b..d335adcda691e5750b40e23ca8227236ca9e740d 100644 --- a/docs/nodes/modifier_make/uv_connect.rst +++ b/docs/nodes/modifier_make/uv_connect.rst @@ -1,6 +1,9 @@ UV Connection ============= +.. image:: https://user-images.githubusercontent.com/14288520/200192031-e5ca76be-9456-462c-b075-c9f248daf2aa.png + :target: https://user-images.githubusercontent.com/14288520/200192031-e5ca76be-9456-462c-b075-c9f248daf2aa.png + Functionality ------------- diff --git a/docs/nodes/modifier_make/wireframe.rst b/docs/nodes/modifier_make/wireframe.rst index 9e96120f3a3fea99faa898254ca805b7bcb1ec6b..c6cd08fbafd917bf867d1f97c66cb0b10bdd9700 100644 --- a/docs/nodes/modifier_make/wireframe.rst +++ b/docs/nodes/modifier_make/wireframe.rst @@ -1,2 +1,16 @@ Wireframe -========= \ No newline at end of file +========= + +.. image:: https://user-images.githubusercontent.com/14288520/201467891-274ae39e-3fdb-4c5b-899a-82bacbb426aa.png + :target: https://user-images.githubusercontent.com/14288520/201467891-274ae39e-3fdb-4c5b-899a-82bacbb426aa.png + +Functionality +------------- + +The Wireframe node transforms a mesh into a wireframe by iterating over its faces, collecting all edges and +turning those edges into four-sided polygons. Be aware of the fact that your mesh needs to have faces to be wireframed. + +.. image:: https://user-images.githubusercontent.com/14288520/201468102-88563b81-1c20-469a-b7f5-77e8efdece71.png + :target: https://user-images.githubusercontent.com/14288520/201468102-88563b81-1c20-469a-b7f5-77e8efdece71.png + +See: https://docs.blender.org/manual/en/latest/modeling/modifiers/generate/wireframe.html \ No newline at end of file diff --git a/docs/nodes/transforms/align_mesh_by_mesh.rst b/docs/nodes/transforms/align_mesh_by_mesh.rst index af81dc1e03fc9cfa6ca05201da49464bc3f2174d..08d9c2804bb51c9bdd4378a007244a4467b4e45c 100644 --- a/docs/nodes/transforms/align_mesh_by_mesh.rst +++ b/docs/nodes/transforms/align_mesh_by_mesh.rst @@ -77,7 +77,7 @@ Examples :target: https://user-images.githubusercontent.com/28003269/59979724-514feb00-95fc-11e9-9f59-cbf2df8832c7.png * Transform-> :doc:`Move ` -* Modifier->Modifier Change-> :doc:`Delete Loose ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` * ADD: Vector-> :doc:`Vector Math ` * List->List Struct-> :doc:`List Item ` * Scene-> :doc:`Objects In Lite ` diff --git a/docs/nodes/transforms/barycentric_transform.rst b/docs/nodes/transforms/barycentric_transform.rst index 2b05dbdd7ac5698a96754df82bb08379e24a4859..d3596105e0dd9f9e075680ed26d57e38a766723f 100644 --- a/docs/nodes/transforms/barycentric_transform.rst +++ b/docs/nodes/transforms/barycentric_transform.rst @@ -60,7 +60,7 @@ The node can be used to place geometry over triangular faces. * Generator-> :doc:`IcoSphere ` * Transform-> :doc:`Rotate ` * Transform-> :doc:`Move ` -* Modifier->Modifier Change-> :doc:`Polygon Boom ` +* Modifiers->Modifier Change-> :doc:`Polygon Boom ` * Vector-> :doc:`Vector In ` * Viz-> :doc:`Viewer Draw ` @@ -74,7 +74,7 @@ The List Match option can offer different output combinations, in this case Cycl * Generator-> :doc:`Circle ` * Generator-> :doc:`IcoSphere ` * Number-> :doc:`Number Range ` -* Modifier->Modifier Change-> :doc:`Polygon Boom ` +* Modifiers->Modifier Change-> :doc:`Polygon Boom ` * Viz-> :doc:`Viewer Draw ` * Text-> :doc:`Stethoscope ` @@ -88,7 +88,7 @@ Custom triangular Tessellation in this case Cyclic is used to alternate between * Generator-> :doc:`Circle ` * Generator->Generator Extended-> :doc:`Polygon Grid ` * Transform-> :doc:`Rotate ` -* Modifier->Modifier Change-> :doc:`Polygon Boom ` +* Modifiers->Modifier Change-> :doc:`Polygon Boom ` * Number-> :doc:`List Input ` * Vector-> :doc:`Vector In ` * Matrix-> :doc:`Matrix In ` diff --git a/docs/nodes/transforms/transform_select.rst b/docs/nodes/transforms/transform_select.rst index 473a21886fd1a1cdc546ec9f7c53a1bd2fa696d7..22578e6984095f03ec4c252c331467fd24cc6438 100644 --- a/docs/nodes/transforms/transform_select.rst +++ b/docs/nodes/transforms/transform_select.rst @@ -55,7 +55,7 @@ Examples of usage * Generator-> :doc:`Circle ` * Transform-> :doc:`Matrix Apply (verts) ` -* Modifier->Modifier Change-> :doc:`Mesh Join ` +* Modifiers->Modifier Change-> :doc:`Mesh Join ` * Number-> :doc:`List Input ` * Number-> :doc:`Number Range ` * Vector-> :doc:`Vector In ` diff --git a/docs/nodes/vector/attractor.rst b/docs/nodes/vector/attractor.rst index 0f40df1ed41c915e6850fe7c504394a825f1b9f6..3c4d2e2eb647f960f1da1a367d43c9a4d3764dc5 100644 --- a/docs/nodes/vector/attractor.rst +++ b/docs/nodes/vector/attractor.rst @@ -45,33 +45,46 @@ This node has the following parameters: this line (**Center** input) and directing vector (**Direction** input). - **Plane**. Attractor is a plane, defined by a point belonging to this line (**Center** input) and normal vector (**Direction** input). + +.. image:: https://user-images.githubusercontent.com/14288520/200179955-7dfe5db7-5c36-4d3a-b27e-f42f89b6850a.png + :target: https://user-images.githubusercontent.com/14288520/200179955-7dfe5db7-5c36-4d3a-b27e-f42f89b6850a.png + - **Points mode**. This defines how attraction vectors are calculated in case several points are provided as attraction centers. The available modes are: - **Average**. Attracting force for each vertex will be calculated as average of attracting forces towards each attractor point. - - **Nearest**. Attracting force for each vertex will be calculated as the - attracting force towards the nearest of attractor points. + - **Nearest**. Attracting force for each vertex will be calculated as the attracting force towards the nearest of attractor points. The default mode is **Average** (which is more physically correct). This parameter is available only if **Attractor type** parameter is set to **Point**. + +.. image:: https://user-images.githubusercontent.com/14288520/200180797-4ac81fe7-6a59-445a-837e-5b5ac8181541.png + :target: https://user-images.githubusercontent.com/14288520/200180797-4ac81fe7-6a59-445a-837e-5b5ac8181541.png + - **Falloff type**. Used falloff law. Available values are: - **Inverse**. Falloff law is 1/R, where R is distance from vertex to attractor. - - **Inverse square**. Falloff law is 1/R^2. This law is most common in - physics (gravity and electromagnetizm), so this is the default value. - + - **Inverse square**. Falloff law is 1/R^2. This law is most common in physics (gravity and electromagnetizm), so this is the default value. - **Inverse cubic**. Falloff law is 1/R^3. - - **Inverse exponent**. Falloff law is `exp(- C * R)`, where R is distance - from vertex to attractor, and C is value from **Coefficient** input. - - **Gauss**. Falloff law is `exp(- C * R^2 / 2)`, where R is distance from - vertex to attractor, and C is value from **Coefficient** input. + - **Inverse exponent**. Falloff law is `exp(- C * R)`, where R is distance from vertex to attractor, and C is value from **Coefficient** input. + - **Gauss**. Falloff law is `exp(- C * R^2 / 2)`, where R is distance fromcvertex to attractor, and C is value from **Coefficient** input. + +.. image:: https://user-images.githubusercontent.com/14288520/200181691-32baefab-07c5-4117-b2b6-72ebc276f62b.png + :target: https://user-images.githubusercontent.com/14288520/200181691-32baefab-07c5-4117-b2b6-72ebc276f62b.png + - **Clamp**. Whether to restrict output vector length with distance from vertex to attractor. If not checked, then attraction vector length can be very big for vertices close to attractor, depending on selected falloff type. Default value is True. +.. image:: https://user-images.githubusercontent.com/14288520/200178995-517be50c-12bb-4e28-8188-66d608dba774.png + :target: https://user-images.githubusercontent.com/14288520/200178995-517be50c-12bb-4e28-8188-66d608dba774.png + +.. image:: https://user-images.githubusercontent.com/14288520/200178869-bb8de78b-861f-4073-8e1d-13f56e8c6561.png + :target: https://user-images.githubusercontent.com/14288520/200178869-bb8de78b-861f-4073-8e1d-13f56e8c6561.png + Outputs ------- @@ -81,6 +94,11 @@ This node has the following outputs: - **Directions**. Unit vectors in the same directions as attracting force. - **Coeffs**. Lengths of calculated attraction force vectors. +See also +-------- + +* Analyzers-> :doc:`Proportional Edit Falloff ` + Examples of usage ----------------- @@ -122,7 +140,7 @@ Coefficients can be used without directions: * Generator-> :doc:`Plane ` * Vector-> :doc:`Vector In ` * Analyzers-> :doc:`Component Analyzer ` -* Modifier->Modifier Change-> :doc:`Extrude Separate Faces ` +* Modifiers->Modifier Change-> :doc:`Extrude Separate Faces ` Torus attracted by a line along X axis: diff --git a/docs/nodes/vector/drop.rst b/docs/nodes/vector/drop.rst index f7c72c288d49aee6ff0d85d578dc4e159b0a31e3..f45e8502126d19de691b3147fc63db440d21ecef 100644 --- a/docs/nodes/vector/drop.rst +++ b/docs/nodes/vector/drop.rst @@ -33,7 +33,7 @@ Examples * Generator-> :doc:`Box ` * Generator-> :doc:`Plane ` * Analyzers-> :doc:`Component Analyzer ` -* Modifier->Modifier Change-> :doc:`Polygon Boom ` +* Modifiers->Modifier Change-> :doc:`Polygon Boom ` * Matrix-> :doc:`Matrix In ` * List->List Main-> :doc:`List Length ` * List->List Struct-> :doc:`List Length ` diff --git a/docs/nodes/vector/noise_mk3.rst b/docs/nodes/vector/noise_mk3.rst index 8f463e18491615303cc51b54a6d7c8284df66af5..2feb474561f6b15cee73b491560f5fa652e17f27 100644 --- a/docs/nodes/vector/noise_mk3.rst +++ b/docs/nodes/vector/noise_mk3.rst @@ -90,7 +90,7 @@ Using noise to mask a mesh :target: https://user-images.githubusercontent.com/14288520/189533504-00a43a7f-3d60-4739-92d4-e5225dc4c779.png * Generator-> :doc:`Plane ` -* Modifier->Modifier Change-> :doc:`Mask Vertices ` +* Modifiers->Modifier Change-> :doc:`Mask Vertices ` * Selected Statistics: List->List Main-> :doc:`List Statistics ` * BIG: Logic-> :doc:`Logic Functions ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/vector/vertices_sort.rst b/docs/nodes/vector/vertices_sort.rst index 041249190ae38c4a5586b74654944487ac8a2943..932ddffc7c17c4bcd2c9c7d03d9325187e68ac51 100644 --- a/docs/nodes/vector/vertices_sort.rst +++ b/docs/nodes/vector/vertices_sort.rst @@ -109,7 +109,7 @@ Example used to sort the vertices after the *Mesh Filter* node * Generator-> :doc:`Plane ` * Analyzer-> :doc:`Mesh Filter ` -* Modifier->Modifier Change-> :doc:`Delete Loose ` +* Modifiers->Modifier Change-> :doc:`Delete Loose ` * Modifiers->Modifier Make-> :doc:`UV Connection ` * Viz-> :doc:`Viewer Draw ` diff --git a/docs/nodes/viz/viewer_draw_mk4.rst b/docs/nodes/viz/viewer_draw_mk4.rst index da4c0393e901cd0d96d3ab68ba1d5163e6c9c003..41e06e8a3bfd171549ec05adcb383cd72ddd96e7 100644 --- a/docs/nodes/viz/viewer_draw_mk4.rst +++ b/docs/nodes/viz/viewer_draw_mk4.rst @@ -4,8 +4,8 @@ Viewer Draw .. image:: https://user-images.githubusercontent.com/14288520/189978461-92a31395-6702-4623-8904-952b96f4d8d3.png :target: https://user-images.githubusercontent.com/14288520/189978461-92a31395-6702-4623-8904-952b96f4d8d3.png -.. image:: https://user-images.githubusercontent.com/14288520/190861303-a38c5dc0-d8c8-47b8-ac19-d824c7709021.png - :target: https://user-images.githubusercontent.com/14288520/190861303-a38c5dc0-d8c8-47b8-ac19-d824c7709021.png +.. image:: https://user-images.githubusercontent.com/14288520/201473680-b993c305-99b4-4eea-8af4-93baf8a7329b.png + :target: https://user-images.githubusercontent.com/14288520/201473680-b993c305-99b4-4eea-8af4-93baf8a7329b.png Functionality ------------- diff --git a/nodes/modifier_change/opensubdivision.py b/nodes/modifier_change/opensubdivision.py index dadecbad5c980730faea73e5cd484845f614aec8..c269f7712eff9edb88c06fda472873db6512861d 100755 --- a/nodes/modifier_change/opensubdivision.py +++ b/nodes/modifier_change/opensubdivision.py @@ -58,7 +58,7 @@ class SvOpenSubdivisionNode(bpy.types.Node,SverchCustomTreeNode): socket = self.inputs.new('SvStringsSocket', "Levels") socket.use_prop=True socket.default_property_type = 'int' - socket.default_int_property = 0 + socket.default_int_property = 0 # socket.int_range = (0,self.maxSubdivision) # There's no way to visually limit the subdivision levels (it's handled internally), but something like this would be nice in the future. self.outputs.new('SvVerticesSocket', "Vertices") diff --git a/nodes/modifier_change/subdivide_mk2.py b/nodes/modifier_change/subdivide_mk2.py index 41daada68b62b391b097c157341785535129834e..50a5833f0a0d404662d7c62f53f713f638cc0467 100644 --- a/nodes/modifier_change/subdivide_mk2.py +++ b/nodes/modifier_change/subdivide_mk2.py @@ -80,7 +80,7 @@ class SvSubdivideNodeMK2( updateNode(self, context) - falloff_type: EnumProperty(name="Falloff", items=falloff_types, default="LINEAR", update=updateNode) + falloff_type: EnumProperty(name="Falloff", items=falloff_types, default="LINEAR", update=updateNode, description="Smooth falloff type") corner_type: EnumProperty(name="Corner Cut Type", items=corner_types, default="INNER_VERT", update=updateNode) cuts: IntProperty( @@ -108,11 +108,11 @@ class SvSubdivideNodeMK2( name="Seed", default=0, update=updateNode) grid_fill: BoolProperty( - description="fill in fully-selected faces with a grid", + description="Fill in fully-selected faces with a grid (only quads). No effect if edges of quad not selected", name="Grid fill", default=True, update=updateNode) single_edge: BoolProperty( - description="tessellate the case of one edge selected in a quad or triangle", + description="Tessellate the case of one edge selected in a quad or triangle", name="Single edge", default=False, update=updateNode) only_quads: BoolProperty( diff --git a/nodes/modifier_make/adaptive_polygons_mk3.py b/nodes/modifier_make/adaptive_polygons_mk3.py index 271f955ee05817a685306891fd10df0efd3d635e..11843a051ca3b7d4790fd5c72e11ba8b318758b6 100644 --- a/nodes/modifier_make/adaptive_polygons_mk3.py +++ b/nodes/modifier_make/adaptive_polygons_mk3.py @@ -301,10 +301,12 @@ class SvAdaptivePolygonsNodeMk3(ModifierNode, SverchCustomTreeNode, bpy.types.No z_coef: FloatProperty( name='Z coeff', + description="Coefficient for donor object size along recipient object face normal", default=1.0, max=3.0, min=0.0, update=updateNode) z_offset: FloatProperty( name="Z offset", + description="Offset of donor objects along the normal of recipient object face", default=0.0, update=updateNode) diff --git a/nodes/modifier_make/bevel_curve.py b/nodes/modifier_make/bevel_curve.py index 6c23aeba5b8f03808c7a59ff05e7ca2ec96948f6..5b3113d889b778bb0cf781993aa29c7533b29a94 100644 --- a/nodes/modifier_make/bevel_curve.py +++ b/nodes/modifier_make/bevel_curve.py @@ -104,7 +104,7 @@ class SvBevelCurveNode(ModifierNode, SverchCustomTreeNode, bpy.types.Node): update = updateNode) tangent_precision: FloatProperty(name='Tangent precision', - description = "Step for tangents calculation. Lesser values correspond to better precision.", + description = "Step for tangents calculation. Lesser values correspond to better precision", default = 0.001, min=0.000001, max=0.1, precision=8, update=updateNode) diff --git a/nodes/modifier_make/contour2D.py b/nodes/modifier_make/contour2D.py index 7092ef852b1dac218ce7d159ffc8ae6872cc0f6b..c0a573d5df647531e030ce297326217329bb484e 100644 --- a/nodes/modifier_make/contour2D.py +++ b/nodes/modifier_make/contour2D.py @@ -455,7 +455,7 @@ class SvContourNode(ModifierLiteNode, SverchCustomTreeNode, bpy.types.Node): intersecction_handle: EnumProperty( name="intersecction_handle", - description="Intersecction mode", + description="Intersection mode", items=intersec_mode_items, default="Circular", update=updateNode) diff --git a/nodes/modifier_make/fractal_curve.py b/nodes/modifier_make/fractal_curve.py index 800b319f8bbaef058cba061a656f343b62038fdd..e16610ee7d01a1633794015f4297617ce6ed1338 100644 --- a/nodes/modifier_make/fractal_curve.py +++ b/nodes/modifier_make/fractal_curve.py @@ -47,7 +47,7 @@ class SvFractalCurveNode(ModifierNode, SverchCustomTreeNode, bpy.types.Node): precision : IntProperty( name="Precision", min=0, max=10, default=7, update=updateNode, - description="decimal precision of coordinates for calculations") + description="Decimal precision of coordinates for calculations") def move_to(self, curve, src, dst): vector = dst - src diff --git a/nodes/modifier_make/offset_line.py b/nodes/modifier_make/offset_line.py index 7a7f56ba85bf1349cbcd229528831851be684200..6bd733b7a1bdc7738019c8c8e5589e34338247ef 100644 --- a/nodes/modifier_make/offset_line.py +++ b/nodes/modifier_make/offset_line.py @@ -195,7 +195,7 @@ class SvOffsetLineNode(EdgeGeneratorLiteNode, SverchCustomTreeNode, bpy.types.No sv_icon = 'SV_OFFSET_LINE' offset: FloatProperty( - name='offset', description='distance of offset', + name='offset', description='Distance of offset (greater than zero. Zero will be replaced by 0.001)', default=0.1, update=updateNode) def sv_init(self, context): diff --git a/nodes/modifier_make/solidify_mk2.py b/nodes/modifier_make/solidify_mk2.py index 66807d93c61ded82cc87d26c3ce312ba6b7a6cbd..282327969b6dcef9cbc223ee718c5b8145b1c954 100644 --- a/nodes/modifier_make/solidify_mk2.py +++ b/nodes/modifier_make/solidify_mk2.py @@ -157,10 +157,10 @@ class SvSolidifyNodeMk2(ModifierNode, SverchCustomTreeNode, bpy.types.Node): bl_icon = 'MOD_SOLIDIFY' thickness: FloatProperty( - name='Thickness', description='Shell thickness', + name='Thickness', description='Shell thickness (distance to extrude)', default=0.1, update=updateNode) offset: FloatProperty( - name='Offset', description='Offset Thickness from center', + name='Offset', description='Relative offset from original mesh', default=1, soft_min=-1, soft_max=1, update=updateNode) even: BoolProperty( name='Even Thickness', description='Mantain Thinkness by adjusting sharp corners', diff --git a/nodes/modifier_make/subdivide_lite.py b/nodes/modifier_make/subdivide_lite.py index 123ec8a9af6106cf8855539adeed9d6e7ed1cfb2..8c1dbc915613998b2819a7689d882688bf8b5423 100644 --- a/nodes/modifier_make/subdivide_lite.py +++ b/nodes/modifier_make/subdivide_lite.py @@ -94,19 +94,19 @@ class SvSubdivideLiteNode(ModifierNode, SverchCustomTreeNode, bpy.types.Node): default=0, update=updateNode) grid_fill: BoolProperty(name="Grid fill", - description="fill in fully-selected faces with a grid", + description="Fill in fully-selected faces with a grid", default=True, update=updateNode) single_edge: BoolProperty(name="Single edge", - description="tessellate the case of one edge selected in a quad or triangle", + description="Tessellate the case of one edge selected in a quad or triangle", default=False, update=updateNode) only_quads: BoolProperty(name="Only Quads", - description="only subdivide quads (for loopcut)", + description="Only subdivide quads (for loopcut)", default=False, update=updateNode) smooth_even: BoolProperty(name="Even smooth", - description="maintain even offset when smoothing", + description="Maintain even offset when smoothing", default=False, update=updateNode) show_new: BoolProperty(name="Show New", diff --git a/nodes/modifier_make/unsubdivide.py b/nodes/modifier_make/unsubdivide.py index 2f492cf99029a34a67042173bbd194f3f24dbf61..01d4a502fd59a40ad990bb970140e5ad7ca9709d 100644 --- a/nodes/modifier_make/unsubdivide.py +++ b/nodes/modifier_make/unsubdivide.py @@ -36,7 +36,7 @@ class SvUnsubdivideNode(ModifierNode, SverchCustomTreeNode, bpy.types.Node): def update_sockets(self, context): self.inputs['bmesh_list'].hide_safe = not self.show_bmesh_list self.outputs['bmesh_list'].hide_safe = not self.show_bmesh_list - iter: IntProperty(name='Iterations', default=1, min=1, update=updateNode) + iter: IntProperty(name='Iterations', default=1, min=1, description="Number of times to unsubdivide", update=updateNode) show_bmesh_list: BoolProperty(name='Show bmesh socket', default=False, update=updateNode) diff --git a/nodes/modifier_make/uv_connect.py b/nodes/modifier_make/uv_connect.py index e3aeab913bc65edf216493144e1ddec4c3b201ac..66b496c36b65d996a320e328b5d130af5db7bae1 100644 --- a/nodes/modifier_make/uv_connect.py +++ b/nodes/modifier_make/uv_connect.py @@ -51,7 +51,7 @@ class LineConnectNodeMK2(ModifierNode, SverchCustomTreeNode, bpy.types.Node): cicl_check_V: BoolProperty(name='cycleV', description='cycle V', default=False, update=updateNode) cap_U: BoolProperty(name='capU', description='cap U', default=False, update=updateNode) cap_V: BoolProperty(name='capV', description='cap V', default=False, update=updateNode) - slice_check: BoolProperty(name='slice', description='slice polygon', default=True, update=updateNode) + slice_check: BoolProperty(name='slice', description='Slice polygon', default=True, update=updateNode) def sv_init(self, context): self.inputs.new('SvVerticesSocket', 'vertices') diff --git a/nodes/modifier_make/wireframe.py b/nodes/modifier_make/wireframe.py index 1df5b5b964ce1d2d2010fa985b5a9c14b13d2609..1428d5b89038b61229ef8a557d26d07089880364 100644 --- a/nodes/modifier_make/wireframe.py +++ b/nodes/modifier_make/wireframe.py @@ -53,7 +53,7 @@ class SvWireframeNode(ModifierNode, SverchCustomTreeNode, bpy.types.Node): bl_icon = 'MOD_WIREFRAME' thickness: FloatProperty( - name='thickness', description='thickness', + name='thickness', description='The depth or size of the wireframes', default=0.01, min=0.0, update=updateNode) offset: FloatProperty( @@ -61,19 +61,19 @@ class SvWireframeNode(ModifierNode, SverchCustomTreeNode, bpy.types.Node): default=0.01, min=0.0, update=updateNode) replace: BoolProperty( - name='replace', description='replace', + name='replace', description='Replace original', default=True, update=updateNode) even_offset: BoolProperty( - name='even_offset', description='even_offset', + name='even_offset', description='Maintain thickness by adjusting for sharp corners', default=True, update=updateNode) relative_offset: BoolProperty( - name='relative_offset', description='even_offset', + name='relative_offset', description='Longer edges will be thicker', default=False, update=updateNode) boundary: BoolProperty( - name='boundary', description='boundry', + name='boundary', description='Creates wireframes on mesh island boundaries', default=True, update=updateNode) def sv_init(self, context):