R quartz macOS 石英设备

说明

quartz 启动 macOS 系统的图形设备驱动程序。它支持绘制到屏幕(默认)和各种图形文件格式。

用法

quartz(title, width, height, pointsize, family, antialias, type,
      file = NULL, bg, canvas, dpi)

quartz.options(..., reset = FALSE)

quartz.save(file, type = "png", device = dev.cur(), dpi = 100, ...)

参数

title	Quartz 窗口的标题(仅适用于屏幕输出)，默认 "Quartz %d" 。整数的 C 样式格式将替换为设备号(有关更多详细信息，请参阅 postscript 的 file 参数)。
width	绘图区域的宽度(以英寸为单位)。默认7。
height	绘图区域的高度(以英寸为单位)。默认7。
pointsize	要使用的默认磅值。默认12。
family	这是设备将使用的字体的家族名称。默认"Arial"。这将是字体的基本名称，如字体簿中所示。
antialias	是否使用抗锯齿。默认TRUE。
type	要使用的输出类型。请参阅“详细信息”了解更多信息。默认"native"。
file	图形设备的可选目标。默认值 NULL 在需要时选择默认名称。请参阅“详细信息”了解更多信息。
bg	用于设备的初始背景颜色。默认"transparent"。支持透明度的 off-screen 类型(例如 "png" 和 "tiff")通常需要不透明颜色，例如 "white" 。
canvas	用于屏幕设备的画布颜色。默认 "white" ，并且将被强制为不透明颜色。
dpi	输出的分辨率。屏幕显示的默认分辨率 ( NA_real_ ) 默认为主屏幕的分辨率，否则为 72 dpi。查看具体信息'。
...	quartz 的任何参数，file 除外。
reset	逻辑：默认值应该重置为默认值吗？
device	要复制的设备号。

细节

quartz 除其中一个参数外的所有参数的默认值均由 quartz.options 设置：“参数”部分提供“factory-fresh”默认值。

Quartz 图形设备支持多种输出类型。屏幕上的输出类型为 "" 或 "native" 或 "Cocoa" 。 Off-screen 输出类型生成输出文件并利用file 参数。 type = "pdf" 提供 PDF 输出。可能支持以下位图格式(取决于操作系统版本)："png" , "jpeg" , "jpg" , "jpeg2000" , "tif" , "tiff" , "gif" , "psd" (Adobe Photoshop)、"bmp"(Windows 位图)、"sgi" 和 "pict" 。

file 参数用于off-screen 绘图。实际文件仅在设备关闭时创建(例如，使用 dev.off() )。对于位图设备，如果字符串中包含 C 整数格式，例如，页码将被替换。 Rplot%03d.png 。 (根据平台的不同，结果应小于 PATH_MAX 个字符长，否则可能会被截断。有关更多详细信息，请参阅 postscript。)如果未提供 file 参数，则默认值为 Rplots.pdf或Rplot%03d.type。波形符扩展(参见path.expand)已完成。

如果设备无关R指定图形字体系列(例如，通过par(family =)在图形包中)，Quartz 设备使用 Quartz 字体数据库(参见quartzFonts) 将 R 图形字体系列转换为 Quartz-specific 字体系列说明。默认转换为(MonoType TrueType 版本)Helvetica为了sans,Times-Roman为了serif和Courier为了mono.

屏幕设备以半透明画布启动。创建新绘图后，首先使用 canvas 颜色绘制画布，然后使用当前背景颜色(可以是透明或半透明)。 Off-screen 设备没有画布颜色，因此尽可能从透明背景开始(例如 type = "png" 和 type = "tiff" ) - 否则，Quartz 代码中会假定纯白色画布。 PNG 和 TIFF 文件以深灰色遮罩保存，该遮罩将显示在某些查看器中，包括 Preview 。

title 可用于屏幕输出。它必须是具有可选整数 printf-style 格式的单个字符串，该格式将被设备编号替换。它还可以选择使用(无格式)为 PDF 文件提供标题。

对于屏幕设备，调用 quartz() 将 .Device 设置为 "quartz"，否则设置为 "quartz_off_screen"。

选择的字体系列需要覆盖要使用的字符：不在字体中的字符将呈现为空的长方形。对于非西欧语言，可能需要除默认值 "Arial" 之外的其他语言 - 对于中文，一个选择是 "MingLiU" 。

quartz.save 是 dev.copy2pdf 的修改版本，用于将绘图从当前屏幕设备复制到 quartz 设备，默认为 PNG 文件。

惯例

本节介绍“R Internals”手册中规定的图形设备约定的实现。

• 默认设备尺寸为 7 平方英寸。

• 字体大小以大点为单位。

• 默认字体系列是 Arial。

• 线宽是 1/96 英寸的倍数，没有最小设置R.

• 圆半径是实数值，没有设置最小值R.

• 颜色指定为 sRGB。

注意

长期以来，默认字体系列被记录为 "Helvetica"，后来为了解决 macOS 10.4 中的缺陷而更改为 "Arial"。将来可能会改返回。

一个相当常见的 Mac 问题是由于系统上的字体损坏或重复而导致绘图上没有文本出现。您可以使用其他字体系列来确认这一点，例如family = "serif" 。打开 Font Book 应用程序(在 Applications 中)并检查您正在使用的字体。

例子

## Not run: 
## Only on a Mac,
## put something like this is your .Rprofile to customize the defaults
setHook(packageEvent("grDevices", "onLoad"),
        function(...) grDevices::quartz.options(width = 8, height = 6,
                                                pointsize = 10))

## End(Not run)

也可以看看

quartzFonts、Devices。

png用于访问该设备的位图类型的方法R的标准位图设备。