feat: paint tools (Epic #313) — vertex + texture painting in Material Mode

.github/workflows/deploy.yml

@@ -1045,6 +1045,12 @@ jobs:
 
                 echo "Found $test_name at $test_path"
                 local exit_code=0
+                local expected_tests
+                if [ -n "$filter" ]; then
+                    expected_tests=$(count_listed_tests "$test_path" "$filter")
+                else
+                    expected_tests=$(count_listed_tests "$test_path")
+                fi
                 if [ -n "$filter" ]; then
                     $test_path --gtest_output=xml:$output_file --gtest_filter="$filter"
                 else
@@ -1056,6 +1062,13 @@ jobs:
                     return $exit_code
                 fi
 
+                local actual_tests
+                actual_tests=$(count_testcases_in_xml "$output_file")
+                if [ "$actual_tests" -ne "$expected_tests" ]; then
+                    echo "ERROR: $test_name ran $actual_tests/$expected_tests discovered test(s)."
+                    return 1
+                fi
+
                 local skipped_count
                 skipped_count=$(count_skipped_in_xml "$output_file")
                 if [ "$skipped_count" -gt 0 ]; then
@@ -1098,6 +1111,25 @@ jobs:
                 grep -E '<testcase[^>]*(result="skipped"|status="notrun"|result="suppressed")' "$xml_file" | wc -l
             }
 
+            count_testcases_in_xml() {
+                local xml_file=$1
+                if [ ! -f "$xml_file" ]; then
+                    echo "0"
+                    return 0
+                fi
+                grep '<testcase ' "$xml_file" | wc -l
+            }
+
+            count_listed_tests() {
+                local test_path=$1
+                local filter=${2:-}
+                if [ -n "$filter" ]; then
+                    $test_path --gtest_filter="$filter" --gtest_list_tests 2>/dev/null | grep -E '^  [^[:space:]]' | wc -l
+                else
+                    $test_path --gtest_list_tests 2>/dev/null | grep -E '^  [^[:space:]]' | wc -l
+                fi
+            }
+
             # === Run UnitTests: each test suite in its own process ===
             # This prevents a crash in one suite (e.g. Ogre GL init segfault)
             # from killing all subsequent suites and losing their coverage data.
@@ -1108,16 +1140,26 @@ jobs:
                 echo "=== Running UnitTests suites in isolation ==="
                 # Get list of test suites
                 SUITES=$($UNIT_TEST_PATH --gtest_list_tests 2>/dev/null | grep -E '^\w' | sed 's/\.$//' | sort -u)
+                EXPECTED_UNIT_TESTS=$(count_listed_tests "$UNIT_TEST_PATH")
+                ACTUAL_UNIT_TESTS=0
 
                 for suite in $SUITES; do
                     TOTAL_SUITES=$((TOTAL_SUITES + 1))
                     echo "--- Running suite: $suite ---"
                     # Run without sudo so signal exit codes (e.g. 139 for SIGSEGV) propagate correctly.
                     # sudo can mask crash exit codes, reporting 0 for segfaulted children.
                     suite_xml="test-results-${suite}.xml"
+                    expected_suite_tests=$(count_listed_tests "$UNIT_TEST_PATH" "${suite}.*")
                     $UNIT_TEST_PATH --gtest_filter="${suite}.*" --gtest_output=xml:${suite_xml} 2>&1
                     exit_code=$?
                     if [ $exit_code -eq 0 ]; then
+                        actual_suite_tests=$(count_testcases_in_xml "$suite_xml")
+                        ACTUAL_UNIT_TESTS=$((ACTUAL_UNIT_TESTS + actual_suite_tests))
+                        if [ "$actual_suite_tests" -ne "$expected_suite_tests" ]; then
+                            echo "ERROR: Suite $suite ran $actual_suite_tests/$expected_suite_tests discovered test(s)."
+                            FAILED_SUITES=$((FAILED_SUITES + 1))
+                            continue
+                        fi
                         skipped_count=$(count_skipped_in_xml "$suite_xml")
                         if [ "$skipped_count" -gt 0 ]; then
                             echo "ERROR: Suite $suite produced $skipped_count skipped test(s)."
@@ -1141,7 +1183,12 @@ jobs:
                     fi
                 done
 
+                if [ "$ACTUAL_UNIT_TESTS" -ne "$EXPECTED_UNIT_TESTS" ]; then
+                    echo "ERROR: UnitTests executed $ACTUAL_UNIT_TESTS/$EXPECTED_UNIT_TESTS discovered test(s)."
+                    FAILED_SUITES=$((FAILED_SUITES + 1))
+                fi
                 echo "=== UnitTests summary: $PASSED_SUITES/$TOTAL_SUITES suites passed, $FAILED_SUITES failed, $CRASHED_SUITES crashed, $SKIPPED_TESTS skipped tests ==="
+                echo "=== UnitTests cases: $ACTUAL_UNIT_TESTS/$EXPECTED_UNIT_TESTS executed ==="
             else
                 echo "ERROR: UnitTests not found!"
                 FAILED_SUITES=$((FAILED_SUITES + 1))

README.md

@@ -166,10 +166,72 @@ qtmesh pose model.fbx --animation "Dance" --count 4 -o pose_%02d.stl
 
 # LOD generation
 qtmesh lod model.fbx --auto
+
+# Bake vertex colors → texture (with UV-seam dilation)
+qtmesh bake-vertex-colors model.fbx -o color_map.png --resolution 1024 --dilation 4
 ```
 
 ---
 
+### 🎨 Paint Tools
+
+ZBrush-style polypaint and BaseColor texture painting, with a 2D preview
+panel, multiple brush tools (paint, erase, fill, color picker, smudge),
+texture-slot picker per submesh, and a one-click bake that turns vertex
+colors into a UV-space texture.
+
+**Quick start (texture paint, GUI):**
+
+1. Switch to **Material Mode** (mode bar at the top).
+2. Select a mesh entity. The Inspector's **Texture Paint** section
+   shows a slot picker (every paintable TUS across submeshes) and a 256×256
+   live preview of the active texture.
+3. Click the **paint brush** button in the toolbar to enable painting. The
+   first click on the mesh auto-creates a paint session against the active
+   slot (or you can pre-create with *Create / Attach Texture*).
+4. Pick a tool from the row at the top of the panel: ✏ Paint, ⌫ Erase, ⧉ Fill,
+   ⊰ Pick (eyedropper), ∿ Smudge. Brush color/radius/strength/falloff comes
+   from the shared Paint Brush section above the toolbar's brush popup.
+5. Left-click-drag on **either** the 3D mesh or the 2D preview panel. Both
+   drive the same paint buffer; the 2D preview updates in real time and a
+   brush ring shows where the cursor maps on the 3D surface (and vice versa).
+6. *Save…* / *Load…* round-trips the buffer to disk as PNG (or any format
+   QImage can write).
+
+**Vertex paint (GUI):**
+
+Same flow, but vertex paint operates in **Edit Mode** instead. Press **Tab**
+on a selected mesh to enter Edit Mode, then tick *Vertex Color Preview* in
+the Edit Mode Tools section to see vertex colors live.
+
+**Bake Vertex Colors → Texture** rasterizes the active mesh's vertex colors
+into a UV-space PNG via barycentric interpolation, then dilates the result
+outward by N pixels to mask UV-seam bleed at MIP-map time.
+
+**Headless (CLI):**
+
+```bash
+qtmesh bake-vertex-colors model.fbx -o color_map.png --resolution 1024 --dilation 4
+```
+
+**Export.** Vertex colors are preserved on export to formats that support
+them (glTF preferred — verified round-trip).
+
+**Notes / limitations.**
+
+- Brush size is in local mesh units (shared with vertex paint). For texture
+  paint we divide by mesh bounding-box extent and clamp to a UV-friendly
+  range, so 0.25 produces a sensible stamp on both a unit cube and a
+  100-unit character.
+- Painting auto-rebinds every TUS named `albedo` or `diffuse_map` on the
+  active material — imported PBR materials alias the diffuse texture under
+  both, and rebinding only one would leave the other pointing at the
+  original.
+- Bake uses fan triangulation of n-gon faces; concave faces should be
+  pre-triangulated.
+
+---
+
 ### ✨ Merge Mixamo Animations in Seconds
 
 Download animations from [Mixamo](https://www.mixamo.com), drop them into QtMeshEditor, and merge into a single file — export as glTF, FBX, Collada, OBJ, or Ogre Mesh.
@@ -198,6 +260,7 @@ Split View|Skeleton Animation Controls
 - **Animation resampling** — reduce keyframe density for game engines
 - **Pose export** — bake animation frames as static meshes (3D printing)
 - **LOD generation** — automatic level-of-detail mesh reduction
+- **Paint tools** — vertex paint, texture paint (BaseColor), bake vertex colors to texture with seam dilation
 - **Material editor** — visual editing with AI-assisted generation
 - **Skeleton inspection** — bone weights, debug overlays, animation preview
 - **Scene management** — duplicate (Ctrl+D), group (Ctrl+G), snap, pivot modes