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 }
[[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"]
