9.7 - Text Generation Dialog

Controls are provided for the font face, the font size, text alignment, color, and antialiasing. You can enter multiple lines of text, or just one.

The text is generated into a new image. To compose it into another image, you ensure the new text image is set as the origin image, then use the Merge operator to do the composing.

Tip: The reason this approach is used is because it offers four worthy advantages over composing text directly on an image.

First, you can place the text in more than one place, at more than one size, without having to constantly re-create it.

Second, you can place the text in more than one image without having to re-create it.

Third, you can do almost anything to the text in its image that would be very difficult to do if the text had already been composed into the target image first.

Fourth, you can control the aspect ratio of the text, and its scaling, during the merge operation.

When typing in the text entry box, if you press tab, this will immediately close the dialog and generate the text. If you press esc, this will immediately close the dialog and cancel text generation.

The text generation dialog blocks; that is, you have to close it before you can do anything with the rest of the application.

Note: When the text is generated, the entire text image is filled with the selected color, and then the text is generated as a transparency mask over that color. This ensures that when composing, the text color is what blends into the target image, even when certain combinations of antialiasing and blending go beyond the strict boundaries of the text mask.

The Text Generation Dialog

The image resulting from the above dialog settings

The area selection

When making a rectangular area selection for merge, the rectangle area tool displays guides that match the aspect of the text origin image so you can place it accurately, in a non-distorted, aspect-correct manner.

If the selection is smaller than the origin image, the guides will be red. If the selection size matches the origin image, the guides will be green. If the selection is larger than the origin image, the guides will be yellow.

In the example placement shown, the merge region is considerably smaller than the source text image. So the placement guides are red, indicating that the placement is not using all the available resolution. The text in the example was generated with a very large (100 point) font. In the view below, you can see that between the large, high-quality text itself, and the careful scaling done by the merge operator, the end result is very nice even though it doesn't use all of the available detail in the generated text.

The resulting text placement
Keyboard Navigation
, Previous Page . Next Page t TOC i Index o Operators g Glossary

Valid HTML 4.01 Loose

This manual was generated with wtfm
wtfm uses aa_macro and SqLite
aa_macro uses python 2.7
iToolBox 1.13
Please consider supporting my iToolBox development efforts with a small PayPal donation.

Hey, look:
A box!