Committing previous changes to README and other files

README.md

@@ -1,16 +1,22 @@
 ---
-title: STL to TIFF Slicer
+title: STL to G-Code Slicer
 sdk: gradio
 sdk_version: 6.10.0
 python_version: "3.12"
 app_file: app.py
 fullWidth: true
-short_description: Upload an STL and export a TIFF slice.
+short_description: Upload STLs, export TIFF stacks, and generate G-code.
 ---
 
-# STL to TIFF Gradio App
+# STL to G-Code Gradio App
 
-This project provides a Gradio app that takes up to three uploaded STL files, shows interactive 3D viewers, slices each model along the Z axis, saves slices as TIFF images, and lets you browse each stack inside the UI.
+This project provides a Gradio app that takes up to three uploaded STL files, shows interactive 3D viewers, slices each model along the Z axis, saves slices as TIFF images, generates G-code from those TIFF stacks, and lets you preview the resulting tool path.
+
+## Prerequisites
+
+- Python 3.11 or newer for local development
+- `uv` for dependency management and script execution
+- Git LFS for the bundled `.stl` sample files
 
 ## Run
 
@@ -27,17 +33,22 @@ uv run gradio app.py
 
 When `app.py` changes, Gradio will automatically rerun the file and refresh the demo.
 
-Then open the local Gradio URL in your browser, upload an STL file, and generate the TIFF stack.
+Then open the local Gradio URL in your browser, upload STL files or load the bundled samples, and generate the TIFF stacks.
 
 ## What the app does
 
 - Uploads up to three `.stl` files
+- Loads bundled sample STL files
 - Shows interactive 3D viewers for rotating each model
+- Shows model extents, face count, vertex count, and watertight status
 - Lets you choose layer height and XY pixel size
 - Produces one `.tif` image per slice
 - Encodes material as black (`0`) and empty space as white (`255`) in each TIFF slice
 - Lets you step through the slice stack in the browser
 - Exports a ZIP containing the generated TIFF images
+- Combines generated stacks into a reference TIFF stack
+- Converts generated TIFF ZIPs into G-code files with pressure, valve, and port settings per shape
+- Visualizes generated or uploaded G-code tool paths
 
 ## Behavior and Implementation Notes
 
@@ -55,6 +66,27 @@ When you click **Generate Reference TIFF Stack**, the app combines available TIF
 
 - G-code generation uses the slicer's `Pixel Size/Fill Width` for XY step distance by passing `fil_width=pixel_size` into `generate_snake_path_gcode()`.
 
+### G-code Output
+
+- Generated G-code starts in relative coordinate mode (`G91`).
+- `G0` is travel and `G1` is print/feed.
+- The app generates print/feed moves from material pixels and travel moves between material regions.
+- Generated files include pressure preset commands and WAGO valve commands based on the selected pressure, valve, and port.
+- Pressure increases by `0.1` psi per layer by default.
+
+### G-code Visualization
+
+The G-code visualization tab can render either the generated Shape 1 G-code or an uploaded `.txt`, `.gcode`, or `.nc` file. It parses `G0` and `G1` movement lines, supports relative (`G91`) and absolute (`G90`) positioning, and displays travel and print segments with separate colors and opacity controls.
+
+## Dependency Updates
+
+When dependencies change, update the lockfile and refresh the Hugging Face `requirements.txt` export:
+
+```powershell
+uv sync --all-groups
+uv export --format requirements.txt --no-hashes --no-dev --frozen --output-file requirements.txt
+```
+
 ## Test
 
 ```powershell

gcode_viewer.py

@@ -70,7 +70,7 @@ def parse_gcode_path(gcode_text: str) -> dict:
             if dz_match is not None:
                 z = dz
 
-        kind = "travel" if gcmd == "G1" else "print"
+        kind = "print" if gcmd == "G1" else "travel"
 
         if kind != current_kind:
             flush_segment()

tests/test_gcode_viewer.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from gcode_viewer import parse_gcode_path
+
+
+def test_parse_gcode_classifies_g0_as_travel_and_g1_as_print() -> None:
+    parsed = parse_gcode_path(
+        "\n".join(
+            [
+                "G91",
+                "G0 X1 Y0 ; travel",
+                "G1 X0 Y1 ; print",
+            ]
+        )
+    )
+
+    assert len(parsed["travel_segments"]) == 1
+    assert len(parsed["print_segments"]) == 1

tests/test_tiff_to_gcode.py

@@ -34,3 +34,30 @@ def test_gcode_header_writes_presets_before_initial_aux_commands(tmp_path) -> No
     assert lines[2].startswith("{preset}serialPort3.write(")
     assert lines[3].startswith("{aux_command}WAGO_ValveCommands(")
     assert lines[4].startswith("{aux_command}WAGO_ValveCommands(")
+
+
+def test_gcode_uses_g1_for_print_and_g0_for_travel(tmp_path) -> None:
+    tiff_path = tmp_path / "slice_0000.tif"
+    Image.new("L", (1, 1), 0).save(tiff_path)
+
+    zip_path = tmp_path / "slices.zip"
+    with zipfile.ZipFile(zip_path, mode="w") as archive:
+        archive.write(tiff_path, arcname=tiff_path.name)
+
+    gcode_path = generate_snake_path_gcode(
+        zip_path,
+        shape_name="move_types",
+        pressure=25,
+        valve=7,
+        port=3,
+    )
+
+    move_lines = [
+        line.strip()
+        for line in gcode_path.read_text().splitlines()
+        if line.startswith(("G0", "G1"))
+    ]
+
+    assert any(line.startswith("G1") and "; Color 255" in line for line in move_lines)
+    assert all(not line.startswith("G0") for line in move_lines if "; Color 255" in line)
+    assert all(not line.startswith("G1") for line in move_lines if "; Color 0" in line)

tiff_to_gcode.py

@@ -306,7 +306,7 @@ def generate_snake_path_gcode(
                         f.write(_valve_cmd(color_dict[cur_color], 1))
                         f.write(_valve_cmd(color_dict[prev_color], 0))
 
-            move_type = "G0" if cur_color != off_color else "G1"
+            move_type = "G1" if cur_color != off_color else "G0"
             if "Z" in move:
                 line = (
                     f"{move_type} X{move['X']} Y{move['Y']} Z{move['Z']} "