Short:        libAYEmu, use this to play AY music
Author:       Roman Scherbakov, Sashnov Alexander, AmigaOS 4.0 compile by Spot / Up Rough
Uploader:     Varthall / Up Rough <varti02 hotpop com>
Type:         dev/lib
Version:      0.9.5
Architecture: ppc-amigaos >= 4.0.5

 AY/YM sound co-processor emulation library.

  This is the AY/YM sound chip emulator. These chips was used in such
computers as Sinclair ZX Spectrum 128Kb(AY8912), Atari and some others.

  This library allow to use AY/YM sound effects and music in your own
programms, games, demos, etc. User must pass to library array of AY/YM
registers (14-bytes) and library will generate sound stream by this.
Library have functions for handle .vtx files (see below), doxygen
format documentation and samples of use the library API.

  VTX format is made for store AY/YM song in lha5 complession. This
library can read sond info header and unpack lha5 compressed data from
vtx file. There are thousands songs from games, magazins, demos
available from other sources in internet. You can see
http://vtx.microfor.ru/music.htm for example.

See also playvtx (vtx console player) and xmms-vtx (vtx xmms plugin).




    Installation.

For configure, make and install just do the following commands:
 
 tar xzf libayemu-*.tgz
 cd libayemu
 ./configure
 make
 make install

(last command requires the root privelegies).
It will install library and headers in /usr/local/lib and /usr/local/include.
See file INSTALL for read more about standard configure script options. 




    Install latest version from CVS.

You can download and install laters (under development) version of
libayemu directly from CVS repository on sourceforge.net by following
commands (this example for Linux/cygwin users):

 cvs -d:pserver:anonymous()cvs.sf.net:/cvsroot/libayemu co libayemu
 cd libayemu
 sh bootstrap      # (for generate build script)
 ./configure
 make
 make install      # (with root privelegies)




    Using the library

You can find several usage examples for this library:
  * console VTX-file player: playvtx;
  * custom register data set: test.c in src dir.

Also there is a good doxygen format documentation available.

Other examples (under SDL, win32) coming soon (volunteers?).




    Other resources

On vtx.microfor.ru you can found vtx player for winamp (as plugin) and
pocketPC.

Warning: There is the large zip archive on vtx.microfor.ru:

vtx_songs   23.65 Mb  ZX Spectrum Vortex Music SFX Archive v1.5

But inside this zip the windows-executable self-extracting archive.
So if you have problem with run it (if you use other than Windows (TM)
operating system or you not want run not trusted executable from
Internet) you can download it as plain zip archive by following link:

http://sashnov.fanstvo.com/vtx_songs.zip  (27 Mb)

   .___________________________________________________________.
   |                                                           |
   |       A M I G A   O S   4 . 0   C O M P I L E   B Y       |
  ._______                                        .______.     |
  |  ____/________________________________________|      |__   .
._|____._         |      ._       |      ._       |       _/______.
|      |/         |      |/       |      |/       |      |/       |
|                 |      _________|               |               |
|_________________|______|spt/up  |_______________|_______________| 
   .                                                           .
   |                                                           |
   |      This one is dedicated to Curty, Bean and Olle!       |
   |                 Umpa Umpa - Pumpa Rumpa!                  |
   |        Go make an AY plugin for TuneNet now! Run!         |
   |                                                           |
   |   I am in a shitty economical situation, so if you feel   |
   |  that what I do is  worth anything, use paypal to donate  |
   |         to my email addy, spotATtriadDOTse, thanx!        |
   |                                                           |
   |                    Spot / Up Rough 2006                   |
   |___________________________________________________________|