Add comprehensive documentation for SnapForm extension

- Created development.md for development setup and licensing information.
- Added features.md detailing functionalities and usage instructions for developers and users.
- Introduced index.md to serve as a navigation hub for the documentation.
- Developed outputs.md to explain output formats and their specifications.
- Established service.md to describe the AI Service architecture and environment setup.
- Created surface.md to outline the process of converting Image Empty to perspective meshes.

tools/validate_geometry_nodes_asset.py

@@ -21,14 +21,9 @@ def set_input(modifier, group, name, value):
     modifier[item.identifier] = value
 
 
-def add_face_attributes(mesh, count, background_values=None):
+def add_face_attributes(mesh, count):
     confidence = mesh.attributes.new("o_face_confidence", "FLOAT", "FACE")
     confidence.data.foreach_set("value", [1.0] * count)
-    background = mesh.attributes.new("o_background_face", "BOOLEAN", "FACE")
-    background.data.foreach_set(
-        "value",
-        background_values or [False] * count,
-    )
 
 
 def main():
@@ -44,6 +39,13 @@ def main():
         and item.name == "Geometry"
     )
     assert geometry_input.structure_type == "SINGLE"
+    input_sockets = [
+        item for item in group.interface.items_tree
+        if item.item_type == "SOCKET" and item.in_out == "INPUT"
+    ]
+    assert all(item.structure_type == "SINGLE" for item in input_sockets)
+    resolution = next(item for item in input_sockets if item.name == "Resolution")
+    assert abs(resolution.default_value - 0.1) < 1e-6
     assert group.asset_data is None
     assert not any(node.bl_idname == "GeometryNodeGroup" for node in group.nodes)
     assert not any(node.bl_idname == "GeometryNodeTriangulate" for node in group.nodes)
@@ -72,8 +74,8 @@ def main():
     assert not panels["Culling"].default_closed
     assert panels["Options"].default_closed
     assert [item.name for item in panels["Culling"].interface_items] == [
+        "Depth Continuity",
         "Confidence",
-        "Stretch",
     ]
     assert [item.name for item in panels["Options"].interface_items] == [
         "Fix Topology",
@@ -86,7 +88,10 @@ def main():
         and item.name == "Smooth"
     )
     assert smooth.default_value == 0.5
-    for name, default_value in (("Confidence", 0.0), ("Stretch", 10.0)):
+    for name, default_value in (
+        ("Confidence", 0.0),
+        ("Depth Continuity", 50.0),
+    ):
         item = next(
             item
             for item in panels["Culling"].interface_items
@@ -105,11 +110,21 @@ def main():
         [],
         [(0, 2, 1), (1, 2, 3)],
     )
-    edge_stretch = mesh.attributes.new("o_edge_stretch", "FLOAT", "EDGE")
-    edge_stretch.data.foreach_set("value", [0.05] * len(mesh.edges))
+    discontinuity = mesh.attributes.new(
+        "o_depth_discontinuity",
+        "FLOAT",
+        "FACE",
+    )
+    discontinuity.data.foreach_set("value", [0.03] * len(mesh.polygons))
     uv = mesh.uv_layers.new(name="UVMap")
     uv.data.foreach_set("uv", [0, 0, 0, 1, 1, 0, 1, 0, 0, 1, 1, 1])
-    add_face_attributes(mesh, 2, [False, True])
+    add_face_attributes(mesh, 2)
+    assert not {
+        "o_background",
+        "o_background_face",
+        "o_confidence",
+        "o_confidence_percentile",
+    }.intersection(mesh.attributes.keys())
 
     obj = bpy.data.objects.new("Validation Object", mesh)
     bpy.context.scene.collection.objects.link(obj)
@@ -130,13 +145,13 @@ def main():
     finally:
         evaluated.to_mesh_clear()
 
-    set_input(modifier, group, "Stretch", 0.0)
-    stretch_item = next(
+    set_input(modifier, group, "Depth Continuity", 100.0)
+    discontinuity_item = next(
         item
         for item in group.interface.items_tree
-        if item.item_type == "SOCKET" and item.name == "Stretch"
+        if item.item_type == "SOCKET" and item.name == "Depth Continuity"
     )
-    assert modifier[stretch_item.identifier] == 0.0
+    assert modifier[discontinuity_item.identifier] == 100.0
     obj.update_tag(refresh={"DATA"})
     bpy.context.view_layer.update()
     culled = obj.evaluated_get(bpy.context.evaluated_depsgraph_get())