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_moge_surface.py

@@ -51,6 +51,10 @@ def main():
             mask=mask,
             points=points,
             intrinsics=intrinsics,
+            normal=np.broadcast_to(
+                np.array([0.0, 0.0, -1.0], dtype=np.float32),
+                (1, height, width, 3),
+            ),
         )
         prepare_moge_surface_archive(results_path, mesh_path)
         surface = build_image_mesh(
@@ -60,7 +64,6 @@ def main():
             False,
             True,
             False,
-            False,
             True,
         )
     assert len(surface.data.vertices) > 0
@@ -71,12 +74,16 @@ def main():
         if getattr(item, "in_out", None) == "INPUT"
     }
     assert "Stretch" not in inputs
+    assert "Depth Continuity" in inputs
     assert "Mask" in inputs
     assert "Confidence" not in inputs
     assert "o_mask" in surface.data.attributes
     assert surface.data.attributes["o_mask"].domain == "FACE"
+    assert not all(item.value for item in surface.data.attributes["o_mask"].data)
     attribute_names = set(surface.data.attributes.keys())
     assert attribute_names >= {"o_depth", "o_mask"}
+    assert "o_depth_discontinuity" in attribute_names
+    assert surface.data.attributes["o_depth_discontinuity"].data_type == "FLOAT"
     assert "o_edge_stretch" not in attribute_names
     assert not {
         "o_confidence",
@@ -90,13 +97,35 @@ def main():
         for item in surface.modifiers[0].node_group.interface.items_tree
         if getattr(item, "in_out", None) == "INPUT" and item.name == "Mask"
     )
-    assert mask_socket.default_value is True
+    assert mask_socket.default_value is False
     assert mask_socket.structure_type == "SINGLE"
-    assert not mask_socket.parent.name
-    assert not any(
-        item.item_type == "PANEL" and item.name == "Culling"
+    assert mask_socket.parent.name == "Culling"
+    depth_edge_socket = next(
+        item
         for item in surface.modifiers[0].node_group.interface.items_tree
+        if getattr(item, "in_out", None) == "INPUT"
+        and item.name == "Depth Continuity"
     )
+    assert depth_edge_socket.default_value == 50.0
+    assert depth_edge_socket.subtype == "PERCENTAGE"
+    assert depth_edge_socket.structure_type == "SINGLE"
+    culling_panel = next(
+        item for item in surface.modifiers[0].node_group.interface.items_tree
+        if item.item_type == "PANEL" and item.name == "Culling"
+    )
+    assert [item.name for item in culling_panel.interface_items] == [
+        "Depth Continuity",
+        "Mask",
+    ]
+    input_sockets = [
+        item for item in surface.modifiers[0].node_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_socket = next(
+        item for item in input_sockets if item.name == "Resolution"
+    )
+    assert abs(resolution_socket.default_value - 0.1) < 1e-6
     smooth_socket = next(
         item
         for item in surface.modifiers[0].node_group.interface.items_tree
@@ -111,6 +140,26 @@ def main():
     assert MOGE_SURFACE_MATERIAL_NODE_GROUP_NAME in bpy.data.node_groups
     material_group = bpy.data.node_groups[MOGE_SURFACE_MATERIAL_NODE_GROUP_NAME]
     assert any(node.bl_idname == "ShaderNodeBump" for node in material_group.nodes)
+    normal_map = next(
+        node for node in material_group.nodes
+        if node.bl_idname == "ShaderNodeNormalMap"
+    )
+    assert normal_map.space == "OBJECT"
+    normal_strength = next(
+        item for item in material_group.interface.items_tree
+        if getattr(item, "in_out", None) == "INPUT"
+        and item.name == "Normal Strength"
+    )
+    assert normal_strength.default_value == 1.0
+    assert normal_strength.min_value == 0.0
+    assert normal_map.inputs["Strength"].is_linked
+    assert not surface.data.has_custom_normals
+    normal_texture = next(
+        node for node in surface.data.materials[0].node_tree.nodes
+        if node.bl_idname == "ShaderNodeTexImage"
+        and node.image.colorspace_settings.name == "Non-Color"
+    )
+    assert normal_texture.image.name == "MoGe Surface Test.normal"
     assert any(child.type == "CAMERA" for child in surface.children)
     print("MoGe-2 surface validation passed")
 
@@ -131,23 +180,24 @@ def validate_real_result(results_path, image_path):
         False,
         True,
         False,
-        False,
         True,
     )
     assert len(surface.data.vertices) > 100
     assert len(surface.data.polygons) > 100
     assert surface.modifiers[0].node_group.name == MOGE_NODE_GROUP_NAME
     assert MOGE_SURFACE_MATERIAL_NODE_GROUP_NAME in bpy.data.node_groups
-    assert surface.data.has_custom_normals
-    normals = np.empty(len(surface.data.corner_normals) * 3, dtype=np.float32)
-    surface.data.corner_normals.foreach_get("vector", normals)
-    normals = normals.reshape(-1, 3)
-    assert np.isfinite(normals).all()
-    assert np.min(np.linalg.norm(normals, axis=1)) > 0.99
+    assert not surface.data.has_custom_normals
     material_group = bpy.data.node_groups[MOGE_SURFACE_MATERIAL_NODE_GROUP_NAME]
     assert any(node.bl_idname == "ShaderNodeBump" for node in material_group.nodes)
+    normal_map = next(
+        node for node in material_group.nodes
+        if node.bl_idname == "ShaderNodeNormalMap"
+    )
+    assert normal_map.space == "OBJECT"
+    assert normal_map.inputs["Strength"].is_linked
     attribute_names = set(surface.data.attributes.keys())
     assert {"o_depth", "o_mask"}.issubset(attribute_names)
+    assert "o_depth_discontinuity" in attribute_names
     assert "o_edge_stretch" not in attribute_names
     assert not {
         "o_confidence",