Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
161 lines (160 sloc) 4.58 KB
.\" -*-nroff-*-
.\"
.\" Copyright (C) 2010 Martin Lambers <marlam@marlam.de>
.\"
.\" Copying and distribution of this file, with or without modification, are
.\" permitted in any medium without royalty provided the copyright notice and this
.\" notice are preserved. This file is offered as-is, without any warranty.
.TH Bino 1 2010-12
.SH NAME
Bino - a player for stereoscopic videos.
.SH SYNOPSIS
.B bino
[option...] [file-0] [file-1] [file-2]
.SH DESCRIPTION
Bino plays stereoscopic videos, also known as 3D videos. Such videos have
separate views for the left and right eye and thus allow depth perception
through stereopsis.
.br
The input streams (one or two video streams, zero or one audio streams)
can be in one, two, or three input files. The files are decoded with the
\fBFFmpeg\fP libraries, so URLs are supported.
.br
If input files are given, Bino immediately starts playing them. Otherwise, it
starts in GUI mode.
.IP "\-\-help"
Print help
.IP "\-\-version"
Print version
.IP "\-g|\-\-gui"
Show the GUI even if input files are given on the command line.
.IP "\-l|\-\-log\-level=\fILEVEL\fP"
Select log level:
\fIdebug\fP, \fIinfo\fP, \fIwarning\fP, \fIerror\fP, or \fIquiet\fP.
.IP "\-i|\-\-input=\fITYPE\fP"
Select input type.
.RS
.IP "\fImono\fP"
Single view
.IP "\fIseparate\fP"
Left/right view in separate streams
.IP "\fItop\-bottom\fP"
Left view top, right view bottom
.IP "\fItop\-bottom\-half\fP"
Left view top, right view bottom, half height
.IP "\fIleft\-right\fP"
Left view left, right view right
.IP "\fIleft\-right\-half\fP"
Left view left, right view right, half width
.IP "\fIeven\-odd\-rows\fP"
Left view even rows, right view odd rows
.PP
The default is to autodetect the input type from meta data stored in the file.
If this fails, Bino tries to autodetect the input type based on the file name,
by looking at the last part of the file name before the file name extension
(.ext). If that fails, too, Bino guesses based on the resolution of the input.
.br
The following file name forms are recognized:
.IP "*\-lr.ext"
left\-right
.IP "*\-lrh.ext or *\-lrq.ext"
left\-right\-half
.IP "*\-rl.ext"
left\-right swapped
.IP "*\-rlh.ext or *\-rlq.ext"
left\-right\-half swapped
.IP "*\-tb.ext or *\-ab.ext"
top\-bottom
.IP "*\-tbh.ext or *\-abq.ext"
top\-bottom\-half
.IP "*\-bt.ext or *\-ba.ext"
top\-bottom swapped
.IP "*\-bth.ext or *\-baq.ext"
top\-bottom\-half swapped
.IP "*\-eo.ext or *\-eoq.ext or *\-3dir.ext"
even\-odd\-rows
.IP "*\-oe.ext or *\-oeq.ext or *\-3di.ext"
even\-odd\-rows swapped
.IP "*\-2d.ext"
mono
.RE
.IP "\-s|\-\-swap\-eyes"
Swap left/right view
.IP "\-o|\-\-output=\fITYPE\fP"
Select output type.
.RS
.IP "\fImono\-left\fP"
Left view only
.IP "\fImono\-right\fP"
Right view only
.IP "\fItop\-bottom\fP"
Left view top, right view bottom
.IP "\fItop\-bottom\-half\fP"
Left view top, right view bottom, half height
.IP "\fIleft\-right\fP"
Left view left, right view right
.IP "\fIleft\-right\-half\fP"
Left view left, right view right, half width
.IP "\fIeven\-odd\-rows\fP"
Left view even rows, right view odd rows
.IP "\fIeven\-odd\-columns\fP"
Left view even columns, right view odd columns
.IP "\fIcheckerboard\fP"
Left and right view in checkerboard pattern
.IP "\fIanaglyph\fP"
Red/cyan anaglyph, default method, same as \fIanaglyph\-dubois\fP"
.IP "\fIanaglyph\-monochrome\fP"
Red/cyan anaglyph, monochrome method
.IP "\fIanaglyph\-full\-color\fP"
Red/cyan anaglyph, full color method
.IP "\fIanaglyph\-half\-color\fP"
Red/cyan anaglyph, half color method
.IP "\fIanaglyph\-dubois\fP"
Red/cyan anaglyph, high\-quality Dubois method
.IP "\fIstereo\fP"
OpenGL quad\-buffer stereo
.IP "\fIequalizer\fP"
Multi-display OpenGL via Equalizer with a 2D canvas setup
.IP "\fIequalizer\-3d\fP"
Multi-display OpenGL via Equalizer with a 3D screen setup
.PP
For stereo input, the default is \fIstereo\fP if the display supports it,
otherwise \fIanaglyph\fP. The default for mono input is \fImono\-left\fP.
.RE
.IP "\-f|\-\-fullscreen"
Fullscreen
.IP "\-c|\-\-center"
Center window on screen
.IP "\-b|\-\-benchmark"
Benchmark mode: no audio, no time synchronization, output of frames-per-second
measurements.
.SH INTERACTIVE CONTROL
.IP "q or ESC"
quit
.IP "p or SPACE"
Pause / unpause
.IP "f"
Toggle fullscreen
.IP "c"
Center window
.IP "s"
Swap left/right view
.IP "1, 2"
Adjust contrast
.IP "3, 4"
Adjust brightness
.IP "5, 6"
Adjust hue
.IP "7, 8"
Adjust saturation
.IP "left, right"
Seek 10 seconds backward / forward
.IP "up, down"
Seek 1 minute backward / forward
.IP "page up, page down"
Seek 10 minutes backward / forward
.SH AUTHORS
Bino was written by Martin Lambers <marlam@marlam.de>.
.SH SEE ALSO
.BR mplayer (1),
.BR ffmpeg (1)