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指定地图上的参考点
- g 指定某地图坐标位参考点
- j|J 通过2字母的对齐方式码指定矩形区域的某个锚点作为参考点
- n 在归一化坐标系（即0-1）中指定参考点
- x 在绘图坐标系下指定参考点
- +jjustify 指定logo上的锚点（默认锚点为logo的左下角(BL)）
- +odx/dy 在参考点的基础上设置图片的额外偏移量
- +rdpi 指定图片的DPI以间接指定图片的尺寸
- +w[-]width[/height] 直接指定图片的尺寸。若未给定 height 则按照 width 以及原图的横纵比进行缩放；若 width 为负值，则使用其绝对值作为宽度，并使用PS的图片操作符将图片插值到设备的分辨率
- +nnx[/ny] 使图片在水平方向重复 nx 次，垂直方向重复 ny 次。若省略 ny 则默认其与 nx 相等 [默认值为 1/1]
- g|j|J|n|x]refpoint指定地图上的参考点
- -F[+cclearances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]
控制图片的背景面板属性
若只使用 -F 而不使用其它子选项，则会在 GMT logo 周围绘制矩形边框。下面简单介绍各子选项，详细用法见 绘制修饰物
- +ppen 指定背景面板的画笔属性（默认画笔属性由 MAP_FRAME_PEN 决定）
- +gfill 设置背景面板的填充色 [默认不填充]
- +cclearances 以设置不同方向的空白间隔
- +igap/pen 在背景面板内部绘制一个额外的内边框。gap 为外边框与内边界之间的距离 [2p]，默认边界属性由 MAP_DEFAULT_PEN 控制
- +rradius 控制圆角矩形边框，圆角矩形半径 radius 默认为 6p
- +s 绘制背景面板阴影区。dx/dy 是阴影区相对于背景面板的偏移量 [4p/4p]。 shade 为阴影区的颜色 [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 等级 [c]
-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参数的值，可重复多次使用。参数列表见 gmt.conf
注意事项¶
-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