add man pages

This commit is contained in:
j 2012-08-12 19:01:28 +02:00
parent cd1cafbc57
commit ff5de3a375
5 changed files with 91 additions and 4 deletions

View file

@ -32,8 +32,9 @@ clean:
install: ${PROG}
${INSTALL} -c -m 555 -o root -g bin ${PROG} ${BINDIR}
${INSTALL} -c -m 555 -o root -g bin oxposterframe ${BINDIR}
${INSTALL} -c -m 444 -o root -g bin man/oxframe.1 man/oxposterframe.1 ${MAN1DIR}
uninstall:
@rm -f ${BINDIR}/${PROG} ${BINDIR}/oxposterframe
@rm -f ${BINDIR}/${PROG} ${BINDIR}/oxposterframe ${MAN1DIR}/oxframe.1 ${MAN1DIR}/oxposterframe.1
.PHONY: all install uninstall

4
README
View file

@ -24,8 +24,8 @@ Latest version is at:
Dependencies:
liboggz git://git.xiph.org/liboggz.git
liboggplay git://git.xiph.org/liboggplay.git
libtheora svn co https://svn.xiph.org/trunk/theora
libvpx git clone git://review.webmproject.org/libvpx.git
libtheora https://svn.xiph.org/trunk/theora
libvpx http://git.chromium.org/webm/libvpx.git
imlib2 http://sourceforge.net/project/showfiles.php?group_id=2
On Debian and Ubuntu you can install those with

47
man/oxframe.1 Normal file
View file

@ -0,0 +1,47 @@
.TH OXFRAME 1 "Aug 12, 2012"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
oxframe \- command-line tool to extract frames from videos.
.SH SYNOPSIS
.B oxframe
.RI [options]
.SH DESCRIPTION
This manual page documents the \fBoxframe\fP command.
.PP
oxframe can extract frames from Ogg Theora and WebM videos
and resize them to a given width or height.
.SH OPTIONS
.TP
.B \-h, \-\-help
show help message and exit
.TP
.B \-x WIDTH, \-\-width=WIDTH
scale image to given width
.TP
.B \-y HEIGHT, \-\-height=HEIGHT
scale image to given height
.TP
.B \-p POS, \-\-pos=POS
frame position in seconds, float
.TP
.B \-i INPUT, \-\-input=INPUT
video input
.TP
.B \-o OUTPUT, \-\-output=OUTPUT
path to save frame to, jpg, png supported
(defaults to png)
.TP
.B \-f FORMAT, \-\-output=FORMAT
output format, jpg or png
if not provided detected from output extension

39
man/oxposterframe.1 Normal file
View file

@ -0,0 +1,39 @@
.TH OXPOSTERFRAME 1 "Aug 12, 2012"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
oxposterframe \- command-line tool to extract frames from videos.
.SH SYNOPSIS
.B oxposterframe
.RI [options]
.SH DESCRIPTION
This manual page documents the \fBoxposterframe\fP command.
.PP
oxposterframe can extract frames from Ogg Theora and WebM videos
and resize and pan\-zoom them to a square image with a given size.
.SH OPTIONS
.TP
.B \-h, \-\-help
show help message and exit
.TP
.B \-x SIZE, \-\-size=SIZE
scale image to size
.TP
.B \-p POS, \-\-pos=POS
frame position in seconds, float
.TP
.B \-i INPUT, \-\-input=INPUT
video input
.TP
.B \-o OUTPUT, \-\-output=OUTPUT
path to save frame to, jpg, png supported

View file

@ -1,7 +1,7 @@
/* -*- tab-width:2;c-file-style:"cc-mode"; -*- */
/*
* oxframe.c -- dump frame from an Ogg or WebM file
* Copyright (C) 20010 <j@mailb.org>
* Copyright (C) 2010 <j@mailb.org>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by