theater.needle.tools

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Image URL: http(s), a small data:image/ URL, or /api/sheets/<id>. For a large PNG/WebP, POST its raw bytes to /api/sheets (5 MB maximum) and use the returned URL within two hours. Other origins must allow CORS so the image can be cut."
    },
    "columns": {
      "type": "number",
      "description": "Cells across."
    },
    "rows": {
      "type": "number",
      "description": "Cells down."
    },
    "as": {
      "type": "string",
      "enum": [
        "actors",
        "backgrounds"
      ],
      "description": "What is on it. 'actors' is for anything that stands on a stage — use it for scenery too, since a tree is cut out exactly as a person is. 'backgrounds' is a legacy import mode and is not used by stage_create in new plays."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What each cell is, in reading order — left to right, then down."
    }
  },
  "required": [
    "url",
    "columns",
    "rows",
    "as"
  ]
}