✍️ 田冬冬 , 周茂 , 朱邓达 • 📅 2026-01-04

# image

官方文档:

  image

简介:

  将图片或EPS文件放在图上

image 模块可以读取EPS文件或任意一个光栅图片文件，并将其画在图上。该模块的几个主要用途：

- 将多张图合并到一张图上

- 将自己单位的 logo 放在 GMT 生成的图上

- 将一般图片放在图上

图像可以进行任意缩放。对于 1-bit 位图图像，可以执行以下操作：

1. 反转 ：即黑像素（开启）变白（关闭），反之亦然

2. 着色 ：指定不同的前景色和背景色

3. 设置透明 ：即仅绘制前景色或背景色中的一种

此外，用户可以选择使用电视标准的 YIQ 变换将彩色位图图像转换为灰度图。对于位图文件，用户还可以指定将哪种特定颜色设置为透明。 用户还可以选择复制（平铺）图像。当配合适当的裁剪路径使用时，这允许实现更大尺寸的自定义填充模式 （大多数 GMT 模块提供的 -Gp 功能仅限于小于 146x146 像素的位图）。

## 语法

gmt image imagefile [ `-B`[p|s]parameters ] [ `-D` refpoint ] [ `-F` box ] [ `-G`[color][+b|f|t] ] [ `-I` ] [ `-J` parameters ] [ `-Jz|Z` parameters ] [ `-M` ] [ `-R` west/east/south/north[/zmin/zmax][+r][+u unit] ] [ `-U`[stamp] ] [ `-V`[level] ] [ `-X`[a|c|f|r][xshift] ] [ `-Y`[a|c|f|r][yshift] ] [ `-p` flags ] [ `-t` transp ] [ --PAR=value ]

## 输入数据

imagefile

  EPS文件或其他光栅图片格式（GIF、PNG等）的文件

  - EPS文件必须包含合适的BoundingBox

  - 光栅文件的颜色深度可以是1、8、24、32位

  - 光栅文件是通过GDAL读入的，若安装GMT时未配置GDAL，则该命令只支持EPS文件

## 可选选项

-B

-B parameters

  设置底图边框和轴属性。 (参数详细介绍)

-D

-D[g|j|J|n|x]refpoint+r dpi+w[-]width[/height][+j justify][+n nx[/ny] ][+o dx[/dy]]

  指定图片的尺寸和位置

  简单介绍各子选项的含义，详情见 修饰物

  - [g|j|J|n|x]refpoint指定地图上的参考点

    - g lon/lat 指定数据坐标为参考点

    - j code 或者 J code 通过 2 个字母的对齐方式码指定锚点作为参考点

    - n xn/yn 指定归一化坐标系（即 0-1）为参考点

    - x x/y 指定绘图坐标 为参考点， 追加 cm, inch, 或者 point 用来指定单位

  - +j justify 指定logo上的锚点（默认锚点为logo的左下角(BL)）

  - +o dx/dy 在参考点的基础上设置图片的额外偏移量

  - +r dpi 指定图片的DPI以间接指定图片的尺寸

  - +w[-]width[/height] 直接指定图片的尺寸。若未给定 height 则按照 width 以及原图的横纵比进行缩放；若 width 为负值，则使用其绝对值作为宽度， 并使用PS的图片操作符将图片插值到设备的分辨率

  - +n nx[/ny] 使图片在水平方向重复 nx 次，垂直方向重复 ny 次。 若省略 ny 则默认其与 nx 相等 [默认值为 1/1]

-F

-F[+c clearances][+g fill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]

  控制图片的背景面板属性

  若只使用 `-F` 而不使用其它子选项，则会在 GMT logo 周围绘制矩形边框。 下面简单介绍各子选项，详细用法见 修饰物

  - +g fill 指定面板填充颜色 [默认不填充]

  - +p pen 绘制面板边框。pen 为边框的画笔属性，若不指定 pen， 则默认使用 MAP_DEFAULT_PEN

  - +r[radius] 绘制圆角边框，radius 为圆角的半径

  - +i[[gap/]pen] 在边框内部绘制一个内边框，gap 为内外边框空白距离 [默认为 2p]， pen 为内边框的画笔属性 [默认使用 MAP_DEFAULT_PEN]

  - +c clearance 设置修饰物与面板之间的空白距离。 默认情况下面板的大小由修饰物的大小决定，使用该子选项可以为面板增加额外的尺寸。 clearance 的具体设置包括下面 3 种情况：

    - gap 为四个方向增加相同的空白距离

    - xgap/ygap 分别为 X 方向和 Y 方向指定不同的空白距离

    - lgap/rgap/bgap/tgap 分别为四个方向指定不同的空白距离

  - +s[[dx/dy/][shade]] 设置面板背景阴影。dx/dy 为阴影区相对于面板的偏移量， shade 为阴影区颜色 [默认为 4p/-4p/gray50]

-G

-G[color][+b|+f|+t]

  修改特定像素值为其它颜色或透明（该选项可重复使用）

  对于1-bit光栅图片，可以通过 +b 或 +f 指定背景色或前景色为 color。 若不给 color 则表示设置背景色或前景色为透明色。 对于其它图片而言，还可以使用 `-G` color+t 将颜色 color 设置为 透明。

-I

-I

  绘图前对1-bit图片进行反转，即黑色变白色，白色变黑色

-J

-J projection

  设置地图投影方式。 (参数详细介绍)

> 仅与 -p 一起使用。

-Jz|Z

-J z|Z parameters

  绘制三维图时，设置垂直方向 Z 轴的线性投影尺度。 参数用法与 -Jx|X 相同。

-M

-M

  使用YIQ变换将彩图转换成灰度图

-R

-R west/east/south/north[/zmin/zmax][+r][+u unit]

  指定数据范围。对于三维透视图（-p 选项） ，可以加上 /zmin/zmax 指定Z轴的范围。 (参数详细介绍)

> 仅与 -p 选项一起使用。

-U

-U[label][+c][+j just][+o dx/dy]

  在图上绘制GMT时间戳logo。 (参数详细介绍)

-V

-V[level]

  设置 verbose 等级 [w]。 (参数详细介绍)

-X

-Y

-X[a|c|f|r][xshift[u]]

-Y[a|c|f|r][yshift[u]]

  移动绘图原点。 (参数详细介绍)

-p

-p[x|y|z]azim[/elev[/zlevel]][+w lon0/lat0[/z0]][+v x0/y0]

  设置3D透视视角。 (参数详细介绍)

-t

-t[transp]

  设置图层透明度（百分比）。取值范围为0（不透明）到100（全透明）。 (参数详细介绍)

-^ 或 -

  显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）

-+ 或 +

  显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明

-? 或无参数

  显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明

--PAR=value

  临时修改GMT参数的值，可重复多次使用。参数列表见 配置参数

## 注意事项

`-G` 和 `-I` 选项仅适用于光栅图片文件，对于EPS文件无效。

## 示例

绘制GMT示例图片 needle.jpg，其宽度为7厘米:

    gmt image @needle.jpg -Dx0/0+w7c -pdf plot

绘制相同的文件，但是反转其RGB带:

    gmt image @needle.jpg+b2,1,0 -Dx0/0+w7c -pdf plot

相同的文件，只绘制其红色带，但以灰度方式绘制:

    gmt image @needle.jpg+b0 -Dx0/0+w7c -pdf plot

绘制EPS文件:

    gmt image @gallo.eps -Dx2i/1i+jTR+w3i -png image

以一个1-bit光栅图片为模板，设其背景色为darkgray、前景色为yellow，并设置重复6x12次，宽度为2.5厘米:

    gmt image @vader1.png -Gdarkgray+b -Gyellow+f -Dx0/0+w2.5c+n6/12 -pdf image

## 相关模块

logo, legend, colorbar, plot, psconvert