Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Dupli instancer mk5 #4085

Merged
merged 2 commits into from
May 11, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 0 additions & 65 deletions docs/nodes/scene/dupli_instances_mk4.rst

This file was deleted.

3 changes: 1 addition & 2 deletions docs/nodes/scene/scene_index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,11 @@ Scene
objects_in_lite
FCurve_in
curve_in
dupli_instances_mk4
obj_remote_mk2
3dview_props
monad
collection_picker_mk1
particles_MK2
node_remote_mk2
selection_grabber_lite
timer
timer
80 changes: 80 additions & 0 deletions docs/nodes/viz/dupli_instances_mk5.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
Dupli Instances
===============

Functionality
-------------

This node exposes the Blender functionality of Instancing on object Vertices or Faces
to the Sverchok node tree being able to display many copies of the same object with a very
low memory impact.

The Node has to main modes Verts and Polys.
- In the **Verts** mode the instances will be placed at the inputted vertices.
- In the **Polys** mode the instances will be placed with a incoming list matrices,
being able to rotate and scale the instances.

Parameters & Features
---------------------

+-------------------+---------------------------------------------------------------------------------------+
| Param | Description |
+===================+=======================================================================================+
| Live | Processing only happens if *update* is ticked |
+-------------------+---------------------------------------------------------------------------------------+
| Hide View | Hides current meshes from view |
+-------------------+---------------------------------------------------------------------------------------+
| Hide Select | Disables the ability to select these meshes |
+-------------------+---------------------------------------------------------------------------------------+
| Hide Render | Disables the renderability of these meshes |
+-------------------+---------------------------------------------------------------------------------------+
| Base Name | Base name for Objects and Meshes made by this node |
+-------------------+---------------------------------------------------------------------------------------+
| Random name | Generates random name with random letters |
+-------------------+---------------------------------------------------------------------------------------+
| Select | Select every object in 3dview that was created by this Node |
+-------------------+---------------------------------------------------------------------------------------+
| Collection | Pick collection where to put objects |
+-------------------+---------------------------------------------------------------------------------------+
| Fast mesh update | It tries to update mesh in fast way. It can not update mesh at all in some corner |
| | cases. In case you notify some glitches in the mesh disable it (N-Panel) |
+-------------------+---------------------------------------------------------------------------------------+
| Show instancer | Show instancer geometry in viewport |
| in viewport | |
+-------------------+---------------------------------------------------------------------------------------+
| Show instancer | Show instancer geometry in render |
| in render | |
+-------------------+---------------------------------------------------------------------------------------+
| Show base child | Show base child geometry in viewport |
| in viewport | |
+-------------------+---------------------------------------------------------------------------------------+
| Scale Children | Scale children instances (only in Polys mode) |
+-------------------+---------------------------------------------------------------------------------------+
| Auto Release | Remove children not called by this node |
+-------------------+---------------------------------------------------------------------------------------+
| Clear Location | Clear base child location |
+-------------------+---------------------------------------------------------------------------------------+


Inputs
------

**Child**: Object(s) to instance.

**Vertices**: Location of instances.

**Matrices**: Matrices of the instances. (but scale is converted to uniform)


Limitations
-----------

It's worth mentioning that because the faces duplication relies on the area of the triangle to determine the scale, that the scale is a scalar, and therefor uniform (x,y,z are scaled equally).



Examples
--------

Setting 1.000.000 icospheres (whole node-tree update 0.069 secs)

.. image:: https://user-images.githubusercontent.com/10011941/117689137-c0fffc80-b1b9-11eb-9a00-2a57f7e49976.png
1 change: 1 addition & 0 deletions docs/nodes/viz/viz_index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,5 @@ Viz
light_viewer
vd_matrix
instancer
dupli_instances_mk5
polyline_viewer
5 changes: 3 additions & 2 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -587,7 +587,10 @@
SvMetaballOutNode
SvNurbsCurveOutNode
SvNurbsSurfaceOutNode
---
SvInstancerNodeMK3
SvDupliInstancesMK5
---
SvLightViewerNode
---
SvGreasePencilStrokes
Expand Down Expand Up @@ -641,8 +644,6 @@
---
SvFrameInfoNodeMK2
SvTimerNode
---
SvDupliInstancesMK4

## Objects
SvVertexGroupNodeMK2
Expand Down
Loading