R语言 SVGAnnotation包 compressStyles()函数中文帮助文档(中英文对照)

loveR

compressStyles(SVGAnnotation)
compressStyles()所属R语言包：SVGAnnotation

                                        Replace repeated inline CSS style settings with a CSS document
                                         一个CSS文件替换重复的内联CSS样式设置

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

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

This function takes an SVG document and extracts all the style attributes within the nodes and converts them to a set of CSS specifications and then replaces the style attribute with a class attribute which associates that node with the CSS declaration/rule. This can lead to a "significant" reduction in the size of the file (~ 30%) by avoiding duplication.  It also allows one to easily change the appearance of all nodes with the same settings by modifying the centralized CSS rule. Furthermore, it allows somebody  to customize the appearance of a plot without using R commands and regenerating the plot. This can be useful if the person doesn't know R or does not have the original data.
这个函数接受一个SVG文档内的节点提取所有的样式属性，将它们转换为一组CSS规范，然后替换同一个类的属性样式属性联营节点的CSS声明/规则。这可能会导致一个“显着”减少文件大小（〜30％），以避免重复。它还允许一个轻易改变外观的所有节点具有相同的设置，由修改集中CSS规则。此外，它允许有人来定制，而无需使用R命令和再生图图的外观。这可能是有用的，如果人不知道R或没有原始数据。


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


compressStyles(doc,
               classNames =
                       function(x)
                         paste("style", seq(along = x), sep = ""),
               threshold = NA, add = FALSE)



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

参数：doc
the parsed SVG document from svgPlot or xmlParse.
svgPlot或xmlParse解析SVG文件。


参数：classNames
names for the newly created styles which will be and which will be used as the values of the class attribute in the nodes
新创建的样式，这将是class属性的值将作为节点名


参数：threshold
a number (or NA) that controls whether to bother  converting the style nodes into CSS entries. The idea is that we will only bother doing the conversion if there is a sufficient number of repeated style values. If all are different, we will have as many CSS rules as there are style nodes and so it may not be worth separating them. This parameter identifies the cut-off point at which we bother to create the CSS entries.  If this is NA, we do the conversion. If this is a number between 0 and 1, we take this as a percentang and if the proportion  the number of unique styles divided by the total number of styles is less than this, we do the conversion. Alternatively, if threshold is an integer greater than 1, we do the conversion if the number of unique styles is greater than this value.  
一个数字（或NA）控制是否打扰转换成CSS项的样式节点。我们的想法是，我们只会懒得做转换，如果有一个足够数量的重复的样式值。如果所有的都不同，我们将有许多的CSS规则，有风格的节点，因此它可能是不值得把它们分开。此参数确定的截止点，在我们费心创建的CSS条目。如果这是NA，我们做转换。如果这是一个介于0和1的数量，我们采取作为percentang，如果这个比例数除以总数的风格独特的风格是低于这一标准，我们做转换。另外，如果threshold是一个大于1的整数，我们独特的风格，如果大于这个值的转换。


参数：add
either a logical value or a character string. This controls whether or how the newly created CSS content is added to the document. If add is a character string, we use this as the name of the CSS file and write the CSS content to that and  add a reference to that CSS file in the SVG document. If add is a logical value and TRUE, we insert the newly generated CSS file directly into the SVG document. If it is FALSE, we do not add the CSS content to the SVG document but just return the new styles as a character vector and allow the caller to use them in whatever she wants.  
无论是逻辑值或一个字符串。这种控制是否或如何在新创建的CSS内容添加到文档中。 add如果是一个字符串，我们使用的CSS文件的名称和写CSS内容，并添加一个引用到SVG文档中的CSS文件。 add如果是一个逻辑值和TRUE，我们插入新生成的CSS文件到SVG文档直接。如果它是FALSE，我们不添加CSS内容的SVG文件，但只返回作为一个特征向量的新风格，并允许呼叫者使用他们不管她想。


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

If add is FALSE, a named character vector giving the newly-created CSS styles. Otherwise, the updated XMLInternalDocument object is returned. If add is a character string, a new file is created with that name and contains the CSS definitions.
add如果是FALSE，给新创建的CSS样式命名的特征向量。否则，更新XMLInternalDocument对象返回。如果add是一个字符串，该名称创建一个新的文件包含CSS定义。


作者（S）----------Author(s)----------


Duncan Temple Lang



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

svgPlot convertCSSStylesToSVG  
svgPlotconvertCSSStylesToSVG


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


d = data.frame(x = runif(100), y = runif(100),
                type = sample(c("A", "B", "C"), 100, replace = TRUE))

doc = svgPlot(plot(y ~ x, d, col = c("red", "green", "blue")[type]))
compressStyles(doc)

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


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