Distribute Points on Faces¶
The Distribute Points on Faces node places points on the surface of the input geometry object. Point, corner, and polygon attributes of the input geometry are transferred to the generated points. That includes vertex weights and UV maps. Additionally, the node has Normal and Rotation outputs.
The node also generates a stable ID, stored in the built-in id
attribute, used as
a stable identifier for each point. When the mesh is deformed or the density changes
the values will be consistent for each remaining point. This attribute is used in
the Random Value and
Instance on Points nodes.
Inputs¶
- Mesh
Entrada padrão de geometria.
Nota
A geometria de entrada precisa conter uma malha com faces.
- Seleção
The selection of which face corners should be considered for point distribution.
- Distance Min
The minimal distance points can have to each other. This option is only available for the Poisson Disk distribution method. At its default value of zero, the node’s behavior is the same as it is in Random mode, because none of the internally generated points are removed.
- Density Max
The point density for the point distribution. The unit is in number of points per square meter. This value is multiplied by the values from the Density input. Only available in Poisson Disk mode.
Nota
Isso será limitado em distribuições pela opção Distance Min. Se a densidade é maior que a distância mínima permite, novos pontos não serão adicionados depois que esse limiar for ultrapassado.
- Density
The number of points to distribute per square meter on each mesh face. This value is multiplied by the values from the Density Attribute.
In Poisson Disk mode, this value is multiplied by the Density Max input for the final density.
- Semente
A Seed aleatória para usar ao gerar pontos.
Properties¶
- Distribution Method
- Random:
Distribui pontos aleatoriamente na superfície. Esse é o método de distribuição mais rápido.
- Poisson Disk:
Distribui pontos aleatoriamente na superfície levando em conta uma distância mínima.
- Legacy Normal
By default, the node uses smooth and custom normals for the Normal and Rotation values . An earlier version of this node only uses «true» normals, this option brings back this behavior of only using «true» normals.
This option can only be available in the Sidebar.
Saídas¶
- Pontos
Generated points. Named attributes are copied to the result mesh, along with the data in the other attribute field outputs.
- Normal
A Normal do triângulo na qual cada ponto é espalhado.
- Rotação
An XYZ Euler rotation built from the normal attribute for convenience. Such a value can also be built from the normal with the Euler to Rotation Node. Keep in mind that the Z axis of the result rotation will be arbitrary, since the mesh normal used to create the rotation does not have enough information to set all three rotation axes.