home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1997 #2 / amigaacscoverdisc / utilities / shareware / music / gfft-2.03 / readme < prev    next >
Text File  |  1996-06-21  |  9KB  |  198 lines
  1.                   Welcome to GFFT
  2.                   ------- -- ----
  3.  
  4.          This is the second public release of GFFT, an FFT-based
  5.     spectrum analysis program with many features.  Improvements
  6.     include:
  7.  
  8.         -- an AmigaGuide discussion of Spectrum Analysis with
  9.            many pictures!
  10.  
  11.         -- Support for different screens and (system default)
  12.            fonts
  13.  
  14.         -- progress indicator with stop button
  15.  
  16.         -- support for GFFT commands in the icon tooltypes
  17.  
  18.         -- bugfixes and other small improvements
  19.  
  20.          If you would like to get the binary optimized for machines
  21.     with FPU, please send $25.  For best results, please specify the
  22.     exact CPU and FPU (e.g. 25 MHz 68030 with 25 MHz 68882) you have.
  23.  
  24.         Address:    Charles P. Peterson
  25.             4007 Enchanted Sun
  26.             San Antonio, TX 78244-1254 USA
  27.  
  28.         E-mail:    Charles_P_Peterson@fcircus.sat.tx.us
  29.             cpp@crl.com
  30.             charlesp@darwin.sfbr.org
  31.  
  32.          Please help me support this program by sending a donation of
  33.     any amount.  I will acknowledge all donations of $10 US or more
  34.     with a short thank-you note and instructions as to how to disable
  35.     the donation reminders.  For a donation of $25 US, I will also send
  36.     you a binary of the current release optimized for your system (with
  37.     donation reminders disabled), AND advise you of the next release,
  38.     which will be sent for the cost of shipping (which may be prepaid;
  39.     allow for the weight of one floppy disk and packing materials).
  40.     The ideas of contributors will be given extra weight in planning
  41.     future releases.
  42.  
  43.         Even if you cannot afford to make a donation now, please
  44.     let me know if you find the program useful, or how I might make
  45.     it useful to you.
  46.  
  47.          Unique among programs available to the personal computer user,
  48.     the design of GFFT emphasizes the ability to produce spectrum
  49.     analyses of very high precision and accuracy.  The tradeoff is
  50.     speed; don't expect anything like real-time performance.* GFFT was
  51.     never intended to be a real-time analyzer.  My experience with most
  52.     consumer real-time analyzers is that they are little better than
  53.     toys, like a light show to watch while you are listening to music,
  54.     and to really appreciate music, it's best not to watch such things
  55.     anyway.  By operating from stored sample data files, GFFT offers
  56.     higher resolution and/or accuracy than most real-time analyzers.
  57.     There is no limit to the length of samples that GFFT can analyze
  58.     and average, and the longer the sample that is averaged, the more
  59.     accurate the results can be.  Without averaging over a significant
  60.     period of time, a spectrum analysis is not much better than a list
  61.     of random numbers.
  62.  
  63.          (*However, with suitably chosen parameters, GFFT can also give
  64.     more approximate results in a few seconds.  But why can't you wait
  65.     a little longerfor something a little less random?  See the
  66.     SpectrumAnalysis.guide for a full discussion.)
  67.  
  68.          GFFT accepts 8, 12, or 16-bit data in in IFF 8SVX, AIFF, and
  69.     AVR formats, or in unformatted files, and can accept data points
  70.     entered through a console in floating point.  GFFT can be operated
  71.     from either a Workbench GUI or from a CLI in interactive or batch
  72.     modes.  It has built-in help facilities for all operating modes.
  73.  
  74.          Before running GFFT on your Amiga system, read the file named
  75.     INSTALLATION.  If you experience problems while running GFFT, see
  76.     the file named Bugs.  If you would like to read about how to use
  77.     GFFT, you can read the file named GFFT.HELP, which is also used by
  78.     GFFT to display help messages.  After installing GFFT according to
  79.     the instructions, you can get help while running GFFT either from
  80.     the Workbench or from the CLI.
  81.  
  82.          If you want further information about the GNU General Public
  83.     License which applies to GFFT and the specific rights it gives you
  84.     to modify and distribute GFFT, or the no-warranty disclaimer which
  85.     applies to it, refer to the file named COPYING.
  86.  
  87.          Though GFFT is copyrighted under a General Public License and
  88.     the author respects and agrees with the ideas of the Free Software
  89.     Foundation, GFFT is not currently part of project GNU.  So please
  90.     direct any inquiries about the program itself to the author, and
  91.     not the Free Software Foundation.
  92.  
  93.          The most important files in this archive are provided with
  94.     icons so you can use them from the Workbench.  Two files not
  95.     provided with icons are the the Product-Info and History files.
  96.  
  97.  
  98.                GFFT README TABLE OF CONTENTS
  99.  
  100.         Preface (the long part you just read)
  101.     1.  What can I do with GFFT?
  102.     2.  What features does GFFT have?
  103.     3.  What are my rights to use, modify, and distribute GFFT?
  104.     4.  The trademark and copyright statements
  105.  
  106.  
  107.     1.  What can I do with GFFT?
  108.  
  109.          With GFFT you can explore the world of sound in a new domain--
  110.     the frequency domain.
  111.  
  112.          With GFFT you can "see" what frequencies are present in a
  113.     particular sound, and how they vary over time.  This might be
  114.     useful if you are involved in some kind of research, or if you want
  115.     to understand a sound better so that you can synthesize a
  116.     simulation of it.
  117.  
  118.          With GFFT, an audio sampler, and a random noise generator
  119.     (preferrably a pink noise generator), you can analyze the frequency
  120.     response of electronic audio equipment.  Add a calibrated
  121.     microphone, and you can also analyze loudspeakers and room
  122.     acoustics.  This is where GFFT really shines.  Few (if any)
  123.     analyzers are able to achieve the fine resolution or accuracy that
  124.     GFFT can achieve, or compensate for the frequency response of
  125.     ancillary equipment as flexibly as GFFT, or produce hardcopy which
  126.     looks as nice. 
  127.  
  128.  
  129.     2.  What are the features of GFFT?
  130.  
  131.          GFFT is an FFT-based spectrum analysis program with many
  132.     features.  
  133.         
  134.          GFFT can produce high quality spectrum plots on screen,
  135.     plotter, or printer, or save to Postscript or TeX files, or output
  136.     spectral data in text form to a console or file.  (GNUPLOT, a
  137.     separate program by other authors, is required for plotting
  138.     features.  GFFT is designed to invoke and control GNUPLOT
  139.     automatically.)  It can plot in 2D (Amplitude vs Frequency), or 3D
  140.     (Amplitude vs Frequency vs Time).  It allows the selection of
  141.     logarithmic X and/or Y axes, the dB scaling of X, and arbitrary 3D
  142.     rotation.  GFFT can show multiple spectra in the same plot, or
  143.     append spectral data bands from earlier sessions.
  144.  
  145.          GFFT provides 8 selectable FFT window types, including
  146.     Blackman-Harris 92 dB.  It can apply a special weighting for pink
  147.     noise testing.  Smoothing, calibration, ranging, and quantization
  148.     are also available.  There are no arbitrary limits to the number of
  149.     frequency bins or smoothing points, or to the length of data which
  150.     can be analyzed.
  151.  
  152.          GFFT is intended to be fairly universal in nature.
  153.     Furthermore, since it is provided under a GNU General Public
  154.     License and distributed with source code, a user with an
  155.     understanding of programming can adapt it to more specialized
  156.     requirements.  (I may also be able to help; see below.)
  157.  
  158.          Please be aware that GFFT (and all the code provided with
  159.     GFFT) is not intended for use in applications where error or
  160.     inaccuracy could endanger life or property.  There is ABSOLUTELY NO
  161.     WARRANTY, express or implied, concerning the performance or
  162.     accuracy of GFFT.  The general no-warranty disclaimer is given in
  163.     the file named COPYING which should be included with this
  164.     distribution. 
  165.  
  166.  
  167.     3.  What are my rights to use, modify, and distribute GFFT?
  168.  
  169.          This program is 'free' software; you can redistribute it and/or
  170.     modify it under the terms of the GNU General Public License as
  171.     published by the Free Software Foundation; either version 2 of the
  172.     License, or (at your option) any later version.
  173.  
  174.          This program is distributed in the hope that it will be useful,
  175.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  176.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  177.     General Public License for more details.
  178.  
  179.          You should have received a copy of the GNU General Public
  180.     License along with this program (in a file named 'COPYING'); if
  181.     not, write to the Free Software Foundation, Inc., 675 Mass Ave,
  182.     Cambridge, MA 02139, USA.  Please do not contact them for any
  183.     other information about this program; they do not necessarily
  184.     know anything about it.
  185.  
  186.  
  187.     4.  The trademark and copyright statements
  188.  
  189.         GFFT, GFFT.HELP, and related contents in this distribution are 
  190.     Copyright (C) 1994, 1996 Charles P. Peterson.
  191.  
  192.     'Workbench', 'Amiga', and 'AmigaGuide' are registered trademarks of
  193.     Amiga Technologies.  GNU is a name used by the Free Software
  194.     Foundation, Inc.  GNUPLOT is copyright by Thomas Williams and Colin
  195.     Kelley.  POST is copyright by Adrian Aylward.  All other trademarks
  196.     or copyrights mentioned here or in code or supporting documentation
  197.     are property of their respective owners. 
  198.