Extra documentation for outputting UV maps from Geometry Nodes #104392

New Issue

Martijn Versteegh · 2023-03-24T21:10:55+01:00

Martijn Versteegh commented

2023-03-24 21:10:55 +01:00

Add 2 small blurbs to the UV Unwrap node and the attributes output docs

uvmaps-docs.diff

1.5 KiB

Hans Goudey commented

2023-03-24 21:26:25 +01:00

A complication with 2D Vector attributes

This is also the case with byte color data, the node has to be used there too. Maybe it could say something more basic like "In order to create UV maps (2D vectors) and byte colors, the store named attribute node must be used instead"

When saving UV coordinates to an atribute, you must save them as 2D Vectors on Corners

This isn't quite true though, if the goal is just to create an attribute. We also try to avoid second person in the manual (and in UI text in Blender) since it reads weirdly like a command. it might be more helpful to be more specific:

In order for Blender to recognize the created attribute as a UV map, it must be created with the [](link to store named attribute node) on the face corner domain with the 2D vector data type. This is necessary because there is no 2D vector socket type.

>A complication with 2D Vector attributes This is also the case with byte color data, the node has to be used there too. Maybe it could say something more basic like "In order to create UV maps (2D vectors) and byte colors, the [store named attribute node](link) must be used instead" >When saving UV coordinates to an atribute, you must save them as 2D Vectors on Corners This isn't quite true though, if the goal is just to create an attribute. We also try to avoid second person in the manual (and in UI text in Blender) since it reads weirdly like a command. it might be more helpful to be more specific: > In order for Blender to recognize the created attribute as a UV map, it must be created with the [](link to store named attribute node) on the face corner [domain](link) with the [2D vector](link) data type. This is necessary because there is no 2D vector socket type.

Martijn Versteegh commented

2023-03-25 13:25:35 +01:00

Better like this?

I couldn't find if there is a way to link to a specific section in another file

Better like this? I couldn't find if there is a way to link to a specific section in another file

uvmap-doc.diff

1.5 KiB

Aaron Carlisle commented

2023-03-25 20:52:36 +01:00

Seems good to me, I will apply this Monday unless @HooglyBoogly has something to add.

Hans Goudey commented

2023-03-25 21:14:25 +01:00

Just a couple things, but yeah, looks good.

:doc:`store named attribute node</modeling/geometry_nodes/attribute/store_named_attribute> -> :doc:/modeling/geometry_nodes/attribute/store_named_attribute`` That will fill in the name automatically.
You can link to specific sections like :ref:attribute domain ``
That should be possible for data types too

Just a couple things, but yeah, looks good. - ``:doc:`store named attribute node</modeling/geometry_nodes/attribute/store_named_attribute>`` -> `:doc:`/modeling/geometry_nodes/attribute/store_named_attribute`` That will fill in the name automatically. - You can link to specific sections like `:ref:`attribute domain <attribute-domains>`` - That should be possible for data types too

Martijn Versteegh commented

2023-03-25 23:30:13 +01:00