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的標準位圖設備。