Table of Contents  ▸  List of Commands  ▸  Image Drawing  ▸  text

◀  tetraedron_shade    |    text_outline  ▶

text	Built-in command

Arguments:

• text,_x[%|~],_y[%|~],_font_height[%]>=0,_opacity,_color1,...

Description:

Draw specified colored text string on selected images.

(equivalent to shortcut command t).

If one of the x or y argument ends with a ~, its value is expected to be
a centering ratio (in [0,1]) rather than a position.
Usual centering ratio are { 0=left-justified | 0.5=centered | 1=right-justified }.
Sizes 13 and 128 are special and correspond to binary fonts (no-antialiasing).
Any other font size is rendered with anti-aliasing.
Specifying an empty target image resizes it to new dimensions such that the image contains
the entire text string.

Default values:

x=y=0.01~, font_height=16, opacity=1 and color1=0.

Examples of use:

• Example #1

Command: image.jpg resize2dy 600 y=0 repeat 30 { text {2*$>}" : This is a nice text, isn't it ?",10,$y,{2*$>},0.9,255 y+={2*$>} }

• Example #2

Command: 0 text "G'MIC",0,0,23,1,255