The CDPD Public Domain Collection for CDTV 2

home *** CD-ROM | disk | FTP | other *** search

/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 176-200 / scopedisk191 / multiripper / multi-ripper.doc < prev next >

Wrap

Text File | 1992-10-27 | 17KB | 372 lines

**************************************************************************** * * * MULTI-RIPPER! * * ^^^^^^^^^^^^^^^ * * * * (C)1990 UNIT ONE/FANTASY * * * **************************************************************************** ABOUT: ^^^^^^ > DOCS FOR: MULTI-RIPPER V2.1 > PROGGY MADE BY: JELLY-FISH OF UNIT ONE & ROBIN HOOD OF FANTASY > DOCS WRITTEN BY: VALHERU OF UNIT ONE > THE RIPPER IS FREE-WARE. THIS MEANS THAT THE PROGRAM CANNOT BE PARTED, REWRITTEN OR EDITED WITHOUT THE AUTHORS AKNOWLEDGE. THE PROGRAM MAY BE FREELY DISTRIBUTED, BUT NOT SOLD! OTHERWISE EVERYTHING'S OK. FIRST INFO: ^^^^^^^^^^^ The ripper can rip any module made with: 1 SoundTracker 15 instr. 2 SoundTracker 31 instr. 3 NoiseTracker 4 voices 4 FutureComposer 1.0-1.4 5 SidMon 6 BugMon 7 SoundMon The ripper can recognize and handle 35 crunchers correctly. The ripper can scan non-standard DOS-disks for crunchers/modules. The ripper saves both instruments and modules. The ripper has an option for searching after text or other data. The ripper can view CHIP-mem as a bitplane (useful????) The ripper can also do lots of other things.. FUTURE IMPROVEMENTS: ^^^^^^^^^^^^^^^^^^^^ -Make a keypad more like the one in NOISETRACKER. (Done, but not inserted because of some minor problems.) -Recognize more crunchers. -Recognize TFMX/SoundFX (Sonix??). -Get some bugs debugged. -Making macros. DEBUGGS AND IMPROVEMENTS: ^^^^^^^^^^^^^^^^^^^^^^^^^ SCAN-command fixed. No more GURU's when finding a module! EXIT-command fixed. No more GURU's when ending while playing a song. (Lot's of more should be done with this...) INFO-command has been improved. Now the numbers of patterns are displayed as well as the highest song-pattern. SAVE/LOAD-commands now takes files with spaces in the names. HUNT-routine is improved and rewritten. Commands ADD and SUB are no longer of any use. HUNT-command fails when playing a module. FIXED! MAKEDIR-command inserted. DELETE-command inserted. LIST-command inserted. The text "Ripped with MULTI-RIPPER 2.1" is saved as the comment of each module. More shortcuts may be used. R for READ L for LOAD J for JUMP H for HUNT C for CONT M for MENU P for PLAY S for STOP KNOWN BUGGGS!: ^^^^^^^^^^^^^^ HUNT-command should, when finding a module, not list all the instruments, but rather just the name. This should make it quicker to find modules when memory is thrashed. A shortcut for EXIT (X) should be inserted! ************************************************************************* COMMANDS: ^^^^^^^^^ Infos: Addresses Are always written in HEX ($). Case-Sensetive This means that it sees the difference between 'A' and 'a'. Executable = Run-able, a file you can load from CLI. Decrunch-headers When a program is crunched, a decruncher is put in front of the program (usually). The decrunch- header is just a part of the decruncher which the ripper recognizes. Sector The disk is blocked up in different sectors of information. One sector holds 512 bytes and on one Amiga-disk there are 1760 sectors (=880K). CHIP-mem Is the memory between $00000000 and $00080000. ---------------------------------------------------------------------------- <Text> Means ASCII-codes, text written with the keyboard. <From> Is a start-address in memory. This must be written in HEX ($). <To> Is an end-address in memory. This must be written in HEX ($). <File> The file you are working with. If the filename got space(es) within it, use the sign " before and after the name, or else the program can't be sure what's what when loading/saving/renaming. <SS> Start-Sector. The sector that are to be read first and onwards to <ES> End-Sector. This is the last read sector. The last possible sector is $6e0. <ADD> Address. This is where the data are to be read. <SA> Start Address. The start address (what else?). <EA> End Address. The end address (what else?). <Path> The path on the disk that are being used. <OPT> What kind of option you want on the command. (Look at the place you found it for further information.) <INR> Instrument number. (It is given in front of the instrument's name.) <Rate> Tells at what speed the sample shall be played at. <NR> Any number. (What else, stupid?) <Name> The NAME! A name is a name is a name... ---------------------------------------------------------------------------- Command Parameters Explanation ^^^^^^^ ^^^^^^^^^^ ^^^^^^^^^^^ -FIND <Text> This command scans CHIP-mem and compares <Text> with the data. If found, Addresses will appear. This command is case-sensetive. (ex. FIND Rat) -FILL <From><To> This fills a memory-block (which you specify) with blanks (0's). This is useful when the ripper always stop at a certain point and there are no module lying there. Just some 'bad' data. Just type the start- and end-addresses, and voila!, the point is no more. (ex. FILL 0456AB 06FC00) -R(EAD) <File> This command reads an executable file into memory and searches for decrunch-headers. If this is found, it decrunches the file and stops (hopefully) before it runs the program. You are now able to rip the module(s) in the program. If the decrunch-header is not found, the ripper locates and lists all possible jumps for the unknown decruncher to jump to for starting the program. You are now have to choose which one of the addresses you want disabled (the one you think starts the program). (ex. READ DF1:Demo) -RS <SS><ES><ADD> Reads sectors from disk in DF0: into memory. The pointers tells which sector it shall start reading from, the last sector it are to read, and at what point of memory it should be put. This is useful when the disk is no DOS-disk, but we know there is good music on it, and we want it!! The parameters must all be written in HEX ($). Read further about this in the SCAN-command. (ex. RS 2b3 31c 030000) -RI <File><ADD> Read Image. Read a non-executable file into the address given in <ADD>. All parameters must be in HEX ($). (ex. RI mod.Future 038000) -WI <SA><EA><File> Write Image. Write the memory-block between <SA> and <EA> to disk and names it with the name written in <File>. All parameters must be in HEX ($). (ex. WI 030000 058000 DF2:Piccy) -L(OAD) <File> Works exactly as in CLI. It loads the file and runs it. (ex. LOAD RSI-DEMO) -SAVE <File> Saves the module to disk and names it the name written in <File>. (Could it be easier?!?) (ex. SAVE DF1:mod.aaargh!) -DIR <Path> gives a list (directory) of all the files in the directory <Path>. If no <Path> is given, it lists the files in the current directory. (ex. DIR DF1:MODULES/SIDMON) -CD <Path> Changes Current Directory. (ex. CD DF1:MODULES) -DUMP <SA><EA> Gives the contents written in ASCII-codes and in HEX of the memory-block <SA> to <EA>. The registers must be written in HEX ($). (ex. DUMP 030000 030800) -TYPE <File> Gives the contents of the file (written in ASCII- codes) put on the screen. (ex. TYPE S:Startup-Sequence) -SCAN <SS><OPT> Scans through the disk starting with <SS> and ending with sector $06e0 for either decrunch-headers, sound-modules or both. If this is found, the ripper writes down (on the screen) what sector(s) the header(s)/module(s) was found. You may now use the RS-command. The <SS> must be written in HEX ($). The option-register may either be M for modules or D for decrunch-headers or not written for both. (ex. SCAN 0360) -J(UMP) <ADD> Jumps either to the address the decruncher has put as a start-address, or to the address you have given in the parameter <ADD>. This should start the program. The address must be in HEX ($) (ex. JUMP) -I <INR><Rate> Plays the instrument <INR> at the speed <Rate>. This option is only availible when a ST-/NT-module is found. The <Rate> do not have to be given. Both <INR> and <Rate> must be written in HEX ($) (ex. I 1A 260) -FIX <NR> Puts (renames) all instruments into the volume ST-xx where xx is <NR>. (This does not have to be in HEX ($) does it?) (ex. FIX 78) -SI<INR> Saves the instrument to disk. The <INR> must be written in HEX ($) (ex. SI 1A) -REN <INR><Name> Renames an instrument to the name you choose. ...And the <INR> must be written in HEX ($). (ex. REN 1A BULL:S/BANG!) -MD <Name> Makes a directory named <Name>. (ex. MD DF1:MODULES) -RM <Name> Remove (Delete) file from disk. (ex. RM DF1:MODULES/MOD.AAARGH!) -HUNK Searches through CHIP-mem for decrunch-headers. It is useful when a program is crunched twice, as some smart-asses do. Also useful if the file which is crunched is non-executable file. (ex. HUNK) ( <- it's spelled with a K, yes!) -LED Turns the LED (Low-Pass-Filter) on or off. (ex. LED) -M(ENU) Hey! The menu shows up again! (ex. MENU) -EXIT Xit the ripper. (often results in a GURU MED.) (ex. EXIT) -VIEW View the memory as a picture. Use the mouse up/down/left/right for changing address, left/right mousebutton to increase/decrease modulo-values. Press both mouse-buttons to quit viewer. (ex. VIEW (now I'm playing with the mouse!)) -LMOD Gives a list of all found modules found on the last SCAN, and their sector-addresses. (ex. LMOD) -LDEC Gives a list of all found decrunch-headers found on the last SCAN, and their sector-addresses, plus where in the memory they will decrunch (hopefully!). (ex. LDEC) -H(UNT) This command searches through the memory for any song-module. If this is found, a screen of the known data will appear. (This is the main thing in the ripper, you know.) The ripper only hunts in CHIP-mem. (ex. HUNT) -C(ONT) continues the HUNT (for Red October) 'till the last memory-spot. (ex. CONT) -INFO Gives you a screen (the same you got when finding a module) with a little info about the module. (ex. INFO) -H(ELP) Shows the HELP!-page. This is the spot where you find the authors (Geir's & Erlend's) addrezzez. (ex. HELP) -P(LAY) Plays the found module. (Even when you uses other commands except disk-commands.) (ex. PLAY) -S(TOP) Why, the music stopped! (ex. STOP) -STP Stops the (booooring) sound of the sample. (ex. STP) -LIST Lists all files last loaded. Useful if you've forgotten what you've loaded before. (ex. LIST) **************************************************************************** GENERAL INFO: ^^^^^^^^^^^^^ Any command may be cut off by pressing the left or right mouse-button. THE ADDRESS OF: JELLY-FISH/UNIT ONE ROBIN HOOD/FANTASY VALHERU/UNIT ONE BJORNHEIMVN. 8D GYDASV. 35 FELTSPATVN. 3 N-1086 OSLO 10 N-1413 TARNASEN N-2008 FJERDINGBY N O R W A Y N O R W A Y N O R W A Y TLF: (02) 210928 ERLEND (02) 325566 GEIR (06) 833437 LASSE VALHERU'S NOTE(S): ^^^^^^^^^^^^^^^^^^ This ripper is good!!!! It has (almost) everything that can be asked of a ripper. But it's still buggy, and does not have equalizers! Keep up the good work, 'cause it's the best there is! VHU/UNIT ONE! AUTHORS NOTE(S): ^^^^^^^^^^^^^^^^ We just want to remind you that when you rip a module, GIVE CREDITS TO THE CORRECT COMPOSER !! All composers get really angry if you use their modules without giving them the credits for the song !! We would also appreciate it if you would send us suggestions on hov to improve this ripper. Bug reports are also welcome. Complaints can be sent to NIL: You can contact Jelly-Fish/Unit One at one of the following BBS'es in Norway : The Crusaders BBS The Crusaders Golden Gate Maverick BBS The New Line Rodeløkka (M)BBS We would also like to thank the following people : Wiseguy /Triumph Falch /Triumph El Cubo /Crusaders Raven /Crusaders Dr. Awesome /Crusaders Inventor /The Law Breakers Rattler /Unit One Valheru /Unit One Jason /Fantasy We think that was all.. Jelly-Fish/Unit One and Robin Hood/Fantasy signing off...... Enjoy this product !!