Short:        Improved sc68 package (w/ cust. builder)
Author:       Benjamin Gerard
Uploader:     megacz usa com
Type:         mus/play
Version:      2.3.0-2
Replaces:     mus/play/sc68-bin-debug-m68k.lha; mus/play/sc68-bin-m68k.lha
Requires:     see notes
Architecture: m68k-amigaos;generic

sc68-2.3.0 (#2 attempt)
-------------------------

---

sc68 is an Atari ST and Amiga music player. It emulates the Mc68000
microprocessor and all Atari ST and Amiga chips necessary to play musics.

sc68 programs handle sc68 files (.sc68). A complete collection of sc68
files and more informations are available on sc68 official website.

Since version 2.1.0 sc68 support SNDh files. You may find such files
on some Atari ST related website.

Copyright (C) 1998-2003  Benjamin Gerard
<ben@sashipa.com>
<http://sc68.atari.org>
<http://sourceforge.net/projects/sc68/>

---

NEWS:
     [15-Feb-2008] - Signals checking changed in raw/aiff part.
 
     [14-Feb-2008] - Fixed potential crash. Lombi suggested '--info' in
                     conjunction with '--track=#', so here it is.
                     Fpu related libs removed! - there was no benefit
                     on anything.

     [12-Feb-2008] - Added extra signalling for subsongs (CTRL-F),

     [09-Feb-2008] - Some more fixes.

     [07-Feb-2008] - Lombi found a bug affecting Amiga(Paula) modules,
                     mixing frequency was cleared where it shouldnt
                     be each time new track was invoked(that looked
                     like a my fault but it wasnt). Bug was api related.
                     Thanks to him and that bug, this version is 
                     completelty rebuilt with new features(i planned
                     to add ahi and stuff but had no motivation :) ).
---

NOTES:

Requires 68000+(no FPU) or 68020+(no FPU), 1+ MiB of free memory, ixemul 48+
[ixnet 48+], [bsdsocket 3+ compatible TCP/IP stack], [AHI 4+]

'sc68' prefers Unix like paths in the environment variables, but Amiga like
will also work unless you dont use 'sh'.

Paula related tunes can be played smoothly on 68040/33 using just "AUDIO:"
at 12000 Hz and using AHI at 24000 Hz(eats all MIPS)! Atari tunes(sndh) load
the cpu way too much, even AHI cant handle them nicely in low quality on my
040... I think that 8bit mixer would cure that, but this is a lot of work.

'api68_shutdown()' does not write configuration anymore, if you want that
use 'api68_config_save()' before the shutdown.

'--bufauto=#' isnt perfect(this is exactly same trick as in hvlplay2007), it
does not like exotic frequencies(11025,17640..), you can still use '--buf=#'
but when saving to a file the first one is recommeneded, this is because it
adds silence at the end of a track so there is no ugly "peek" effect(by def.
'--buf=2048' is used).

The only useful environment variables are: SC68_DATA, SC68_HOME

'--sc68_*' options in the player are bogus(leftovers probably).

I have made different builds of libraries and prepared 'curl' and 'zlib'
objects so that you can simply jump into 'custom/sc68' and build your own
binary with modifications if you need(see Makefile first!). Avoid gcc-3 !!!
gcc-2.95.3 + binutils-2.9.1 were used to create libraries and binaries.

In 'bonus/' you will find early build of 'curl' version 7.17.1 - not
releasing as a standalone package since i also plan to build working SSL,
branch through 'GnuTLS'. There is also 'sorrycat68', it may help in
filtering out tunes by replayer name. 

Use debug builds to hunt down bugs and your errors, they are in '68000-debug/',
this is also a sort of kit for developing new and bugfixing old replayers.

If you want to skip to another subsong then just press Control-F or send
it externally, but note this makes only sense with '--track=0' !

If you got fast machine then you do not need to set huge buffers!

---

HELP:

sc68 - Atari ST and Amiga music emulator
Copyright (C) 1998-2003 Benjamin Gerard <ben@sasghipa.com>
Player improved by megacz@usa.com

This program is free software.

usage : sc68 [options] <URL>

options:
  --help             : Display this message and exit
  --version          : Display sc68 version x.y.z and exit
  --quiet            : Do not display music info
* --info             : Dump infos about all the tracks,
                       track 0 is the sum of all the tracks!
* --stdout           : Prefer stdout instead of stderr
  --track=#[,#]      : Choose track to play [0=all tracks]
                       and number of loop [0=infinite]
* --buf=#            : Memory for audio buffer (512-65536)
* --autobuf=#        : Calculates buffer automatically allowing
                       multiplication factor (1-128) to be used
* --freq=#           : Set new frequency (6000-50000) Hz
* --ahi=#            : Play through AHI unit directly (0-3)
                       (This enforces --autobuf=32 by default!)
* --aiff=name        : Output to AIFF instead of >RAW
  --sc68_data=path   : Set shared resource path (prior to ${SC68_DATA})
  --sc68_user=path   : Set user resource path (prior to ${SC68_USER})
  --sc68_music=path  : Set local music path (prior to ${SC68_USER})
  --sc68_rmusic=path : Set remote music path (prior to ${SC68_USER})

URL:
  - or 
  stdin://           : Read file fron standard input.
  path or
  file://path or 
  local://path       : Local sc68 music file.
  http://path or 
  ftp://path or
  ...                : Load nusic file via given protocol (see curl)
  sc68://author/hw/title[/#track]
  Access sc68 music database. The music file is searched first in local
  music path and if not found in remote music path.


  * - new options

---

EXAMPLES(play):

   cd sc68-2.3.0-bin-m68k/
   set SC68_DATA `cd`/usr/local/share/sc68
   cd 68020-nofpu/usr/local/bin/

   ;(output through AHI wrapper 'AUDIO:')
   sc68 "../../../../tunes/Cytax #1.sc68" --freq=12000 --buf=4096 >"audio:c=2/b=16/f=12000/buf=12000/unit=2" 

   ;(output through AHI)
   sc68 "../../../../tunes/Cytax #1.sc68" --freq=24000 --autobuf=128 --ahi=2

   ;(hq aiff with all the subsongs)
   sc68 ../../../../tunes/Mazemania.sc68 --track=0 --freq=44100 --autobuf=128 --aiff=Mazemania.aiff


EXAMPLES(info):

   ;(get infos on current track)
   sc68 <tune> --info

   ;(get infos on requested track)
   sc68 <tune> --track=5 --info

   ;(dump infos of all the tracks)
   sc68 <tune> --track=0 --info

---

SORRYCAT68 USAGE:

   ;(quick explanation)
   sorrycat68 dirfulloftunes/ �replayer� copier whereto/

   ;(dont use system 'copy' try 'cp' or 'mv')
   sorrycat68 hd1:_sc68_music/ �musmon2� mv hd1:_sc68_music_sorted/musmon2/ >ram:sc68doit
   execute ram:sc68doit

---
   
AVAILABLE REPLAYERS:

ssd1(!!!)              none                    huelsbeck            
spacegun               nobuddiesland           hpn-jam              
spacecrusade           ninjatfmx               hippel-coso_note.deli
soundfx(!)             ninjaremix              harlequin            
sndh_ice(!!!)          musmon2(!!!)            gemx(!!!)                 
sidsound               musmon1(!!)             fred(!)                 
sidmon2(!)             mon_old.deli            fireice              
sidmon1(!)             mon(!!)                 fc13_14(!)              
shadowdancer           mmmesid                 elf                  
rollingronny           mmme                    dyter07              
robhubbard.deli        midi                    dwaga(!!)                
realms                 metrocross              dmu(!!)                  
quartet_mindbomb       megatizer               digitfmx             
quartet                mcoder(!!!)             deltamusic2(!!)          
puma2                  lx_mmme                 deltamusic1(!)         
puma                   lcd                     crapman2             
psgtrackerv2(!!)       lastninjaiii            crapman1             
psg1                   lastninja3              cosotfmx(!!!)             
page                   jamcrackerpro(!!)       chipmon2(!!)             
note2                  ivanhoe                 cabal                
note                   huntforredoct           bs22                 

blipp079(!)            tao_ms27       
blipblop(!!)           tao_ms25       
big                    tao_ms211      
bendaglish.deli        tao_hubbard    
armalyte(!!!)          tao_digi       
alteredbeast(!!!)      synthiv(!)        
aenigmatica(!!!)       stos           
zonewarrior            built-in[amiga](!)               
xbiossound             built-in[atari](!!!)               
vikingchild                           
utopia                                
tsd1                                  
toki(!)                                  
timerc                                
tfmx_st(!!!)                               
tfmx_old                              
tfmx_aga                              
tfmx(!!!)                                  
test                                  
tcbtracker(!!!)                            
tao_tsd                               

 cpu load
 ----------
 !    - low
 !!   - high
 !!!  - very high

---
megacz@usa.com