.\" Man page generated from reStructuredText.
.
.TH IBNIZ 1 "2013-09-23" "1.18" "real time audio-video synthesis"
.SH NAME
ibniz \- Virtual machine for compact low-level audiovisual programs
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
ibniz [OPTION]... [CODE]
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
Virtual machine for compact low\-level audiovisual programs
.sp
IBNIZ is a virtual machine designed for extremely compact low\-level
audiovisual programs. The leading design goal is usefulness as a
platform for demoscene productions, glitch art and similar projects.
Mainsteam software engineering aspects are considered totally
irrelevant.
.sp
IBNIZ stands for Ideally Bare Numeric Impression giZmo. The name also
refers to Gottfried Leibniz, the 17th\-century polymath who, among all,
invented binary arithmetic, built the first four\-operation calculating
machine, and believed that the world was designed with the principle
that a minimal set of rules should yield a maximal diversity.
.sp
The IBNIZ virtual machine is basically a two\-stack machine somewhat
similar to Forth implementations but with the major difference that
the stack is cyclical and also used as output buffer. The machine runs
in an endless loop by default, with the loop counter variable(s)
pushed on top of the stack on every loop cycle.
.sp
Each instruction is one character long, with the exception of
\(aqloadimm\(aq which consists of a string of hexadecimal digits. This also
gives IBNIZ some flavor of an esoteric programming language.
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-\-config\fB= <file>
Read configuration settings from <file>, if it exists.
.TP
.B \-\-version\fP,\fB  \-V
Show this program\(aqs version number and exit.
.TP
.B \-\-help\fP,\fB  \-h
Show this help message and exit.
.UNINDENT
.sp
And a lot more standard docutils options.
.SH COMMAND LINE OPTIONS
.INDENT 0.0
.TP
.B \-h
Dump help on command line usage
.TP
.B \-v
Dump version info
.TP
.BI \-c \ CODE
Execute code
.TP
.B \-n
No autorun of loaded code
.UNINDENT
.sp
The following extra options were added for creating the YouTube
video:
.INDENT 0.0
.TP
.B \-e
Dump user keystrokes to stdout
.TP
.B \-p
Playback dumped user keystrokes from stdin
.TP
.B \-M
Dump raw video to stdout and raw audio to stderr, 30 fps, non\-realtime, yuv4mpeg2 and pcm_s16
.UNINDENT
.SH EXAMPLES
.sp
Some commands used in this process, for reference:
.sp
\fB\&./ibniz \-e > events\fP
.sp
\fB\&./ibniz \-M \-p < events 2>vid.pcm | ffmpeg \-y \-i \- \-r 30 vid.avi\fP
.sp
\fBffmpeg \-i vid.avi \-f s16le \-ar 44100 \-ac 1 \-i vid.pcm \-vcodec copy vidav.avi\fP
.SH SEE ALSO
.INDENT 0.0
.IP \(bu 2
\fIibniz.txt </usr/share/doc/ibniz/ibniz.txt>\fP
.UNINDENT
.SH AUTHOR
Originally written by Ville-Matias Heikkila <viznut@low.fi>, Man page by maxigas <maxigas@anargeek.net>, based on the original ibniz.txt.
.SH COPYRIGHT
zlib
.\" Generated by docutils manpage writer.
.