{
  "id": "povray",
  "name": "POV-Ray",
  "homepage": "https://github.com/POV-Ray/povray",
  "description": "The Persistence of Vision Raytracer (POV-Ray)",
  "executables": [
    "povray"
  ],
  "dotfiles": {
    "paths": [
      "~/.povrayrc",
      "~/.povray/*/povray.ini",
      "~/.povray/*/povray.conf"
    ],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Render a scene",
    "description": "Render a POV-Ray scene file at a chosen size, quality and output file. Switch-style options (+D, +P, +V, +F...) are left out because a leading - turns a switch off.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "man",
        "kind": "manual",
        "url": "https://manpages.debian.org/unstable/povray/povray.1.en.html",
        "revision": "debian unstable 2026-10",
        "evidence": "Options can be specified with either a leading '+' or a leading '-'. For other options (those that are not switches), it doesn't matter if a '+' or a '-' is used. Most options cannot have spaces in them so you should specify +FN rather than +F N.\n-Iinput_file_name or Input_File_Name=file  Specifies the input file to use.\n-Hn or Height=integer  The image should be n pixels high.\n-Wn or Width=integer  The image should be n pixels wide.\n-Ooutput_file or Output_File_Name=file  Write the output to the file named output_file, or the standard output if '-' is given as the output file name.\n-Qn or Quality=integer  Render at quality n. Qualities range from 0 for rough images and 9 for complete ray-tracing and textures, and 10 and 11 add radiosity.\n"
      }
    ],
    "field": [
      {
        "id": "input",
        "label": "Scene file",
        "type": "path",
        "option": [
          "-I"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "man"
        ]
      },
      {
        "id": "width",
        "label": "Width (pixels)",
        "type": "integer",
        "option": [
          "-W"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "height",
        "label": "Height (pixels)",
        "type": "integer",
        "option": [
          "-H"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "quality",
        "label": "Quality (0-11)",
        "description": "0 is a rough image, 9 is complete ray-tracing and textures, 10 and 11 add radiosity.",
        "type": "integer",
        "option": [
          "-Q"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "output",
        "label": "Output file",
        "description": "Use - for standard output.",
        "type": "path",
        "option": [
          "-O"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "effect": "overwrite",
        "sources": [
          "man"
        ]
      }
    ],
    "task": [
      {
        "id": "render",
        "label": "Render a scene",
        "fields": [
          "input",
          "width",
          "height",
          "quality",
          "output"
        ],
        "required": [
          "input"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "input",
          "width",
          "height",
          "output"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "quality"
        ]
      }
    ]
  }
}