home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 19 / AACD19.BIN / CDTools / Players / DeliTracker / Bonus / playsid3.lha / PlaySID3.0 / Library.doc < prev    next >
Text File  |  1994-08-12  |  8KB  |  232 lines
  1.  
  2.     PLAYSID.LIBRARY V1.0        (C)1994 Per Håkan Sundell & Ron Birk
  3.  
  4.     Release date: 1 June 1994
  5.  
  6. NOTE:
  7.  
  8.     This is SHAREWARE, not Public Domain. That means that if you like
  9.     this program and want further updates, you can be a registered owner
  10.     by sending us $15. It also means that you can copy this program only
  11.     if all files (including this) are included and nothing is changed.
  12.     You are not allowed to replicate any portion of the program, both
  13.     code or data. Note also that we take no responsibilities for the use
  14.     of this    program considering any damage to or failure of your hardware
  15.     , software etc.
  16.  
  17.     You have the permission to put this unmodified and full archive on
  18.     any BBS, FTP site, CD Rom, Magazine, Disk etc. In other words, the
  19.     archive    may be freely distributed as long as no more than a nominal
  20.     fee is charged to cover time and copying costs.
  21.  
  22.     If you just like the program, PLEASE let us know so by sending us a
  23.     postcard or similiar to the addresses below.
  24.  
  25.  
  26. NEW FEATURES:
  27.  
  28.     V1.0 (1994)
  29.  
  30.     * New, faster and better sound and waveform routines
  31.         * PAL and NTSC TV System simulation
  32.         * Channel on/off selection
  33.     * Support for Compute! SID ".mus" files
  34.     * Audio device and cia timers allocated only when playing
  35.     * Icon tooltypes now have default settings, if omitted
  36.  
  37.  
  38. PRODUCT INFO:
  39.  
  40.     The playsid.library is a standard amiga library    where all the c64
  41.     music emulation is done. You can now add support for PlaySID modules
  42.     in your own programs!! REMEMBER, you still need to supply the whole
  43.     PlaySID archive with your program and CAN NOT only extract the
  44.     library.
  45.  
  46.     This library emulates the SID and 6510 chip. The SID chip is the
  47.     component in the C64 computer that handles sound. The 6510 chip
  48.     is the CPU of the C64, that means the component    that actually
  49.     executes all programs. Because the Amiga does not have these chips
  50.     and others, you can't run C64 programs directly on Amiga.
  51.  
  52.     Now this library lets you play all those C64 programs that produce
  53.     sound. As you probably know, the C64 has three sound channels (the
  54.     amiga has four). But this utility also allows use of the fourth
  55.     channel. This channel is the product of    some special programming on
  56.     the C64, it isn't really a channel.
  57.  
  58.     The purpose of this product is to make the best conversion of C64
  59.     sound on Amiga ever possible. If you think some sound isn't correctly
  60.     converted please let us know.
  61.  
  62.     This utility is designed to work with true multitasking, under any
  63.     system version and any amiga model. It can be run from both Workbench
  64.     and CLI/Shell. It should work with any other program that don't use
  65.     sound or timing. If this isn't the fact please let us know.
  66.  
  67.  
  68. PROGRAM INSTALLATION:
  69.  
  70.     To install playsid.library copy it to your LIBS: directory by hand,
  71.     or run the installation script 'Install' (by using 'Execute' or by
  72.     doubleclicking its icon).
  73.  
  74.  
  75. FILE FORMAT:
  76.  
  77.     playsid.library needs a PlaySID module header and a C64 data file to
  78.     work. One-file modules have the header in front of the data. Icon
  79.     files have the header data as icon tooltypes instead. The library
  80.     support a conversion to a module header.
  81.  
  82.  
  83. TECHNICAL INFO:
  84.  
  85.     Up to date playsid.library features:
  86.  
  87.     * Full emulation of 6510 instructions
  88.     * Full envelope emulation (even better than SID)
  89.     * Full waveform emulation (uses highest quality ever possible)
  90.     * Full ringmodulation/synchronize emulation (even both!)
  91.     * Emulation of the fourth channel, including Martin Galway NOISE
  92.       and all kind of SAMPLES
  93.     * Sounding like C64 PAL and C64 NTSC on all Amigas
  94.     * Handles vertical sync, 60Hz and variable speed timing
  95.     * Fast Forward and Rewind!
  96.     * Timer (holds the actaul time, dependant of forward/rewind)
  97.     * Amiga 4 kHz Filter ON/OFF (should be off)
  98.     * Full TRUE Multitasking (opens, closes and checks everything)
  99.     * Above new feutures
  100.  
  101.     playsid.library is written with GnuEmacs 18.58 and compiled with
  102.     SAS/C 6.50 and Devpac 3.02 assembler. It uses about 50kB of chip
  103.     memory and 160kB of other memory. If playing samples or rewind
  104.     option is on, more memory will be used. Also add the length of the
  105.     tune to the amount of other memory.
  106.  
  107.  
  108. FUTURE FEATURES:
  109.  
  110.     This is a list of features that still isn't included into the current
  111.     version. They will probably be included in future versions.
  112.  
  113.     * Emulation of Filter.
  114.     * Option to load and play Tunes which are already emulated.
  115.     * Support for other c64 module players
  116.     * Features YOU would like to be added (PLEASE WRITE AND TELL US).
  117.  
  118.  
  119. CONVERSION:
  120.  
  121.     If you convert by yourself, PLEASE send them to us, using e-mail or
  122.     regular mail, so we can release complete packages. Then the user will
  123.     not get several packages with same or bad tunes. PLEASE, supply full
  124.     information (name, author and copyright).
  125.  
  126.     If you want to help us with conversion, we would be very pleased. We
  127.     have a lot of disks on 1541-format and Amiga-format with already
  128.     ripped tunes. On a lot of the files, the only work to do, is to    find
  129.     the addresses of the initroutines. Some of them are splitted in
  130.     several files but the most of them are one-parted. If you don't    have
  131.     a C64 anymore but still have the knowledge of 6502, we could also
  132.     supply you with a fast C64emulator with a machinecodemonitor made by
  133.     ourselves. If you would want these files, please send some blank
  134.     disks (in either format) to any address belove. If it shows up that
  135.     you are a good converter, then you will have the next updates for
  136.     free.
  137.  
  138.     For more information about conversion, read the supplied docs.
  139.  
  140.  
  141. REGISTRATION:
  142.  
  143.     If you want to support our work, you have the option to become a
  144.     registered owner of this utility and receive further upgrades WHEN
  145.     THEY ARE READY. Send $15 USD (US DOLLAR) or equal amount in SEK
  146.     (Swedish Krona) or DM (German Mark). Send it to either address below
  147.     with your name, address, e-mail, phone etc. If you later change
  148.     address, PLEASE let us know.
  149.  
  150.         Håkan Sundell            Ron Birk
  151.         Dr. Lindhs Gata 3,II        Krögarvägen 11
  152.         413 25 Göteborg            145 52 Norsborg
  153.         SWEDEN                SWEDEN
  154.  
  155.     Those of you who already are registered users and have got one or
  156.     more upgrade version, and want further upgrades can send either a
  157.     fully post-paid return letter (swedish stamps!) with a disk or $5
  158.     USD (or equal) for our expenses. You can do this right now so that
  159.     you will get the upgrade the same moment it is ready.
  160.  
  161.  
  162. CONTACT ADRESSES:
  163.  
  164.     You will reach us through usual mail, phone or Internet mail. Regular
  165.     mail is very slow so Internet mail is the best way to reach us and is
  166.     usually answered the very same day!
  167.  
  168.     If you want to call us about suggestions, bug report or complains
  169.     about PlaySID you may call:
  170.  
  171.     +46 (0)31 419 418  (Håkan) about 6502 and SID Emulation
  172.     +46 (0)8 531 88626 (Ron)   about Library, User Interface and Features
  173.  
  174.     If you have access to Internet you will reach us at the following
  175.     e-mail addresses:
  176.  
  177.     md1phs@mdstud.chalmers.se (Håkan)
  178.     rbk@ios.se (Ron)
  179.  
  180.  
  181. NOTE TO OTHER DEVELOPERS:
  182.  
  183.     To Questronix (The makers of The A64 Package):
  184.  
  185.     We are still offering you our SID emulation to your C64 Emulator
  186.     (We have listened to your noise emulation). And if that is
  187.     interresting, we could help with the Cassette interface    (including
  188.     software) too! It's connected as a diskdrive, and it works very fine.
  189.  
  190.  
  191. THANKS:
  192.  
  193.     We want to thank the following people for helping us with the
  194.     development of PlaySID:
  195.  
  196.     Robert Eichelsheim   - For supporting us with extremely many ripped
  197.                    tunes and for information about the authors
  198.                    and copyrights. For beta testings and good
  199.                    suggestions about improvements.
  200.  
  201.     Bent Nielsen         - For supporting good ideas and algorithms
  202.                    about synthesized waveforms.
  203.  
  204.     Alexander Andelkovic - For lending us your C64, 1541 and many
  205.                    games to rip songs from.
  206.  
  207.     Peter Kunath         - For good suggestions and beta testing.
  208.  
  209.     Stefan Boberg        - For early beta tests and good suggestions.
  210.  
  211.     ??? (Florida?)         - For giving us the Compute! SID player.
  212.  
  213.     Teijo Kinnunen       - For making MED! It inspired us to make
  214.                    PlaySID multitask.
  215.  
  216.     Olaf Barthel         - For making Term! Without it we would still
  217.                    use snail mail during development, as we
  218.                    live 460 km from each other.
  219.  
  220.     Registered Users     - Thanks for supporting our work. You are
  221.                    the reason for our work.
  222.  
  223.     Commodore-Amiga      - For making all this possible!
  224.  
  225.  
  226. LAST WORDS:
  227.  
  228.     We hope that you will find this program useful and that
  229.     it will bring back the old C64 athmosphere to you too...
  230.  
  231.  
  232.