R语言:grid.grab()函数中文帮助文档(中英文对照)

loveR

grid.grab(grid)
grid.grab()所属R语言包：grid

                                         Grab the current grid output
                                         抓住当前电网输出

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Creates a gTree object from the current grid display list or from a scene generated by user-specified code.
从目前的网格显示列表或从用户指定的代码生成一个场景创建1 gTree对象。


用法----------Usage----------


grid.grab(warn = 2, wrap = FALSE, ...)
grid.grabExpr(expr, warn = 2, wrap = FALSE, ...)



参数----------Arguments----------

参数：expr
An expression to be evaluated.  Typically, some calls to grid drawing functions.  
表达式进行评估。通常情况下，一些电网绘图功能的调用。


参数：warn
An integer specifying the amount of warnings to emit.  0 means no warnings, 1 means warn when it is certain that the grab will not faithfully represent the original scene. 2 means warn if there's any possibility that the grab will not faithfully represent the original scene.  
一个整数，指定发出警告。 0表示没有任何警告，1表示警告时，可以肯定的是，抓斗不会忠实代表原始场景。 2表示警告说，如果有任何的可能性，抓斗不会忠实代表原始场景。


参数：wrap
A logical indicating how the output should be captured. If TRUE, each non-grob element on the display list is captured by wrapping it in a grob.   
一个逻辑显示输出应该如何被捕获。如果TRUE，每个非GROB元素，在显示列表被包裹在GROB抓获。


参数：...
arguments passed to gTree, for example, a name and/or class for the gTree that is created.
参数传递到gTree的，例如，名称和/为创建gTree或类。


Details

详情----------Details----------

There are four ways to capture grid output as a gTree.
有四种方式，捕获作为gTree的电网输出。

There are two functions for capturing output: use grid.grab to capture an existing drawing and grid.grabExpr to capture the output from an expression (without drawing anything).
捕获输出有两个功能：使用grid.grab捕获现有的图纸和grid.grabExpr捕捉输出表达式（不画什么）。

For each of these functions, the output can be captured in two ways.  One way tries to be clever and make a gTree with a childrenvp slot containing all viewports on the display list (including those that are popped) and every grob on the display list as a child of the new gTree;  each child has a vpPath in the vp slot so that it is drawn in the appropriate viewport. In other words, the gTree contains all elements on the display list, but in a slightly altered form.
对于这些功能，可以捕获输出两种方式。单程试图聪明和1 gTree，与childrenvp包含所有视口中显示列表（包括那些被弹出）每GROB上显示列表作为新gTree儿童插槽，每个孩子都有一个vpPath VP槽，所以，它是在适当的视口中绘制。换句话说，gTree包含在显示列表中的所有元素，但在形式略有改变。

The other way, wrap=TRUE, is to create a grob for every element on the display list (and make all of those grobs children of the gTree).
其他方式，wrap=TRUE，是建立在显示列表中（并让所有的gTree那些grobs儿童）每个元素GROB。

The first approach creates a more compact and elegant gTree, which is more flexible to work with, but is not guaranteed to faithfully replicate all possible grid output.  The second approach is more brute force, and harder to work with, but should always faithfully replicate the original output.
第一种方法是创建一个更紧凑和的优雅gTree，这是更灵活的工作，但不能保证忠实地复制所有可能的电网输出。第二种方法是更多的蛮力，更难处理，但应始终忠实地复制原始输出。


值----------Value----------

A gTree object.
一个gTree对象。


参见----------See Also----------

gTree
gTree


举例----------Examples----------


pushViewport(viewport(w=.5, h=.5))
grid.rect()
grid.points(stats::runif(10), stats::runif(10))
popViewport()
grab <- grid.grab()
grid.newpage()
grid.draw(grab)

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。