reloadium.com

captureScanView

Look at a real 3D scan (see showScan) from a specific vantage point and get back a real photo-like image of what's there — use this to actually inspect an attached scan's content (e.g. before describing a room, labeling what's in it, or handing a view to annotateImage/editImage) rather than guessing from the title alone. Args: optional {"preset":"front"|"back"|"left"|"right"|"top-down"|"corner-ne"|"corner-nw"|"corner-se"|"corner-sw"} (default "front"), optional {"flip":true} if a PREVIOUS capture of this same scan came back upside down, optional {"url":"..."} only for a pasted-link scan rather than an attached one (omit to reuse whichever scan you most recently showed or the user attached). Call it a few times with different presets to build up a real understanding of a space before making claims about it — a single angle can miss most of a room. Presets are relative to the scan file's own raw coordinate axes, not a guaranteed true compass direction (real scans have no standardized orientation). Raw scan files carry no up-vector metadata, so there is no way to know ahead of time whether a given scan will render right-side up — after your first capture of a scan, actually look at it: upside-down text, ceilings appearing below floors, or furniture hanging downward all mean the scan is inverted. If so, call again with the same preset and "flip":true rather than assuming the content itself is just odd. When you intend to capture several presets of the same scan, check orientation on the FIRST capture before firing off the rest — it's a property of the whole scan, not one view, so an inverted first result means every subsequent call in the batch should also carry "flip":true, and checking upfront avoids capturing several views at the wrong orientation before noticing.

Page: /

Input schema

{
  "type": "object",
  "properties": {
    "preset": {
      "type": "string",
      "enum": [
        "front",
        "back",
        "left",
        "right",
        "top-down",
        "corner-ne",
        "corner-nw",
        "corner-se",
        "corner-sw"
      ],
      "description": "Which vantage point to view the scan from. Defaults to \"front\"."
    },
    "flip": {
      "type": "boolean",
      "description": "Set true to correct an upside-down scan, once you've noticed one from a prior capture (e.g. inverted text or furniture)."
    },
    "url": {
      "type": "string",
      "description": "URL to a .ply/.splat/.ksplat file — only for a pasted link. Omit to use the most recently attached scan."
    }
  },
  "required": []
}