scanruler-mcp 0.1.0 → 0.3.0

package/src/commands.json

@@ -2,10 +2,19 @@
   {
     "name": "align.auto",
     "title": "Auto-align the part",
-    "description": "Read a coordinate system off the scan and apply it, as Auto-align then Confirm alignment do: the directions most faces are square to and the axis round walls run along, the part standing on its base, its long side along X. Returns what the pose was read from, the transform and the elements afterwards. One undo step.",
+    "description": "Read a coordinate system off the scan and apply it, as Auto-align then Confirm alignment do: the directions most faces are square to and the axis round walls run along, the part standing on its base, its long side along X. Returns what the pose was read from, the transform and how many elements moved with it. One undo step.",
     "input": {
       "type": "object",
-      "properties": {},
+      "properties": {
+        "detail": {
+          "type": "string",
+          "enum": [
+            "brief",
+            "full"
+          ],
+          "description": "brief (the default): the transform and how many elements moved with the part. full: every element where it now is, as the list gives it."
+        }
+      },
       "additionalProperties": false
     },
     "readOnly": false,
@@ -15,10 +24,19 @@
   {
     "name": "align.clear",
     "title": "Reset the alignment",
-    "description": "Put the part back in the coordinates the scanner delivered it in, with everything measured on it. One undo step.",
+    "description": "Put the part back in the coordinates the scanner delivered it in, with everything measured on it. Returns how many elements moved with it. One undo step.",
     "input": {
       "type": "object",
-      "properties": {},
+      "properties": {
+        "detail": {
+          "type": "string",
+          "enum": [
+            "brief",
+            "full"
+          ],
+          "description": "brief (the default): the transform and how many elements moved with the part. full: every element where it now is, as the list gives it."
+        }
+      },
       "additionalProperties": false
     },
     "readOnly": false,
@@ -28,7 +46,7 @@
   {
     "name": "align.datum",
     "title": "Align the part to datums",
-    "description": "A 3-2-1 alignment, as the panel’s alignment box sets it up: primary levels the part — a plane (or 3 points on a face) whose outward normal becomes primaryAxis (default z-, the face the part stands on facing down); secondary turns it — a line, axis or plane (or 2 points along an edge) laid along secondaryAxis (default x+); origin is the zero point — a point, sphere or circle (or 1 point). Each is an element by id or name, or points on the scan in mm. An origin alone moves the part without turning it. Everything measured moves with the part. Returns the transform applied and the elements afterwards. One undo step.",
+    "description": "A 3-2-1 alignment, as the panel’s alignment box sets it up: primary levels the part — a plane (or 3 points on a face) whose outward normal becomes primaryAxis (default z-, the face the part stands on facing down); secondary turns it — a line, axis or plane (or 2 points along an edge) laid along secondaryAxis (default x+); origin is the zero point — a point, sphere or circle (or 1 point). Each is an element by id or name, or points on the scan in mm. An origin alone moves the part without turning it. Everything measured moves with the part. Returns the transform applied — the whole alignment the part carries, when it was aligned before — and how many elements moved with it. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -208,6 +226,14 @@
             }
           ],
           "description": "The zero point: an element, or a point on the scan."
+        },
+        "detail": {
+          "type": "string",
+          "enum": [
+            "brief",
+            "full"
+          ],
+          "description": "brief (the default): the transform and how many elements moved with the part. full: every element where it now is, as the list gives it."
         }
       },
       "additionalProperties": false
@@ -219,10 +245,19 @@
   {
     "name": "align.symmetry",
     "title": "Align the part on its symmetry plane",
-    "description": "Settle the part’s pose on its mirror plane and apply it, as Use symmetry then Confirm alignment do: the pose is Auto-align’s, the mirror plane a measured symmetry plane or one searched for on the scan; the axis nearest its normal is turned onto it and the zero point put on it. Refuses when the scan has no symmetry plane. Returns the note on what it settled on, the transform and the elements afterwards. One undo step.",
+    "description": "Settle the part’s pose on its mirror plane and apply it, as Use symmetry then Confirm alignment do: the pose is Auto-align’s, the mirror plane a measured symmetry plane or one searched for on the scan; the axis nearest its normal is turned onto it and the zero point put on it. Refuses when the scan has no symmetry plane. Returns the note on what it settled on, the transform and how many elements moved with it. One undo step.",
     "input": {
       "type": "object",
-      "properties": {},
+      "properties": {
+        "detail": {
+          "type": "string",
+          "enum": [
+            "brief",
+            "full"
+          ],
+          "description": "brief (the default): the transform and how many elements moved with the part. full: every element where it now is, as the list gives it."
+        }
+      },
       "additionalProperties": false
     },
     "readOnly": false,
@@ -299,6 +334,36 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "deviation.hotspots",
+    "title": "Where the deviation lies over tolerance",
+    "description": "The deviation map read as patches: the scan vertices whose deviation lies past the tolerance (the map’s own, under deviation.settings, unless tolerance says otherwise) gathered into connected regions, the largest and farthest first — where the part is off, how large each place is and by how much, instead of one number over the whole part. Each patch: its centre and box in mm (in the frame the scan is measured in — what scan.query { box } and element.fit take), its area, how many vertices, the mean and the extreme deviation and which side (outside the reference or inside), the point of the extreme and the scan vertex there, and a few of its vertices (what element.fit_marked takes). With a map against the reference part the patch’s centre and extreme are given on the reference too (onReference — what the Deviation workspace shows and view.render { frame } takes there). grain is how close two vertices over tolerance have to be to be one patch, three point spacings by default. found and over say how many patches and vertices over tolerance there were in all — within the search distance, the vertices the map draws as a measurement. Then far, the vertices past the search distance, which the map draws bare: read it every time — far.inside is the scan deeper inside the reference than the search distance, where the reference has material the part has not (a hole, a pocket or a slot the model lacks), far.outside the scan further off it, where the part has what the model has not, or scan spray; each with its count and its patches, the largest first, and far.count both together; unmeasured says how many vertices the facing limit left without a reading. Needs a deviation map (deviation.align, or deviation.set_target). Changes nothing.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "tolerance": {
+          "type": "number",
+          "description": "± mm; the map’s tolerance by default.",
+          "exclusiveMinimum": 0
+        },
+        "patches": {
+          "type": "integer",
+          "description": "How many patches to name; 8 by default, 50 at most.",
+          "minimum": 1,
+          "maximum": 50
+        },
+        "grain": {
+          "type": "number",
+          "description": "mm — how close two vertices over tolerance have to be to be one patch; three point spacings by default.",
+          "exclusiveMinimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "deviation.measure",
     "title": "Measure the deviation map",
@@ -416,7 +481,7 @@
   {
     "name": "deviation.settings",
     "title": "Set how the deviation is read",
-    "description": "The deviation map’s reading: range, the colour scale ± mm; maxDistance, how far from the reference a point may be to count, mm; bands, a stepped scale of that many colours or null for smooth; tolerance, ± mm, the share within which the statistics give; facingDeg, how far the reference surface a point is measured against may turn from facing it, degrees, or null for the nearest surface whatever it faces — a change of it measures the map again. Returns the deviation state. One undo step.",
+    "description": "The deviation map’s reading: range, the colour scale ± mm; maxDistance, how far from the reference a point may be to count, mm; bands, a stepped scale of that many colours or null for smooth; tolerance, ± mm, the share within which the statistics give; facingDeg, how far the reference surface a point is measured against may turn from facing it, degrees, or null for the nearest surface whatever it faces — a change of it measures the map again; colormap, the colour map every deviation map and the live map of the bodies are drawn in — the person’s own choice, kept in the browser and outside the undo, so set it only to read a render by its colours and read settings.colormap for what the ramp shows at −range, 0 and +range and the caps past either end before judging a picture. Returns the deviation state. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -461,6 +526,21 @@
             }
           ],
           "description": "Facing limit, degrees, or null."
+        },
+        "colormap": {
+          "type": "string",
+          "enum": [
+            "jet",
+            "viridis",
+            "magma",
+            "plasma",
+            "inferno",
+            "cividis",
+            "mako",
+            "rocket",
+            "turbo"
+          ],
+          "description": "The colour map: jet (blue inside, green on the surface, red outside) or one of the perceptual ramps."
         }
       },
       "additionalProperties": false
@@ -472,7 +552,7 @@
   {
     "name": "dimension.add",
     "title": "Add a dimension",
-    "description": "Measure between elements, or a size or tolerance of one, as the panel’s dimension box does. refs are the elements by id or name. Without type, the type follows the elements as clicking them in the viewport does — two spheres or points give their centre distance, two planes their distance, a plane and an axis their distance, and so on. With type, it is one of: dist-point-point (From, To); dist-point-axis (Point, Axis); dist-point-plane (Point, Plane); dist-axis-axis (Axis A, Axis B); dist-axis-plane (Axis, Plane); dist-plane-plane (From, To); angle-axis-axis (Axis A, Axis B); angle-axis-plane (Axis, Plane); angle-plane-plane (Plane A, Plane B); size-diameter (Feature); form-flatness (Plane); form-cylindricity (Cylinder); form-circularity (Circle); form-sphericity (Sphere); orient-parallelism (Feature, Datum); orient-perpendicularity (Feature, Datum); orient-angularity (Feature, Datum); loc-coaxiality (Feature, Datum axis). anchor, for two spheres: center (default), gap or span. limit holds the value to a ceiling or a nominal ± band. Returns the dimension with its value (mm or degrees, full precision), the formatted value the panel shows, and the verdict. One undo step.",
+    "description": "Measure between elements, or a size or tolerance of one, as the panel’s dimension box does. refs are the elements by id or name. Without type, the type follows the elements as clicking them in the viewport does — two spheres or points give their centre distance, two planes their distance, a plane and an axis their distance, and so on. With type, it is one of: dist-point-point (From, To); dist-point-axis (Point, Axis); dist-point-plane (Point, Plane); dist-axis-axis (Axis A, Axis B); dist-axis-plane (Axis, Plane); dist-plane-plane (From, To); angle-axis-axis (Axis A, Axis B); angle-axis-plane (Axis, Plane); angle-plane-plane (Plane A, Plane B); size-diameter (Feature); form-flatness (Plane); form-cylindricity (Cylinder); form-circularity (Circle); form-sphericity (Sphere); orient-parallelism (Feature, Datum); orient-perpendicularity (Feature, Datum); orient-angularity (Feature, Datum); loc-coaxiality (Feature, Datum axis). anchor, for two spheres: center (default), gap or span. limit holds the value to a ceiling or a nominal ± band. Returns the dimension with its value (mm or degrees, finer than the panel shows it), the formatted value the panel shows, and the verdict. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -771,7 +851,7 @@
   {
     "name": "element.construct",
     "title": "Construct an element",
-    "description": "Construct an element from others and typed-in numbers, as the panel’s creation methods do — by kind: point (point-coords, point-centroid, point-midpoint, point-line-plane), line (line-two-points, line-axis, line-plane-plane), plane (plane-three-points, plane-offset, plane-midplane, plane-coords, plane-symmetry), circle (circle-plane-cylinder, circle-plane-sphere, circle-coords). refs fill the method’s slots in order, by element id or name; params are its numbers in order (or by key: x, y, z; offset; nx, ny, nz, px, py, pz; d, cx, cy, cz). point-centroid and plane-symmetry measure the scan themselves: vertices confines them to a marked surface, seed starts the symmetry search from a plane. Returns the element. One undo step.",
+    "description": "Construct an element from others and typed-in numbers, as the panel’s creation methods do — by kind: point (point-coords, point-centroid, point-midpoint, point-line-plane), line (line-two-points, line-axis, line-plane-plane), plane (plane-three-points, plane-offset, plane-midplane, plane-coords, plane-symmetry), circle (circle-plane-cylinder, circle-plane-sphere, circle-coords). refs fill the method’s slots in order, by element id or name; params are its numbers in order (or by key: x, y, z; offset; nx, ny, nz, px, py, pz; d, cx, cy, cz). point-centroid and plane-symmetry measure the scan themselves: vertices confines them to a marked surface, seed starts the symmetry search from a plane. plane-symmetry finds the scan’s own mirror plane as an element, the alignment left as it is (align.symmetry re-poses the part on it instead), and answers with the search’s residual: symmetry { rms, matched, sampled } and a note. Returns the element. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -911,7 +991,7 @@
   {
     "name": "element.fit",
     "title": "Fit an element",
-    "description": "Fit an element on the scan where the panel would take a click: a plane, sphere, cylinder, cone or torus grows its surface from the place given and is best-fitted to it; a point is the place itself; a circle goes through three or more places. `at` is one place, or a list — a feature seen in patches can be seeded on each. A place is { vertex } (a scan vertex), { point: [x, y, z] } (the nearest scan vertex to a point, mm, in the current frame), or { screen } / { candidate } (not available yet). Returns the element with its fit at full precision and the seed actually used (vertex and point), so a recipe can be replayed on another scan. One undo step.",
+    "description": "Fit an element on the scan where the panel would take a click: a plane, sphere, cylinder, cone or torus grows its surface from the place given and is best-fitted to it; a point is the place itself; a circle goes through three or more places. `at` is one place, or a list — a feature seen in patches can be seeded on each. A place is { vertex } (a scan vertex), { point: [x, y, z] } (the nearest scan vertex to a point, mm, in the current frame), or { screen } / { candidate } (not available yet). Returns the element with its fit and the seed actually used (vertex and point), so a recipe can be replayed on another scan. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -1502,7 +1582,7 @@
   {
     "name": "flat.calibrate",
     "title": "Calibrate the image",
-    "description": "Set the image’s scale against a known length, as the Calibrate tool does: distance takes two places a known distance apart, diameter three or more on a circle of known diameter; mm is that length. Every measurement on the image follows the new scale. Returns the calibration. One undo step.",
+    "description": "Set the image’s scale against a known length, as the Calibrate tool does: distance takes two places a known distance apart, diameter three or more on a circle of known diameter; mm is that length. Every measurement on the image follows the new scale, and the edges are found again (their chain numbers change). Returns the calibration. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -1548,7 +1628,7 @@
   {
     "name": "flat.detect_edges",
     "title": "Detect the image’s edges",
-    "description": "Find the edges in the image again at a sensitivity from 0 (only the strongest) to 1 (every faint one) — what the seed and edge methods of flat.fit and the snapping of every place follow. Needs the browser. Returns how many edge chains were found.",
+    "description": "Find the edges in the image again at a sensitivity from 0 (only the strongest) to 1 (every faint one) — what the edge methods of flat.fit and the snapping of every place follow. The chains are numbered afresh. Needs the browser. Returns how many edge chains were found.",
     "input": {
       "type": "object",
       "properties": {
@@ -1618,10 +1698,170 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "flat.edges",
+    "title": "List the detected edges",
+    "description": "The edge chains detected on the sheet, by number — what flat.fit takes as chains and flat.render writes beside each. Each with its length, whether it closes on itself, how many points and the box round it, in the sheet’s units; the longest first, or with near the nearest first, each with its point nearest that place and how far (within reach only, when given). box keeps the chains that enter it, minLength the long ones. tolerance adds each chain’s polyline, thinned to stray no further than that (5000 points at most over all). limit chains at most, 50 by default. The numbers hold until the edges are found again. Changes nothing.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "box": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The lowest corner.",
+              "minItems": 2,
+              "maxItems": 2
+            },
+            "max": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The highest corner.",
+              "minItems": 2,
+              "maxItems": 2
+            }
+          },
+          "required": [
+            "min",
+            "max"
+          ],
+          "additionalProperties": false,
+          "description": "Only chains with a point in this box."
+        },
+        "near": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "description": "Nearest this place first.",
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "reach": {
+          "type": "number",
+          "description": "With near: only chains this close.",
+          "exclusiveMinimum": 0
+        },
+        "minLength": {
+          "type": "number",
+          "description": "Only chains at least this long.",
+          "minimum": 0
+        },
+        "tolerance": {
+          "type": "number",
+          "description": "Add each chain’s polyline, thinned to this.",
+          "exclusiveMinimum": 0
+        },
+        "limit": {
+          "type": "integer",
+          "description": "Chains at most — 50 by default.",
+          "minimum": 1,
+          "maximum": 2000
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "flat.edit",
+    "title": "Change a 2D element, dimension, note or count",
+    "description": "Change one thing on the 2D sheet, named by its id (or name): an element, a dimension or a count takes a new name; a note new text or a new place (at, its lower-left corner); any of them visible: false to leave it out of the stage, the picture and the exports, true to bring it back. Returns the 2D state. One undo step.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "element": {
+          "oneOf": [
+            {
+              "type": "integer",
+              "description": "The 2D element’s id.",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "description": "Its name — \"Line 1\".",
+              "minLength": 1
+            }
+          ],
+          "description": "A 2D element."
+        },
+        "dimension": {
+          "oneOf": [
+            {
+              "type": "integer",
+              "description": "Its id.",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "description": "Its name — \"Distance 1\".",
+              "minLength": 1
+            }
+          ],
+          "description": "A 2D dimension."
+        },
+        "note": {
+          "type": "integer",
+          "description": "A note, by its id.",
+          "minimum": 1
+        },
+        "count": {
+          "oneOf": [
+            {
+              "type": "integer",
+              "description": "Its id.",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "description": "Its name — \"Count 1\".",
+              "minLength": 1
+            }
+          ],
+          "description": "A count (tally)."
+        },
+        "name": {
+          "type": "string",
+          "description": "The new name.",
+          "minLength": 1
+        },
+        "text": {
+          "type": "string",
+          "description": "A note’s new text.",
+          "minLength": 1
+        },
+        "at": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "description": "A note’s new lower-left corner.",
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "visible": {
+          "type": "boolean",
+          "description": "Shown, or left out."
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "flat.fit",
     "title": "Fit a 2D element",
-    "description": "Make a 2D element on the sheet as its tool does — kind point, line, circle, arc or spline, by a method of that kind: point: flat-point-pick (pick), flat-point-midpoint (construct), flat-point-intersect (construct), flat-point-center (construct); line: flat-line-pick (pick), flat-line-seed (seed), flat-line-edge (edge); circle: flat-circle-pick (pick), flat-circle-seed (seed), flat-circle-edge (edge); arc: flat-arc-pick (pick), flat-arc-edge (edge); spline: flat-spline-pick (pick). A pick method takes points, the places clicked; a seed method one place on a detected edge, grown along it; an edge method a place on an edge, taken whole; a construct method refs, other 2D elements by id or name. Returns the element with its fit. One undo step.",
+    "description": "Make a 2D element on the sheet as its tool does — kind point, line, circle, arc or spline, by a method of that kind: point: flat-point-pick (pick), flat-point-midpoint (construct), flat-point-intersect (construct), flat-point-center (construct); line: flat-line-pick (pick), flat-line-seed (seed), flat-line-edge (edge); circle: flat-circle-pick (pick), flat-circle-seed (seed), flat-circle-edge (edge); arc: flat-arc-pick (pick), flat-arc-edge (edge); spline: flat-spline-pick (pick). A pick method takes points, the places clicked — each snapped to the nearest detected edge within reach unless snap: false, and the answer’s picks say where each landed and on which chain. A seed method takes one place on a detected edge and grows along it; an edge method a place on an edge, taken whole. The edge methods also take chains — whole edge chains by number (flat.edges, flat.render) — and box, every edge point inside it (of those chains only, with both); the kind’s edge method is the default then. A construct method takes refs, other 2D elements by id or name. Returns the element with its fit. One undo step.",
     "input": {
       "type": "object",
       "properties": {
@@ -1655,6 +1895,44 @@
           "description": "The places, in the sheet’s units.",
           "minItems": 1
         },
+        "chains": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "description": "Edge chains by number, taken whole — for an edge or seed method.",
+          "minItems": 1
+        },
+        "box": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The lowest corner.",
+              "minItems": 2,
+              "maxItems": 2
+            },
+            "max": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The highest corner.",
+              "minItems": 2,
+              "maxItems": 2
+            }
+          },
+          "required": [
+            "min",
+            "max"
+          ],
+          "additionalProperties": false,
+          "description": "Edge points inside this box, in the sheet’s units — for an edge or seed method."
+        },
         "refs": {
           "type": "array",
           "items": {
@@ -1678,6 +1956,15 @@
           "type": "string",
           "description": "A name for it.",
           "minLength": 1
+        },
+        "snap": {
+          "type": "boolean",
+          "description": "Picks snap to the nearest edge within reach — true by default, as the panel’s Snap box is."
+        },
+        "reach": {
+          "type": "number",
+          "description": "How far a place reaches for an edge, in the sheet’s units — ten image pixels by default.",
+          "exclusiveMinimum": 0
         }
       },
       "required": [
@@ -1689,6 +1976,78 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "flat.note_add",
+    "title": "Write a note on the sheet",
+    "description": "Write a text note on the 2D sheet, as the Text tool does — a label beside a part, a size read elsewhere, a remark. One line, as the tool writes it: a line break is written as \" / \". at is its lower-left corner, in the sheet’s units. It is drawn on the stage and in flat.render, written into the SVG and DXF exports and listed in the report. Returns the note with its id. One undo step.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "text": {
+          "type": "string",
+          "description": "What it says.",
+          "minLength": 1
+        },
+        "at": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "description": "Its lower-left corner.",
+          "minItems": 2,
+          "maxItems": 2
+        }
+      },
+      "required": [
+        "text",
+        "at"
+      ],
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "flat.objects",
+    "title": "Find the parts on the image",
+    "description": "The separate parts lying on the flatbed image, parted from the background by a grey level (Otsu’s, unless threshold is given; dark says the parts are darker than the background, read off the image’s border by default) and numbered in reading order — rows from the top, left to right. Each with its area (holes left out) and holes, box, centroid, equivalentDiameter (of a circle of its area), feret — the largest and smallest caliper widths and the directions they are measured along, degrees from +X — axisAngle (its long axis, degrees), and chains, the edge chains along its outline, longest first. minArea drops smaller ones: 1 mm² by default, or its pixels at 600 dpi on an image with no scale. outline adds each outline as a polygon thinned to that tolerance. flat.profile takes an object by its number. limit, 100 by default. Changes nothing.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "threshold": {
+          "type": "integer",
+          "description": "Grey level, 0 to 255.",
+          "minimum": 0,
+          "maximum": 255
+        },
+        "dark": {
+          "type": "boolean",
+          "description": "The parts are darker than the background."
+        },
+        "minArea": {
+          "type": "number",
+          "description": "The smallest part, in the sheet’s units squared.",
+          "minimum": 0
+        },
+        "outline": {
+          "type": "number",
+          "description": "Add each outline, thinned to this, in the sheet’s units.",
+          "exclusiveMinimum": 0
+        },
+        "limit": {
+          "type": "integer",
+          "description": "Parts at most — 100 by default.",
+          "minimum": 1,
+          "maximum": 1000
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "flat.open_image",
     "title": "Open a flatbed image",
@@ -1718,23 +2077,294 @@
     "returnsImage": false
   },
   {
-    "name": "flat.report",
-    "title": "Get the 2D report",
-    "description": "The 2D Measure report as its Copy button gives it: the image or section, the scale it rests on, the alignment, every element and dimension.",
+    "name": "flat.profile",
+    "title": "Profile an outline and count its peaks",
+    "description": "An outline read against a centre or along an axis, and its peaks counted — the teeth of a knurl or a gear. The outline: an object of the last flat.objects by number, or edge chains by number (several make one). radial (the default): its radius against the angle about about — a circle, arc or point — or about the outline’s own centre: a part standing upright, seen from above. axial: its distance from about — a line — or from the outline’s own long axis, against the position along it, each side apart (left and right of the axis’ direction): a part lying on its side. A peak counts when it stands prominence above the higher of the valleys either side — by default 0.3 of the profile’s spread, never under the outline’s noise. Returns per side the count, the pitch (degrees round, or along the axis), the envelope (largest, smallest, mean peak, mean valley; radial also as diameters) and every peak’s angle or position and place; points adds the sampled profile. mark: true puts a count on the sheet with a numbered pick on every peak, to check by eye — one undo step; otherwise nothing changes.",
     "input": {
       "type": "object",
-      "properties": {},
-      "additionalProperties": false
-    },
-    "readOnly": true,
-    "returnsFile": false,
-    "returnsImage": false
-  },
-  {
-    "name": "flat.set_alignment",
-    "title": "Align the sheet",
-    "description": "Put the sheet’s zero point at origin and its X axis through xAxis, as the Align tool’s two clicks do — every coordinate on the sheet is then read in that frame. clear: true takes the alignment off. Returns the 2D state. One undo step.",
-    "input": {
+      "properties": {
+        "object": {
+          "type": "integer",
+          "description": "An object of the last flat.objects, by number.",
+          "minimum": 1
+        },
+        "chains": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "description": "Edge chains by number, as one outline.",
+          "minItems": 1
+        },
+        "about": {
+          "oneOf": [
+            {
+              "type": "integer",
+              "description": "The 2D element’s id.",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "description": "Its name — \"Line 1\".",
+              "minLength": 1
+            }
+          ],
+          "description": "A circle, arc or point to read the radius about, or a line to read the distance from."
+        },
+        "axis": {
+          "type": "string",
+          "enum": [
+            "radial",
+            "axial"
+          ],
+          "description": "Without about: radial about the outline’s centre (the default), or axial along its long axis."
+        },
+        "samples": {
+          "type": "integer",
+          "description": "Bins round the turn, or along the axis — from the point count by default.",
+          "minimum": 16,
+          "maximum": 20000
+        },
+        "prominence": {
+          "type": "number",
+          "description": "How far a peak must stand out, in the sheet’s units.",
+          "exclusiveMinimum": 0
+        },
+        "mark": {
+          "type": "boolean",
+          "description": "Put a count on every peak."
+        },
+        "points": {
+          "type": "boolean",
+          "description": "Add the sampled profile."
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "flat.remove",
+    "title": "Remove from the 2D sheet",
+    "description": "Remove elements, dimensions, notes and counts from the 2D sheet, each by id or name (a note by id) — all of them or none. An element built on a removed one stays and says it has lost its source, and a dimension on one turns invalid, as in the panel; the answer names them. Returns what is left. One undo step.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "elements": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "integer",
+                "description": "The 2D element’s id.",
+                "minimum": 1
+              },
+              {
+                "type": "string",
+                "description": "Its name — \"Line 1\".",
+                "minLength": 1
+              }
+            ],
+            "description": "A 2D element."
+          }
+        },
+        "dimensions": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "integer",
+                "minimum": 1
+              },
+              {
+                "type": "string",
+                "minLength": 1
+              }
+            ]
+          },
+          "description": "Dimensions, by id or name."
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "description": "Notes, by id."
+        },
+        "counts": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "integer",
+                "minimum": 1
+              },
+              {
+                "type": "string",
+                "minLength": 1
+              }
+            ]
+          },
+          "description": "Counts, by id or name."
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "flat.render",
+    "title": "Picture the sheet",
+    "description": "A picture of the 2D sheet as a PNG, drawn as the sheet lies in the sheet’s own units — +X right, +Y up, whatever the stage’s alignment or turns — with a grid ruled in those units and its values written along the top and left edges. map says where it lies: picture pixel (column c, row r from the top) is the sheet place [left + c·unitsPerPx, top − r·unitsPerPx], to hand straight back as a place. frame zooms in on a box. show puts layers in or out: image, edges (the detected chains — as the panel shows them by default), chains (their numbers, as flat.fit and flat.edges name them), elements (with counts and the alignment), dimensions, notes, labels (names and readings), grid. width and height in pixels: the frame’s shape at most 800 on its long side by default, up to 2048. Needs the browser.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "frame": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "min": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The lowest corner.",
+                  "minItems": 2,
+                  "maxItems": 2
+                },
+                "max": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The highest corner.",
+                  "minItems": 2,
+                  "maxItems": 2
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "additionalProperties": false,
+              "description": "A box on the sheet."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "at": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "Its centre.",
+                  "minItems": 2,
+                  "maxItems": 2
+                },
+                "size": {
+                  "oneOf": [
+                    {
+                      "type": "number",
+                      "exclusiveMinimum": 0
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "type": "number",
+                        "exclusiveMinimum": 0
+                      },
+                      "minItems": 2,
+                      "maxItems": 2
+                    }
+                  ],
+                  "description": "Its side, or [width, height]."
+                }
+              },
+              "required": [
+                "at",
+                "size"
+              ],
+              "additionalProperties": false,
+              "description": "A box round a place."
+            }
+          ],
+          "description": "What to picture, in the sheet’s units — the whole sheet by default."
+        },
+        "width": {
+          "type": "integer",
+          "description": "Pixels across, 64 to 2048.",
+          "minimum": 64,
+          "maximum": 2048
+        },
+        "height": {
+          "type": "integer",
+          "description": "Pixels down, 64 to 2048.",
+          "minimum": 64,
+          "maximum": 2048
+        },
+        "show": {
+          "type": "object",
+          "properties": {
+            "image": {
+              "type": "boolean"
+            },
+            "edges": {
+              "type": "boolean"
+            },
+            "chains": {
+              "type": "boolean"
+            },
+            "elements": {
+              "type": "boolean"
+            },
+            "dimensions": {
+              "type": "boolean"
+            },
+            "notes": {
+              "type": "boolean"
+            },
+            "labels": {
+              "type": "boolean"
+            },
+            "grid": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Layers in (true) or out (false)."
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": true,
+    "returnsImage": true
+  },
+  {
+    "name": "flat.report",
+    "title": "Get the 2D report",
+    "description": "The 2D Measure report as its Copy button gives it: the image or section, the scale it rests on, the alignment, every element, dimension, count and note.",
+    "input": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "flat.set_alignment",
+    "title": "Align the sheet",
+    "description": "Put the part’s zero point at origin and its X axis through xAxis, as the Align tool’s two clicks do: the report, the panel and the exports then read in that frame. Places given to the commands stay the sheet’s own. clear: true takes the alignment off. Returns the 2D state. One undo step.",
+    "input": {
       "type": "object",
       "properties": {
         "origin": {
@@ -1766,6 +2396,19 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "history.checkpoint",
+    "title": "Mark the history",
+    "description": "Mark where the undo history stands, before a run of changes that should stand or fall together: history.restore { checkpoint } later undoes every step made since, back to this mark. Changes nothing. Returns the checkpoint, the step on top and how many there are.",
+    "input": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "history.redo",
     "title": "Redo",
@@ -1779,6 +2422,28 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "history.restore",
+    "title": "Back to a mark in the history",
+    "description": "Undo every step made since history.checkpoint gave this checkpoint, newest first, as the undo key would one by one — so a run of changes that went wrong in the middle is taken back whole. Refused, undoing nothing, when the mark is no longer under the steps on top — undone past it, or the history started afresh (a scan or a project opened). Returns the steps undone, newest first, and the session afterwards.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "checkpoint": {
+          "type": "string",
+          "description": "What history.checkpoint returned.",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "checkpoint"
+      ],
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "history.undo",
     "title": "Undo",
@@ -1823,6 +2488,27 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "project.rename",
+    "title": "Name the project",
+    "description": "Give the project a name — what Save Project saves it under, the stem of every export and the browser tab’s title, kept in the project file. An empty name takes it off, and the scan’s or the image’s name stands in again. session.state reads it as project.name.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name; empty takes it off."
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "project.save",
     "title": "Save the project",
@@ -1868,6 +2554,99 @@
     "returnsFile": false,
     "returnsImage": false
   },
+  {
+    "name": "scan.fit_surface",
+    "title": "Fit a sloped or curved patch",
+    "description": "A patch of the scan measured as a surface — a sloped side, a twisted ruled face, a dome, a saddle, a fairing — the points given as vertices (from scan.query or a patch) or as a box (normal keeps those facing a way, within withinDeg, 30 by default). The best plane through them sets the patch’s own frame: origin at their centroid, normal (w) out of it, basisU and basisV in it, all in the frame the part is measured in now. Each model is a height over (u, v) along the normal: plane h = a + b·u + c·v; bilinear + d·u·v (a hyperbolic paraboloid: a straight-lined twisted face); quadric + d·u² + e·u·v + f·v² (a dome, bowl, saddle or a cylinder’s strip). Each answers its coefficients, rms and worst (mm off along the normal); the quadric also curvature: k1 and k2 (1/mm, the larger first), r1 and r2 (their radii, null where flat), axis1 and axis2 (their directions in the world) and shape (flat, cylinder, dome or saddle) at the patch’s middle. model: one of them, or best (the default) — every one, and best names the simplest whose rms is within a tenth of the lowest: the model that holds, plain. At most limit points are fitted (20000), spread evenly. Changes nothing.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "vertices": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "description": "The scan vertices of the patch.",
+          "minItems": 7
+        },
+        "box": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The lowest corner, mm.",
+              "minItems": 3,
+              "maxItems": 3
+            },
+            "max": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The highest corner, mm.",
+              "minItems": 3,
+              "maxItems": 3
+            }
+          },
+          "required": [
+            "min",
+            "max"
+          ],
+          "additionalProperties": false,
+          "description": "The patch as the scan inside a box, in place of vertices."
+        },
+        "normal": {
+          "type": "object",
+          "properties": {
+            "dir": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The direction, any length.",
+              "minItems": 3,
+              "maxItems": 3
+            },
+            "withinDeg": {
+              "type": "number",
+              "description": "Degrees; 30 by default.",
+              "exclusiveMinimum": 0,
+              "maximum": 180
+            }
+          },
+          "required": [
+            "dir"
+          ],
+          "additionalProperties": false,
+          "description": "With box: only the vertices facing this way."
+        },
+        "model": {
+          "type": "string",
+          "enum": [
+            "plane",
+            "bilinear",
+            "quadric",
+            "best"
+          ],
+          "description": "Which surface; best (the default) fits each and names the simplest that holds."
+        },
+        "limit": {
+          "type": "integer",
+          "description": "How many points at most; 20000 by default.",
+          "minimum": 7,
+          "maximum": 20000
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
   {
     "name": "scan.nearest",
     "title": "Find a place on the scan",
@@ -1966,81 +2745,345 @@
           "format": "binary",
           "description": "The file’s contents."
         },
-        "name": {
-          "type": "string",
-          "description": "The file's name with its extension — \"ballbar.stl\". It is what the session calls the model.",
-          "minLength": 1
+        "name": {
+          "type": "string",
+          "description": "The file's name with its extension — \"ballbar.stl\". It is what the session calls the model.",
+          "minLength": 1
+        },
+        "units": {
+          "type": "string",
+          "enum": [
+            "mm",
+            "cm",
+            "m",
+            "in"
+          ],
+          "description": "What the file’s coordinates are in: mm (the default), cm, m or in. An STL carries no units of its own; PLY and OBJ are taken in millimetres unless told otherwise. Everything is measured in millimetres once read."
+        },
+        "discard": {
+          "type": "boolean",
+          "description": "Replace the session even though it holds measurements — they are lost (a project file saved before keeps them). Without it the command refuses when there is work to lose."
+        }
+      },
+      "required": [
+        "bytes",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "scan.query",
+    "title": "Read the scan’s points",
+    "description": "The scan’s vertices inside a box, or within a radius of a point, with their outward normals — the points on a face, to measure a dimension or a draft angle off, or to see what the scan has where a model is being built. normal keeps only the vertices facing a direction (within withinDeg, 30 by default): the top face alone, say. At most limit come back (1000 by default, 20000 at most): past it every k-th matching vertex is kept, spread evenly, and step says which k. Returns how many matched, the vertices kept (their numbers, as scan.nearest and element.fit_marked name them), their points and normals in millimetres, in the frame the part is measured in now, the box round the points kept, their centroid and mean normal. Changes nothing.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "box": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The lowest corner, mm.",
+              "minItems": 3,
+              "maxItems": 3
+            },
+            "max": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The highest corner, mm.",
+              "minItems": 3,
+              "maxItems": 3
+            }
+          },
+          "required": [
+            "min",
+            "max"
+          ],
+          "additionalProperties": false,
+          "description": "A box in the frame the part is measured in now."
+        },
+        "near": {
+          "type": "object",
+          "properties": {
+            "at": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The centre, mm.",
+              "minItems": 3,
+              "maxItems": 3
+            },
+            "radius": {
+              "type": "number",
+              "description": "How far from it, mm.",
+              "exclusiveMinimum": 0
+            }
+          },
+          "required": [
+            "at",
+            "radius"
+          ],
+          "additionalProperties": false,
+          "description": "A ball about a point — in place of box."
+        },
+        "normal": {
+          "type": "object",
+          "properties": {
+            "dir": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The direction, any length.",
+              "minItems": 3,
+              "maxItems": 3
+            },
+            "withinDeg": {
+              "type": "number",
+              "description": "How far from it a normal may lean, degrees; 30 by default.",
+              "exclusiveMinimum": 0,
+              "maximum": 180
+            }
+          },
+          "required": [
+            "dir"
+          ],
+          "additionalProperties": false,
+          "description": "Keep only the vertices whose outward normal faces this way."
+        },
+        "limit": {
+          "type": "integer",
+          "description": "How many vertices at most; 1000 by default, 20000 at most.",
+          "minimum": 1,
+          "maximum": 20000
+        }
+      },
+      "additionalProperties": false
+    },
+    "readOnly": true,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "section.cut",
+    "title": "Cut a section",
+    "description": "Cut the scan with a plane and keep the cut as a section, measured in the 2D workspace (flat) — where it is put on the sheet. across is what the plane is taken across: an element with a direction (a plane, cylinder, cone, line or circle) by id or name, or a coordinate plane \"XY\", \"YZ\" or \"ZX\", which is laid through the part’s centre. offset slides the plane along its normal, mm — from the element, or for a coordinate plane the coordinate itself. Returns the section: its plane and how many chains the cut has. One undo step.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "across": {
+          "oneOf": [
+            {
+              "type": "integer",
+              "description": "The element’s id.",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "description": "The element’s name, as the list shows it — \"Sphere 1\".",
+              "minLength": 1
+            }
+          ],
+          "description": "An element with a direction, or a coordinate plane \"XY\", \"YZ\", \"ZX\"."
+        },
+        "offset": {
+          "type": "number",
+          "description": "Where along the normal the plane lies, mm."
+        },
+        "name": {
+          "type": "string",
+          "description": "A name for it; otherwise it is numbered — \"Section 2\".",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "across"
+      ],
+      "additionalProperties": false
+    },
+    "readOnly": false,
+    "returnsFile": false,
+    "returnsImage": false
+  },
+  {
+    "name": "section.get",
+    "title": "Read a section’s polylines",
+    "description": "A section’s cut as the polylines it is: each chain’s points in order, as the 2D sheet lays them flat — [u, v] millimetres in the section’s plane, what flat.fit and a sketch on the section take — and, with space \"world\" or \"both\", as [x, y, z] in the frame the part is measured in now. With them the plane (origin, normal, basisU, basisV: a sheet point is origin + u·basisU + v·basisV), and for each chain whether it is closed (a loop; its first point is repeated at the end), its length along the path, how many points it has and the box round it on the sheet. At most limit points come back over all the chains (4000 by default, 50000 at most): past it every k-th point of a chain is kept, its ends always, and step says which k. chains picks chains by their index. Changes nothing.",
+    "input": {
+      "type": "object",
+      "properties": {
+        "section": {
+          "oneOf": [
+            {
+              "type": "integer",
+              "description": "The section’s id.",
+              "minimum": 1
+            },
+            {
+              "type": "string",
+              "description": "The section’s name, as the list shows it — \"Section 1\".",
+              "minLength": 1
+            }
+          ],
+          "description": "The section, by id or name."
+        },
+        "chains": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "description": "A chain’s index.",
+            "minimum": 0
+          },
+          "description": "Which chains; every one when left out.",
+          "minItems": 1
         },
-        "units": {
+        "space": {
           "type": "string",
           "enum": [
-            "mm",
-            "cm",
-            "m",
-            "in"
+            "sheet",
+            "world",
+            "both"
           ],
-          "description": "What the file’s coordinates are in: mm (the default), cm, m or in. An STL carries no units of its own; PLY and OBJ are taken in millimetres unless told otherwise. Everything is measured in millimetres once read."
+          "description": "sheet (the default): [u, v] on the section’s plane; world: [x, y, z]; both."
         },
-        "discard": {
-          "type": "boolean",
-          "description": "Replace the session even though it holds measurements — they are lost (a project file saved before keeps them). Without it the command refuses when there is work to lose."
+        "limit": {
+          "type": "integer",
+          "description": "How many points at most, over every chain asked for; 4000 by default, 50000 at most.",
+          "minimum": 2,
+          "maximum": 50000
         }
       },
       "required": [
-        "bytes",
-        "name"
+        "section"
       ],
       "additionalProperties": false
     },
-    "readOnly": false,
+    "readOnly": true,
     "returnsFile": false,
     "returnsImage": false
   },
   {
-    "name": "section.cut",
-    "title": "Cut a section",
-    "description": "Cut the scan with a plane and keep the cut as a section, measured in the 2D workspace (flat) — where it is put on the sheet. across is what the plane is taken across: an element with a direction (a plane, cylinder, cone, line or circle) by id or name, or a coordinate plane \"XY\", \"YZ\" or \"ZX\", which is laid through the part’s centre. offset slides the plane along its normal, mm — from the element, or for a coordinate plane the coordinate itself. Returns the section: its plane and how many chains the cut has. One undo step.",
+    "name": "section.render",
+    "title": "Picture a section",
+    "description": "A picture of a section as a PNG, for checking a slice against what was built on it: the scan’s cut as points on the section’s sheet ([u, v] mm as section.get gives them, +u right, +v up), a grid ruled in millimetres with its values at the top and left margins, a scale bar, and over it what the workspaces’ layers draw — a model’s cut by the section’s plane as outlines, a sketch’s pieces on the section with their ids. Every scan point within ten tolerances of an outline is read against it: on it within ± tolerance (grey), or off it (red), outside the outline or inside it; points with no outline near are pale. The answer gives gap: points (the cut’s), read, over (red), outside and inside (of a closed outline — inside is scan within the model’s material, so the model stands proud there; outside, the model is short), max and rms (mm) and overBox (the sheet box round the red, to frame the next look); layers: each layer drawn by key, its outlines and pieces counted; map: picture pixel (column c, row r from the top) is the sheet place [left + c·unitsPerPx, top − r·unitsPerPx]. section names a section; or plane { origin, normal } cuts the scan there for the picture alone — no section is made, the sheet’s u and v any pair square to the normal (the answer’s sheet gives them). frame { at: [u, v], size } looks at a square of the sheet; everything by default. tolerance: the Deviation workspace’s by default. layers: the keys to draw; every one by default, [] for the scan alone. 800 px on the long side by default, up to 2048. Needs the browser. Changes nothing.",
     "input": {
       "type": "object",
       "properties": {
-        "across": {
+        "section": {
           "oneOf": [
             {
               "type": "integer",
-              "description": "The element’s id.",
+              "description": "The section’s id.",
               "minimum": 1
             },
             {
               "type": "string",
-              "description": "The element’s name, as the list shows it — \"Sphere 1\".",
+              "description": "The section’s name — \"Section 1\".",
               "minLength": 1
             }
           ],
-          "description": "An element with a direction, or a coordinate plane \"XY\", \"YZ\", \"ZX\"."
+          "description": "The section, by id or name."
         },
-        "offset": {
+        "plane": {
+          "type": "object",
+          "properties": {
+            "origin": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "A point on the plane, mm.",
+              "minItems": 3,
+              "maxItems": 3
+            },
+            "normal": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "Its normal.",
+              "minItems": 3,
+              "maxItems": 3
+            }
+          },
+          "required": [
+            "origin",
+            "normal"
+          ],
+          "additionalProperties": false,
+          "description": "A plane to cut the scan by for the picture alone, in place of a section."
+        },
+        "frame": {
+          "type": "object",
+          "properties": {
+            "at": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "The sheet place in the middle, [u, v] mm.",
+              "minItems": 2,
+              "maxItems": 2
+            },
+            "size": {
+              "type": "number",
+              "description": "The side of the square looked at, mm.",
+              "exclusiveMinimum": 0
+            }
+          },
+          "required": [
+            "at",
+            "size"
+          ],
+          "additionalProperties": false,
+          "description": "Look at a square of the sheet."
+        },
+        "tolerance": {
           "type": "number",
-          "description": "Where along the normal the plane lies, mm."
+          "description": "± mm a scan point may lie off the outlines and still be on them.",
+          "exclusiveMinimum": 0
         },
-        "name": {
-          "type": "string",
-          "description": "A name for it; otherwise it is numbered — \"Section 2\".",
-          "minLength": 1
+        "layers": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "The layers to draw, by key; every one by default."
+        },
+        "width": {
+          "type": "integer",
+          "description": "Pixels across, 64 to 2048.",
+          "minimum": 64,
+          "maximum": 2048
+        },
+        "height": {
+          "type": "integer",
+          "description": "Pixels down, 64 to 2048.",
+          "minimum": 64,
+          "maximum": 2048
         }
       },
-      "required": [
-        "across"
-      ],
       "additionalProperties": false
     },
-    "readOnly": false,
-    "returnsFile": false,
-    "returnsImage": false
+    "readOnly": true,
+    "returnsFile": true,
+    "returnsImage": true
   },
   {
     "name": "session.reset",
     "title": "Start over",
-    "description": "Close the scan, the reference part and the 2D image, and with them every measurement, as opening an empty project does. Refuses while the session holds measurements unless discard is true. Not undoable: the history starts over too.",
+    "description": "Close the scan, the reference part and the 2D image, and with them every measurement and the project’s name, as opening an empty project does. Refuses while the session holds measurements unless discard is true. Not undoable: the history starts over too.",
     "input": {
       "type": "object",
       "properties": {
@@ -2058,7 +3101,7 @@
   {
     "name": "session.state",
     "title": "Read the session",
-    "description": "The whole session as JSON: the app and its plugins, the workspace on screen, whether it is busy, the scan (file, units, vertex and triangle counts, bounding box, centre, size, applied alignment), every element with its fit at full precision, every dimension with its value, limit and verdict, the sections, what is open in the panels, the deviation, wall thickness and 2D Measure state with their statistics, the guided hint for the next step, and the undo history. Lengths in millimetres, angles in degrees. Read it before acting and after.",
+    "description": "The whole session as JSON: the app and its plugins, the workspace on screen, whether it is busy, the scan (file, units, vertex and triangle counts, bounding box, centre, size, applied alignment), every element with its fit, every dimension with its value, limit and verdict, the sections, what is open in the panels, the deviation, wall thickness and 2D Measure state with their statistics, the guided hint for the next step, and the undo history. Lengths in millimetres, angles in degrees. Read it before acting and after.",
     "input": {
       "type": "object",
       "properties": {},
@@ -2203,7 +3246,7 @@
   {
     "name": "view.render",
     "title": "Picture the view",
-    "description": "A picture of the 3D view as a PNG — what the person sees in the viewport, without the HTML labels over it (dimension values, names). Give view and/or fit to turn the view first, as view.set does. width and height in pixels: the viewport’s own shape at most 1280 pixels on its long side by default; one of them alone keeps the viewport’s shape. Waits for the session to settle first. Needs the viewport.",
+    "description": "A picture of the 3D view as a PNG — what the person sees in the viewport, without the HTML labels over it (dimension values, names). Give view and/or fit to turn the view first, as view.set does, or frame to frame a box or a place. show puts the scan, the reference, the sections, the elements or the labels on screen or away for the picture alone, by key — { scan: false } pictures what was built on the scan on its own; view.set lists the keys. section cuts everything open for the picture alone, as view.set does. width and height in pixels: the viewport’s own shape at most 800 pixels on its long side by default, enough to check a step by — ask for more (up to 2048) for a picture to keep; one of them alone keeps the viewport’s shape. Waits for the session to settle first. Needs the viewport.",
     "input": {
       "type": "object",
       "properties": {
@@ -2235,6 +3278,127 @@
         "fit": {
           "type": "boolean",
           "description": "Bring everything shown into the frame, keeping the direction looked from."
+        },
+        "show": {
+          "type": "object",
+          "description": "What to show or put away, by key, true or false: scan, reference (the Deviation workspace’s reference part), sections, elements (the measured elements and dimensions), labels — and the keys a workspace adds (view.set answers with every key standing now and whether it is shown). { scan: false } pictures what was built on the scan on its own.",
+          "properties": {
+            "scan": {
+              "type": "boolean"
+            },
+            "reference": {
+              "type": "boolean"
+            },
+            "sections": {
+              "type": "boolean"
+            },
+            "elements": {
+              "type": "boolean"
+            },
+            "labels": {
+              "type": "boolean"
+            }
+          }
+        },
+        "frame": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "min": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The lowest corner, mm.",
+                  "minItems": 3,
+                  "maxItems": 3
+                },
+                "max": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The highest corner, mm.",
+                  "minItems": 3,
+                  "maxItems": 3
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "additionalProperties": false,
+              "description": "A box, in the frame the part is measured in now."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "at": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The centre, mm.",
+                  "minItems": 3,
+                  "maxItems": 3
+                },
+                "size": {
+                  "type": "number",
+                  "description": "The width of the view there, mm.",
+                  "exclusiveMinimum": 0
+                }
+              },
+              "required": [
+                "at",
+                "size"
+              ],
+              "additionalProperties": false,
+              "description": "A place, looked at from `size` mm across."
+            }
+          ],
+          "description": "Frame a box or a place instead of everything shown — a corner or a fillet looked at closely; fit is then left alone."
+        },
+        "section": {
+          "oneOf": [
+            {
+              "type": "boolean",
+              "description": "true opens it as the Section key does — square to the view, through the part’s middle; false puts it away."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "across": {
+                  "oneOf": [
+                    {
+                      "type": "integer",
+                      "description": "The element’s id.",
+                      "minimum": 1
+                    },
+                    {
+                      "type": "string",
+                      "description": "The element’s name, as the list shows it — \"Sphere 1\".",
+                      "minLength": 1
+                    }
+                  ],
+                  "description": "A coordinate plane \"XY\", \"YZ\", \"ZX\", or an element with a direction."
+                },
+                "offset": {
+                  "type": "number",
+                  "description": "Where along its normal, mm: for a coordinate plane the coordinate, for an element from its centre."
+                },
+                "flip": {
+                  "type": "boolean",
+                  "description": "Take away the half away from the camera instead."
+                }
+              },
+              "required": [
+                "across"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "The section view: everything cut open at a plane, the half toward the camera taken away, closed parts capped — to see inside. Set after any turn."
         }
       },
       "additionalProperties": false
@@ -2246,7 +3410,7 @@
   {
     "name": "view.set",
     "title": "Turn the view",
-    "description": "Turn the 3D view to a standard view and/or fit everything shown into the frame — with neither given, it fits. It waits for the session to settle first (a fit, a map, a rebuild), so what was just made is in the frame. Not a step of the history. Needs the viewport. Returns the view.",
+    "description": "Turn the 3D view to a standard view and/or fit everything shown into the frame — with neither given, it fits — or frame a box or a place (frame). show puts the scan, the reference, the sections, the elements or the labels on screen or away, by key, and leaves them so — { scan: false } to look at what was built on the scan without it. section cuts everything open at a plane to look inside, and leaves it so. It waits for the session to settle first (a fit, a map, a rebuild), so what was just made is in the frame. Not a step of the history. Needs the viewport. Returns the view, the section view (null when off) and, under shown, every key that can be shown now and whether it is.",
     "input": {
       "type": "object",
       "properties": {
@@ -2266,6 +3430,127 @@
         "fit": {
           "type": "boolean",
           "description": "Bring everything shown into the frame, keeping the direction looked from."
+        },
+        "show": {
+          "type": "object",
+          "description": "What to show or put away, by key, true or false: scan, reference (the Deviation workspace’s reference part), sections, elements (the measured elements and dimensions), labels — and the keys a workspace adds (view.set answers with every key standing now and whether it is shown). { scan: false } pictures what was built on the scan on its own.",
+          "properties": {
+            "scan": {
+              "type": "boolean"
+            },
+            "reference": {
+              "type": "boolean"
+            },
+            "sections": {
+              "type": "boolean"
+            },
+            "elements": {
+              "type": "boolean"
+            },
+            "labels": {
+              "type": "boolean"
+            }
+          }
+        },
+        "frame": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "min": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The lowest corner, mm.",
+                  "minItems": 3,
+                  "maxItems": 3
+                },
+                "max": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The highest corner, mm.",
+                  "minItems": 3,
+                  "maxItems": 3
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "additionalProperties": false,
+              "description": "A box, in the frame the part is measured in now."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "at": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  },
+                  "description": "The centre, mm.",
+                  "minItems": 3,
+                  "maxItems": 3
+                },
+                "size": {
+                  "type": "number",
+                  "description": "The width of the view there, mm.",
+                  "exclusiveMinimum": 0
+                }
+              },
+              "required": [
+                "at",
+                "size"
+              ],
+              "additionalProperties": false,
+              "description": "A place, looked at from `size` mm across."
+            }
+          ],
+          "description": "Frame a box or a place instead of everything shown — a corner or a fillet looked at closely; fit is then left alone."
+        },
+        "section": {
+          "oneOf": [
+            {
+              "type": "boolean",
+              "description": "true opens it as the Section key does — square to the view, through the part’s middle; false puts it away."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "across": {
+                  "oneOf": [
+                    {
+                      "type": "integer",
+                      "description": "The element’s id.",
+                      "minimum": 1
+                    },
+                    {
+                      "type": "string",
+                      "description": "The element’s name, as the list shows it — \"Sphere 1\".",
+                      "minLength": 1
+                    }
+                  ],
+                  "description": "A coordinate plane \"XY\", \"YZ\", \"ZX\", or an element with a direction."
+                },
+                "offset": {
+                  "type": "number",
+                  "description": "Where along its normal, mm: for a coordinate plane the coordinate, for an element from its centre."
+                },
+                "flip": {
+                  "type": "boolean",
+                  "description": "Take away the half away from the camera instead."
+                }
+              },
+              "required": [
+                "across"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "The section view: everything cut open at a plane, the half toward the camera taken away, closed parts capped — to see inside. Set after any turn."
         }
       },
       "additionalProperties": false