116 lines
3.3 KiB
Groff
116 lines
3.3 KiB
Groff
.\" Title: ale
|
|
.\" Author:
|
|
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
|
|
.\" Date: 03/31/2009
|
|
.\" Manual:
|
|
.\" Source:
|
|
.\"
|
|
.TH "ALE" "1" "03/31/2009" "" ""
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.SH "NAME"
|
|
ale \- a synthetic capture engine and renderer
|
|
.SH "SYNOPSIS"
|
|
\fBale\fR [\fIOPTIONS\fR] \fIoriginal\-frame\fR [\fIsupplemental\-frames\fR \&...] \fIoutput\-file\fR
|
|
.sp
|
|
\fBale\fR [\fIHELP OPTIONS\fR]
|
|
.sp
|
|
\fBale \-\-version\fR
|
|
.sp
|
|
.SH "DESCRIPTION"
|
|
\fBALE\fR 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)\&.
|
|
.sp
|
|
.SH "EXAMPLES"
|
|
.PP
|
|
\fBale \-\-hu\fR
|
|
.RS 4
|
|
Print the help page on program usage\&.
|
|
.RE
|
|
.PP
|
|
\fBale 001\&.ppm 002\&.ppm 003\&.ppm out\&.ppm\fR
|
|
.RS 4
|
|
Render output file
|
|
\fBout\&.ppm\fR
|
|
from inputs
|
|
\fB001\&.ppm\fR,
|
|
\fB002\&.ppm\fR, and
|
|
\fB003\&.ppm\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBale \-\-scale 2 001\&.ppm 002\&.ppm 003\&.ppm out\&.png\fR
|
|
.RS 4
|
|
Render output file
|
|
\fBout\&.png\fR
|
|
at 2x scale\&.
|
|
.RE
|
|
.PP
|
|
\fBale \-\-perturb\-upper=0 \-\-trans\-load=a\&.t \-\-projective frame*\&.png out\&.png\fR
|
|
.RS 4
|
|
Render output file
|
|
\fBout\&.png\fR
|
|
from inputs
|
|
\fBframe*\&.png\fR, using projective transformations as described in the file
|
|
\fBa\&.t\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBale \-\-3dv 0 out\&.png \-\-projective frame*\&.png null:\fR
|
|
.RS 4
|
|
Render output file
|
|
\fBout\&.png\fR
|
|
from inputs
|
|
\fBframe*\&.png\fR, using a 3D scene model to determine transformations\&.
|
|
.RE
|
|
.PP
|
|
\fBale \-\-visp last:sinc*lanc:6 sf:0 out/ \&.jpg in/*\&.jpg null:\fR
|
|
.RS 4
|
|
Render a video stream from files
|
|
\fBin/*\&.jpg\fR
|
|
to the directory
|
|
\fBout/\fR, stabilizing to the first frame, with a lanczos\-windowed sinc filter\&.
|
|
.RE
|
|
.SH "USAGE"
|
|
\fBale\fR is a wrapper script that calls the executable \fBale\-bin\fR after extracting exposure EXIF information from image files (when the \fBexiftool\fR utility is available) and converting from raw formats (when the \fBdcraw\fR utility is available)\&.
|
|
.sp
|
|
When \fBale\-bin\fR 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 \fBale\-bin\fR\&.
|
|
.sp
|
|
.SH "OPTIONS"
|
|
\fIOPTIONS\fR are summarized via built\-in help pages (see \fBHELP OPTIONS\fR below)\&. More detailed manuals describing options and internal algorithms are available for certain versions of ALE\&. See \fBSEE ALSO\fR below for more details on other manuals\&.
|
|
.sp
|
|
.SH "HELP OPTIONS"
|
|
A listing of available help options can be obtained by invoking \fBale \-\-hu\fR\&.
|
|
.sp
|
|
.SH "ENVIRONMENT"
|
|
The wrapper script \fBale\fR recognizes the following environment variables:
|
|
.PP
|
|
\fBALE_BIN\fR
|
|
.RS 4
|
|
ALE executable to use\&.
|
|
.RE
|
|
.PP
|
|
\fBDCRAW\fR
|
|
.RS 4
|
|
dcraw raw extraction tool to use\&.
|
|
.RE
|
|
.PP
|
|
\fBEXIF_UTILITY\fR
|
|
.RS 4
|
|
EXIF extraction utility to use\&.
|
|
.RE
|
|
.PP
|
|
\fBALE_COUNT_THREADS\fR
|
|
.RS 4
|
|
Displays statistics on thread counts when set to a non\-zero value\&.
|
|
.RE
|
|
.PP
|
|
\fBPAGER\fR
|
|
.RS 4
|
|
Text pager to use (e\&.g\&., for displaying help pages)\&.
|
|
.RE
|
|
.SH "SEE ALSO"
|
|
More detailed manuals for certain versions of ALE are distributed with source packages, and may also be available from:
|
|
.sp
|
|
http://auricle\&.dyndns\&.org/ALE/manuals/
|
|
.sp
|