README for Image2File 1.2a --------------------------(13-Jul-99) WHAT'S NEW? * Program now handles END tokens properly (bug fix) WHAT IS IT? Image2File is a simple program for extracting files from Apple II 140k disk images. It: * is command line based. Call me lazy or call me true to the spirit of the Apple II, your choice. Also, the screen does not update, call me lazy on that one. * reads images stored in DOS 3.3 or ProDOS order. * reads DOS 3.3, ProDOS or Apple Pascal images. The 'cat' command returns the appropriate directory listing. * automatically determines the image type and order. The order is assumed from the filename extension. .DSK is DOS order, .PO is ProDOS order (naturally, caps don't matter) The image type is determined from the first few bytes of the image. Default is DOS 3.3 for both order and type. * copies Applesoft files as text files replacing the tokens with the actual keywords. Naturally, text files are also copied as text files. * supports a single wildcard '*' when copying. I.e. copy `*.txt` - copy all files ending in .txt copy `*` - copy all files copy `tx.*` - copy all files starting with 'tx.' NOTE the ` (backquote) as the delimiter. You can drop the ending ` if you wish. * copies binary files using the actual length. All other file types are copied verbatim from the image to the end of the sector or block (i.e. you get extra bytes, probably) HOW TO USE IT Run it and type your commands. Case does not matter, but leading blanks count so don't use any! Unknown commands simply return the command prompt. Type ? to see a list. Basically, all you can do is get a catalog of the image and copy files from it. Command (case insensitive) Action ---------------------------------------------------------------- help, ? print a screen like this one cat, dir, ls catalog the image load load the image copy `filename` copy the file to the Mac stats stuff about the current image file set `type`order set the image type and order manually ** bye, quit, exit obvious ** use DOS PRODOS or PASCAL for the type, DOS or PRODOS for the order (case insensitive) MODIFYING THE PROGRAM This was written in Yerk 3.6.7. Yerk is a freeware object-oriented Forth (similar to Mops) It is not to be taken as an example of sterling code! If you do modify the program, see LEGAL STUFF below. The key to the entire program is the word >ADDR which takes a block or a track/sector pair and returns the address of the beginning of that block or track/sector. Note that in some cases, like a ProDOS image stored in DOS order, the address returned is not an absolute address into the image but is the address of a 512 byte buffer. So, with >ADDR assume only that what you have is the address of that 512 byte block and nothing else. I.e. don't assume you can move from block 2 to block 3 with 2 >addr 512 + instead use 3 >addr to get an address for block 3. LEGAL STUFF No warranty is implied or stated. Caveat emptor. This software, such as it is, is copyright 1996, Ronald T. Kneusel and may be distributed freely provided this notice and all original documentation is included. I must be informed of any modified versions. If you want to include this on a CD-ROM you must contact me (see below). CONTACT To report bugs or to give praise (or even to complain) send me some email: rkneusel@post.its.mcw.edu The latest version of this program will be found here: http://net-24-42.dhcp.mcw.edu/image2file.html - Ron Kneusel July 1999 AM+DG