Атрибуты

Атрибут — это общий термин для описания данных, хранящихся для каждого элемента в блоке данных геометрии. Например, каждая вершина может иметь связанное с ней число или вектор. Атрибуты можно изменить, подключив значение к узлу Group Output, но также многие узлы могут изменять значения определённых атрибутов.

Примечание

Типы данных атрибутов и домены преобразуются неявно, где это возможно, точно так же, как порты узлов.

Именованные атрибуты

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 right 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

Поиск по атрибуту.

Поиск по атрибуту даёт немного контекста о каждом атрибуте. Слева от меню отображается домен атрибута, за которым следует имя атрибута. Справа от меню отображается тип данных атрибута.

Анонимные атрибуты

../../_images/modeling_geometry-nodes_attribute-reference_attribute-field.png

Выходные порты Normal и Rotation являются примерами полей атрибутов, которые относятся к атрибуту, хранящемуся в геометрии.

Анонимный атрибут — это набор общих данных, хранящихся в геометрии, у которой нет имени. Обычно атрибуты, отображаемые в интерфейсе Blender, имеют имена. Однако в узлах геометрии атрибуты можно передавать с помощью портов узла. В этих случаях создается выходное поле Attribute Field, которое используется узлами для поиска данных атрибутов во входной геометрии.

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 available too. However, anonymous attributes cannot be connected to a completely separate geometry that was created from a different source. To transfer attributes between separate geometries, the Sample Index Node or other similar nodes like the Sample Nearest Surface Node can be used.

Типы данных атрибута

Тип атрибута — это тип данных, хранящихся в каждом элементе.

Boolean (Логический):

Значение True (правда) или false (ложь)

Integer:

32-битное целое (integer)

8-Bit Integer:

Smaller integer with a range from -128 to 127

Float:

Значение с плавающей запятой (float)

Vector:

3D вектор со значениями с плавающей запятой

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

Вышеприведенный список составлен в порядке от наименее к наиболее «сложному» (целое число может содержать больше данных, чем логическое, поэтому оно более сложное). При соединении отдельных геометрий предпочтительнее использовать более сложный тип данных, если есть совпадающие имена. Это особенно важно при соединении геометрии с именованными атрибутами с помощью Узел Join Geometry

To store 2D Vectors (UV maps) and Byte Colors the Store Named Attribute Node must be used because there are no sockets for those types.

Домены атрибутов

Домен атрибута относится к типу элемента геометрии, которому соответствует атрибут. Знание домена атрибута важно, потому что оно определяет, как его можно интерполировать и использовать в узлах и затенении. Вы можете использовать Редактор электронных таблиц для определения доменов атрибутов.

  • Point атрибуты связаны с отдельными местоположениями в пространстве с позицией:

    • Вершины сетки

    • Точки облака точек

    • Контрольные точки кривой

  • Edge атрибуты домена связаны с рёбрами сетки.

  • Face атрибуты связаны с гранями сетки.

  • Face Corner атрибуты домена связаны с углами граней сетки. Примером может служить атрибут UV-карты .

  • Spline атрибуты домена связаны с группой связанных контрольных точек кривой.

  • Instance атрибуты домена существуют в экземплярах (Instances (экземпляры)) геометрии. Их можно использовать для хранения различных значений копий геометрических данных. Атрибуты домена экземпляра поддерживаются только в узлах геометрии.

Attributes are automatically interpolated to other domains. For example, when the Узел Position (положение) is connected to the selection input of the Узел 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:

Логическая интерполяция домена

Из

В

Преобразование

Point (точка)

Edge (Ребро)

Ребро выбрано, если были выбраны обе его вершины.

Point (точка)

Face (Грань)

Грань выбрана, если все её вершины также были выбраны.

Point (точка)

Corner (угол)

Значение каждого угла — это просто копия значения в его вершине.

Point (точка)

Spline

Сплайн считается выбранным, если были выбраны все его контрольные точки.

Edge (Ребро)

Point (точка)

Вершина выбрана, если было выбрано любое связанное ребро.

Edge (Ребро)

Face (Грань)

Грань выбрана, если выбраны все её ребра

Edge (Ребро)

Corner (угол)

Угол выбран, если были выбраны два его соседних ребра.

Face (Грань)

Point (точка)

Вершина выбрана, если была выбрана любая из соединённых граней.

Face (Грань)

Edge (Ребро)

Ребро выбирается, если была выбрана какая-либо соединённая грань.

Face (Грань)

Corner (угол)

Значение каждого угла — это просто копия значения на его лицевой грани.

Corner (угол)

Point (точка)

Вершина выбрана, если были выбраны все соединённые углы граней и она не является свободной вершиной.

Corner (угол)

Edge (Ребро)

Ребро выбрано, если были выбраны все углы на соседних гранях.

Corner (угол)

Face (Грань)

Грань выбрана, если были выбраны все её углы.

Spline

Point (точка)

Значение каждой точки является просто копией соответствующего значения сплайна.

Встроенные атрибуты

Встроенные атрибуты существуют всегда и не могут быть удалены. Их тип данных и домен не могут быть изменены.

Name (имя)

Type

Domain

Примечания

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 Geometry Node and the Узел Set Position.

radius

Float

Point

Встроенный атрибут облака точек, используемый для установки размера точек в окне просмотра. Также встроен в кривые, где он управляет размером каждой контрольной точки кривой при преобразовании в сетку или для других операций.

id

Integer

Point

Создается с помощью Узел Distribute Points on Faces для обеспечения стабильности при изменении формы входной сетки и используется в экземплярах для создания размытия движения. Ожидается, что значения будут большими, без порядка. Этот атрибут используется узлами, генерирующими случайность, такими как Узел Random Value. В отличие от других встроенных атрибутов, этот атрибут не является обязательным и может быть удалён.

material_index

Integer

Face

Используется для указания слота материала для каждой грани в сетке.

crease

Float

Edge

Атрибут Edge, используемый модификатором Subdivision Surface. Значения ограничены диапазоном от 0 до 1.

shade_smooth

Boolean

Face

Attribute determining if a face should have smooth shading enabled in the viewport or a render.

resolution

Integer

Spline

Определяет количество оцениваемых точек между двумя контрольными точками сплайна. Только сплайны NURBS и Безье имеют этот атрибут, для полисплайнов значение всегда равно единице.

cyclic

Boolean

Spline

Определяет, есть ли у сплайна сегмент, соединяющий его первую и последнюю контрольные точки.

handle_left

Vector

Point

Описывает расположение левой ручки контрольной точки кривой со стороны начала кривой. Существует только тогда, когда кривая содержит сплайн Безье.

handle_right

Vector

Point

Описывает расположение правой ручки контрольной точки кривой со стороны конца кривой. Существует только тогда, когда кривая содержит сплайн Безье.

Соглашения именования

Эти атрибуты не существуют по умолчанию, но неявно используются некоторыми частями Blender. Тип данных этих атрибутов можно изменить, как и любой атрибут, кроме встроенных атрибутов. Однако Blender может ожидать, что атрибуты будут иметь определённый тип.

Name (имя)

Type

Примечания

velocity

Vector

Используется для создания размытия движения при рендеринге анимации.

rest_position

Vector

Holds the position of points or vertices from before a geometry is deformed procedurally. Can be created automatically before Shape Keys and Modifiers are evaluated with the Add Rest Position option.

surface_uv_coordinate

2D Vector

Used to describe curve attachment locations on a mesh surface, typically used for hair use cases.

Пользовательские атрибуты

Vertex groups, UV maps and Color Attributes are available as attributes in geometry nodes. They are referred to by their name. Naming collisions (e.g. a vertex group and a UV map with the same name) should be avoided. If there is a naming collision, only one of the attributes is accessible in geometry nodes.

Атрибуты с любым другим именем также могут быть созданы узлами, когда это имя используется впервые.

Обратите внимание, что узлы геометрии не всегда производят, например, группы вершин, если используется такой узел, как Join Geometry. Точно так же, если тип данных атрибута группы вершин изменён с исходного типа «Float», атрибут больше не будет группой вершин.

Оператор преобразования атрибутов

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

Этот оператор, расположенный на панели Attributes редактора свойств, может изменить домен или тип данных атрибута.

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:

Interpolate and convert the attribute between the domains and data types described on this page.

Vertex Group (группа вершин):

Создание Группы вершин из атрибута, который соответствует атрибуту с плавающей запятой в домене точек.

Примечание

Этот оператор работает только с исходными данными объекта, не включая результаты модификаторов, поэтому любые атрибуты, добавленные или изменённые узлами геометрии, не будут затронуты. Чтобы изменить тип атрибута, сгенерированного процедурно, необходимо применять модификаторы.