R grid.raster 渲染光栅对象

说明

在给定位置、大小和方向渲染光栅对象(位图图像)。

用法

grid.raster(image,
            x = unit(0.5, "npc"), y = unit(0.5, "npc"),
            width = NULL, height = NULL,
            just = "centre", hjust = NULL, vjust = NULL,
            interpolate = TRUE, default.units = "npc",
            name = NULL, gp = gpar(), vp = NULL)

rasterGrob(image,
           x = unit(0.5, "npc"), y = unit(0.5, "npc"),
           width = NULL, height = NULL,
           just = "centre", hjust = NULL, vjust = NULL,
           interpolate = TRUE, default.units = "npc",
           name = NULL, gp = gpar(), vp = NULL)

参数

image	任何可以强制转换为栅格对象的 R 对象。
x	指定 x-location 的数值向量或单位对象。
y	指定 y-location 的数值向量或单位对象。
width	指定宽度的数值向量或单位对象。
height	指定高度的数值向量或单位对象。
just	矩形相对于其 (x, y) 位置的对齐方式。如果有两个值，则第一个值指定水平对齐方式，第二个值指定垂直对齐方式。可能的字符串值为： "left" 、 "right" 、 "centre" 、 "center" 、 "bottom" 和 "top" 。对于数值，0 表示左对齐，1 表示右对齐。
hjust	指定水平对齐的数值向量。如果指定，则覆盖 just 设置。
vjust	指定垂直对齐的数值向量。如果指定，则覆盖 just 设置。
default.units	指示 x 、 y 、 width 或 height 仅作为数值向量给出时使用的默认单位的字符串。
name	字符标识符。
gp	类 "gpar" 的对象，通常是调用函数 gpar 的输出。这本质上是图形参数设置的列表。
vp	网格视口对象(或 NULL)。
interpolate	一个逻辑值，指示是否对图像进行线性插值(替代方法是使用nearest-neighbour插值，这会产生更多块状结果)。

细节

不需要指定 width 和 height，在这种情况下，将保留图像的宽高比。如果同时指定width和height，则图像可能会失真。

并非所有图形设备都能够渲染光栅图像，有些可能无法生成旋转图像(即，如果在旋转视口内渲染光栅对象)。另请参阅 rasterImage 下的评论。

gp 中的所有图形参数设置都将被忽略，包括 alpha 。

值

一个光栅格罗布。

例子

redGradient <- matrix(hcl(0, 80, seq(50, 80, 10)),
                      nrow=4, ncol=5)
# interpolated
grid.newpage()
grid.raster(redGradient)
# blocky
grid.newpage()
grid.raster(redGradient, interpolate=FALSE)
# blocky and stretched
grid.newpage()
grid.raster(redGradient, interpolate=FALSE, height=unit(1, "npc"))

# The same raster drawn several times
grid.newpage()
grid.raster(0, x=1:3/4, y=1:3/4, width=.1, interpolate=FALSE)

作者

Paul Murrell

也可以看看

as.raster 。

dev.capabilities看看是否支持。