text

官方文档

text

简介

在图上写文本

该命令用于在图上添加文本,可以自由控制文本的大小、颜色、字体、角度。

除了可以添加键盘上可直接输入的字符外,还可以通过使用转义字符、特殊字体以及八进制码实现希腊字母、上下标等功能,详见 文字转义序列特殊字符

必选选项

<textfiles>

输入文件。最简单的情况下,输入数据包括三列,其格式为:

X  Y  text

示例:

echo 2 2 SHOW TEXTS | gmt text -JX10c -R0/5/0/5 -Ba -pdf test

若使用了 -F 选项,则输入数据的格式为:

x  y  [font  angle  justify]  text

其中,括号内的三项是否存在以及三项的顺序由 -F 选项决定。

可选选项

-A

默认情况下, 输入数据中 angle 是指沿水平方向逆时针旋转的角度。 -A 选项表明 angle 是方位角,即相对于北向顺时针旋转的角度。

-C[dx/dy][+to|O|c|C]

设置文本框与文本之间的空白区域,默认值为字体大小的15%。该选项仅当指定了 -W-G 选项时才有效。 dx 可以是具体的距离值也可以接 % 表示空白与当前字号的百分比。例如 -C1c/1c-C20%/30%

+t 可以用于进一步控制文本框的形状

  • +to: 直角矩形 [默认值]

  • +tO: 圆角矩形

  • +tc: 凹矩形(与 -M 选项一起使用)

  • +tC:凸矩形(与 -M 选项一起使用)

下图展示了 -C 选项的作用。

Source Code

../../_images/text-gmtplot-01.png
-D[j|J]<dx>[/<dy>][+v[<pen>]]

文本在指定坐标的基础上偏移 <dx>/<dy> ,默认值为 0/0 即不偏移。

使用text经常遇到的情况是在台站处标记台站名,此时传递给text的位置参数通常是台站坐标,因而text会将文本置于台站坐标处,该选择用于将文本稍稍偏离台站坐标位置以避免文本挡住台站处的符号。

  1. 若不指定 <dy> ,则默认 <dy>=<dx>

  2. -Dj<dx>/<dy> 表示沿着 <justify> 所指定的方向偏移

  3. -DJ<dx>/<dy> 表示shorten diagonal offsets at corners by sqrt(2)

  4. 偏移量后加上 +v 表示绘制一条连接初始位置与偏移后位置的直线

  5. +v<pen> 控制连线的画笔属性

-F[+a|+A[angle]][+c[justify]][+f[font]][+j[justify]][+h|+l|+r[<first>]|+t<text>|+z<format>]

控制文本的角度、对齐方式和字体等属性。

  1. +f<font> 设置文本的字体, 见 文字

  2. +a<angle> 文本相对于水平方向逆时针旋转的角度

  3. +A<angle> force text-baselines to convert into the -90/+90 range

  4. +j<justify> 文本对齐方式,见 锚点

下面的命令中,统一设置了所有文本的字号为30p,4号字体,红色,文本旋转45度,且以左上角对齐:

gmt text -R0/10/0/10 -JX10c/10c -B1g1 -F+f30p,4,red+a45+jTL -pdf text << EOF
3 4 Text1
6 8 Text2
EOF

若使用了 +f 子选项,但是未给定 <font> ,则意味着输入数据的每一行需要自定义本行的字体属性,因为输入数据的格式要发生变化。例如 -F+f 选项要求的输入数据的格式为:

x   y   font    text

对于 +a+j 同理。若 +f+a+j 中有两个以上未在命令行中指定参数,则输入数据中要增加多列,每列的顺序由这三个子选项的相对顺序决定。比如 -F+f+a 的输入数据格式是:

x   y   font   angle  text

-F+a+f 的输入数据格式为:

x   y   angle  font   text

-F+f+j+a 表示所有数据都需要单独指定字体、对齐方式和角度,此时输入数据的格式为:

x   y   font    justification   angle    text

-F+a+j+f 与前一个例子类似,唯一的区别在于子选项的顺序不同,而输入数据的格式要与子选项的顺序相匹配,此时输入数据的格式为:

x   y   angle   justification   font    text

-F+f12p,Helvetica-Bold,red+j+a 为所有行设置了统一的字体,但每一行需要单独指定对齐方式和角度,此时输入数据的格式为:

x   y   justification   angle   text

使用 +c<justify> 选项,则输入数据中不需要XY坐标,只需要文本即可,该选项直接从 -R 选项中提取出范围信息,并由对齐方式决定文本的坐标位置。比如 -F+cTL 表示将文本放在底图的左上角,在加上合适的偏移量即可放在任意位置。例如:

echo '(a)' | gmt text -R0/10/0/10 -JX10c/10c -B1 -F+cTL -Dj0.2c/0.2c -pdf text

通常来说,要绘制的文本都来自于输入数据的某一列。对于多段数据而言,还可以使用其他子选项来设置文本的来源:

  • +h 会直接从多段数据的段头记录中提取文本:

    gmt text -R0/10/0/10 -JX10c/10c -B1 -F+h -pdf text << EOF
    > TEXT1
    2  2
    > TEXT2
    5  5
    EOF
    
  • +l 会直接从多段数据的段头记录里的 -L<label> 中提取信息:

    gmt text -R0/10/0/10 -JX10c/10c -B1 -F+l -pdf text << EOF
    > -LTEXT1
    2  2
    > -LTEXT2
    5  5
    EOF
    
  • +r<first> 会使用记录号作为文本(记录号从 <first> 起算)

  • +t<text> 设置使用一个固定的字符串

  • +z<format> 将 Z 值以特定的格式输出为字符串,默认格式由 FORMAT_FLOAT_MAP 控制

-G

设置文本框的填充色。

除了设置填充色之外, -G 选项还有两个高级用法,即 -Gc-GC 。其中, -Gc 表示先绘制文本,然后将文本框裁剪出来,并打开裁剪选项,之后的绘图命令都不会覆盖文本所在区域,最后需要使用 clip-C 选项关闭裁剪。若不想要绘制文本只想要激活裁剪选项,可以使用 -GC 选项。

-L

用于列出GMT所支持的所有字体名及其对应的字号:

gmt text -L
-M

段落模式,用于输入大量文本。

输入文件必须是多段数据。数据段头记录的格式为:

> X Y [font angle justify] linespace parwidth parjust
  1. 第一个字符是数据段开始标识符,默认为 >

  2. 从第三列开始,包含了本段文本的设置信息

  3. font angle justify 是可选的,由 -F 选项控制

  4. linespace 行间距

  5. parwidth 段落宽度

  6. parjust 段落对齐方式,可以取为 l (左对齐)、 c (居中对齐)、 r (右对齐)、 j (分散对齐)

段头记录后即为要显示在图上的文本,每段数据之间用空行分隔。

#!/usr/bin/env bash
gmt begin text_-M png,pdf
gmt text -R0/3/0/5 -JX8c/3c -F+f+a+j -Baf -M -N << EOF
> 0 -1 12p,black 0 LT 13p 8c j
@%5%Figure 1.@%% This illustration shows nothing useful, but it still needs
a figure caption. Highlighted in @;255/0/0;red@;; you can see the locations
of cities where it is @_impossible@_ to get any good Thai food; these are to be avoided.
EOF
gmt end show
../../_images/text-gmtplot-11.png

段落模式示意图

-N

位于地图边界外的文本也被绘制。

默认情况下,若文本超过了底图边框,则不显示该文本,即文本被裁剪掉了。使用 -N 选项,即便文本超出了底图边框的范围,也依然会显示。

-Ql|u

所有文本以小写(lower case)或大写(upper case)显示

-Wpen

设置文本框的边框属性,默认值为 default,black,solid

-Z

3D投影中,需要在数据的第三列指定文本的Z位置,数据格式为:

X   Y   Z   Text

此时强制使用 -N 选项。

-U[label][+c][+jjust][+odx/dy] (more …)

在图上绘制GMT时间戳logo

-t[transp] (more …)

设置图层透明度(百分比)。取值范围为0(不透明)到100(全透明)

示例

下面的例子中设置文本框的相关属性:蓝色边框、淡蓝填充色、圆角矩形,空白为 100%/100%

gmt text -R0/10/0/5 -JX10c/5c -B1 -Wblue -Glightblue -C100%/100%+tO -pdf text << EOF
3   1   Text1
6   3   Text2
EOF