.---------------------------------------------------------------------------. | Documentation: "The best way to use ADR ripper's capacities !" | '---------------------------------------------------------------------------' --== Version 1'05 ==-- required hardware: colour monitor + 512 Kb minimum advisable memory for { ST: 1 Meg { Falcon: 4 Megs At the begining, the ADRENALINE ripper was made to search just for music formats. Later, Picture options and unpacking options were included. Here is the latest version: Option load files ( key 1 on numeric keypad ): ================= - The old file selector has been replaced by the GEM file selector to offer you the best interface. - It allows you to use Ram-disk (as M-Disk 6) and make use of extended file selectors (such as UIS 3'3). Search all music formats ( keys 2 & 3): ======================== - These options are useful if you don't know which specific format to search for. It prevents you from searching each individual format. - The 2 key : this key searches for all soundchip music formats. Each music format it finds is printed on screen. - The 3 key : almost the same, except there are half-track music formats and soundtrack music formats which are searched. These formats offer you a the best sound quality. - If a music has been found, and if you would like to search again,choose the option "Search another music". - For all musics, all music channels are represented like a graph. People who who don't like duochrome will go away. - some formats like Veggy, Maestro & Ens are recognize by the Mad Max format. Search samples ( key 4 ): ============== - Unlike the others formats,you must search the sample yourselves by the help of the cursor keys, because this format is very difficult to find. - firstly, you should know if you search a signed sample or not . To help you an Amiga module contains signed samples, the ST Replay format uses unsigned samples. - To change the format, press the key <*>. - The Left & Right Cursor key allow you to select the sample length to play. If the length is null, the play option won't run. - the key and the cursor keys allow you to make a precise adjustment. - The frequency can be modified with the keys <+> & <->. - To stop a sample actually playing, press or . - Press to take the length of a loaded file. - Recently, it is possible to draw a sample. It can be useful when you're searching one sample or more. Search picture formats ( key 5 ): ====================== - Once more, you must search the formats yourselves. Degas Elite format and Neochrome format are recognized. - Press to show the picture. Once this key is pressed, you can use the following functions: - The Up and Down Cursor keys allow you to move the screen by one line. By pressing the simulataneously ,the scroll will be much faster. - The Right and Left cursor keys allow you to move the screen by one plane. Use this function to have a clean picture. - To modify the picture length, use <-> & <+> . This function will be useful when ripping sprites. - Use to take the palette of a Degas Elite picture,and to take a Neochrome palette. the key generates a random palette. - Recently, it is possible to use brackets <(> & <)> to scroll picture by picture. - A new function allows you to show pictures using all lengths in all resolutions. You only need to use the keys & <*> which correspond to the jump function. - The function keys to allow you to use 1 plane up to 5 planes. Planes correspond to the number of colours (e.g. The more planes the more colours). These keys must be pressed when you show the picture. - Press to go back to the picture option menu. here, you can do this: - It is possible to use the low & medium resolution by pressing the keys or in the menu. The picture parameters will be automaticaly changed. Also, the keys & allow you to use the 256 colors mode of the Falcon 030, respectively the 40 & 80 columns mode. - The key <*> allow you to use, either the normal mode, or the interlaced mode (only with a Falcon). The vertical resolution will adapt to your monitor capacities. - If you press <1>, ADR Ripper hunts for a packed Degas Elite picture (PC1). - To save a picture, press the key <2>. Attention, the ripper will save the picture with actual parameters (planes,size,colors). Search disk headers ( key 6 ): =================== - Disk editors, this fonction is for you ! Generaly, demos use a header to verify they load the good sectors. But, demos don't always use the packer header. This function allows you to find these headers, known or not,and to print on screen how many headers there is ( only 20 differents headers can be printed) - the information is printed like this: first, the header in hexadecimal, and in ASCII mode. Finally, there is the number of times the header was found. - To modify the track number to read, use the left & right cursor. The sector per track number to read can be modified with the up & down cursor . Select the face with the key . - Press the key <1> to start the search. All errors during the loading will stop the search. - The key allows you to take the disk parameters, only if parameters are coherents. - To increase the power of this option,the keys <+> & <-> allow you to change the offset which start from 0 to 508. Search packed datas ( key 7 ): =================== - All packed datas aren't at the start of a file. It's the reason why this option has been included. - The most used packers are recognized. If you find packed datas, you could unpacked them,save the file in packed format,or search others packed datas. If you choose to unpack datas, it will be possible to save unpacked datas with the preference option. Memory editor ( key 8 ): ============= - Modify a file,show or modify the memory are the usages of this editor. Access to all the memory is the power of this editor. - The editor is separated into 3 columns: the address,the hexadecimal values and the ASCII values. In hexadecimal values, a <**> means the value can't be read. Also, the editor shows values in real time, don't be surprised to see a value always changing. - The key allows you to enter the address. Attention, the address must be an hexadecimal value. - The cursor and the keys <+> & <-> allow you to change the address without entering a new one. You can move the address by 1, 16 & 256 octets. - The editor, available by the key allows you to modify every value,ascii or hexadecimal. Use to change columns. You can move in the columns by the help of the cursor on the entire screen. - Search octets is possible by pressing the key . You could choose between the hexa or ascii search. We can't search more than 4 octets at the same time. If you want to continue the search, press the key . Options or preferences ( key 9 ): ====================== - This option is very useful for ST owner with important memory capacities. - When you've got 1 Meg or more, and you want to load a file lesser than 300 ko, you'd better to reduce the memory space in which you make research. We can define a research zone with a precision of one octet. - An other option allow you to change the frequency by pressing the key . TT owner, attention ! - Some data files intentionally use bad packer headers. Then, you must switch off the automatical unpacking by pressing the key . - It is possible to switch off the automatical cleaning memory by pressing the key . - It is possible to save unpacked file by pressing the key . All unpacked files will be saved with modifications made in the memory editor. - The key allow you to kill a file. It's useful when your disk is full. Search a specific music format ( key F1 ): ============================== - On previous versions, the choice of a format was made with the function keys. Now, there are too many music formats, so I've changed the selection process: - The selected music is printed in inversed mode. To choose a format, use the cursor keys. - To start the search, press . To quit this menu,press . Load track option ( key F2 ): ================= - Before loading everything in memory, check or change the following parameters: - The start track number can be modified with the keys & . For the end track number, use the keys & . - The sector per track number can be modified with the help of the keys <+> & <->. If you choose a wrong number, the loading won't run. - The face number can be modified with the help of the key . Check the face you want to load exists. - If you've not got enough memory to load tracks,decrease the track number by changing the end track number. Info & Greets Option ( key HELP ): ==================== - In this option there is a list of packers recognized by the ripper. - We can find some greets. Maybe you will be in this list, else you're already belong to this list. - If you want to contact me, my address is in this option. You can quit the ripper by pressing the key . Advises: ------- The ripper can play every music relocated with GSR 3'1 if the following format is respected: - BRA ** relocation \ - BRA ** initialisation | will not change - BRA ** vbl rout / - BRA ++ restore music \ - BRA ++ initialise drums | user routs order - BRA ++ restore drums / As you can see, the rout user 1 must be used to restore the music. The rout user 2 must be used to initialise digi-drums, the rout user 3 to restore digi- drums. Sometimes, it isn't necessary to initialise these routs. Warning: ------- For your information, this ripper changes many vectors ! You should have no resident programs changing vectors. Hackers, rip musics and graphs can be justified, but rip code isn't moral. Have respect towards others programs. You'd better not use this ripper with programs like Multi-Tos because the ripper doesn't support this kind of compatibility. For every doubtful use of this ripper on every soft, the user is the only one responsible. Feedback: -------- This program, and other files are always public domain. but, contrary to the other versions, it is no more a shareware, it's now a postcardware. I don't ask you money, but simply a postal card on which you'll give me your opinion about this ripper. What is it, compared to others ? I don't think i released a new version if nobody ask me to make a new version. It's the feedback. Then,if you like this ripper, tell me it, it's only can be good for you and me. I would like to thank some ADRENALINE members for their help ( they know who they are). Also, thanks to Grazey/PHF for making this doc more readable. Dr Computer of ADRENALINE.