home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff335.lzh / SeeHear / SeeHear.readme < prev    next >
Text File  |  1990-03-22  |  5KB  |  112 lines
  1. SEEHEAR INTRODUCTION
  2.  
  3. SeeHear does frequency spectrum analysis of sampled sounds.  It
  4. displays a graph of frequency in hertz (cycles per second) on the
  5. horizontal axis and time on the vertical.  Successive time slices
  6. of the sound are analyzed, and at each frequency the loudness
  7. determines the pixel color.  This type of analysis if commonly
  8. call a spectrogram.
  9.  
  10. GETTING STARTED
  11.  
  12. To run the program, double-click its icon.  Don't be confused the
  13. the details of the control window which opens, just select Open
  14. from the File menu and pick a sound file (a DEMO_SOUND file is
  15. included).  SeeHear recognizes IFF 8SVX format files, although
  16. any file can be interpreted as sound.  SeeHear will read and play
  17. the sound before opening a 32 color 320x200 screen for analysis,
  18. so be sure to have your sound volume turned on.
  19.  
  20. Some lengthy number crunching is involved especially at startup,
  21. so be patient.  SeeHear will slice out a short piece of sound
  22. (0.1 s or so), play it, and scan across one line displaying its
  23. color-coded frequency spectrum.  The 30 display colors are shown
  24. in 2 columns at the right, brighter colors for louder sounds.
  25.  
  26. We perceive frequency as the pitch of a sound, and a steady pitch
  27. will result in a vertical line.  Because of harmonics, even a
  28. single musical note will produce several lines; more complicated
  29. sounds produce more complex patterns.
  30.  
  31. ANALYSIS SCREEN GADGETS
  32.  
  33. SeeHear analysis may be interrupted by toggling the halt/freeway
  34. gadget at the upper right.  Seehear only checks for events after
  35. each line of analysis, and so will probably not respond
  36. immediately.  Once halted, one can play the sound with the
  37. loudspeaker gadget.  Sound playing is controlled by three arrows
  38. at the right of the graph, for start, select, and end.  These
  39. arrows are moved by selecting with the left mouse button down and
  40. releasing within the graph area.  The latest arrow touched is
  41. hilited in green, and controls the play mode.  Start hilited
  42. plays through to end, select hilited plays only the selected
  43. line, and end hilited plays through like start but with clicks to
  44. set off the selected line.  Moving the select arrow also causes a
  45. crosshair mark to be placed on the graph, with a readout of time
  46. and frequency in the title bar.  This readout includes a zoom of
  47. the 3x3 pixels at the crosshair, and bars in the color scale
  48. indicating the 3 pixels across the selected line.  The frequency
  49. readout can interpolate between pixels.  A file scroll gadget on
  50. the far right allows different segments of the input file to be
  51. analyzed.  A window switching gadget takes SeeHear back and forth
  52. between the analysis screen and the control window on the
  53. Workbench screen.
  54.  
  55. Playing the selected line only also outputs data for that line to
  56. file ram:SeeHear.temp; see the source for details.  This can be
  57. used to make ordinary line graphs of the spectrum, etc.
  58.  
  59. CONTROL WINDOW
  60.  
  61. A control window on the Workbench screen allows many options to
  62. be adjusted.  Gadgets are outlined in boxes to distinguish them
  63. from information and text.  The file format gadgets allow an IFF
  64. file to be analyzed as RAW if one wants to change the sampling
  65. rate for example.  Byte offsets for time zero (t0) and analysis
  66. start can be specified (t0 not with IFF).  Sample rate in hertz
  67. is specified for RAW files.  SeeHear uses the Fast Fourier
  68. Transform (FFT) algorithm, and takes slices that are a power of 2
  69. in length.  The FFT produces half as many frequencies as time
  70. samples; since the graph uses 256 pixels for frequency, several
  71. frequency steps may need to be averaged into one pixel, or just
  72. the lower frequencies are displayed.  Multiple pixels per
  73. frequency sample are also allowed, especially for short FFTs.
  74. Frequency annotation is both in hertz and musical notes using the
  75. 12 semitone chromatic scale based on a specified middle A.
  76. Successive time slices usually step ahead less than the length of
  77. the FFT because of the need to smoothly fade in and out of the
  78. time slices to avoid analysis artifacts.  Spacing of timing lines
  79. and annotation can be controlled.  Smoothing uses a gaussian
  80. curve whose width is specified relative to the time step as an
  81. envelope to select the time slice for analysis so that clicks at
  82. the ends are avoided (these result in spurious frequencies).  A
  83. large width effectively disables smoothing.  Frequency amplitudes
  84. are mapped into 30 colors with either a logarithmic (decibel, dB)
  85. or linear (%) scale.  When selecting a point for frequency
  86. readout on the analysis screen, SeeHear will search for a peak
  87. amplitude over (possibly) several pixels to enable interpolation.
  88. The sound can optionally be played before analysis, and also each
  89. time slice during analysis.  A window switching gadget permits
  90. going back and forth with the analysis screen.  The bottom of the
  91. control window is a message area.
  92.  
  93. MENU
  94.  
  95. The File/Open item brings up a file requester for the input sound
  96. file.  Once selected, analysis begins immediately, so any options
  97. must be changed before opening.
  98.  
  99. File/Quit has the same effect as the close gadgets.
  100.  
  101. Control/Restart begins analysis using a previously opened file.
  102.  
  103. AUTHOR
  104.  
  105. SeeHear was written and is copyright 1989, 1990 by
  106.  
  107.      Daniel T. Johnson
  108.      2654 E. 25 St.
  109.      Tulsa, OK  74114
  110.  
  111. and is freely distributable for non-commercial use only.
  112.