(Document v3.0, using Ascgen dotNET 0.9.7(pre), updated 20080402)

In the first in a series of tutorials on how to use the ASCGEN dotNET, I show you how to convert an image to a high quality fixed width text image with just a few simple steps and very little effort.

We will be going from this

to

First, a quick lesson about fonts or just skip ahead to the tutorial.

There are two main types of font: Fixed Width, which has one specific size for every character, and Variable Width, which has a fixed height but the width can vary between different characters.

Fixed width fonts such as Courier New, Lucida Console, Fixedsys are traditionally used for ASCII art, however most word processors use a variable width font like Times New Roman, or Arial.

When you have selected a fixed width font, at the top of the program you will see the “Ramp” toolbar used for setting the current ASCII ramp. When you use a variable width font, you will instead see the “Characters” toolbar, which is used for setting the conversion characters.

The ASCGEN dotNET is the first and only program able to convert images into ASCII art made for variable width fonts. We will cover variable width font conversions in a future tutorial, but for now let’s start with the default fixed width font.

Tutorial One: Creating your first image

Get a suitable image into the program

For this tutorial I will be using the following image, which was taken from a royalty free stock photo archive.

Go to “File/Load” or double-click the image area and select the image, or you can drag and drop the image onto the image tab or just copy it and paste it with “File/Import from Clipboard”.

Select an area of the image
When we convert the image, its resolution is reduced to the output size in memory, which means that small details will be lost or difficult to see. To produce the best output, we need to zoom in and concentrate on the main subject of the image.

So, imagine a box around the person or thing you want to see, then click on a corner and drag to create the selection area.

Click and drag the box to move it around, and use the white boxes to adjust the size. Make the input image bigger by dragging the separator between the text and image if needed.

Select the output font
For this tutorial, we will leave it at the default font settings which are Lucida Console, 9pt. The “Auto” button on the toolbar should be pushed down by default, which has the program create an accurate ASCII ramp for the font, and the ramp box will be grayed out.

Switch to full screen mode
To get a better view of the output, switch to full screen by clicking the button, or pressing F11. You could also hide the input image by clicking the or pressing F12.

Adjust the brightness/contrast and levels for the output

To get the best results, the ASCGEN dotNET allows you to adjust the output image in real time through the Text widget.

The recommended method for adjusting the text is through the levels control. This shows you a histogram of the current image, and allows you to adjust the minimum, median and maximum values in exactly the same way as you would in photoshop and other photo applications.

Choose the ‘Levels’ tab if it isn’t currently visible. Using this will make the image use the whole range of the output ramp, and can drastically improve the results.

Click and drag the black slider to adjust the minimum level. Try and put it near the first peak. Then, click and drag the white slider to adjust the maximum level. Try and put it around the last peak. If necessary, adjust the grey slider a little to set the middle point of the range. Just play around with the settings until you are happy with the results.

Another available method is adjusting the output Brightness/Contrast by switching to its tab on the text widget. This works in a similar way to the Levels, however the contrast effect will be cancelled out if the output is being stretched (”Edit/Output/Stretch” or right-click the output and uncheck “Stretch”).

Dithering is a method of introducing noise which helps to blend the characters together to improve the output.

Save the text image
Now the image is finished, we just need to save it.

Go to “File/Save As…” and the save dialog will appear.

Let’s leave Colour conversions for now. The default is black and white output, so make sure that is selected and also the output type is text.

Set the “Save as type” drop down box for how you want to output the text image:

• Plain Text - Save the text without any font information (remember to set the correct font when you display it)
• Plain Text (Unicode) - Same as above, but will save as a unicode text file that can store ANSI and other non standard characters
• NFO - Same as Plain Text (Unicode), but with the .nfo extension
• Rich Text - Saves the text and font settings as a rtf file that can be opened by wordprocessors
• XHTML 1.1 - Saves the image and font settings to a valid html file that can be opened by web browsers.

An alternative way to save the image is by clicking on Image which will output the text into an image format.

This is useful if you want to make sure the image will be displayed looking exactly as it should look without having to worry about the font.

By default the image is resized to 75% of its original size, but you can adjust up to 100% (the actual text size) with the slider or down to 25%. Use the arrow keys to adjust the size in smaller increments to the exact dimensions you want. Click “Ok”, then set the output filename and type (.gif usually produces the smallest output sizes), and we’re done.