classref: Sync with current master branch (7d9923b2e)

classes/class_primitivemesh.rst

@@ -24,6 +24,8 @@ Base class for all primitive meshes. Handles applying a :ref:`Material<class_Mat
 Properties
 ----------
 
++---------------------------------+--------------------------------------------------------------+----------------------------+
+| :ref:`bool<class_bool>`         | :ref:`add_uv2<class_PrimitiveMesh_property_add_uv2>`         | ``false``                  |
 +---------------------------------+--------------------------------------------------------------+----------------------------+
 | :ref:`AABB<class_AABB>`         | :ref:`custom_aabb<class_PrimitiveMesh_property_custom_aabb>` | ``AABB(0, 0, 0, 0, 0, 0)`` |
 +---------------------------------+--------------------------------------------------------------+----------------------------+
@@ -31,6 +33,8 @@ Properties
 +---------------------------------+--------------------------------------------------------------+----------------------------+
 | :ref:`Material<class_Material>` | :ref:`material<class_PrimitiveMesh_property_material>`       |                            |
 +---------------------------------+--------------------------------------------------------------+----------------------------+
+| :ref:`float<class_float>`       | :ref:`uv2_padding<class_PrimitiveMesh_property_uv2_padding>` | ``2.0``                    |
++---------------------------------+--------------------------------------------------------------+----------------------------+
 
 Methods
 -------
@@ -44,6 +48,22 @@ Methods
 Property Descriptions
 ---------------------
 
+.. _class_PrimitiveMesh_property_add_uv2:
+
+- :ref:`bool<class_bool>` **add_uv2**
+
++-----------+--------------------+
+| *Default* | ``false``          |
++-----------+--------------------+
+| *Setter*  | set_add_uv2(value) |
++-----------+--------------------+
+| *Getter*  | get_add_uv2()      |
++-----------+--------------------+
+
+If set, generates UV2 UV coordinates applying a padding using the :ref:`uv2_padding<class_PrimitiveMesh_property_uv2_padding>` setting. UV2 is needed for lightmapping.
+
+----
+
 .. _class_PrimitiveMesh_property_custom_aabb:
 
 - :ref:`AABB<class_AABB>` **custom_aabb**
@@ -90,6 +110,22 @@ This gives the same result as using :ref:`BaseMaterial3D.CULL_FRONT<class_BaseMa
 
 The current :ref:`Material<class_Material>` of the primitive mesh.
 
+----
+
+.. _class_PrimitiveMesh_property_uv2_padding:
+
+- :ref:`float<class_float>` **uv2_padding**
+
++-----------+------------------------+
+| *Default* | ``2.0``                |
++-----------+------------------------+
+| *Setter*  | set_uv2_padding(value) |
++-----------+------------------------+
+| *Getter*  | get_uv2_padding()      |
++-----------+------------------------+
+
+If :ref:`add_uv2<class_PrimitiveMesh_property_add_uv2>` is set, specifies the padding in pixels applied along seams of the mesh. If at generation the size of the lightmap texture can't be determined, the UVs are calculated assuming a texture size of 1024x1024.
+
 Method Descriptions
 -------------------
 
@@ -97,6 +133,10 @@ Method Descriptions
 
 - :ref:`Array<class_Array>` **_create_mesh_array** **(** **)** |virtual| |const|
 
+.. container:: contribute
+
+	There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
+
 ----
 
 .. _class_PrimitiveMesh_method_get_mesh_arrays: