From 809c5e94794cd8b3a7a96e07872d056fdb63aa35 Mon Sep 17 00:00:00 2001 From: Andreas Klemm Date: Sun, 17 Aug 1997 16:56:12 +0000 Subject: =?UTF-8?q?Created=20manpages=20mpeg=5Fmusicin.1=20and=20mpeg=5Fmu?= =?UTF-8?q?sicout.1=20Expect=20not=20too=20much=20...=20but=20if=20somebod?= =?UTF-8?q?y=20is=20very=20experienced=20in=20using=20these=20tools,=20the?= =?UTF-8?q?n=20please=20feel=20free=20to=20add=20some=20,,flesh=C2=B4?= =?UTF-8?q?=C2=B4=20to=20these=20manpages.=20Now=20you=20have=20a=20good?= =?UTF-8?q?=20starting=20point.=20PR:=09closes=20PR=201518?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- audio/mpegaudio/Makefile | 8 ++- audio/mpegaudio/files/mpeg_musicin.1 | 122 ++++++++++++++++++++++++++++++++++ audio/mpegaudio/files/mpeg_musicout.1 | 94 ++++++++++++++++++++++++++ audio/mpegaudio/pkg-plist | 2 + 4 files changed, 225 insertions(+), 1 deletion(-) create mode 100644 audio/mpegaudio/files/mpeg_musicin.1 create mode 100644 audio/mpegaudio/files/mpeg_musicout.1 (limited to 'audio/mpegaudio') diff --git a/audio/mpegaudio/Makefile b/audio/mpegaudio/Makefile index ea0085378b36..f7664bc80bc4 100644 --- a/audio/mpegaudio/Makefile +++ b/audio/mpegaudio/Makefile @@ -2,7 +2,7 @@ # Date created: 1 July 1996 # Whom: torstenb # -# $Id: Makefile,v 1.1.1.1 1996/07/06 09:27:10 gpalmer Exp $ +# $Id: Makefile,v 1.2 1996/11/15 23:13:52 obrien Exp $ # DISTNAME= mpegaudio @@ -13,4 +13,10 @@ EXTRACT_SUFX= .tar.Z MAINTAINER= torstenb@FreeBSD.ORG +MAN1= mpeg_musicin.1 mpeg_musicout.1 + +post-install: + ${INSTALL_MAN} ${FILESDIR}/mpeg_musicin.1 ${PREFIX}/man/man1 + ${INSTALL_MAN} ${FILESDIR}/mpeg_musicout.1 ${PREFIX}/man/man1 + .include diff --git a/audio/mpegaudio/files/mpeg_musicin.1 b/audio/mpegaudio/files/mpeg_musicin.1 new file mode 100644 index 000000000000..dbdd28030471 --- /dev/null +++ b/audio/mpegaudio/files/mpeg_musicin.1 @@ -0,0 +1,122 @@ +.\" Copyright (c) 1997 Andreas Klemm . Neuss. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $Id:$ +.Dd August 17, 1997 +.Dt MPEG_MUSICIN 1 +.Os FreeBSD +.Sh NAME +.Nm mpeg_musicin +.Nd MPEG/audio Layer 1 and Layer 2 decoder +.Sh SYNOPSIS +.Nm mpeg_musicin +queries for all arguments, or +.br +.Nm mpeg_musicin +.Op Fl l Ar lay +.br +.Op Fl m Ar mode +.br +.Op Fl p Ar psy +.br +.Op Fl s Ar sfrq +.br +.Op Fl b Ar br +.br +.Op Fl d Ar emp +.br +.Op Fl c +.br +.Op Fl o +.br +.Op Fl e +.br +inputCM +.br +.Op Ar outBS +.br +.Sh DESCRIPTION +The encoder and decoder software are configured to output +the coded audio bitstreams as a string of hexadecimal ascii +characters. For greater compression efficiency, compile flag, +BS_FORMAT, in common.h can be switched to configure the bitstream +reading and writing routines to process raw binary bitstreams. +.br +The decoder program has a very crude implementation of bitstream +synchword detection. It may not be able to correctly decode valid +bitstreams which have false synchword patterns in the ancillary data +portion of the bitstream. +.Sh RESTRICTIONS +The software implements levels I and II and psychophysical auditory +models I and II as described in the ISO 3-11171 rev 1 standard. +There are future plans to implement level III. +.br +The input/output audio data may either be headerless raw 16 bit data +or alternatively an AIFF formatted file (Audio Interchange File Format) +with certain limitations. +.br +For more information on the AIFF format see the postscript file +/sgi/aiff-c.9.26.91.ps at the anonymous ftp site FTP.SGI.COM +(192.48.153.1). +.br +The AIFF formatted file is a convenient way for storing sampling rate +of the audio file. +.br +The encoder and decoder software are configured to output the coded +audio bitstreams as a string of hexadecimal ascii characters. +For greater compression efficiency, compile flag, BS_FORMAT, +in common.h can be switched to configure the bitstream reading +and writing routines to process raw binary bitstreams. +.br +This software has been run and verified on a large variety of +computers and operating systems. In particular UNIX, MS_DOS (with +MicroSoft C version 6), Macintosh, AIX Platform (RS6000) and Convex. +.Sh OPTIONS +.Bl -tag -width Ds +.It Sy -l lay +use layer coding (default: 2) +.It Sy -m mode +channel mode : s/d/j/m (default: s) +.It Sy -p psy +psychoacoustic model 1/2 (default: 2) +.It Sy -s sfrq +input smpl rate in kHz (default: 44.1) +.It Sy -b br +total bitrate in kbps (default: 384) +.It Sy -d emp +de-emphasis n/5/c (default: n) +.It Sy -c +mark as copyright +.It Sy -o +mark as original +.It Sy -e +add error protection +.It Sy inputPCM +input PCM sound file (standard or AIFF) +.It Sy outBS +output bit stream of encoded audio (dflt inName+.mpg) +.Sh SEE ALSO +.Xr mpeg_musicout 1 +.Sh HISTORY +Written by Andreas Klemm, August 17, 1997 diff --git a/audio/mpegaudio/files/mpeg_musicout.1 b/audio/mpegaudio/files/mpeg_musicout.1 new file mode 100644 index 000000000000..7dc76eade226 --- /dev/null +++ b/audio/mpegaudio/files/mpeg_musicout.1 @@ -0,0 +1,94 @@ +.\" Copyright (c) 1997 Andreas Klemm . Neuss. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $Id:$ +.Dd August 17, 1997 +.Dt MPEG_MUSICOUT 1 +.Os FreeBSD +.Sh NAME +.Nm mpeg_musicout +.Nd MPEG/audio Layer 1 and Layer 2 encoder +.Sh SYNOPSIS +.Nm mpeg_musicout +queries for all arguments, or +.br +.Nm mpeg_musicout +.Op Fl A +.br +.Op Fl s Ar sb +.br +inputBS +.br +.Op Ar outPCM +.br +.Sh DESCRIPTION +The encoder and decoder software are configured to output +the coded audio bitstreams as a string of hexadecimal ascii +characters. For greater compression efficiency, compile flag, +BS_FORMAT, in common.h can be switched to configure the bitstream +reading and writing routines to process raw binary bitstreams. +.br +The decoder program has a very crude implementation of bitstream +synchword detection. It may not be able to correctly decode valid +bitstreams which have false synchword patterns in the ancillary data +portion of the bitstream. +.Sh RESTRICTIONS +The software implements levels I and II and psychophysical auditory +models I and II as described in the ISO 3-11171 rev 1 standard. +There are future plans to implement level III. +.br +The input/output audio data may either be headerless raw 16 bit data +or alternatively an AIFF formatted file (Audio Interchange File Format) +with certain limitations. +.br +For more information on the AIFF format see the postscript file +/sgi/aiff-c.9.26.91.ps at the anonymous ftp site FTP.SGI.COM +(192.48.153.1). +.br +The AIFF formatted file is a convenient way for storing sampling rate +of the audio file. +.br +The encoder and decoder software are configured to output the coded +audio bitstreams as a string of hexadecimal ascii characters. +For greater compression efficiency, compile flag, BS_FORMAT, +in common.h can be switched to configure the bitstream reading +and writing routines to process raw binary bitstreams. +.br +This software has been run and verified on a large variety of +computers and operating systems. In particular UNIX, MS_DOS (with +MicroSoft C version 6), Macintosh, AIX Platform (RS6000) and Convex. +.Sh OPTIONS +.Bl -tag -width Ds +.It Sy -A +write an AIFF output PCM sound file +.It Sy -s sb +resynth only up to this sb (debugging only) +.It Sy inputBS +input bit stream of encoded audio +.It Sy outPCM +output PCM sound file (dflt inName+.dec) +.Sh SEE ALSO +.Xr mpeg_musicin 1 +.Sh HISTORY +Written by Andreas Klemm, August 17, 1997 diff --git a/audio/mpegaudio/pkg-plist b/audio/mpegaudio/pkg-plist index 8525a9efa3af..c718915a5c3f 100644 --- a/audio/mpegaudio/pkg-plist +++ b/audio/mpegaudio/pkg-plist @@ -21,3 +21,5 @@ lib/mpegaudio/tables/alloc_2 lib/mpegaudio/tables/alloc_3 lib/mpegaudio/tables/dewindow lib/mpegaudio/tables/enwindow +man/man1/mpeg_musicin.1.gz +man/man1/mpeg_musicout.1.gz -- cgit v1.2.3