Reference

Table of Contents  ▸  List of Commands  ▸  Image Drawing  ▸  text◀  tetraedron_shade    |    text_outline  ▶

text

Built-in command

Arguments:

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

$ gmic 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*$>} done

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*$>} done

• Example #2

$ gmic 0 text "G'MIC",0,0,23,1,255

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