13.10 figure

官方文档:figure
简介:设置当前图片的属性

一个GMT现代模式会话下可以绘制一张或多张图件。对于一个会话中绘制多张图件的情况, figure 模块可以指定当前图件的文件名和格式。

该模块必须在你开始向当前图件绘图之前执行,且每次调用 figure 模块都会开启一张新的图件。你也可以再次使用 figure 模块在多个图件之间来回切换,但此时不能再指定 formatsoptions 等选项。一个会话中的每张图都有各自的历史记录和配置参数,因而不同图之间的 -R-J 选项等信息不会出现错乱。

13.10.1 语法

gmt figure [ prefix ] [ formats ] [ psoptions ] [ -V[level] ]

13.10.2 必须选项

prefix

图片文件名前缀,默认值为 gmtsession。图片文件名后缀由 formats 自动决定。

注解

文件名中应尽量避免出现空格。若存在空格,则文件名必须用单引号括起来。

13.10.3 可选选项

formats

图片文件格式。多个格式之间可以用逗号分开。默认图片格式为 pdf,由参数 GMT_GRAPHICS_FORMAT 控制。

GMT支持输出如下矢量图片格式:

GMT支持输出如下位图图片格式:

psoptions

GMT现代模式本质上是先生成PS文件,再通过调用 psconvert 自动转换成用户指定的图片格式。此处可以设置要传递给模块 psconvert 的选项,多个选项之间用逗号分隔。

默认值为 A,表示将 -A 选项传给 psconvert

其他可选的选项包括:

  • A[args]: 裁剪图片
  • Cargs: 额外传递给GhostScript的选项
  • Ddir: 指定图片的输出目录
  • Edpi: 设置图片分辨率
  • Hfactor: 对图片做平滑以避免混叠
  • Margs: 为当前图片叠加前景图片或背景图片
  • Qargs: 设置图像和文本的抗锯齿选项
  • S : 把 GhostScript 命令输出到标准错误输出,且不删除所有中间文件

详细解释见 psconvert 的说明文档。

-V[level] (more …)
设置 verbose 等级 [c].
-^-
显示简短的帮助信息,包括模块简介和基本语法信息 (Windows下只能使用 -
-++
显示帮助信息,包括模块简介、基本语法以及模块特有选项的说明
-? 或无参数
显示完整的帮助信息,包括模块简介、基本语法以及所有选项的说明

13.10.4 示例

在当前的现代模式下开启一个新绘图,图片名为 Regional,格式为PDF和EPS格式:

gmt begin
gmt figure Regional pdf,eps
gmt ...
gmt end

开启一个新绘图,名为GlobalMap,图片格式为JPEG,并对图片进行裁剪,四边均保留1厘米的空白:

gmt begin
gmt figure GlobalMap jpg A1c
gmt ...
gmt end

在一个会话中绘制两张图,并在两张图之间来回切换:

gmt begin

# 在 Fig1 中绘制
gmt figure Fig1 png
gmt ...

# 在 Fig2 中绘制
gmt figure Fig2 png
gmt ...

# 切换回 Fig1
gmt figure Fig1
gmt ...

# 切换回 Fig2
gmt figure Fig2
gmt ...

gmt end