94 lines
2.7 KiB
Plaintext
94 lines
2.7 KiB
Plaintext
ALE(1)
|
|
======
|
|
David Hilvert <dhilvert@gmail.com>
|
|
|
|
NAME
|
|
----
|
|
ale - a synthetic capture engine and renderer
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*ale* ['OPTIONS'] 'original-frame' ['supplemental-frames' ...] 'output-file'
|
|
|
|
*ale* ['HELP OPTIONS']
|
|
|
|
*ale --version*
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
*ALE* is a free software synthetic capture engine and renderer accepting, as
|
|
input, a sequence of image frames, and producing, as output, rendered images,
|
|
registration data, and 3D models (currently experimental).
|
|
|
|
EXAMPLES
|
|
--------
|
|
*ale --hu*::
|
|
Print the help page on program usage.
|
|
|
|
*ale 001.ppm 002.ppm 003.ppm out.ppm*::
|
|
Render output file *out.ppm* from inputs *001.ppm*, *002.ppm*, and
|
|
*003.ppm*.
|
|
|
|
**ale --scale 2 001.ppm 002.ppm 003.ppm out.png**::
|
|
Render output file *out.png* at 2x scale.
|
|
|
|
**ale --perturb-upper=0 --trans-load=a.t --projective frame*.png out.png**::
|
|
Render output file *out.png* from inputs **frame*.png**, using
|
|
projective transformations as described in the file *a.t*.
|
|
|
|
**ale --3dv 0 out.png --projective frame*.png null:**::
|
|
Render output file *out.png* from inputs **frame*.png**, using a
|
|
3D scene model to determine transformations.
|
|
|
|
**ale --visp last:sinc*lanc:6 sf:0 out/ .jpg in/*.jpg null:**::
|
|
Render a video stream from files **in/\*.jpg** to the directory **out/**,
|
|
stabilizing to the first frame, with a lanczos-windowed sinc filter.
|
|
|
|
USAGE
|
|
-----
|
|
*ale* is a wrapper script that calls the executable *ale-bin* after extracting
|
|
exposure EXIF information from image files (when the *exiftool* utility is
|
|
available) and converting from raw formats (when the *dcraw* utility is
|
|
available).
|
|
|
|
When *ale-bin* has been linked with ImageMagick, input and output files may be
|
|
of any kind supported by ImageMagick. Otherwise, only PPM files can be read
|
|
and written by *ale-bin*.
|
|
|
|
OPTIONS
|
|
-------
|
|
'OPTIONS' are summarized via built-in help pages (see *HELP OPTIONS* below).
|
|
More detailed manuals describing options and internal algorithms are available
|
|
for certain versions of ALE. See *SEE ALSO* below for more details on other
|
|
manuals.
|
|
|
|
HELP OPTIONS
|
|
------------
|
|
A listing of available help options can be obtained by invoking *ale --hu*.
|
|
|
|
ENVIRONMENT
|
|
-----------
|
|
The wrapper script *ale* recognizes the following environment variables:
|
|
|
|
*ALE_BIN*::
|
|
ALE executable to use.
|
|
|
|
*DCRAW*::
|
|
dcraw raw extraction tool to use.
|
|
|
|
*EXIF_UTILITY*::
|
|
EXIF extraction utility to use.
|
|
|
|
*ALE_COUNT_THREADS*::
|
|
Displays statistics on thread counts when set to a non-zero value.
|
|
|
|
*PAGER*::
|
|
Text pager to use (e.g., for displaying help pages).
|
|
|
|
SEE ALSO
|
|
--------
|
|
More detailed manuals for certain versions of ALE are distributed with source
|
|
packages, and may also be available from:
|
|
|
|
http://auricle.dyndns.org/ALE/manuals/[]
|