Fix #252: Update Scatter/project_on_terrain3d to align meshes to normals

project/addons/terrain_3d/extras/project_on_terrain3d.gd

@@ -2,6 +2,7 @@
 # It allows Scatter to detect the terrain height from Terrain3D
 # Copy this file into /addons/proton_scatter/src/modifiers
 # Then uncomment everything below
+# In the editor, add this modifier, then set your Terrain3D node
 
 #@tool
 #extends "base_modifier.gd"
@@ -11,6 +12,7 @@
 #
 #
 #@export var terrain_node : NodePath
+#@export var align_with_collision_normal := false
 #
 #var _terrain: Terrain3D
 #
@@ -30,6 +32,16 @@
 #
 # This modifier must have terrain_node set to a Terrain3D node.")
 #
+# var p := documentation.add_parameter("Terrain Node")
+# p.set_type("NodePath")
+# p.set_description("Set your Terrain3D node.")
+#
+# p = documentation.add_parameter("Align with collision normal")
+# p.set_type("bool")
+# p.set_description(
+# "Rotate the transform to align it with the collision normal in case
+# the ray cast hit a collider.")
+#
 #
 #func _process_transforms(transforms, domain, _seed) -> void:
 # if transforms.is_empty():
@@ -46,10 +58,20 @@
 # warning += """Terrain3D storage is not initialized"""
 # return
 #
-# var domain_xform: Transform3D = domain.get_global_transform()
+# # Get global transform
+# var gt: Transform3D = domain.get_global_transform()
+# var gt_inverse := gt.affine_inverse()
 # for i in transforms.list.size():
-# var height: float = _terrain.storage.get_height(( domain_xform * transforms.list[i]).origin)
-# transforms.list[i].origin.y = height - domain_xform.origin.y
+# var location: Vector3 = (gt * transforms.list[i]).origin
+# var height: float = _terrain.storage.get_height(location)
+# var normal: Vector3 = _terrain.storage.get_normal(location)
+#
+# if align_with_collision_normal:
+# transforms.list[i].basis.y = normal
+# transforms.list[i].basis.x = -transforms.list[i].basis.z.cross(normal)
+# transforms.list[i].basis = transforms.list[i].basis.orthonormalized()
+#
+# transforms.list[i].origin.y = height - gt.origin.y
 #
 # if transforms.is_empty():
 # warning += """Every point has been removed. Possible reasons include: \n
@@ -59,3 +81,4 @@
 # + Collision mask is not set properly.
 # + Max slope is too low.
 # """
+

project/demo/textures/asset_licenses.txt

@@ -1,6 +1,6 @@
 All ambientCG assets are provided under the
 Creative Commons CC0 1.0 Universal License.
-https://docs.ambientcg.com/books/website-licensing/page/license-information
+https://docs.ambientcg.com/license/
 
 Grass:
 https://ambientcg.com/view?id=Ground037