THIS PROGRAM IS FREEWARE

Dir2Atr - Converts a IBM compatible PC Directory into one
or multiple Atari 8-bit .ATR disk images
by Bo Schreurs

There are some nifty programs out there that let you extract
Atari 8-bit files from .ATR disk images on your pc,
i.e. XDIR is a utility which does this for you
So, now you have several seperate Atari 8-bit files, and you
want to store them all back in an .ATR disk image, so
you can access them (with the help of Sio2PC) on your Atari
8-bit computer (i.e. 400, 600XL, 800, 800XL, 1200XL, 65XE, 130XE, etc.)
With XFormer you can turn one file into a disk image.
And ATRIMG11 you can select seperate files from within a pc directory
and put them in a .ATR disk image.

So, with the above utilities you can create your own .ATR images.
However, I thought it was time for another nice utility.
It's called Dir2Atr.
It has been previously released as a command line driven utility.
It has been enhanced and some more time was spend to make it user-friendly.
The nice thing about Dir2Atr, is that is converts a complete pc directory
into one or more .ATR disk images. So you can create a BASIC pc directory,
store all your favourite Atari Basic files in it, and then convert that
directory into mulitple .ATR disk images!
The disk images will all be Medium density.

HOW IT WORKS
------------
1. SELECTING THE DIRECTORY TO BE IMAGED.
   Select a pc directory to be converted into one or more .ATR disk images.
   Pressing the "Esc" key, terminates the program.
   Pressing the F1 key, shows a help screen.
   Pressing the F3 key, let you select between the available drives.
   Pressing the ENTER key let you select a subdirectory if there is one.
   Pressing the F2 key, selects the current directory (see the path displayed
            at the top of the screen) to be converted.
            Continue with step 2.
   Use cursor keys to move around the screen.
   Use "Pg Up", "Pg Dn", "End" and "Home" to scroll up or down faster.
   If a mouse is enabled, you can use the mouse too to select a directory.
            Use the up and down arrow at the top right corner of the box,
            to scroll up or down.

2. SELECTING THE DIRECTORY WHERE THE IMAGES ARE STORED.
   If the F2 was selected on step 1, you'll continue with step 2.
   Select a pc directory where the .ATR disk images will be stored.
   Pressing the "Esc" key, let you return to step 1.
   Pressing the F1 key, shows a help screen.
   Pressing the F3 key, let you select between the available drives.
   Pressing the ENTER key let you select a subdirectory if there is one.
   Pressing the F2 key, selects the current directory (see the path displayed
            at the top of the screen) to be used as the store directory.
            Continue with step 3.
   Use cursor keys to move around the screen.
   Use "Pg Up", "Pg Dn", "End" and "Home" to scroll up or down faster.
   If a mouse is enabled, you can use the mouse too to select a directory.
            Use the up and down arrow at the top right corner of the box,
            to scroll up or down.

3. SELECTING THE DISK IMAGE DENSITY.
   If the F2 was selected on step 2, you'll continue with step 3.
   Select what kind of density the disk image should be.
   Standard the Medium format is assumed.
   Although the Double Density is shown as well, it cannot be choosen.
   Maybe this is supported in future releases.
   You can choose between SINGLE density, MEDIUM density, or ENHANCED
   density disk images.

   Placing a nonblank character in front of the desired option is sufficient
   to activate the option. Please note that you cannot choose multiple
   options.

   Pressing the "Esc" key, let you return to step 2.
   Pressing the ENTER key to confirm your selection.
            Make your selection by non-blanking one selection!    
            Continue with step 4.
   Use cursor keys to move around the screen.
   Use "Tab" to jump to the next field.

4. SELECTING THE DOS TO INCLUDE ON THE IMAGE(S).
   If ENTER key was selected on step 3, you'll continue with step 4.
   Select if a Disk Operating System (DOS) should be stored on the
   .ATR disk images, and if so, which DOS.
   You can choose between no DOS at all, Atari DOS 2.5, or MYDOS 4.53.
   If you include a DOS, you can also specify if the DUP.SYS file
   should be included on the image. The DUP.SYS gives you the DOS Menu
   when you boot up the disk image on your original Atari XL/XE. In this
   Menu you can run programs, copy files, remove files, etc.

   Placing a nonblank character in front of the desired option is sufficient
   to activate the option. Please note that you cannot choose multiple
   options. Please note that the DUP.SYS option will only be validated
   if you selected to include a DOS on the image.

   If DOS 2.5 is selected the DOS.SYS and DUP.SYS files should reside
   in the following PC directory: C:\DIR2ATR\DOS25\
   If MYDOS 4.5.3 us selected the DOS.SYS and DUP.SYS files should reside
   in the following PC directory: C:\DIR2ATR\MYDOS\
   Pressing the "Esc" key, let you return to step 3.
   Pressing the ENTER key to confirm your selection.
            Make your selection by non-blanking one selection!    
            Continue with step 5.
   Use cursor keys to move around the screen.
   Use "Tab" to jump to the next field.

5. IF OTHER IMAGES ALREADY EXIST IN THE STORE DIRECTORY.
   If no previous .ATR disk images reside in the "store" directory,
   the program will continue with step 5.

   If the ENTER key was selected on step 4, you'll continue with step 5.
   Select if the disk images to be created will be added after the
   highest currently available disk number, or should start from the
   beginning of the numbering sequence (i.e. 001.ATR).
   The program checks if there are disk images present in the "store"
   directory with disk numbers within the range "001.ATR" thru "999.ATR".
   If so, step 4 is executed, and you'll have to decide what the start
   number of the first to be created disk image will be.
   Of not, step 4 is skipped, and the program will start with disk image
   number "001.ATR".

   Placing a nonblank character in front of the desired option is sufficient
   to activate the option. Please note that you cannot choose multiple
   options.

   Pressing the "Esc" key, let you return to step 4.
   Pressing the ENTER key to confirm your selection.
            Make your selection by non-blanking one selection!    
            Continue with step 6.
   Use cursor keys to move around the screen.
   Use "Tab" to jump to the next field.

6. INFORMING THE USER ABOUT THE PROGRESS OF THE IMAGE PROCESSING.
   The program will convert the selected pc directory into .ATR disk images,
   and stores them in the selected pc "store" directory.
   DOS will be written to the disk images if selected.
   The program will create the disk images starting from disk number 001.ATR
   unless the user specified differently.

7. WHEN THE PROGRAM IS FINISHED IMAGING THE DIRECTORY TO BE IMAGED.
   After creating the disk images, the program continues with step 1.

Well, that's basically it!
Thank you for using Dir2Atr.
If you've got questions, my email address is: stack@xs4all.nl

Sincerely, Bo.

************************** Modification History ******************************
v1.00.00
November 5th, release of the program to the Public Domain.

v2.00.00
The program is now Freeware.
It's no longer command line driven.
An user interface has been implemented.
The user can skip the DUP.SYS file from the image if desired.
The DOS.SYS and DUP.SYS file are still located in the same directory
(i.e. \DOS25 or \MYDOS), but the DOS25 and MYDOS directory have been
placed in the C:\DIR2ATR directory now. So DOS.SYS for DOS 2.5 should
be located at: C:\DIR2ATR\DOS25\DOS.SYS
Wish list: Being able to create DOUBLE density disks.
