home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-2 / X11 / clients / audio / mixview.README next >
Encoding:
Text File  |  1996-11-09  |  4.2 KB  |  90 lines

  1. README -- 8/93
  2.  
  3. Greetings and welcome to mixview.
  4.  
  5. This program is currently designed to run under Sun OS 3.2, 3.4, and 4.0, and
  6. should be totally compatible with all BSD Unix machines.  The lxt toolkit has
  7. separate makefiles for the various Sun OS releases -- consult the documentation
  8. in the toolkit release, as you may need to make minor changes to reflect your
  9. system.  Additional changes have been made to allow mixview to compile on an
  10. IBM 386 machine.
  11.  
  12. The lxt source code should be untarred in a separate directory from the
  13. mixview source code, and the mixview Makefile should be edited to reflect the
  14. location of the lxt source (see the Makefile).
  15.  
  16. Building Mixview on Different Machines:
  17.  
  18. The only system-dependent portion of the editor is the code relating to 
  19. D-to-A conversion of soundfiles.  It is compatible with with D-A converters
  20. on NeXTs, SPARC I, and SPARC 10 workstations that have the optional SOUND 
  21. package (library and include files) installed.
  22. Two new converters are now supported:  the SoundBlaster, used on IBM 386
  23. machines, and the Audio Controller Board from Audio Digital Systems.
  24. The program will compile without errors, however, on any machine without
  25. changing the conversion code.  I would be delighted to hear of other drivers
  26. capable of converting from memory so that I may add options for them in mixview.
  27.  
  28. Here are some guidelines on how to set the compiler options in the mixview
  29. Makefile.
  30.  
  31. FLAGS=    Set this one to a typical set of flags for the c compiler on your
  32. machine (e.g., -O).  Several samples are included.
  33.  
  34. SYSLIBS= Set this according to your system (see Makefile).
  35.  
  36. LXTMAKEOPTS= This determines which Makefile will be used to build the LXT
  37. toolkit.  It should be set on all machines other than Sun4s, which use the
  38. default makefile.  Examine the available Makefiles in LXT if you are not
  39. sure.
  40.  
  41. COMMENTFLAGS= This is set to -DHAS_SFCOMMENT on all machines except those that
  42. use the Ircam soundfile header without comment space. (Very few of these).
  43.  
  44. DACFLAGS= This is set depending on the D-to-A converter used on your machine.
  45. All available options are given the the Makefile.  Only set one!  If your
  46. machine has no DACs, set it to nothing.
  47.  
  48. DACINCLUDES= This is currently used only on machines using the Audio Digital
  49. Systems converters.
  50.  
  51. SNDFLAGS= This determines what type of soundfile headers and header routines
  52. will be used.  It is most important on Sun Sparcs using the Sparc soundfile
  53. headers [-DSPARC_AUDIO], or on machines that wish to read NeXT header format
  54. files [-DUSE_NeXT_HEADERS].  This can only be done if you have a copy of the
  55. NeXT soundfile header files from the include/sound dir on a NeXT.
  56.  
  57. SNDINCLUDES= On Sparc machines, this need to be set to -I<dir> where <dir> is
  58. the directory containing the header files for sound.  If you are working on a
  59. Sparc and wish to read NeXT format files, set this to the dir containing your
  60. copy of the NeXT header files.
  61.  
  62. FORTDEFINES= Set this depending on whether your machine has a Fortran compiler
  63. [-DHAS_F77] or has the f2c libraries [-DHAS_F2C] or neither [leave blank].
  64.  
  65. FORTFLAGS= Set this to -lF77 or -lf2c depending on your configuration, as
  66. above.
  67.  
  68. NOTE:  Farther down in the Makefile is a target for setell.o.  This must be
  69. set to match the fortran configuration as well.
  70.  
  71. There may be other smaller adjustments to the Makefile, such as the options
  72. for the X11 inclusions and libraries.  Examine the Makefile for such things if
  73. you are having problems.
  74.  
  75. -------------------------------------------------------------------------------
  76. NOTE:  You must use the newest release of LXT with this release of mixview.
  77. There are changes that are not compatible with the old toolkit.  As the author
  78. of mixview, I do not have the authority to issue the additional changes that
  79. may be needed to compile LXT on other machines.  Send me mail if you have
  80. problems.
  81. -------------------------------------------------------------------------------
  82.  
  83. Once the toolkit and this source code are unpacked and un-tarred and after
  84. modifying the makefile in the top level, simply type 'make' at the top-level
  85. directory, and then 'make install'. If you are running X11 R3, add a "-DR3" 
  86. option to the flags (as indicated in the Makefile).
  87.  
  88. Douglas Scott
  89. doug@foxtrot.ccmrc.ucsb.edu
  90.