home *** CD-ROM | disk | FTP | other *** search
/ X-Ray / X-Ray.iso / gfx-soft / xanim / audio.readme < prev    next >
Text File  |  1996-09-20  |  13KB  |  308 lines
  1.  
  2.  
  3. NOTE: You must edit either the Imakefile or the Makefile to
  4. and uncomment out the AUDIO DEFINES and Libraries for your
  5. machine type before compiling.
  6.  
  7.  
  8. --------------------------------------------------------------
  9. What's Supported
  10. --------------------------------------------------------------
  11.  
  12.  The following is a list of currently supported audio formats: 
  13.  
  14.      AVI 8 and 16 bit RAW(PCM) mono/stereo.
  15.      AVI ADPCM is supported(mono only for now).
  16.      Quicktime 8 and 16 bit RAW(PCM) mono/stereo.
  17.      Quicktime 8 and 16 bit TWOS(signed PCM) mono/stereo.
  18.      Quicktime MAC6 is *NOT* supported.
  19.  
  20.  The following is a list of currently supported machines:
  21.  
  22.         Sun Sparcs
  23.         NEC EWS workstations
  24.     Sony NEWS 5000 series workstations
  25.         SGI Indigo
  26.         PC  with soundcards running unix/linux/QNX
  27.         Any machine running AudioFile(AF)
  28.         Any machine(or Xterminal) running Net Audio (NAS)
  29.         HP 9000/715 - sort of working - still has problems.
  30.     IBM AIX S6000 machines with audio.
  31.  
  32. --------------------------------------------------------------
  33. Generic Bug's
  34. --------------------------------------------------------------
  35.   + JPEG/MPEG codecs, because of their compute intensive nature, cause
  36.     audio starvation(pops). Solution is to use +b option. Looking
  37.     into other causes.
  38.   + Remote Control Window colors not selectable.
  39.   + HP support pseudo functional. Still needs a lot of work.
  40.  
  41. --------------------------------------------------------------
  42. New(or Fixes) to 2.69.7.8
  43. --------------------------------------------------------------
  44.   + fixed bad core dump bug in some audio section. overwriting 
  45.     a buffer.
  46.   + SGI syncing problem fixed. Audio was block and preventing
  47.     video from be able to play at speed.
  48.   + A handful of minor bugs where fixed in the MPEG routines.
  49.     Two caused corruption and one prevented bottom part of
  50.     screen from being drawn with certain resolutions.
  51.   + MPG  wasn't properly flushing bits after a new quant scale
  52.   + MPG  if height > bug, was truncating bottom of image.
  53.   + MPG  spurious warning messages(DCT-A and DCT-B err) removed.
  54.   + AVI  RGB depth 24 support added.
  55.   + AVI XMPG support added. This is the Editable MPEG Video
  56.     Codec and if the spec matches the sample I have, it's
  57.     a Kludge. The AVI Headers DON'T match(as in resolution and
  58.     proper audio/video timing) the MPEG SEQ header which looks
  59.     to have the correct info.
  60.   + AVI support for "pads" streams(or rather tolerance for). 
  61.   + HP Raw audio device support to bypass upper lever HP 
  62.     audio server routines.
  63.   + QT: minor bug in Gray Colormap generation. 
  64.   + DL animation format thrown back in and now allows it to
  65.     be readable from the file.
  66.   + IFF Anim8 support written by Garrick Meeker.
  67.   + Added Quiet flag(+q) to prevent XAnim title from being
  68.     printed out to tty. Useful when called in background by
  69.     another program.
  70.   + AUDIO fixed bug where anims without audio prevent following
  71.     anims with audio from enabling that audio.
  72.   + AUDIO Fixed scaling bug in ADPCM audio code. Affected main 8khz 
  73.     machines.
  74.   + Fixed compile bug when compiling without Remote Control Window.
  75.   + cleaning and simplifying internal structures. reducing global
  76.     variables, etc.
  77.   
  78.  
  79. --------------------------------------------------------------
  80. New(or Fixes) to 2.69.7.7
  81. --------------------------------------------------------------
  82.   + remodified audio/video sync code yet again. This time to
  83.     help smooth out some startup syncing problems and to help
  84.     handle more compute intensive video(large frame or jpeg/mpeg).
  85.   + Added IBM RS6000 audio support - Code written by Jeff Kusnitz, thanks.
  86.   + Fixed bug in NAS audio that caused memory corruption after
  87.     an "unable to Toggle" warning(which occurs if a machine has
  88.     an audio device with a fixed output).
  89.   + Merged Audio_Outputs into one routine so I didn't have to
  90.     keep modifying all of them(95% of the code was the same).
  91.   + Added Dithering(+F option) to Cinepak Video Codec. It's on
  92.     by default unless +CF4 is used(list +F after that to override).
  93.   + Fixed Bug with some RLE depth 1 codec.
  94.   + Fixed audio Bug with SGI generated quicktimes audio depth > 8.
  95.   + Fixed bug that was causing quicktime to erroneously send
  96.     back a FULL_IM flag allowing serious skipping to occur. This
  97.     causes on screen corruption if the Video Codec doesn't
  98.     really support serious skipping.
  99.  
  100.  
  101. --------------------------------------------------------------
  102. New(or Fixes) to 2.69.7.6
  103. --------------------------------------------------------------
  104.    + Added MPEG support for Type I frames. Type B and Type P
  105.      frames are currently skipped, but will be added in the
  106.      future. Although I've rewritten large chunks of it, the
  107.      core decoding routines are from mpeg_play.
  108.    + Added Sony NEWS workstation audio support. Thanks to
  109.      Kazushi Yoshida for writing the code.
  110.    + Fixed some bugs in the JPEG routines.
  111.  
  112. --------------------------------------------------------------
  113. New(or Fixes) to 2.69.7.5
  114. --------------------------------------------------------------
  115.    + JPEG: code massively rewritten and optimized. MJPG and IJPG
  116.      video codecs now supported.
  117.    + CVID: some optimization here.
  118.    + SGI: sgi hardware volume is actually exponential. Now XAnim's
  119.      SGI volume function is also exponential
  120.    + Sparc: had some problems with older Sparc audio devices that
  121.      couldn't support NOT having an audio channel selected. The
  122.      Sparc audio ports are now radio button style.
  123.    + Sparc: Some serious incompatibility problems between gcc/cc
  124.      and the /usr/includes and gcc's /usr/includes. Fixed for now.
  125.      Was causing ioctl err 22's during run time on certain
  126.      machine configurations.
  127.  
  128. --------------------------------------------------------------
  129. New(or Fixes) to 2.69.7.4a
  130. --------------------------------------------------------------
  131.    + ALL: You can now add sound to animations that don't have
  132.      sound support(ie FLI/FLC/IFF) by specifying a .wav file
  133.      after the animation file. ie "xanim bart.fli laugh.wav".
  134.      Only some .wav audio compression are currently supported,
  135.      more on the way. NOTE: if audio is longer than animation,
  136.      then animation waits on the last frame until audio is done.
  137.      +f option currently doesn't affect .wav files.
  138.    + PC: best variable not defined in Linux_Closest_Freq() err.
  139.    + PC: libjpeg.a already used by the system and was being found
  140.          1st by the linker causing errors. Renamed to libxajpg.a.
  141.    + ALL: Solution that helps high frame rate anims on SGI machines
  142.      was hurting some others. Now only fixed on SGI machines.
  143.    + ALL: work around to help play some broken FLC's.
  144.       
  145. --------------------------------------------------------------
  146. New(or Fixes) to 2.69.7.4
  147. --------------------------------------------------------------
  148.    + Fixed bug with Quicktime signed(TWOS) 16 bit stereo audio format.
  149.    + Fixed bug with +f option and any 16 bit audio format.
  150.    + +Ae is now be made enabled by default.
  151.    + SPEAKER env variable checked(INTERNAL/HEADPHONES/EXTERNAL/NONE).
  152.    + RemoteControl Window made smaller and now has dynamically
  153.      changing bitmaps to better indicate current function of
  154.      the buttons.
  155.    + RemoteControl window no longer overlaps Anim Window.
  156.    + "+Ar" option enables/disables RemoteControl Window.
  157.    + "z" window command pops creates/destroys RemoteControl Window
  158.      on-the-fly.
  159.    + More fine tuning of video/audio routines.
  160.    + AVI ADPCM is no longer decompressed 1st. +f now works with
  161.      this audio codec.
  162.    + AVI JPEG Video Codec support added, including interleaved frames.
  163.    + AVI MJPG Video Codec support added.
  164.    + HP: finally code sound out of an HP. Code still has a ways to go.
  165.          And HP Aserver library seems to be part of the problem.
  166.  
  167. --------------------------------------------------------------
  168. Configuring For Your Machine
  169. --------------------------------------------------------------
  170.  
  171.   You'll need to edit the Makefile or the Imakefile. Go to the Audio 
  172.   section and uncomment out the DEFINE's associated with your machine
  173.   type. Make sure no other machine's DEFINE's are uncommented. That 
  174.   would be bad. 
  175.  
  176.  
  177. --------------------------------------------------------------
  178. Sun Sparc Specific Info
  179. --------------------------------------------------------------
  180.  
  181.   IF YOUR ARE USING OPENWINDOWS THEN YOU MUST USE Makefile.unx
  182.   AND YOU MUST EDIT THE CHANGES REQUIRED. This is because of
  183.   bugs/deficiencies with the OpenWindows Athena libraries.
  184.   See top of Makefile.unx for more details.
  185.  
  186.   Having some problems with gcc, because it wants to use it's
  187.   own include files and they're usually wrong(or out of date).
  188.   Use cc if this happens.
  189.  
  190.   If you are using Solaris, use the -DSOLARIS define in the Makefile.
  191.  
  192. --------------------------------------------------------------
  193. Linux(soundcard) Specific Info
  194. --------------------------------------------------------------
  195.  
  196.   Compiles and runs on 8 bit and 16 bit sound cards(sound driver 2.5 and 2.99).
  197.   Some video/audio syncing problem with driver 2.5 that got better with 2.99.
  198.  
  199. --------------------------------------------------------------
  200. SGI Specific Info
  201. --------------------------------------------------------------
  202.  
  203.   NEWSFLASH. The audio stuff should be included now in Irix 5.3. You
  204.   might be able to obtain them for free if you have the Irix 5.1 or
  205.   Irix 5.2 releases, but that's just a rumor.
  206.  
  207.   If you have Irix 5.1 or greater then make sure you have installed 
  208.   the digital media development subsystem (dmedia_dev.sw.audio) off
  209.   of the CD-ROM.  
  210.  
  211.   If this isn't on your CD_ROM then read on...
  212.  
  213.   "according to the 5.2 readme first page, it says
  214.    that the Audio Development software has been moved from
  215.    the IDO to a purchasable option, IRIS media libraries. "
  216.  
  217.   And you either have to contact SGI and buy it($495) OR
  218.  
  219.   In the meantime, you can compile XAnim on an Irix 4.0.5 machine
  220.   and the XAnim binary should work back on the original Irix 5.1
  221.   or 5.2 machine. 
  222.  
  223.   Once XAnim audio is stablized on SGI's, I should be able to provide
  224.   an xanim executable.  NOTE: I don't have nor can I legally distribute
  225.   the SGI audio libraries and include files.
  226.  
  227. --------------------------------------------------------------
  228. HP Specific Info
  229. --------------------------------------------------------------
  230.  
  231.   Written and getting better, but still has a ways to go.
  232.  
  233.   With HP's you need to start up the system Audio Server before
  234.   you can use ANY audio program. Here's how(from the Audio.man
  235.   page on an HP 700/915):
  236.  
  237.            Step 1.   Start the NCS Local Location Broker Daemon.
  238.                      Task 1.   If you are not already superuser, log in as
  239.                                superuser.
  240.                      Task 2.   Enter the command line /usr/etc/ncs/llbd&&&&.
  241.                                To make llbd start automatically at boot
  242.                                time, edit the file /etc/netncsrc and change
  243.                                the line START_LLBD=0 to START_LLBD=1.
  244.            Step 2.   Reboot.
  245.            Step 3.   Set the AUDIO environment variable to specify the node
  246.                      where the audio client should look for the audio
  247.                      server.  If AUDIO is not set or if it is set to :0, the
  248.                      client connects with a server on the same node.
  249.  
  250.                      To specify that the client should connect to a server
  251.                      on another node, set
  252.  
  253.                           AUDIO = node_name: (Korn, Bourne, and POSIX
  254.                           shells)
  255.                           export AUDIO
  256.  
  257.                      or
  258.  
  259.                           setenv AUDIO node_name: (C shell)
  260.  
  261.            Step 4.   Normally, the audio server starts whenever the system
  262.                      is booted.  Check for the existence of the Aserver
  263.                      processes by typing
  264.  
  265.                      ps -e | grep Aserver
  266.  
  267.            You should see two Aserver processes.  If the server is not
  268.            running, start the audio server by hand by typing
  269.  
  270.                 /usr/audio/bin/Aserver
  271.  
  272.            Then type
  273.  
  274.                 ps -e | grep Aserver
  275.  
  276.            and check that there are two active server processes.
  277.  
  278. --------------------------------------------------------------
  279. IBM RS6000  Specific Info
  280. --------------------------------------------------------------
  281.  
  282.   Waiting for feedback on how it works.
  283.  
  284. --------------------------------------------------------------
  285. AudioFile (AF) Specific Info
  286. --------------------------------------------------------------
  287.  
  288.   I haven't brought up AF yet on my machine, but have gotten
  289.   reports that it works okay.
  290.  
  291. --------------------------------------------------------------
  292. Net Audio (NAS) Specific Info
  293. --------------------------------------------------------------
  294.  
  295.   I have brought NAS up on my machine and have fine tuned it. NAS
  296.   has some deficiencies that make it difficult to keep audio/video
  297.   in sync. Hopefully they'll improve it and likewise I'll improve 
  298.   my understanding of it and work from there.
  299.  
  300. --------------------------------------------------------------
  301. Any comments, questions, bugs, fixes, etc  email me at 
  302. podlipec@wellfleet.com or podlipec@shell.portal.com
  303.  
  304. If you make changes to the audio code, please send entire 
  305. xanim_audio.c file unless the patches are minor.
  306.  
  307. --------------------------------------------------------------
  308.