R patterns 定义渐变和图案填充

说明

定义渐变填充和图案填充的函数。

用法

linearGradient(colours = c("black", "white"),
               stops = seq(0, 1, length.out = length(colours)),
               x1 = unit(0, "npc"), y1 = unit(0, "npc"),  
               x2 = unit(1, "npc"), y2 = unit(1, "npc"),
               default.units = "npc",
               extend = c("pad", "repeat", "reflect", "none"),
               group = TRUE) 
radialGradient(colours = c("black", "white"),
               stops = seq(0, 1, length.out = length(colours)),
               cx1 = unit(.5, "npc"), cy1 = unit(.5, "npc"),
               r1 = unit(0, "npc"),
               cx2 = unit(.5, "npc"), cy2 = unit(.5, "npc"),
               r2 = unit(.5, "npc"),
               default.units = "npc",
               extend = c("pad", "repeat", "reflect", "none"),
               group = TRUE) 
pattern(grob,
        x = 0.5, y = 0.5, width = 1, height = 1,
        default.units = "npc",
        just="centre", hjust=NULL, vjust=NULL,
        extend = c("pad", "repeat", "reflect", "none"),
        gp = gpar(fill="transparent"),
        group = TRUE) 

参数

colours	用于渐变的两种或多种颜色之间的过渡。
stops	渐变起点和终点之间渐变颜色的位置(作为从起点到终点的距离的比例)。
x1 , y1 , x2 , y2	线性渐变的起点和终点。
default.units	如果任何位置或尺寸仅指定为数值，则要使用的坐标系。
extend	渐变开始和结束之外发生了什么(请参阅详细信息)。
cx1 , cy1 , r1 , cx2 , cy2 , r2	径向渐变的起始圆和结束圆的中心和半径。
grob	将在图案填充中绘制为图块的 grob(或 gTree)。
x , y , width , height	图案填充的图块大小。
just , hjust , vjust	磁贴相对于其位置的对齐方式。
gp	图块的默认图形参数设置。
group	指示渐变或图案是否相对于对象的边界框或者是否相对于对象内的各个形状的逻辑。

细节

使用这些函数定义渐变填充或图案填充，然后在调用 gpar() 函数时使用生成的对象作为 fill 的值。

Extend 的可能值及其含义是：

• [ pad :] 在其边界处传播梯度值。

• [none :] 不会产生超出渐变限制的填充。

• [repeat：]重复填充。

• [reflect :] 反向重复填充。

要创建平铺图案，请提供一个简单的 grob(如圆形)，指定图案的位置和大小以包含简单的 grob，并指定 extend="repeat" 。

在视口上，渐变和图案是相对于整个视口的，除非 group = FALSE ，在这种情况下，它们在绘制时相对于单个对象。在 gTree 上，渐变和图案与 gTree 所有子节点周围的边界框相关，除非 group = FALSE ，在这种情况下，它们在绘制时与各个子节点相关。在 grob 上，渐变和图案与由 grob 绘制的所有形状周围的边界框相关，除非 group = FALSE ，在这种情况下它们与各个形状相关。

值

线性渐变或径向渐变或图案对象。

警告

并非所有图形设备都支持渐变填充和图案填充。如果不支持，闭合形状将使用透明填充进行渲染。在支持它们的地方，并非所有 extend 值都受支持。

在 Cairo 设备上，应避免在图案定义中使用裁剪，因为它很可能导致图案拼贴变形。

作者

Paul Murrell

也可以看看

gpar