home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / amiga / playsid.txt < prev    next >
Text File  |  1995-08-16  |  14KB  |  440 lines
  1.  
  2.     PLAYSID V3.0        (C)1990-94 Per Hσkan Sundell & Ron Birk
  3.  
  4.     Release date: 1 Aug 1994
  5.  
  6. NOTE:
  7.  
  8.     From version 2.1 of PlaySID kickstart 2.04 (v37) or above is
  9.     required! This is because it makes heavy use of Release 2 System
  10.     routines.
  11.  
  12.     This is SHAREWARE, not Public Domain. That means that if you like
  13.     this program and want further updates, you can be a registered owner
  14.     by sending us $15. It also means that you can copy this program only
  15.     if all files (including this) are included and nothing is changed.
  16.     You are not allowed to replicate any portion of the program, both
  17.     code or data. Note also that we take no responsibilities for the use
  18.     of this program considering any damage to or failure of your hardware
  19.     , software etc.
  20.  
  21.     You have the permission to put this unmodified and full archive on
  22.     any BBS, FTP site, CD Rom, Magazine, Disk etc. In other words, the
  23.     archive    may be freely distributed as long as no more than a nominal
  24.     fee is charged to cover time and copying costs.
  25.  
  26.     If you just like the program, PLEASE let us know so by sending us a
  27.     postcard or similiar to the addresses below.
  28.  
  29.  
  30. NEW FEATURES:
  31.  
  32.     V3.0 (1994)
  33.  
  34.     * Uses PLAYSID.LIBRARY (please read separate docs)
  35.     * Support of XPK Data Compression
  36.     * Realtime waveform and envelope display (uses low priority task)
  37.         * Shows C64 pictures (Koala, Blazing Paddles, Doodle, Adv Art Studio etc.)
  38.         * TV System detection and selection
  39.         * Channel on/off selection
  40.     * PlaySID is now a commodity
  41.     * Uses a config file for settings
  42.     * Multifile selection (music and pictures)
  43.     * Ability to show and hide PlaySID windows
  44.     * Second PlaySID instance redirect modules to the running one
  45.     * PlaySID font removed
  46.     * More arexx commands
  47.     * Many major bugs corrected
  48.  
  49.  
  50. PRODUCT INFO:
  51.  
  52.     This is a utility which uses the playsid.library to emulate the SID
  53.     and 6510 chip. The SID chip is the component in the C64 computer that
  54.     handles sound. The 6510 chip is the CPU of the C64, that means the
  55.     component that actually executes all programs. Because the Amiga
  56.     does not have these chips and others, you can't run C64 programs
  57.     directly on Amiga.
  58.  
  59.     Now this utility lets you play all those C64 programs that produce
  60.     sound. As you probably know, the C64 has three sound channels (the
  61.     amiga has four). But this utility also allows use of the fourth
  62.     channel. This channel is the product of some special programming on
  63.     the C64, it isn't really a channel.
  64.  
  65.     The purpose of this product is to make the best conversion of C64
  66.     sound on Amiga ever possible. If you think some sound isn't correctly
  67.     converted please let us know.
  68.  
  69.     This utility is designed to work with true multitasking, under any
  70.     system version and any amiga model. It can be run from both Workbench
  71.     and CLI/Shell. It should work with any other program that don't use
  72.     sound or timing. If this isn't the fact please let us know.
  73.  
  74.     Some time ago we released a similar product called "The 100 most
  75.     remembered C64 game-tunes". This product is the version 3.0 of that
  76.     program. The tunes on that demonstration disk are now also available
  77.     to this version. And up to date there are more than 400 tunes
  78.     available. We and others are also working with more.
  79.  
  80.  
  81. PLAYSID LIBRARY
  82.  
  83.     The playsid.library is a standard amiga library    where all the C64
  84.     music emulation is done. You can now add support for PlaySID modules
  85.     in your own programs!! REMEMBER that you still need to supply the
  86.     whole PlaySID archive with your program and CAN NOT only extract the
  87.     library. Read the library documentation for more information.
  88.  
  89.  
  90. PROGRAM INSTALLATION:
  91.  
  92.     From v3.0 and on PlaySID uses a library called "playsid.library".
  93.     This file should be in your LIBS: directory.
  94.  
  95.     To use this utility from Workbench you could assign SID: to a 
  96.     directory containing PlaySID. Then all you have to do is to double
  97.     click on the icon of the tune you want to play. You could also just
  98.     select the icon of the tune, then press the shift key and hold it
  99.     down while double clicking on the PlaySID icon.
  100.  
  101.     If you want to run this utility from CLI/Shell, just put the
  102.     directory containing PlaySID in your path (e.g. c: ) and then write:
  103.     PlaySID [<tune directory>/<tune name>]
  104.  
  105.  
  106. STARTUP PARAMETERS
  107.  
  108.     WORKBENCH:
  109.  
  110.     From Workbech PlaySID uses startup parameters in in its icon
  111.     tooltypes.
  112.  
  113.         CX_POPUP = <Yes|No>
  114.  
  115.     Use "Yes" if you want the PlaySID windows showable at the startup. A
  116.     "No" means all windows will be hidden instead. Default is "Yes".
  117.  
  118.         CX_POPKEY = <key>
  119.  
  120.     The key combination is used as a HotKey for the PlaySID main window.
  121.     Default    key is "Ctrl Shift P".
  122.  
  123.         CX_PRORITY = <pri>
  124.  
  125.     This sets the priority of the commodity engine in PlaySID. Default
  126.     value is zero. IF you do not know what this parameter is used for,
  127.     please leave it then.
  128.  
  129.     SHELL/CLI:
  130.  
  131.     From Shell or CLI you can supply extra parameters after the PlaySID
  132.     command.
  133.  
  134.         CX_POPUP, CX_POPKEY and CX_PRIORITY
  135.  
  136.     Same as above tooltypes parameters.
  137.  
  138.         FILES = <list>
  139.  
  140.     A list of the files to play. The first one is loaded at startup. As
  141.     default    no file is loaded and played.
  142.     
  143.  
  144. PROGRAM USAGE:
  145.  
  146.     It works almost like an ordinary cassette player, with the symbols
  147.     for play, forward, rewind, pause and stop. While PlaySID is active
  148.     you can just drag a tune icon and drop it on the PlaySID window. To
  149.     most commands there are keyboard shortcuts.
  150.  
  151.     l - Play
  152.     a - Pause
  153.     s - Stop
  154.     t - Next Tune
  155.     T - Previous Tune
  156.     o - Open
  157.     p - Previus module
  158.     n - Next module
  159.  
  160.     The menu have more options like about, open, quit, filter, rewind
  161.     and display. The filter option turns on and off the amiga sound 
  162.     filter. Please try it.
  163.  
  164.  
  165. REWIND BUTTON:
  166.  
  167.     If the rewind option is turned on, the rewind gadget will be enabled
  168.     first when you press the play gadget. The rewind routines are very
  169.     complex and need a lot of memory. Thats the reason of the option. It
  170.     takes approximately 30k every minute of playing.
  171.  
  172.  
  173. REAL-TIME DISPLAY:
  174.  
  175.     From version 3.0 of PlaySID and on, a special window with real-time
  176.     information about envelopes and waveforms is included. To enable the
  177.     window, use the display option in the menu.
  178.  
  179.  
  180. SHOW C64 PICTURES:
  181.  
  182.     This option opens a screen with a C64 Picture. The first 2 bytes is
  183.     the loading address and is ignored by PlaySID. Then follows a 8000
  184.     bytes bitmap and a 1000 bytes    charmap. For multicolor    pictures
  185.     there is also a 1000 bytes colormap and 1 byte holding the background
  186.     color. The order and base addresses is depending on the file format.
  187.  
  188.     PlaySID have support for the following formats:
  189.  
  190.     HIRES        Art Studio
  191.             Image System
  192.             Doodle
  193.  
  194.     MULTICOLOR    Koala
  195.             Advanced Art Studio
  196.             Vidcom 64
  197.             Image System
  198.             Blazing Paddles
  199.  
  200.  
  201. XPK AND POWERPACKER SUPPORT:
  202.  
  203.     Version 2.2 of PlaySID and above support powerpacked files. V3.0 and
  204.     above also support the XPK Compression libraries. If PlaySID finds
  205.     XPK or Powerpacker installed all file loading is done with it. To
  206.     save space you can now crunch all your files, e.g. songs and 
  207.     pictures.
  208.  
  209.  
  210. ONE-FILE FORMAT:
  211.  
  212.     Many users requested a new "one file" format of PlaySID data files.
  213.     The file SIDConv on the disk will convert a regular data/icon file
  214.     to the new one-file format or the opposite. Of course these new
  215.     files can be crunched as well.
  216.  
  217.     SIDConv iconfile newfile    - To convert a data/icon file to the
  218.                       "one file" format.
  219.  
  220.     SIDConv    one-filefile newfile ICON
  221.                     - To convert a file in "one file"
  222.                       format to the regular data/icon
  223.                       file.
  224.  
  225.  
  226. AREXX PORT:
  227.  
  228.     PlaySID have an Arexx Port named 'PLAYSID'. This mean that you now
  229.     have full controll of PlaySID through your arexx scripts. Supplied
  230.     with this release are two examples of what you can do with arexx:
  231.  
  232.     Jukebox - This will take given file as input and play each
  233.           module the amount of time given.
  234.  
  235.           Try: RX Jukebox JukeDemo
  236.  
  237.     Preview - This will play each tune in given module for 10 sec.
  238.           Like the preview found in CD Players.
  239.  
  240.           Try: RX Preview Songs/RunTheGauntlet
  241.  
  242.     Arexx commands supported:
  243.  
  244.     SID_PLAY()      - Start cur