Atari 8-bit Disk Image Utility Ver 1.13 Copyright 1998 Ken Siders. This program is freeware and may be freely distributed but not sold. Last update: December 5, 1998 Web page: http://home.columbus.rr.com/ksiders/atari.htm Mailto: atari@columbus.rr.com What is it AtrUtil is the ultimate utility for Windows 95 to handle ATR, XFD, and DCM images. It can show the contents, extract files, delete files, insert files, and view files from Mydos/AtariDos disks. It can also create new blank disk images and even format them. Also, you may view an image's or file'sproperties. Note: This program is a Windows 95 Visual C/C++ learning project so there may always be a few bugs lying around but I try to exterminate as many as possible before each release. Suggestions are always welcome. History Version 1.13 12/04/98 (1) Bug Fix. Extracting or Viewing files that are a multiple of 512 bytes did not work correctly. Should now be fixed. If any problems are found, let me know. Version 1.12 11/18/98 (not released) (1) Bug fix. Files inserted into an image should now have the correct file size. To correct any existing ones inserted with AtrUtil, extract the file to a temporary directory and reinsert it. Version 1.11 11/08/98 (late) (1) Locking and Unlocking Mydos and Atari Dos files has been added. (2) Locked status is now indicated in the file list (with a *) (3) Changed "About" screen. Version 1.10 11/08/98 (early) (1) Fixed bug handling files with no extension (again). (2) Added experimental "Shrink" function which will shrink the size of a Mydos disk down. All unused sectors at the end of the disk will be removed. It does not remove unused VTOC sectors or blank sectors in the middle of a disk left when files are deleted and new files haven't overwritten them yet. Eventually, handling of Non-DOS boot disks will be added which will remove empty sectors at the end of the disk which should work for most disks. The minimum size if 369 sectors which is the last directory sector. Version 1.09 10/27/98 (1) Added Sort option. It will sort files in alphabetical order within the image. Currently it only works with Mydos images (Larger Mydos images that aren't compatable with AtariDos). There currently is no provision to eliminate system files such as DOS.SYS, DUP.SYS, etc. Version 1.08 10/09/98 (1) Bug fix. With the introduction of SpartaDos support in 1.05 a bug was introduced that would cause Atari Dos and Mydos images to sometimes display no files or not all of the files. It has been fixed. Version 1.07 7/27/98 (1) Saving standard ATR images with 128 byte sectors works again. Evidently no one has been using the program since I reversed the definition of standard and non-standard ATR. This effected the saving of KBOOT disks since they are always have 128 byte sectors. (2) Non-Dos and Non-KBoot disks now indicate they have an Unknown Disk Format and don't display garbage in directory. (3) File list is wider to accomodate future additions. Hopefully in next version there will be a real Windows 95 style directory selector and enchanced file list. I also hope to work on subdirectory support. Version 1.06 Internal - no release. Version 1.05 7/27/98 (1) Limited SpartaDos support. Can identify SpartaDos disks and display directories. No other functions are supported yet. (2) Subdirectories should now be indicated with a + in the directory entry. You can NOT tranverse subdirectories yet. Version 1.03 6/11/98 Another Minor update (1) Extrct Txt button is now enabled. It works like Extract but will perform the same text conversions as view. Or simply ut will do ATASCII to ASCII conversions, Atari Basic (and Turbo Basic XL) to text, and binary to hexdump. If anything else got broken in the process, let me know. Version 1.02 6/03/98 Minor update (1) Added more buttons and resized screen and rearranged buttons to accomodate. (2) When inserting files you may now insert as binary (inserts file as is) or insert as text which converts carriage returns and tab characters. It should (hopefully) recognize CR-LF, CR only, or LF only text files and adjust appropriately. If you try to insert a binary file in text mode you will end up with a really messed-up file. (3) Unlock/Lock, View As, Extrct Txt buttons as well as the Help button are currently non-functional Version 1.01 6/01/98 (1) Large files (too big for notepad) can now be viewed in Wordpad. (2) Busy cursor is displayed for Create new image Version 1.00 6/01/98 (1) Format disk option now active. The Create button will change to a Format button when an image is open, and back to a Create button when an image is closed. (2) File name/location now is properly updated at top of screen and on properties screen when saving to a different file. (3) Changed icon. Added Icons for ATR, XFD, and DCM that can be used for files. You must still register file types manually if desired. (4) Busy cursor is displayed for Open, Close, and Format Image operations. I still need to add it for Create Image (I forgot) and possible some of the file operations. Version 0.95 5/21/98 (1) Rename button is now functional (2) Ability to create minimumally sized bootable atr from and Atari 8-bit executable. (called KBOOT image) (3) Original file can be extracted back from or viewed from (2) (4) Format Atari Dos Image button disabled (On Create Image screen.) It would only be needed for DOS 2.5 Enhanced Density images since Mydos disks are more or less compatable with Atari Dos 2.0. (5) Images created by (2) are recognized on the directory box and Image Properties box. (6) Disabled a couple buttons on the main screen when image is closed that weren't being disabled when they were supposed to be Version 0.91 5/14/98 (1) Files can be saved in a few more formats (but NOT dcm yet) (2) Added Save As button. Save and Save As currently both function as Save As. (3) Added Rename button but it is non functional so far. (4) Probably a few minor details or bug fixes I have forgotten. Version 0.90 05/07/98 (1) Misc bug fixes. Due to various problems with low level routines I had to rewrite a bit of existing code. Hopefully no new bugs will be instroduced. (2) You may now select multiple files to insert. They may or may not have been occasional problems with file insertion in the last version but hopefully there are none now. (3) When creating an image you can format it. You should really only choose MyDos format (although Atari is Ok for SD 720K but it is the same as MyDos anyways). Creating a Dos 2.5 Enhanced Density disk will not work properly. (4) You can no longer insert a file into a Dos 2.5 Enhanced Density image. I had to rewrite a lot of stuff and didn't get this implemented yet. The only thing you can safely do with Dos 2.5 Enhanced Density images is extract file. You can select properties and if there are 1040 total sectors and Dos type is Atari Dos it is an Enhanced Density Dos 2.5 disk. (5) Added file properties. Not 100% complete yet but you can see the file size in bytes. (6) Files with more than 255 sectors display sector count properly now. Version 0.81 04/22/98 Bug fixes: (1) Number of VTOC sectors on disk should now be correct. I spent a while looking at the Mydos source and formatting images with XL-IT and I think I finally figured it out. (2) VTOC handling should now work properly for double density images. Inserting files in a double density image should work. (3) Inserting files into images over 720 sectors should now never produce a locked file. Please note that currently AtrUtil ignores the locked file status and always produces non-locked files. Started adding file properties but nothing works correctly yet. Version 0.8 04/16/98 Fixed bugs in sector calculations for larger than normal images. VTOC was begin read wrong and number of sectors for it was being determined wrong. (anyone know what byte 0 of sector 360 on Mydos disks is?? My orignal assumption was wrong) You may now insert files into images. This is new and there still may be some bugs and I would appreciate any feedback on how it works. Note: Atari and MyDos limits you to 64 files. Attempting to insert a 65th will give an error even if there is lots of space left. Inserting files into Dos 2.5 Enhanced Density images is not supported yet. Version 0.7 04/09/98 Big Mydos disk images are now properly recognized as Mydos. Potential problem of extracting/viewing files with no extension fixed. Dos 2.5 Enhanced Density Support. You may now extract and view files that are in the extended sectors. You may now delete files from an image. This should even work for Atari Dos 2.5 enhanced density images as well as Mydos. This is has been tested some but not thoroughly. Let me know of any problems please. On Image Properties, some more info displays. This is mostly for debugging purposes. Hopefully all of the VTOC routines work ok so adding files to images should be added really soon. I had hoped to have had it added this time but I spent a lot of time Hex viewing mega Mydos images and Dos 2.5 Enhanced Density images to figure them out. If any of the addition information on Image Properties seems out of whack let me know. The free sectors here is from counting bits in the VTOC and is independant of the DOS count although they should always agree unless something is wrong with the disk. Version 0.6 3/30/98 Image Properties will now tell you the original image type. The following only involves double density (256 byte sectors): Corrected code to recognize the original SIO2PC double density images (also used by XLIT and other emultors). APE/XFormer ATR double density images can also be read correctly but currently only standard ATR images can be saved. Since SIO2PC was the first program to create the ATR format (I believe - correct me if I am wrong), I will consider it the official format. The ability to save the other ATR type will be added later. XFormer established the XFD format and I am have problems with Imagic (from the creater of APE) to handle them. The main discrepency is the number of bytes for the first three sectors. Sio2Pc/XLit seems to store 256 bytes for each of the first three sectors where APE and Xformer only store 128. XFormer seems to store 256 bytes for the first three sectors of an XFD image, but Imagic can't handle them. Any comments???? I will probably add capability to read nonstandard XFD's in the next release as well as write non-standard ATRs and XFDs in the next release. Version 0.5 3/26/98 Program is now smarter at recognizing Mydos and Atari Dos disks. Mydos Enhanced density disks now can have their files viewed and extracted. Priliminary DCM reading support. It may not work on all images yet, especially double density (256 bytes/sector) images. Added minimize button to main screen. Added 16x16 icon and fixed transparency problems with the existing 32x32 icon. Version 0.4 A new version in only one day!. Added Turbo Basic XL tokens to BASIC viewing - don't know if more needs to be done or not. Added ability to read XFD files. Currently 3 size are supported SSSD, SSED, SSDD. I don't know if there are more legal sizes or not. You cannot save XFD's yet. DCM support still needs to be added. Save option is now enabled whenever an image is loaded. You can now load an XFD images and save it as an ATR image. Save always presents a file selection dialog box now. Version 0.3 Extracting work for real this time - I promise. The last version was loosing some bytes here an there. You may view files (via notepad or wordpad). Files with a BAS extension are even detokenized and displayed as text (this is new - let me know of any problems). Other extensions like COM, EXE, BIN, OBJ, etc. display as a hex dump. Other files display as text. Note: Currently reverse video displays as normal and special characters display as periods. Anyone got an ATASCII font??? The program now remembers the last "Open" directory and "Extract to" directory and will default to them. Version 0.2 Please note I have only spent a few hours with this update even though a month has went by. I hope to add updates more frequently now. When you open a file a temporary copy is made. This will be important later when you can add files to an image so the changes won't be permanent until they are saved. For this reason, opening really large images may take a few seconds now. You can now Save Images. The Save button is only active if there are changes made to the image. Currently "Create" and "Insert" are the only options that will make a change. "Insert" is not implemented yet so it doesn't actually make a real change though. Note "Save As" will be added later on. You may now create new images! The "Create" button will only be active if you do not currently have an image open. You can pick one of three size or create your own. In the future it will be added to automatically allow formatting of an image in MyDos format so you can immediately add files to the image. Note: for really large images creating an image may take a few seconds. If you associate ATR file extension with the program, double clicking an ATR file will now launch it in AtrUtil. An instant way to see the contents of an ATR file. You can even launch multiple instances at once - Yipee. Version 0.1 Initial version just supporting Viewing the directory and extracting files. To Do This is a list of features I plan on adding to am thing about adding. Suggestions and information are always welcome. These are in no particular order. . Fix any problems with reading DCM images. (if you have any let me know) . Add support for saving DCM images. . Ability to View other file types: Mac/65, Picture files, fonts... . More SpartaDos format handling. Let me know of existing problems. . Image Properties button will allow changing some attributes, especially locked status. . Other ideas such as Defrag an image, expand to standard, etc. . Subdirectory support. (what the 3 blank buttons might be used for) . Read an Atari 8-bit Double Density Disk directly in drive a: or b:. . Update DOS based utilities to use new image handling code. . Real Win95 style directory selector. . Other ideas? Highest priority: Subdirectory support, Locking/Unlocking files, More SpartaDos Support, Shrink to Fit. Information The Atari 8-bit Disk Image Utility (ATRUTIL for short currently) allows one currently to view information, view the DOS directory, or extract files from an ATR/XFD/ and DCM image. It also allows one to create ATR disk images of any standard or non-standard size. Hopefully DCM and XFD write support as well as many more functions will be added to make it the all in one Atari disk image utility. This program runs in Windows 95 and should run under Windows NT. This is intended primarily as a test version to get any feedback or requests for features. Send any feedback to ken_siders@compuserve.com or cp576@cleveland.freenet.edu. Installation There is no fancy installation utility with this program yet; come to think of it there isn't any intallation program yet. Just copy ATRUTIL.EXE where you want it and create a short cut to it. You also can run it from a dos command window within windows. The program also requires MFC40.DLL and MSVCRT40.DLL. You may also download these files from my page if they are not already on your PC. Gee, don't you wish there was an install program. Check your \WINDOWS\SYSTEM directory file for these file, if they are not there, download the zip and extract them there. To uninstall, guess how -- Just delete any files you added. You may now associate an ATR/DCM/XFD extension with the program so double clicking an ATR file will launch it in ATrUtil you can also associate an Open action with it. This must currently be done manually however. Note: Launching more than one file at a time will start up multiple copies of AtrUtil. The only problem may be viewing more than one file at a time since currently an unique filename is not generated for this function yet. Usage Atr*Util's primary interface is a simple dialog box that will give you an image's file list on the left and an arsenal of buttons on the right. The following are the image operations currently supporteed: Open - Opens an ATR or XFD image to view or extract files from. Preliminary DCM support has now also been added. Only Atari Dos, MyDos or compatable file systems are displayed. Boot disks or other DOS disks may display an error, garbage, or nothing. If an image is opened successfully, the list box will be populated with a list of files on the disk for which you can select. Multiple files can be selected or unselected at will. Save As - Puts up a dialog box and lets you save the image in the desired format. Choices are Std Atr, Non Std Atr, Std Xfd, Non Std XFD, or DCM. Note:DCM is NOT supported yey for saving. You will not get the DCM or XFD types if the disk is not one of the three standard image sizes. 720 sectors/128 bytes per sec, 1040 sectors/1280 bytes per sec, or 720 sectors/256 bytes per sec. You will not get the Non Std ATR or Non Std XFD options if there are 128 bytes per sector since the only incompatabily is with 256 bytes per sector disks. Save - Currently same as Save As. Eventually it will save the current image back to the same file and format it was loaded from. Close - Closes the current image -- returns the program to its startup state. Properties - Displays filename, number of sectors, sector size, data size of the currently open image. Format - (This option is only available if you have an image currently open). This option will allow you to format an existing image. Two choices are available for formatting: None, which zeros out the entire image, or MyDos which zeros out the image and sets up a MyDos file system. You can not change the attributes such as sector count or sector size. If there are 720 or less sectors the image should be Atari Dos Compatable. Formatting Atari Dos 2.5 Enhanced Density disks is not supported. There must be at least 369 sectors in the image to format it for Mydos. Create - (This option is only available if there is not an image currently open) Create a new blank image with parameters specified. You must not currently have any image open in order to create a new image. Upon clicking Create, a dialog box will appear. You may select one of three "standard" size images, or click custom and pick your own. If you choose to create a custom image select the number of bytes per sector: 128 or 256 bytes, then select the number of sectors. This should be between 3 and 65534 (yes, I know 65535 should be the max but I have to fix something first). The values entered are not verified yet, entering other values may do bad things. Note: The image size to the right keeps you updated with the number of bytes of data the image can hold (if it were a real disk). You must select Save from the main screen to actually save the file. You will be prompted with a file dialog box for a name. You may mark the MyDos box to auto- matically format the image so you may put files on it. To make it Atari Dos compatable choose 128 byte sectors, 720 sectors on disk and MyDos. The image will then be compatable with Atari Dos 2.0 or compatable Dos's. Formatting Dos 2.5 Enhanced Density is not supported. There is also a box you can select now (KBoot). This will create the smallest possible booting ATR for any atari executable you choose. The file created must not need Dos, so it is most suitable for game files. The file created is the same as created by my MakeAtr Utility. When the image is booted a 'K' appears on the screen as it loads. If the screen turns red and error occured. If this occurs be sure that the original file actually works when loaded from DOS before complaining. The original file can be restored by extracting it back out of the image. Sort - Will sort a Mydos image alphabetically from file. Will be expaned to include Atari Dos soon. System files will eventually be able to be excluded in the sort. The following are the file operations currently available: Extrct Bin/Extrct Txt - Will extract currently selected files to a directory of your choosing. Extrct Bin will extract the file as is, Extrct Txt will convert Atascii to CR-LF dos format. It will also convert binary to a hex dump and Atari Basic (or Turbo Basic XL) to text. After pressing the appropriate extract button, a directory selection box will appear. You may type in or select the directory of you choosing. Press the Extract button on the screen will extract all selected file to that directory. The directory defaults to the directory you last extracted to. Atari Dos 2.0/2.5, MyDos, and KBOOT (bootable images created by this program or MakeAtr) are supported. Select All - Selects all files in the list. Currently the list may appear to scroll as files are selected. This will be fixed in the next version. It doesn't cause any problems, but it doesn't look good. Sel None - Unselects all files in the list. View - This option will only be available if only one file is selected. This option will display a file in notepad (or if it is too large you will be prompted to open in wordpad). Files ending in ".BAS" will be detokenized and displayed as text. File with extensions such as "EXE", "COM", "BIN", etc. will display as a hex dump currently. Other files will display as text. I hope to add more file types and configuration later. Note: Inverse video is converted to normal and control characters display as periods currently. Hopefully other types can be added such as PIC converting to BMP, MAC/65 detokenization, etc. Anyone got any code or an ATASCII font?? Atari Dos 2.0/2.5, MyDos, and KBOOT (bootable images created by this program or MakeAtr) are supported. Delete - Delete selected files from an image. There is no further prompting. If you mess up just reopen the image to wipe out your changes. Insert Bin/Insert Txt - Allows you to select files to add to the disk image. Insert Bin will insert the file as is with no changes. Insert Txt will convert CR's, LF's, and Tabs to ATASCII format (should more characters be converted?). The program should automatically adjust beween CR-LF, CR, or LF terminated files although it has not been tested. You currently cannot insert files into Dos 2.5 Enhanced Density images. If some files don't fit it will continue trying to fit any remaining files that will. This should make it easy to fill all the space on a disk. You will receive a warning if some didn't fit or you exceeded the 64 file limit. I will hopefully make it more informative in the future. Notes: Long file names are not gracefully handled and files are not inserted in the order in which they are selected when multiple files are selected. Properties - Give file name, size in sectors, size in bytes and in the future hopefully the file type. Rename - Allow you to rename files in an image. Only one file can be selected for this option to be selectable. Lck/Unlk - Will lock or unlock atari files. Not implemented. Last but not least About - Displays current version, copyright info, and the date the program was last updated. Help - Not implemented. Exit - Exit the program, duh! You will be warned if changes haven't been saved. (I might have forgot to do that for Create) Features (bugs?) You more than likely will not be able to save an image if the original file is write protected. Need to polish this a little more. Note: Image Properties will also show the image write protected if the APE bit to indicate write protect is set. Atr*Util should let you modify the image is this case in the future. If an error occurs when opening an image sometimes buttons are improperly enabled. Probably some more things I have forgotten about.