ASCII Editor Info: #11 BMP2ASCII Conversion
+-----------------------------------------+

TOPIC:
- Bitmap to gray scale conversion
- Picture overlay
- Select, Replace, Flip, Canvas

Start Settings (Default):
- Color mode: Plain text
- Show grid

We will start with a simple example: Conversion of Bitmap to ASCII

STEP 1:
========
Use the open dialog to select a bitmap

INFO: This function converts a bitmap file to ASCII art. The program knows only
      96 characters (= ASCII art restriction) and converts therefore every picture
      to gray scale. "Relative color definitions" means that the program search for
      the most dark and light color before the conversion and fit the color setting.
      The "absolute" mode didn't fit the colors and is therefore a bit faster.
      Normally you should use the "relative color mode".

STEP 2:
========
Search for the file "Sample-1.BMP" in the "Other" directory and open it. Now the
program ask for resample the graphic. We didn't need this at the moment and you
can start the conversion by pressing "OK".

INFO: The program is working with all kind of bitmaps. It converts and resample
      the files automatic. If you didn't change the size in the canvas dialog the
      file is imported 1:1 (char:pixel).

STEP 3:
========
Now you see the result of the conversion. It's the half of a girl portrait. The
program has used (Default) the 'BMP2ASCII.dat' file for this conversion. Before
we start with replacing characters it is help full to overlay the original graphic
to see the colors. Click in the special menu "locked picture overlay" and open
the "Sample-1.bmp" again. You will see the (stretched) bitmap in the grid and now
we can replace some characters:
Choose in the edit2 menu "replace all", enter the search char. in the dialog,
enter the replace char. in the dialog.
The selected character will now be replaced. You can repeat this step until you
like the result. After this you can delete the overlay bitmap by selecting
"special/clear picture overlay". You should always do this, because it takes
some memory.

INFO: You can use your own conversion library (see "External library") or the intern
      algorithm of the program. The default library (BMP2ASCII.dat) has better
      normally better results.

      The converted file isn't typical for ASCII art. It has indexed colors and
      a the right size. I made this, because its more easy to work with it.

      Alternative to the "replace all" function you could use "replace selection"
      or "fill".

      Warning: Picture overlay needs some memory! It is supposed to use only pics
      smaller than 1MB and to clear after using.

STEP 4:
========
The ASCII of a half face isn't very nice and therefore let's make a full face of it.
- Click with the right mouse button on the grid and choose select all.
- Click with the right mouse button on the grid and choose copy.
- Go to the image menu and click "set canvas".
- Disable the checkbox and enter "58" as new width. => prog. creates new grid.
- click on the first empty cell on the top of the grid.
- Click with the right mouse button on the grid and choose paste.
- Select the original part (left) of the face and choose "edit2/flip horz."

Now the first ASCII conversion is ready. You can save it now, or make some other
changes. If you want to see the file in your text editor (without saving) press F4.

INFO: - Most of the functions in the "edit" menu need a selection.
      - You could use the painting functions to draw manually
      - You could exchange the AE clipboard direct with other programs
      - "optimized saving" deletes all left aligned SPACE