Picogen on the Commandline: A Reference

From Picogen-doc

Contents

picogen ...

parameters flags purpose example
show [wc] w, c Print warranty ('w') or conditions ('c') and exit. picogen show w
ssdf ... ... Start a rendition. This is the core feature of picogen. picogen ssdf -f ./awesome.ssdf -w 800 -h 600
mkskymap ... ... A tool to generate nice Skies based on the Model by Preetham, et al. picogen mkskymap --turbidity 2.2
mkheightmap ... ... A tool to generate and test procedural heightmaps. picogen mkheightmap -Lhs "([2 LayeredNoise seed(42)] x y)" --preview


picogen ssdf

picogen mkskymap

short long purpose example
-Lhs {string} (subject to change) --Lheight-slang {string} (subject to change) Code in Jux-Syntax to be used for simple clouds. (Under heavy development.)
-En {name:string} (subject to change) --ExportName {name:string} (subject to change) Filename-Basis. picogen mkskymap -En raboof -Ebmp
-Et --Etext Export the skymap into a textfile (not implemented currently).
-Ebmp --Ebmp Export the skymap into a bitmap-file (not implemented currently).
-p --preview Open a display with a preview of the sky with given parameters.
-f --force-overwrite Overwrite existing destination files without further annoying you. Know what you do.
-w {size:integer>0} --width {size:integer>0} Width of the skymap. Affects preview and final results.
-h {size:integer>0} --height {size:integer>0} Height of the skymap. Affects preview and final results.
-a {size:integer>0} --anti-aliasing {size:integer>0} Draw smoother edges (see Antialiasing). Internally, the image will be drawn size*size times larger, and the resized down again with a simple filter.
-W {real} --domain-width {real} obsolete
-d {x:real} {y:real} {z:real} --direction {x:real} {y:real} {z:real} Sets the sun direction in form of a 3d-Vector; x is for left to right, y is for bottom to top, z is for front to back
-C {r:real} {g:real} {b:real} --sun-color {r:real} {g:real} {b:real} Sets the sun color in RGB-Colors where r, g and b are in the range [0..1].
-F {r:real} {g:real} {b:real} --color-filter {r:real} {g:real} {b:real} Sets a color filter for the atmosphere in RGB-Colors where r, g and b are in the range [0..1].
-O {density:real} {maxRange:real} --fog-hack {density:real} {maxRange:real} Enables a quick-and-dirty solution for fog. The smaller the density, the less intense the fog. The value of maxRange describes the maximum distance at which the fog will "stop getting thicker". It is usable once when you have objects in your scene that are hundreds or thousands of kilometers away from the camera (like moons).
-t {real} --turbidity {real} Sets the turbidity. The turbidity is a measure on how much dust- and microparticles are in the atmosphere. The higher this value, the less transparent the atmosphere will become. According to another paper about the Preetham, et al. one (A Critical Review of the Preetham Skylight Model"), values between 1.9 and 10.0 will yield realistic results.
-A {real} --solid-angle {real} Multiply the standard size of the sun-disk with this value.
-o {real} --falloff {real} Another hack to enable a smooth transition from the full-intensity sun disk to the pure atmosphere. This feature is work in progress.

picogen mkheightmap