home *** CD-ROM | disk | FTP | other *** search
/ Dream 44 / Amiga_Dream_44.iso / Linux / Apps / xanim.tgz / xanim / xanim27064 / audio.readme < prev    next >
Text File  |  1997-01-26  |  8KB  |  222 lines

  1.  
  2. This file has some specific information about which workstations
  3. are supported.
  4.  
  5.  
  6.  XAnim supports audio on the following machines:
  7.  
  8.         Sun Sparcs
  9.         Sun x86 Solaris machines
  10.         NEC EWS workstations
  11.         Sony NEWS 5000 series workstations
  12.         SGI Indigo
  13.         PC  with soundcards running unix/linux/QNX
  14.         HP 9000/715 - sort of working - still has problems.
  15.         IBM AIX S6000 machines with audio.
  16.         DEC Alpha workstations running Multimedia Services
  17.         Any machine running AudioFile(AF)
  18.         Any machine(or Xterminal) running Net Audio (NAS)
  19.  
  20.  
  21. --------------------------------------------------------------
  22. Sun Specific Audio Info
  23. --------------------------------------------------------------
  24.  
  25.   Because SunOS 4.1.3 and Solaris have slightly different ioctl()
  26.   calls, if you need to use the XA_AUDIO* defines with the -DSVR4 
  27.   switch.
  28.  
  29.   Sun x86 Solaris machines with a SB16 sound card are
  30.   supported. The code relies on a _LITTLE_ENDIAN being
  31.   defined. You might have to specifically add -D_LITTLE_ENDIAN
  32.   to the Solaris XA_AUDIO* define in the Makefile if you
  33.   system doesn't automatically set that.
  34.  
  35. --------------------------------------------------------------
  36. Linux(soundcard) Specific Info
  37. --------------------------------------------------------------
  38.  
  39.   Compiles and runs on 8 bit and 16 bit sound cards(sound driver 2.5 and 2.99).
  40.   Some video/audio syncing problem with driver 2.5 that got better with 2.99.
  41.  
  42.   NOTE: There is a bug in the 3.5-beta2 release of the VoxWare/TASD.
  43.   This often causes the audio to hang when using XAnim.
  44.  
  45.   This is fixed in the 3.5-beta4 release.  See
  46.  
  47.         http://personal.eunet.fi/pp/voxware
  48.  
  49.   for the latest VoxWare.
  50.  
  51. --------------------------------------------------------------
  52. QNX 4.2 on PC's
  53. --------------------------------------------------------------
  54.  
  55.   This has a separate XA_AUDIO_DEF than linux. See Makefile.
  56.  
  57. --------------------------------------------------------------
  58. NetBSD on PC's
  59. --------------------------------------------------------------
  60.  
  61.   This also has a separate XA_AUDIO_DEF than linux. See Makefile.
  62.  
  63. --------------------------------------------------------------
  64. SGI Specific Info
  65. --------------------------------------------------------------
  66.  
  67.   If you see errors similiar to the following during compilation:
  68.  
  69.     > cfe: Error: xa_audio.c, line 2252: Syntax Error
  70.     >  static ALport port;
  71.  
  72.   You need to install SGI's audio include and lib files from
  73.   the IRIS 5.3 CDROM onto your machine before you can compile *any*
  74.   application that uses audio. See below.
  75.  
  76.  
  77.   NEWSFLASH. The audio stuff should be included now in Irix 5.3.
  78.   If you still have 5.1 or 5.2 and you owned the development CD
  79.   under a previous release of Irix, you can complain about 
  80.   "loss of functionality" and get the new copy.
  81.  
  82.   If you have Irix 5.1 or greater then make sure you have installed 
  83.   the digital media development subsystem (dmedia_dev.sw.audio) off
  84.   of the CD-ROM.  
  85.  
  86.   If this isn't on your CD_ROM then read on...
  87.  
  88.   "according to the 5.2 readme first page, it says
  89.    that the Audio Development software has been moved from
  90.    the IDO to a purchasable option, IRIS media libraries. "
  91.  
  92.   And you either have to contact SGI and buy it($495) OR
  93.  
  94.   In the meantime, you can compile XAnim on an Irix 4.0.5 machine
  95.   and the XAnim binary should work back on the original Irix 5.1
  96.   or 5.2 machine. 
  97.  
  98.   NOTE: I don't have nor can I legally distribute the SGI audio 
  99.   libraries and include files.
  100.  
  101.  
  102. --------------------------------------------------------------
  103. DEC specific info
  104. --------------------------------------------------------------
  105. Audio support for all machines supported by Multimedia Services for Digital
  106. UNIX including both the DEC 3000 and AlphaStation lines.  XAnim should build
  107. and run on anything from Digital UNIX V3.2c or later and MMS V1.6 or later.
  108. Multimedia Services is factory installed on all Digital UNIX workstations,
  109. so you shouldn't have to do anything special to install it or start it up.
  110.  
  111. Digital workstations can also run the AF audio system and XAnim can be built
  112. with support for that as well.
  113.  
  114.  
  115. --------------------------------------------------------------
  116. HP Specific Info
  117. --------------------------------------------------------------
  118.  
  119.   There are two ways to compile in HP audio support into XAnim.
  120.  
  121.   The highly recommended way is to use the XA_AUDIO_DEFS = -DXA_HPDEV_AUDIO
  122.   defines.  This talks directly to the HP audio device and doesn't
  123.   have the problems, delays and overhead with going through HP's
  124.   audio server. NOTE: you can not have the Audio Server running
  125.   on your machine if you choose this method.
  126.  
  127.  
  128.   The other method isn't fully stable yet and is incapable of producing
  129.   decently audio/video synchronization. Plus you need to do the
  130.   following on you system in order to get the Audio Server up 
  131.   and running.
  132.  
  133.   With HP's you need to start up the system Audio Server before
  134.   you can use ANY audio program. Here's how(from the Audio.man
  135.   page on an HP 700/915):
  136.  
  137.            Step 1.   Start the NCS Local Location Broker Daemon.
  138.                      Task 1.   If you are not already superuser, log in as
  139.                                superuser.
  140.                      Task 2.   Enter the command line /usr/etc/ncs/llbd&&&&.
  141.                                To make llbd start automatically at boot
  142.                                time, edit the file /etc/netncsrc and change
  143.                                the line START_LLBD=0 to START_LLBD=1.
  144.            Step 2.   Reboot.
  145.            Step 3.   Set the AUDIO environment variable to specify the node
  146.                      where the audio client should look for the audio
  147.                      server.  If AUDIO is not set or if it is set to :0, the
  148.                      client connects with a server on the same node.
  149.  
  150.                      To specify that the client should connect to a server
  151.                      on another node, set
  152.  
  153.                           AUDIO = node_name: (Korn, Bourne, and POSIX
  154.                           shells)
  155.                           export AUDIO
  156.  
  157.                      or
  158.  
  159.                           setenv AUDIO node_name: (C shell)
  160.  
  161.            Step 4.   Normally, the audio server starts whenever the system
  162.                      is booted.  Check for the existence of the Aserver
  163.                      processes by typing
  164.  
  165.                      ps -e | grep Aserver
  166.  
  167.            You should see two Aserver processes.  If the server is not
  168.            running, start the audio server by hand by typing
  169.  
  170.                 /usr/audio/bin/Aserver
  171.  
  172.            Then type
  173.  
  174.                 ps -e | grep Aserver
  175.  
  176.            and check that there are two active server processes.
  177.  
  178.  
  179. --------------------------------------------------------------
  180. IBM AIX Specific Info
  181. --------------------------------------------------------------
  182.  
  183.   With AIX machines there can be currently three different
  184.   audio devices.  
  185.  
  186.     /dev/acpa0/1    3.2 machines with the older ACPA(Audio Capture
  187.                             and Playback Adapters)
  188.  
  189.     /dev/baud0/1    4.1 machines with the UltiMedia Sound system
  190.  
  191.     /dev/paud0/1    4.1 machines with built in UltiMedia Sound Systems.
  192.  
  193.   You need to determine which one and the change the
  194.  
  195.       DEFAULT_AUDIO_DEVICE_NAME
  196.  
  197.  in the xa_config.h file and recompile.
  198.  
  199. --------------------------------------------------------------
  200. AudioFile (AF) Specific Info
  201. --------------------------------------------------------------
  202.  
  203.   I haven't brought up AF yet on my machine, but have gotten
  204.   reports that it works okay.
  205.  
  206. --------------------------------------------------------------
  207. Net Audio (NAS) Specific Info
  208. --------------------------------------------------------------
  209.  
  210.   I have brought NAS up on my machine but still need to
  211.   fine tuned the code.
  212.  
  213. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=
  214. Any comments, questions, bugs, fixes, etc  email me at 
  215.  
  216.                                        podlipec@ici.net
  217.  
  218. If you make changes to the audio code, please send entire 
  219. xanim_audio.c file unless the patches are minor.
  220.  
  221. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=
  222.