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看看是否支持。