Attributes

Un attribut est un terme générique pour décrire les données stockées par-élément dans un bloc de données de géométrie. Par exemple, chaque sommet peut avoir un nombre ou un vecteur associé. Les attributs peuvent être modifiés par les nœuds de la catégorie Group Output (Groupe de sortie), mais certains autres nœuds peuvent également modifier les valeurs d’attributs spécifiques.

Note

Les types de données d’attribut et de domaines sont convertis implicitement lorsque cela est possible, tout comme les sockets de nœuds.

Attributs nommés

Named attributes are created and used in other areas of Blender like shaders, painting, and UV mapping. In the modifier panel, a named attribute can be used for input by clicking the icon to the left of the value button. The string input input allows you to search and choose existing attributes from the modifier’s input geometry.

../../_images/modeling_geometry-nodes_attribute-reference_search.png — Recherche d’Attribut.

La recherche d’attribut donne un peu de contexte sur chaque attribut. À gauche du menu, le domaine d’attribut est affiché suivi du nom de l’attribut. À droite du menu, le type de données d’attribut est affiché.

Attributs anonymes

../../_images/modeling_geometry-nodes_attribute-reference_attribute-field.png — Les sorties *Normal* et *Rotation* sont des exemples de champs d’attribut, qui font référence à un attribut stocké sur une géométrie.

Un attribut anonyme est un ensemble de données génériques stockées sur une géométrie qui n’a pas de nom. Habituellement, les attributs exposés dans l’interface de Blender ont tous des noms. Cependant, dans les nœuds de géométrie, les attributs peuvent être transmis avec des sockets de nœud. Dans ces cas, une sortie Attribute Field est créée, qui est utilisée par les nœuds pour rechercher des données d’attribut dans une géométrie d’entrée.

Anonymous attributes are still stored on the geometry like other attributes, and they are even automatically interpolated when the geometry changes with other nodes, except for a few cases. So generally, if the node link is still accessible, the attribute it references will be too. However, anonymous attributes cannot be connected to a completely separate geometry that was not created from their source. To transfer attributes between separate geometries, the Transfer Attribute Node can be used.

Les types de données d’attribut

Le type d’un attribut est le type des données stockées dans chaque élément.

Boolean

True or false value

Integer

Entier - 32 bits

8-Bit Integer

Smaller integer with a range from -128 to 127

Float

Valeur à virgule flottante

Vecteur

Vecteur 3D avec des valeurs à virgule flottante

2D Vector

2D vector with floating-point values

Color

RGBA color with 32-bit floating-point values

Byte Color

RGBA color with 8-bit positive integer values

La liste ci-dessus est dans l’ordre du moins au plus “complexe” (Un entier peut contenir plus de données qu’un booléen, c’est donc plus compliqué). Lorsque vous joignez des géométries distinctes, le type de données le plus complexe est préféré lorsqu’il existe des noms correspondants. C’est particulièrement important lors de la jointure d’une géométrie avec des attributs nommés avec le Nœud Join Geometry

Domaines d’attribut

Le domaine d’un attribut fait référence au type d’élément géométrique auquel l’attribut correspond. Connaître le domaine d’un attribut est important car il définit comment il peut être interpolé et utilisé dans les nœuds et l’ombrage. Vous pouvez utiliser Spreadsheet Editor pour déterminer les domaines d’attributs.

Les attributs de domaine Point sont associés à des emplacements uniques dans l’espace avec une position :
- Les sommets d’un maillage
- Les points d’un nuage de points
- Les points de contrôle d’une courbe
Les attributs du domaine Edge sont associés aux arêtes d’un maillage.
Les attributs du domaine Face sont associés aux faces d’un maillage.
Les attributs du domaine Face Corner sont associés aux coins des faces du maillage. Un exemple est un attribut UVMap.
Les Edge domain attributes sont associés aux arêtes du maillage.Les attributs de domaine Spline sont associés à un groupe de points de contrôle de courbe connectés.
Les attributs de domaine Instance existent sur les Instances d’une géométrie. Ils peuvent être utilisés pour stocker différentes valeurs sur des copies de données géométriques. Les attributs de domaine d’instance sont uniquement pris en charge dans les nœuds de géométrie.

Attributes are automatically interpolated to other domains. For example, when the Nœud Position is connected to the selection input of the Nœud Set Material node, the values are interpolated from the Point domain to the Face domain. Normally, domain conversions use simple averages for values, but Boolean data type attributes have special rules for interpolation:

Interpolation de domaine booléen

Depuis	Vers	Conversion
Point	Edge	Une arête est sélectionnée si ses deux sommets ont été sélectionnés.
Point	Face	Une face est sélectionnée si tous ses sommets ont également été sélectionnés.
Point	Corner	La valeur de chaque coin est simplement une copie de la valeur à son sommet.
Point	Spline	Une spline est sélectionnée si tous ses points de contrôle ont été sélectionnés.

Edge	Point	Un sommet est sélectionné si une arête connectée a été sélectionnée.
Edge	Face	Une face est sélectionnée si toutes ses arêtes sont sélectionnées
Edge	Corner	Un coin est sélectionné si ses deux arêtes adjacentes ont été sélectionnées.

Face	Point	Un sommet est sélectionné si l’une des faces connectées a été sélectionnée.
Face	Edge	Une arête est sélectionnée si une face connectée a été sélectionnée.
Face	Corner	La valeur de chaque coin est simplement une copie de la valeur à sa face.

Corner	Point	Un sommet est sélectionné si tous les coins de face connectés ont été sélectionnés et qu’il ne s’agit pas d’un sommet isolé.
Corner	Edge	Une arête est sélectionnée si tous les coins des faces adjacentes ont été sélectionnés.
Corner	Face	Une face est sélectionnée si tous ses coins ont été sélectionnés.

Spline	Point	La valeur de chaque point est simplement une copie de la valeur correspondante de la spline.

Attributs intégrés

Les attributs intégrés (built-in attributes) existent toujours et ne peuvent pas être supprimés. Leur type de données et leur domaine ne peuvent pas être modifiés.

Name	Type	Domaine	Notes
`position`	Vector	Point	Built-in attribute describing vertex or point locations, in the local space of a geometry. Any node that changes the location of points will adjust this attribute, like the Transform and Set Position nodes.
`radius`	Float	Point	Un attribut intégré sur les nuages de points utilisé pour définir la taille des points dans la fenêtre. Également intégré sur les courbes, où il contrôle la taille de chaque point de contrôle de la courbe lorsqu’elle est convertie en maillage ou pour d’autres opérations.
`id`	Integer	Point	Créé par le Nœud Distribute Points on Faces pour assurer la stabilité lorsque la forme du maillage d’entrée change, et utilisé sur les instances pour créer un flou de mouvement. Les valeurs sont censées être importantes, sans ordre. Cet attribut est utilisé par les nœuds qui génèrent de l’aléatoire, comme le Nœud Random Value. Contrairement à d’autres attributs intégrés, cet attribut n’est pas obligatoire et peut être supprimé si nécessaire.
`material_index`	Integer	Face	Utilisé pour spécifier le slot de matériau pour chaque face d’un maillage.
`crease`	Float	Edge	Edge attribute used by the Subdivision Surface modifier. The values are limited to a range of 0 and 1.
`shade_smooth`	Booléen	Face	Attribute determining if a face should have smooth shading enabled in the viewport or a render.
`resolution`	Integer	Spline	Détermine le nombre de points évalués entre deux points de contrôle d’une spline. Seules les splines NURBS et Bézier ont cet attribut, pour les poly splines, la valeur est toujours un.
`cyclic`	Booléen	Spline	Détermine si la spline a un segment qui relie son premier et son dernier points de contrôle.
`handle_left`	Vector	Point	Décrit l’emplacement de la poignée gauche d’un point de contrôle de courbe, du côté du début de la courbe. N’existe que lorsque la courbe contient une spline de Bézier.
`handle_right`	Vector	Point	Décrit l’emplacement de la poignée droite d’un point de contrôle de courbe, sur le côté de l’extrémité de la courbe. N’existe que lorsque la courbe contient une spline de Bézier.

Conventions de nommage

Ces attributs n’existent pas par défaut, mais sont utilisés implicitement par certaines parties de Blender. Le type de données de ces attributs peut être modifié, tout comme n’importe quel attribut en plus des attributs intégrés. Cependant, Blender peut s’attendre à ce que les attributs aient un certain type.

Name	Type	Notes
`velocity`	Vector	Utilisé pour créer un flou de mouvement lors du rendu des animations.

Attributs personnalisés

Les groupes de sommets, les cartes UV et les attributs de couleur sont disponibles en tant qu’attributs dans les nœuds de géométrie. Ils sont désignés par leur nom. Les collisions de noms (par exemple, un groupe de sommets et une carte UV avec le même nom) doivent être évitées. En cas de collision de noms, un seul des attributs est accessible dans les nœuds géométriques.

Des attributs avec n’importe quel autre nom peuvent également être créés par des nœuds, lorsque le nom est utilisé pour la première fois.

Notez que les nœuds géométriques ne produisent pas toujours par ex. groupes de sommets si un nœud tel que Join Geometry est utilisé. De même, si le type de données d’un attribut de groupe de sommets est modifié par rapport au type “Float” initial, l’attribut ne sera plus un groupe de sommets.

Opérateur de conversion d’attribut

../../_images/modeling_geometry-nodes_attribute-reference_convert.png

Cet opérateur présent dans le panneau Attributes de l’éditeur de propriétés peut modifier le domaine ou le type de données d’un attribut.

Due to ongoing development in the area of attributes, many areas of Blender can not yet work with the generic (identified with a name, stored on any domain with any data type)attributes used by geometry nodes. That makes this operator an essential workaround in some cases where existing tools must be used with data generated from geometry nodes.

Mode

Generic: Interpole et convertit l’attribut entre les domaines et les types de données décrits sur cette page.
UV Map: Create a UV Map layer, editable in the UV editor. These would otherwise be represented by a 2D vector attribute on the face corner domain.
Vertex Group: Crée un Vertex Group à partir de l’attribut, qui correspond à un attribut flottant sur le domaine ponctuel.