id = "povray"
name = "POV-Ray"
homepage = "https://github.com/POV-Ray/povray"
description = "The Persistence of Vision Raytracer (POV-Ray)"
executables = ["povray"]

[dotfiles]

# The official Unix installer probes ~/.povrayrc and the per-version user
# files ~/.povray/X.Y/povray.ini and povray.conf. The Unix README confirms the
# per-user copy of these configuration files.
# https://github.com/POV-Ray/povray/blob/master/unix/install
# https://github.com/POV-Ray/povray/blob/master/unix/README.md
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 }

[[commands.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.
-Iinput_file_name or Input_File_Name=file  Specifies the input file to use.
-Hn or Height=integer  The image should be n pixels high.
-Wn or Width=integer  The image should be n pixels wide.
-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.
-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.
"""

[[commands.field]]
id = "input"
label = "Scene file"
type = "path"
option = ["-I"]
path = { kind = "file", role = "input" }
sources = ["man"]

[[commands.field]]
id = "width"
label = "Width (pixels)"
type = "integer"
option = ["-W"]
sources = ["man"]

[[commands.field]]
id = "height"
label = "Height (pixels)"
type = "integer"
option = ["-H"]
sources = ["man"]

[[commands.field]]
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"]

[[commands.field]]
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"]

[[commands.task]]
id = "render"
label = "Render a scene"
fields = ["input", "width", "height", "quality", "output"]
required = ["input"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["input", "width", "height", "output"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["quality"]