image

官方文档:

image

简介:

将图片或EPS文件放在图上

image 模块可以读取EPS文件或任意一个光栅图片文件,并将其画在图上。

该模块的几个主要用途:

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

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

  • 将一般图片放在图上

必须选项

imagefile

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

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

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

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

可选选项

-D[g|j|J|n|x]refpoint+rdpi+w[-]width[/height][+jjustify][+nnx[/ny] ][+odx[/dy]]

指定图片的尺寸和位置

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

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

    • glon/lat 指定数据坐标为参考点

    • jcode 或者 Jcode 通过 2 个字母的对齐方式码指定锚点作为参考点

    • nxn/yn 指定归一化坐标系(即 0-1)为参考点

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

  • +jjustify 指定logo上的锚点(默认锚点为logo的左下角(BL))

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

  • +rdpi 指定图片的DPI以间接指定图片的尺寸

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

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

-F[+cclearances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]

控制图片的背景面板属性

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

  • +gfill 指定面板填充颜色 [默认不填充]

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

  • +r[radius] 绘制圆角边框,radius 为圆角的半径

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

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

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

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

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

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

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

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

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

-I

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

-Jprojection (more …)

设置地图投影方式

-M

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

-Rxmin/xmax/ymin/ymax[+r][+uunit] (more …)

指定数据范围

对于三维透视图(-p 选项) ,可以加上 /zmin/zmax 指定Z轴的范围。

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

在图上绘制GMT时间戳logo

-V[level] (more …)

设置 verbose 等级 [w]

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

-Y[a|c|f|r][yshift[u]] (more …)

移动绘图原点

-p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more …)

设置3D透视视角

-t[transp] (more …)

设置图层透明度(百分比)。取值范围为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

相关模块

gmtlogo legend, colorbar plot, psconvert