home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / WRIP_20.LHA / WRip / WRip.doc next >
Encoding:
Text File  |  1995-09-14  |  4.8 KB  |  151 lines
  1.  
  2.     WRip 2.0 (14.09.95)
  3.     ===================
  4.  
  5. Introducing
  6.   WRip is a CLI util which scans input data for known formats and save them.
  7.   The input can be a NDOS-Disk via trackdisk.device or a normal file via
  8.   dos.library.
  9.   
  10.   
  11. Requirements
  12.   MC68020 or better
  13.   Kickstart 2.05 (V37) or better
  14.  
  15. Disclaimer
  16.   No warranties of any kind are made as to the functionality of this
  17.   program. You are using it ENTIRE at your own risk.
  18.  
  19.  
  20. Installation
  21.   just copy WRip anywhere you like (e.g. C:)
  22.  
  23.  
  24. Using
  25.   - to scan the file "RAM:test" type "WRip RAM:test"
  26.   - to scan disk in DF1: type "WRip UNIT=1"
  27.   - its recommend to integrate WRip in your DirUtil (e.g. DOpus)
  28.     I use the following buttons : "WRip DF0:" "WRip DF1:" "WRip file" ...
  29.   - While WRip is searching, you can break it with CTRL-C.
  30.   - WRip is PURE and can be hold resident.
  31.  
  32.  
  33.  
  34. WRip knows the follwing formats :
  35.   - Executable files ($000003F3)
  36.   - IFF files (FORM)
  37.   - various pack formats (ATM5, ATN!, BOND, CHFI, CrM2, CrM!, FIRE, ICE!,
  38.     Ice!, IMP!, RNC1, RNC2, S300, S401, S403, S404, SSUR, TTW!, XPKF, Z&G!)
  39.   - rips also PP20 (special tracemode is used) !!!
  40. WRip gives you a message if one of the following crunch-id's were found :
  41.   - GC!, LZWH, SFHD, SFCD, TPWM, TSM!, PX20, PACK, FVL,
  42.     PIco, S310, S400, "T.S "
  43.     (I don't know exact the format therefore WRip can't rip them)
  44.  
  45.  
  46. The CLI-Convention
  47.   - Template :
  48.     WRip LF=LOADFILE,SD=SAVEDISK/S,SB=SAVEBOOTEXE/S,NE=NOEXE/S,
  49.          MU=MAXUNPACKED/K/N,MR=MAXRATIO/K/N,UNIT/K/N,TASKPRI/K/N
  50.  
  51.     LF=LOADFILE    the name of the file that will loaded and scanned
  52.             if no file specified WRip will try to use the disk in
  53.             DF0:
  54.  
  55.     SD=SAVEDISK/S    if WRip has read a disk, the whole disk will saved as
  56.             "BIN__FullDisk" after scan
  57.  
  58.     SB=SAVEBOOTEXE/S if WRip has read a disk the Bootblock will saved as
  59.             a standard amiga executable namely "EXE__BootBlock"
  60.             
  61.     NE=NOEXE/S    if specified WRip will not scan for Executables
  62.             makes sense if you scan an Executable and need no
  63.             duplication of them (hoho!)
  64.  
  65.     MU=MAXUNPACKED/K/N with this option you can set the internal variable
  66.             with same name (e.g. ... MU=150000 ...)
  67.             for any packed file found, WRip will compare the unpacked
  68.             size of the file against MAXUNPACKED, if MAXUNPACKED is
  69.             lower the file won't saved
  70.             it makes no sense to save a file that is unpacked
  71.             50 MB or so...
  72.             lower values speeds up the PP20-trace !
  73.             default: MAXUNPACKED=2000000
  74.  
  75.     MR=MAXRATIO/K/N    set internal variable MAXRATIO
  76.             this var is only used in PP20-trace at the moment
  77.             the var describes how large the unpacked file can be
  78.             dependent on the size packed, or with other words :
  79.             "packedsize * MAXRATIO > unpackedsize" must be true
  80.             otherwise the file won't save
  81.             higher values than default will dramatically slow down
  82.             the trace-mode (see chapter PP20-trace)
  83.             default: MAXRATIO=4 (useful values 2...10)
  84.             
  85.     UNIT/K/N    let you specify from where WRip should read the
  86.             disk via trackdisk.device (e.g. UNIT=17 for DF17:)
  87.             default: UNIT=0
  88.  
  89.     TASKPRI/K/N    with this option you can set the taskpriority of the
  90.             scanroutine, this is useful if you have a PP20-trace
  91.             which will take a long time, and want to do some
  92.             other things with your machine
  93.             default: TASKPRI=-3 (allowed values -10...10)
  94.  
  95.  
  96. PP20 trace-mode
  97.   - to rip PowerPacker files a special trace mode is used
  98.   - if a "PP20" ID will found WRip swiches to trace mode
  99.     the trace-mode will stopped if :
  100.       a valid PP20-file will recognized and saved
  101.       a next "PP20" ID will found
  102.       the file end is reached
  103.       the user press CTRL-C (press twice to leave the program)
  104.   - important for the speed of the trace mode are the value of MAXUNPACKED
  105.     and MAXRATIO
  106.     e.g. if you want to rip a soundfile you can set MAXRATIO=2 because
  107.     PowerPacker is not able to compress samples better than faktor 2
  108.     (gain « 50%)
  109.     see also CLI-Convention
  110.  
  111.             
  112. Other related Programms
  113.   - for decrunching the XFD-package (aminet:util/pack/xfd107.lha) is
  114.     recommend; note: some formats WRip saves are cloned from others
  115.     (ATN!->IMP! CHFI->IMP! Z&G!->S404 B6B2AFCB->S404) if XFD can't decrunch
  116.     them you have to manually change the ID (hexeditor)
  117.   - a good program for ripping soundmodules is ExoticRipper
  118.     (aminet:mus/misc/ExoticRip229.lha)
  119.  
  120.  
  121. Bugs
  122.   - files saved can be corrupt because only ID and sizes are checked
  123.     (except PP20 & SSUR they are always 100% clean)
  124.     the further process of corrupted files can crash other progs/your machine!
  125.   - not a bug :    never try to scan a FileSystemFormatted-Disk (resulting files
  126.         are waste, what else)
  127.  
  128.     
  129. Future plans
  130.   - supporting RAD:
  131.   - supporting HD-Disks
  132.   - allowing of CTRL-C while diskloading
  133.   - QUICK option
  134.   - new formats
  135. let me know if you need one of these or other options !
  136.  
  137.  
  138. Contact
  139. EMail:    jah@th-zwickau.de
  140. WWW:    http://www.th-zwickau.de/~jah
  141. Mail:    Bert Jahn
  142.     WE 9321
  143.     Otto-Hahn-Straße 14
  144.     Zwickau
  145.     08066
  146.     Germany
  147.  
  148.  
  149. sorry for any language mistakes !
  150.  
  151.