blind

commit 8d75367be7671fe59ac85ad2dfeb83b0cd8485a9
parent efa355f0085f13ef650b8db34dcdde1c2ac83484
Author: Mattias Andrée <maandree@kth.se>
Date:   Sat, 21 Jan 2017 11:59:29 +0100

Add man pages

Signed-off-by: Mattias Andrée <maandree@kth.se>

Diffstat:
M
man/blind-crop.1
 | 
44
++++++++++++++++++++++++++++++++++++++------
A
man/blind-cut.1
 | 
30
++++++++++++++++++++++++++++++
A
man/blind-extend.1
 | 
57
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++

3 files changed, 125 insertions(+), 6 deletions(-)
diff --git a/man/blind-crop.1 b/man/blind-crop.1
@@ -1,12 +1,44 @@
-.TH BLIND-FLOP 1 blind
+.TH BLIND-CROP 1 blind
 .SH NAME
-blind-flop - Mirror a video horizontally
+blind-crop - Extract subframes for all frames
 .SH SYNOPSIS
-.B blind-flop
+.B blind-crop
+[-t]
+.I width
+.I height
+.I left
+.I top
 .SH DESCRIPTION
-.B blind-flop
-reads a video from stdin and prints it, mirrored
-horizontally, to stdout.
+.B blind-crop
+reads a video from stdin and prints a cropped
+version of the video to stdout. The new video
+with have the specified
+.I width
+and
+.IR height ,
+and will have the same length as the input video.
+The left-most pixels of the subvideo will be
+.I left
+pixels rightward of the left-most pixels of the
+input video. The top-most pixels of the subvideo
+will be
+.I top
+pixels downward of the top-most pixels of the
+input video.
+.P
+The selected subvideo may not extend beyond the
+input video.
+.SH OPTIONS
+.TP
+.B -t
+Instead of changing the width and height of
+the output video, put the subvideo side-by-side.
+The subvideo's left-most pixel will be positioned
+.I left
+pixels rightward of the output video's left-most pixel,
+and the subvideo's top-most pixel will be positioned
+.I top
+pixels downward of the output video's left-most pixel.
 .SH AUTHORS
 Mattias Andree
 .RI < maandree@kth.se >
diff --git a/man/blind-cut.1 b/man/blind-cut.1
@@ -0,0 +1,30 @@
+.TH BLIND-CUT 1 blind
+.SH NAME
+blind-cut - Retain consecutive frames
+.SH SYNOPSIS
+.B blind-cut
+.I start-point
+.RI ( end-point
+|
+.RB ' end ')
+.I file
+.SH DESCRIPTION
+.B blind-cut
+reads a video from the the selected
+.IR file ,
+which must be a regular file.
+.B blind-cut
+prints the video to stdout, but
+skips the
+.I start-point
+first frames, and ends at the
+.I end-point
+frame, counting from the beginning of the
+input video, or at the end of the video
+if
+.B end
+is specified instead of
+.IR end-point .
+.SH AUTHORS
+Mattias Andree
+.RI < maandree@kth.se >
diff --git a/man/blind-extend.1 b/man/blind-extend.1
@@ -0,0 +1,57 @@
+.TH BLIND-EXTEND 1 blind
+.SH NAME
+blind-extend - Add margins to a video
+.SH SYNOPSIS
+.B blind-extend
+[-l
+.IR left ]
+[-r
+.IR right ]
+[-a
+.IR above ]
+[-b
+.IR below ]
+[-t]
+.SH DESCRIPTION
+.B blind-extend
+reads a video from stdin and prints a version of it,
+where extra space has been to its sides, to stdout.
+.SH OPTIONS
+.TP
+.BR -l " "\fIleft\fP
+Extend the video by
+.I left
+pixels to the left side of the video.
+.I left
+most be a non-negative integer.
+.TP
+.BR -r " "\fIright\fP
+Extend the video by
+.I right
+pixels to the right side of the video.
+.I right
+most be a non-negative integer.
+.TP
+.BR -a " "\fIabove\fP
+Extend the video by
+.I above
+pixels to the top of the video.
+.I above
+most be a non-negative integer.
+.TP
+.BR -b " "\fIbelow\fP
+Extend the video by
+.I below
+pixels to the bottom of the video.
+.I blelow
+most be a non-negative integer.
+.TP
+.BR -t
+Instead of adding transparent pixels, draw the end
+of the input videos in the new room, such that the
+right-most part of the video has is put side-by-side
+with the left-most part of the video, and analogously
+for the other sides.
+.SH AUTHORS
+Mattias Andree
+.RI < maandree@kth.se >