diff options
Diffstat (limited to 'third_party/resample/man')
-rw-r--r-- | third_party/resample/man/Makefile.am | 2 | ||||
-rw-r--r-- | third_party/resample/man/Makefile.in | 330 | ||||
-rw-r--r-- | third_party/resample/man/resample.1 | 115 | ||||
-rw-r--r-- | third_party/resample/man/windowfilter.1 | 27 |
4 files changed, 474 insertions, 0 deletions
diff --git a/third_party/resample/man/Makefile.am b/third_party/resample/man/Makefile.am new file mode 100644 index 00000000..eca52a18 --- /dev/null +++ b/third_party/resample/man/Makefile.am @@ -0,0 +1,2 @@ +man_MANS = resample.1 windowfilter.1 +EXTRA_DIST = $(man_MANS) diff --git a/third_party/resample/man/Makefile.in b/third_party/resample/man/Makefile.in new file mode 100644 index 00000000..c3828b2e --- /dev/null +++ b/third_party/resample/man/Makefile.in @@ -0,0 +1,330 @@ +# Makefile.in generated by automake 1.9.6 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +top_builddir = .. +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +INSTALL = @INSTALL@ +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +subdir = man +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +man1dir = $(mandir)/man1 +am__installdirs = "$(DESTDIR)$(man1dir)" +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +ALLOCA = @ALLOCA@ +AMDEP_FALSE = @AMDEP_FALSE@ +AMDEP_TRUE = @AMDEP_TRUE@ +AMTAR = @AMTAR@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +RANLIB = @RANLIB@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +VERSION = @VERSION@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_RANLIB = @ac_ct_RANLIB@ +ac_ct_STRIP = @ac_ct_STRIP@ +am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ +am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build_alias = @build_alias@ +datadir = @datadir@ +exec_prefix = @exec_prefix@ +host_alias = @host_alias@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +man_MANS = resample.1 windowfilter.1 +EXTRA_DIST = $(man_MANS) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +uninstall-info-am: +install-man1: $(man1_MANS) $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man1dir)" || $(mkdir_p) "$(DESTDIR)$(man1dir)" + @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ + l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ + for i in $$l2; do \ + case "$$i" in \ + *.1*) list="$$list $$i" ;; \ + esac; \ + done; \ + for i in $$list; do \ + if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ + else file=$$i; fi; \ + ext=`echo $$i | sed -e 's/^.*\\.//'`; \ + case "$$ext" in \ + 1*) ;; \ + *) ext='1' ;; \ + esac; \ + inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ + inst=`echo $$inst | sed -e 's/^.*\///'`; \ + inst=`echo $$inst | sed '$(transform)'`.$$ext; \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst"; \ + done +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ + l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ + for i in $$l2; do \ + case "$$i" in \ + *.1*) list="$$list $$i" ;; \ + esac; \ + done; \ + for i in $$list; do \ + ext=`echo $$i | sed -e 's/^.*\\.//'`; \ + case "$$ext" in \ + 1*) ;; \ + *) ext='1' ;; \ + esac; \ + inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ + inst=`echo $$inst | sed -e 's/^.*\///'`; \ + inst=`echo $$inst | sed '$(transform)'`.$$ext; \ + echo " rm -f '$(DESTDIR)$(man1dir)/$$inst'"; \ + rm -f "$(DESTDIR)$(man1dir)/$$inst"; \ + done +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ + list='$(DISTFILES)'; for file in $$list; do \ + case $$file in \ + $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ + $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ + esac; \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test "$$dir" != "$$file" && test "$$dir" != "."; then \ + dir="/$$dir"; \ + $(mkdir_p) "$(distdir)$$dir"; \ + else \ + dir=''; \ + fi; \ + if test -d $$d/$$file; then \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(MANS) +installdirs: + for dir in "$(DESTDIR)$(man1dir)"; do \ + test -z "$$dir" || $(mkdir_p) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +info: info-am + +info-am: + +install-data-am: install-man + +install-exec-am: + +install-info: install-info-am + +install-man: install-man1 + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-info-am uninstall-man + +uninstall-man: uninstall-man1 + +.PHONY: all all-am check check-am clean clean-generic distclean \ + distclean-generic distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-exec \ + install-exec-am install-info install-info-am install-man \ + install-man1 install-strip installcheck installcheck-am \ + installdirs maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic pdf pdf-am ps ps-am uninstall \ + uninstall-am uninstall-info-am uninstall-man uninstall-man1 + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/third_party/resample/man/resample.1 b/third_party/resample/man/resample.1 new file mode 100644 index 00000000..7a85565b --- /dev/null +++ b/third_party/resample/man/resample.1 @@ -0,0 +1,115 @@ +.TH RESAMPLE 1 "5 Jan 2006" "CCRMA" +.SH NAME +resample \- resample a 16-bit mono or stereo sound file by an arbitrary factor + +.SH SYNOPSIS +\fBresample\fR +[-by factor] +[-to newSrate] +[-f filterFile] +[-n] +[-l] +[-trace] +[-version] +inputFile +[outputFile] + +.SH DESCRIPTION +The \fBresample\fR program takes a 16-bit mono or stereo sound file +and performs bandlimited interpolation to produce an output sound file +have a desired new sampling rate. The output file is in the same +format as the input. + +.SH OPTIONS + +.IP \fB\-toSrate\fR +This option or "-byFactor" is required. Specify new sampling rate in +samples per second. The conversion factor is implied and will be set +to the new sampling rate divided by the sampling rate of the input +soundfile. + +.IP \fB\-byFactor\fR +Specify conversion factor. This option or "-toSrate" is required. +The conversion factor is the amount by which the sampling rate is +changed. If the sampling rate of the input signal is Srate1, then the +sampling rate of the output is factor*Srate1. For example, a factor +of 2.0 increases the sampling rate by a factor of 2, giving twice as +many samples in the output signal as in the input. The fractional +part of the conversion factor is accurate to 15 bits. This is +sufficiently accurate that humans should not be able to hear any error +whatsoever in the pitch of resampled sounds. + +.IP \fB\-filterFile\fR +Change the resampling filter from its default. Such a filter file can +be designed by the \fBwindowfilter (1)\fR program (included with the +\fBresample\fR distribution). The preloaded filter file requires an +oversampling factor of at least 20% to avoid aliasing (in other words, +its "transition band" as a lowpass filter is at least 20% of the +useable frequency range in the sampled signal); the stop-band +attenuation is approximately 80 dB. + +.IP \fB\-noFilterInterp\fR +By default, the resampling filter table is linearly interpolated to +provide high audio quality at arbitrary sampling-rate conversion +factors. This option turns off filter interpolation, thus cutting the +number of multiply-adds in half in the inner loop (for most conversion +factors). + +.IP \fB\-linearInterpolation\fR +Select plain linear interpolation for resampling (which means +resampling filter table is not used at all). This option is very fast, +but the output quality is poor unless the signal is already heavily +oversampled. Do not confuse linear interpolation of the signal with +linear interpolation of the resampling-filter-table which is +controlled by the "noFilterInterp" option. + +.IP \fB\-terse\fR +Disable informational printout. + +.IP \fB\-version\fR +Print program version. + +.SH EXAMPLE +To convert the sampling rate from 48 kHz (used by DAT machines) to +44.1 kHz (the standard sampling rate for Compact Discs), the command +line would look something like + + resample -to 44100 dat.snd cd.snd +or + resample -by 0.91875 dat.snd cd.snd + +Any reasonable sampling rate can be converted to any other. (Note +that, in this example, if you have obtained a direct-digital transfer +from DAT or CD, you probably have some pre-emphasis filtering which +should be canceled using a digital filter. See README.deemph in the +\fBresample\fR release for further information) + +.SH REFERENCES +Source code and further documentation may be found at the Digital +Audio Resampling Home Page (DARHP) located at + + http://ccrma.stanford.edu/~jos/resample/ + +.SH HISTORY +The first version of this software was written by Julius O. Smith III +<jos /at/ ccrma /dot/ stanford /dot/ edu> at CCRMA +<http://ccrma.stanford.edu> in 1981. It was called SRCONV and was +written in SAIL for PDP-10 compatible machines (see the DARHP for that +code). The algorithm was first published in + +Smith, Julius O. and Phil Gossett. ``A Flexible Sampling-Rate +Conversion Method,'' Proceedings (2): 19.4.1-19.4.4, IEEE Conference +on Acoustics, Speech, and Signal Processing, San Diego, March 1984. + +An expanded tutorial based on this paper is available at the DARHP. + +Circa 1988, the SRCONV program was translated from SAIL to C by +Christopher Lee Fraley working with Roger Dannenberg at CMU. + +Since then, the C version has been maintained by jos. + +Sndlib support was added 6/99 by John Gibson <jgg9c@virginia.edu>. + +The \fBresample\fR program is free software distributed in accordance +with the Lesser GNU Public License (LGPL). There is NO warranty; not +even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. diff --git a/third_party/resample/man/windowfilter.1 b/third_party/resample/man/windowfilter.1 new file mode 100644 index 00000000..ead219d2 --- /dev/null +++ b/third_party/resample/man/windowfilter.1 @@ -0,0 +1,27 @@ +.TH WINDOWFILTER 1 "19 Jun 2002" "CCRMA"
+.SH NAME
+windowfilter \- design an FIR digital filter by the window method
+
+.SH DESCRIPTION
+The \fBwindowfilter\fR program designs an FIR digital filter for use
+with the \fBresample\fR program. Just run the program and type ? at
+its prompts to get an explanation of its options.
+
+.SH REFERENCES
+
+Digital Signal Processing Committee, ed., \fBPrograms for Digital
+Signal Processing\fR, IEEE Press, New York, 1979.
+
+J. F. Kaiser, "Using the I0-sinh Window Function," Proc. IEEE
+Int. Symp. on Circuits and Syst., April 22-25, pp. 20-23, 1974.
+
+F. J. Harris, "On the Use of Windows for Harmonic Analysis with the
+Discrete Fourier Transform," Proceedings of the IEEE, vol. 66, no. 1,
+pp. 51-83. Jan. 1978.
+
+A. H. Nuttall, "Some Windows with Very Good Sidelobe Behavior," IEEE
+Transactions on Acoustics, Speech, and Signal Processing,
+vol. ASSP-29, no. 1, pp. 84-91, Feb. 1981.
+
+L. R. Rabiner and B. Gold, \fBTheory and Application of Digital Signal
+Processing,\fR Prentice-Hall Inc., Englewood Cliffs, NJ, 1975.
|