R语言 RSVGTipsDevice包 RSVGTipsDevice.design()函数中文帮助文档(中英文对照)

loveR

RSVGTipsDevice.design(RSVGTipsDevice)
RSVGTipsDevice.design()所属R语言包：RSVGTipsDevice

                                        Design and future of the SVG Graphics Driver with dynamic tips
                                         设计和未来的SVG图形驱动程序与动态提示

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

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

The design of this driver is that it can be used with ordinary R plotting commands.  The extra information needed for tooltips and hyperlinks is supplied by a call to a separate function call before the call to the plotting function that generates the shape. Extra information for only one shape can be supplied this way, so shapes that have tooltips or hyperlinks must be drawn one at a time.
该驱动程序的设计是，它可以使用与普通ŕ绘图命令。提示和超链接需要提供额外的信息，通过调用一个单独的函数调用前调用的绘图功能，生成的形状。这样可以提供额外的信息只有一个形状，所以具有工具提示或超链接的形状必须得出一次一个。


SVG编码风格----------SVG coding style----------

It appears that preferred SVG coding styles have changed over time. The defaults in this driver are those suggested at http://jwatt.org/svg/authoring/.
看来，首选SVG编码风格随着时间的推移发生了变化。该驱动程序中的默认值是这些建议在http://jwatt.org/svg/authoring/的。

In particular:
特别是：

The driver output by default does NOT include a DOCTYPE DTD (it is recommended at http://jwatt.org/svg/authoring/ to NOT include a DOCTYPE declaration.)
默认情况下，不包括驱动器输出一个DOCTYPE DTD（建议在http://jwatt.org/svg/authoring/的不包含一个DOCTYPE声明。）

Use shape properties directly rather than specifying them via style property, e.g., prefer this: <circle fill="red" stroke="blue" ... /> over this: <circle style="fill:red; stroke:blue;" ... />.
使用形状属性，而不是直接通过他们指定的样式属性，例如，喜欢这样的：<circle fill="red" stroke="blue" ... />在这个<circle style="fill:red; stroke:blue;" ... />。

Use "Namespace" aware functions, e.g., getElementsByTagNameNS instead of getElementsByTagName (see also "SVG: Namespace Crash Course" in the references).
使用“命名空间”了解功能，例如，getElementsByTagNameNS，而不是getElementsByTagName（见“SVG：名字空间速成班”中的参考文献）。


限制----------Limitations----------

This driver currently does not have any font metric information, so the use of plotmath is not supported.
该驱动程序目前没有任何字体度量信息的使用plotmath的，所以不支持。

This device will not record tool tips and hyperlinks if it is called by dev.copy - the functions to add tool tips and hyperlinks are ignored by other devices.
该设备将无法录制工具提示和超链接，如果它被称为由dev.copy  - 与其他设备的功能添加工具提示和超链接都将被忽略。


未来发展的可能性----------Future development possibilities----------

Clean up the SVG code that defines the layout of a tool tip (SVG_footer() in src/devSVG.c) - currently the vertical spacing (the 'height' and 'y' attributes) is somewhat ad-hoc (coded by trial and error, and may not work for all font sizes).
清理的SVG代码定义的布局工具提示（SVG_footer()src/devSVG.c） - 目前的垂直间距（高和y属性）有些即席（编码试验和错误，可能并不适用于所有的字体大小）。

Add font metric information to support the use of plotmath.
添加字体度量信息支持使用的plotmath。

Note that SVG uses Unicode characters encoded like &amp;\#x3b1;. The symbols for Unicode are described here: http://www.unicode.org/charts/symbols.html.
需要注意的是SVG使用Unicode字符编码，如&amp;\#x3b1;。对Unicode的符号说明如下：http://www.unicode.org/charts/symbols.html。

SVG allows for definitions of fonts - maybe the right approach is to include a symbol font in the doc when plotmath is used.
SVG可以定义字体 - 也许是正确的做法是包括符号字体中的doc使用时plotmath的。

http://www.w3.org/TR/SVG11/fonts.html


http://www.w3.org/TR/xsl/\#font-model


Clean up the two-line tooltip SVG code: The two-line tooltip mode displays OK in the default SVG renderers in Firefox (under Windows 2000/XP and Linux) but does not display in the Batik standalone SVG viewer.  It probably needs declarations to extend XML elements: http://www.w3.org/TR/SVG/extend.html 23.5 Adding private elements and attributes to the DTD.
两行清理工具提示SVG代码：两行的工具提示模式显示在默认的，SVG渲染器火狐（在Windows 2000/XP和Linux）的确定，但不显示在蜡染独立的SVG浏览器。它可能需要声明的扩展XML元素：http://www.w3.org/TR/SVG/extend.html 23.5添加私人的元素和属性的DTD。

Provide post-processing to use CSS (cascading style sheets) to make SVG files with lots of elements more compact.
提供后处理使用CSS（层叠样式表），有很多的元素更简洁的SVG文件。

The design of how tooltip and URL information is passed to the device is somewhat ugly &ndash; it would be nicer if the basic graphics commands allowed additional optional arguments.  However, they don't, and the scheme implemented here at least works.  It has the advantage that the graphics commands that specify tooltips and URLs will be ignored when other devices are used.  One disadvantage is graphics recording will not record tooltips and URLs.
如何提示和URL信息传递给设备的设计是有点丑陋 - 这将是更好，如果基本的图形命令允许额外的可选参数。然而，他们不实施该计划至少在这里的作品。它的优点是，当其他设备所使用的图形命令，用来指定工具提示和网址都将被忽略。一个缺点是图形记录不会记录工具提示和网址。


参考文献----------References----------

W3C Scalable Vector Graphics (SVG) http://www.w3.org/Graphics/SVG/Overview.htm8

http://developer.mozilla.org/en/docs/SVG\_Namespace\_Tips\_(external)


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

Overview of the RSVGTips device.
的RSVGTips设备概述。

pictex, postscript, Devices.
pictex，postscript，Devices。

Cairo is another device for R that can produce SVG graphics; see http://www.rforge.net/Cairo.  However, it doesn't appear to support tooltips.
Cairo另一个设备的R可以产生SVG图形;参阅http://www.rforge.net/Cairo。但是，它不支持工具提示。

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


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