From f46aa241ef14dff525c184ad6fbb975c2a8f4697 Mon Sep 17 00:00:00 2001
From: nx10 <33600480+nx10@users.noreply.github.com>
Date: Mon, 22 Jan 2024 22:24:36 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20nx10/uni?=
 =?UTF-8?q?gd@54f3481bdf87e5dc32faaebf82a7085d3abc7eed=20=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apple-touch-icon-120x120.png | Bin 11905 -> 11905 bytes
 apple-touch-icon-152x152.png | Bin 17338 -> 17338 bytes
 apple-touch-icon-180x180.png | Bin 22670 -> 22670 bytes
 apple-touch-icon-60x60.png   | Bin 4327 -> 4327 bytes
 apple-touch-icon-76x76.png   | Bin 5975 -> 5975 bytes
 apple-touch-icon.png         | Bin 22670 -> 22670 bytes
 articles/b00_guide.html      |   6 +++---
 favicon-16x16.png            | Bin 1179 -> 1179 bytes
 favicon-32x32.png            | Bin 1893 -> 1893 bytes
 index.html                   |   2 +-
 pkgdown.yml                  |   2 +-
 reference/ugd_save.html      |   6 +++---
 search.json                  |   2 +-
 13 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/apple-touch-icon-120x120.png b/apple-touch-icon-120x120.png
index 749205e00457f72bb5e004ab92203c1d41975de6..e4f2c7238388089dc015fbbcf2850eb11ace138e 100644
GIT binary patch
delta 57
zcmZpSZH%2z!zRIA#d@G+V^e@GzmbWRfw{JUft7*5!N6&ECqL9xLKfS=qn9{YNG~4%
D97_?b

delta 57
zcmZpSZH%2z!^Wf7wrrBl#-;#WenTTGV`FUt11kdq{oKXblOO6TA&bQsNMD~Uq?Zo>
D51tV-

diff --git a/apple-touch-icon-152x152.png b/apple-touch-icon-152x152.png
index c3ff89e3e969f0ce735ca64628174fda1558ce1c..f63821d788a6b2b136d58511aae079ec212a3d33 100644
GIT binary patch
delta 59
zcmdnh&bX_caY7B71n1nnZ<{wZbvp4InOGTEY8x0>85m5=d)qKs%2^3n?16Ep&17%q
Fd;of56RZFL

delta 59
zcmdnh&bX_caY79nk8;L}&kP%zI-U3pjjW7KwG9lc3=DksP79nY<*bA(X8S<z?PPD~
Fd;m@R69WJM

diff --git a/apple-touch-icon-180x180.png b/apple-touch-icon-180x180.png
index c80abe79c5dc52cb05bc9816c097d17f69ef4391..2cb9fb338b779375ac7c7970aa58dba31adf4035 100644
GIT binary patch
delta 59
zcmeC%$k?}$aY7B71Q*MeJ(e4rV#E23OsotIv<(cb3=B@htT;RQUAPjm*iJ@)!pZUx
F`2ba_68ZoD

delta 59
zcmeC%$k?}$aY79nkIJ_*X^S^D#fI}68d({eX&V?=85q=t_MDmgE?fy&jEBRdV6uEf
FJ^+2@6FvX{

diff --git a/apple-touch-icon-60x60.png b/apple-touch-icon-60x60.png
index 8258b05744ffe8668a7425e7859159e0ae1b834b..3f922ba92ea774ed39fb0f706c0433cb95889654 100644
GIT binary patch
delta 57
zcmaE^_*`*94VwhZW1fk28=JQA^Bb918JK7r7+4t?eAwCJFxg!|30bW1iOHYI6$1GH
DG9eQM

delta 57
zcmaE^_*`*94I7V~!GZmP8=JQA^BWpj85?LD7+4t?$hGeLHrZW330W-v2BX*H3W0n8
DC>Rmv

diff --git a/apple-touch-icon-76x76.png b/apple-touch-icon-76x76.png
index 57a26c8f528805dfd1829853915c7272714c54da..fc303ed9a525b49b9956565d23efe40680336a2f 100644
GIT binary patch
delta 57
zcmcbvcU^Bn4Vwh(6z+v9Ha4k=@f(>~8JKDt7+4t?gq>^uGI_h060(^3WP6XvFU0Zz
DCo~de

delta 57
zcmcbvcU^Bn4I7Wb$Ayb_ZER8#<2N+2GB(mSFt9Q(=#*M<fAV%QC1kN5?gGh^Ux?)c
E08x7rZ~y=R

diff --git a/apple-touch-icon.png b/apple-touch-icon.png
index 4c6d294503019e37a999a0c8336dfce594162734..05f978c64f78e12e3b0ed20c30424ff23d76f83c 100644
GIT binary patch
delta 59
zcmeC%$k?}$aY7B71kc;+k~|xmV#E23Osouzv<(cb3=HBA?|d@(UAPjmnBF|bh{^I1
F`2c0m6HEXA

delta 59
zcmeC%$k?}$aY79nkDA0G_Wq4cvElrNMpnia+6D$z1_ruW-zQFf7p{aX7Gv(OJ6S#=
F9{@m35;Xt-

diff --git a/articles/b00_guide.html b/articles/b00_guide.html
index e2aca09..3ba6f9e 100644
--- a/articles/b00_guide.html
+++ b/articles/b00_guide.html
@@ -103,7 +103,7 @@ <h2 id="plot-rendering-in-base-r">Plot rendering in base R<a class="anchor" aria
 <span><span class="fu"><a href="https://rdrr.io/r/grDevices/png.html" class="external-link">png</a></span><span class="op">(</span>file<span class="op">=</span><span class="st">"my_plot1.png"</span>, width<span class="op">=</span><span class="fl">600</span>, height<span class="op">=</span><span class="fl">400</span><span class="op">)</span> <span class="co"># (1) Start the 'png' device</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/graphics/hist.html" class="external-link">hist</a></span><span class="op">(</span><span class="va">temp</span>, col<span class="op">=</span><span class="st">"darkblue"</span><span class="op">)</span>                      <span class="co"># (2) Plot a histogram</span></span>
 <span><span class="fu"><a href="https://rdrr.io/r/grDevices/dev.html" class="external-link">dev.off</a></span><span class="op">(</span><span class="op">)</span>                                       <span class="co"># (3) Close the device</span></span></code></pre></div>
-<p>Note that this has some unfortunate contstraints:</p>
+<p>Note that this has some unfortunate constraints:</p>
 <ul>
 <li>Rendering information must be specified <em>before</em> the plot is
 created
@@ -177,7 +177,7 @@ <h2 id="in-memory-render-access">In-memory render access<a class="anchor" aria-l
 <p>For some applications, you might want to access the rendered data
 directly. Example use-cases for this might be report generation, web
 services or interactive applications. While you can most likely think of
-work-arounds for this issue, this <code>unigd</code> feature will
+workarounds for this issue, this <code>unigd</code> feature will
 certainly lower code complexity and increase performance.</p>
 <p>Rendering in-memory is done by simply calling
 <code>ugd_render(...)</code> instead of <code>ugd_save(...)</code>:</p>
@@ -307,7 +307,7 @@ <h3 id="special-renderers">(Special) renderers<a class="anchor" aria-label="anch
 <code>"strings"</code>-renderer
 <ul>
 <li>All text elements inside a plot</li>
-<li>Linebreak seperated plain text format</li>
+<li>Linebreak separated plain text format</li>
 <li>Could be used to e.g. ‘search’ through plots</li>
 </ul>
 </li>
diff --git a/favicon-16x16.png b/favicon-16x16.png
index c8c7ad33a6cf06b8821105b7527a4ccd690289ff..7105ff812a6c4184c94c5dbab93f732f95c9746b 100644
GIT binary patch
delta 59
zcmbQuIh%9CJ|;E^;e`7lKQ|v?(qQB_GO;qW)HX1%GBAie@>Xv0Z)PQAF`b#Aize%^
G<O2XRKoTJU

delta 59
zcmbQuIh%9CJ|;FE-F|_4?3<4;X)y8|8d;f`Y8x0>85p=#%=ei5n^_52%v@Fd%VZsv
Fd;kDD5R(7^

diff --git a/favicon-32x32.png b/favicon-32x32.png
index 2ed84558e0eb65854f4d61ab52abe1ec53526d00..25a5bbdd5fe0fdcb26a87f1ce6eff1ade8e731f7 100644
GIT binary patch
delta 57
zcmaFL_mpo!4V#3>zuk>d8=Fkn_>D}gj106546F<c+%B)zn|zc_30cg%PkhqkZ*2Jh
DGNTf7

delta 57
zcmaFL_mpo!4I7W1m}LLnjZG$O{DwwWCT7|O237_J<r7-3PCm+}ge=B();4qUH@18L
D3wjah

diff --git a/index.html b/index.html
index 41769df..28eb7f3 100644
--- a/index.html
+++ b/index.html
@@ -115,7 +115,7 @@ <h2 id="getting-started">Getting started<a class="anchor" aria-label="anchor" hr
 <div class="section level2">
 <h2 id="contributions-welcome">Contributions welcome!<a class="anchor" aria-label="anchor" href="#contributions-welcome"></a>
 </h2>
-<p><code>unigd</code> is mostly written in C++, but contributions to the tests (in R) or the documentatation are also always welcome!</p>
+<p><code>unigd</code> is mostly written in C++, but contributions to the tests (in R) or the documentation are also always welcome!</p>
 </div>
 <div class="section level2">
 <h2 id="about--license">About &amp; License<a class="anchor" aria-label="anchor" href="#about--license"></a>
diff --git a/pkgdown.yml b/pkgdown.yml
index 856b496..3cb4301 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -4,7 +4,7 @@ pkgdown_sha: ~
 articles:
   a00_installation: a00_installation.html
   b00_guide: b00_guide.html
-last_built: 2024-01-22T22:12Z
+last_built: 2024-01-22T22:24Z
 urls:
   reference: https://nx10.github.io/unigd/reference
   article: https://nx10.github.io/unigd/articles
diff --git a/reference/ugd_save.html b/reference/ugd_save.html
index 4c03f9e..8f61be1 100644
--- a/reference/ugd_save.html
+++ b/reference/ugd_save.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
-<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><meta name="description" content="See ugd_render() for acessing plot data directly in memory without
+<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><meta name="description" content="See ugd_render() for accessing plot data directly in memory without
 saving as a file.
-This function will only work after starting a device with ugd()."><title>Render unigd plot to a file. — ugd_save • unigd</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous"><!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="Render unigd plot to a file. — ugd_save"><meta property="og:description" content="See ugd_render() for acessing plot data directly in memory without
+This function will only work after starting a device with ugd()."><title>Render unigd plot to a file. — ugd_save • unigd</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous"><!-- bootstrap-toc --><script src="https://cdn.jsdelivr.net/gh/afeld/bootstrap-toc@v1.0.1/dist/bootstrap-toc.min.js" integrity="sha256-4veVQbu7//Lk5TSmc7YV48MxtMy98e26cf5MrgZYnwo=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- search --><script src="https://cdnjs.cloudflare.com/ajax/libs/fuse.js/6.4.6/fuse.js" integrity="sha512-zv6Ywkjyktsohkbp9bb45V6tEMoWhzFzXis+LrMehmJZZSys19Yxf1dopHx7WzIKxr5tK2dVcYmaCk2uqdjF4A==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/autocomplete.js/0.38.0/autocomplete.jquery.min.js" integrity="sha512-GU9ayf+66Xx2TmpxqJpliWbT5PiGYxpaG8rfnBEk1LL8l1KGkRShhngwdXK1UgqhAzWpZHSiYPc09/NwDQIGyg==" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mark.js/8.11.1/mark.min.js" integrity="sha512-5CYOlHXGh6QpOFA/TeTylKLWfB3ftPsde7AnmhuitiTX4K5SqCLBeKro6sPS8ilsz1Q4NRx3v8Ko2IBiszzdww==" crossorigin="anonymous"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="Render unigd plot to a file. — ugd_save"><meta property="og:description" content="See ugd_render() for accessing plot data directly in memory without
 saving as a file.
 This function will only work after starting a device with ugd()."><meta property="og:image" content="https://nx10.github.io/unigd/logo.png"><!-- mathjax --><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script><!--[if lt IE 9]>
 <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
@@ -57,7 +57,7 @@
     </div>
 
     <div class="ref-description section level2">
-    <p>See <code><a href="ugd_render.html">ugd_render()</a></code> for acessing plot data directly in memory without
+    <p>See <code><a href="ugd_render.html">ugd_render()</a></code> for accessing plot data directly in memory without
 saving as a file.
 This function will only work after starting a device with <code><a href="ugd.html">ugd()</a></code>.</p>
     </div>
diff --git a/search.json b/search.json
index 9686e95..1e61805 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"system-requirements","dir":"Articles","previous_headings":"","what":"System requirements","title":"Installation","text":"libpng X11 required unix like systems (e.g. Linux, macOS). Cairo optional unix like systems enable PNG, PDF, EPS PS renderers. libtiff required unix like systems enable TIFF renderers.","code":""},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"macos","dir":"Articles","previous_headings":"System requirements","what":"macOS","title":"Installation","text":"libpng missing install via: X11 missing error message include text: Install XQuartz. (see: https://github.com/r-lib/systemfonts/issues/17)","code":"brew install libpng unable to load shared object [...] systemfonts/libs/systemfonts.so [...]"},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"linux","dir":"Articles","previous_headings":"System requirements","what":"Linux","title":"Installation","text":"source installation Linux, fontconfig freetype2 library required install systemfonts package, dependency unigd.","code":""},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"debian-ubuntu-etc-","dir":"Articles","previous_headings":"System requirements > Linux","what":"Debian, Ubuntu, etc.","title":"Installation","text":"","code":"apt install libfontconfig1-dev"},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"fedora-centos-rhel-etc-","dir":"Articles","previous_headings":"System requirements > Linux","what":"Fedora, CentOS, RHEL, etc.","title":"Installation","text":"","code":"dnf install fontconfig-devel"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"plot-rendering-in-base-r","dir":"Articles","previous_headings":"","what":"Plot rendering in base R","title":"Plotting with unigd","text":"Rendering plot base R done (1) starting graphics device, (2) calling plot functions subsequently (3) closing device: Note unfortunate contstraints: File format (png(), pdf(), svg(), …) Filepath (.e.: file=\"my_plot1.png\") Dimensions (.e.: width=600, height=400) …multiple formats. …multiple dimensions. easy way access plotting data without writing file first. Closing device dev.() must called every time. unigd solves issues employing different graphics device architecture.","code":"temp <- airquality$Temp                         # Fetch some data  png(file=\"my_plot1.png\", width=600, height=400) # (1) Start the 'png' device hist(temp, col=\"darkblue\")                      # (2) Plot a histogram dev.off()                                       # (3) Close the device"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"plot-rendering-with-unigd","dir":"Articles","previous_headings":"","what":"Plot rendering with unigd","title":"Plotting with unigd","text":"Let’s see render can created using unigd: Notice rendering explicit instruction plotting using unigd. way can also render plot multiple formats /dimensions: Starting closing device can cumbersome, especially plotting code aborts error leaves device open. reason unigd comes set functions called ugd_*_inline: Plotting way keeps create close device manually. Depending personal preference may also considered ‘readable’ code. can obtain full list included renderers ugd_renderers(). (’s growing every unigd update!) next section illustrate access render data directly without create file.","code":"library(unigd) temp <- airquality$Temp                              # Fetch some data  ugd()                                                # (1) Start the 'ugd' device hist(temp, col=\"darkblue\")                           # (2) Plot a histogram ugd_save(file=\"my_plot1.png\", width=600, height=400) # Render 600*400 PNG file dev.off()                                            # (3) Close the device # ... hist(temp, col=\"darkblue\") ugd_save(file=\"my_plot1.png\", width=600, height=400) # Render 600*400 PNG file ugd_save(file=\"my_plot2.pdf\", width=300, height=300) # Render 300*300 PDF file # ... library(unigd) temp <- airquality$Temp # Fetch some data  ugd_save_inline({   hist(temp, col=\"darkblue\") }, file=\"my_plot1.png\", width=600, height=400)"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"in-memory-render-access","dir":"Articles","previous_headings":"","what":"In-memory render access","title":"Plotting with unigd","text":"applications, might want access rendered data directly. Example use-cases might report generation, web services interactive applications. can likely think work-arounds issue, unigd feature certainly lower code complexity increase performance. Rendering -memory done simply calling ugd_render(...) instead ugd_save(...): course also inline function :","code":"temp <- airquality$Temp  ugd() hist(temp, col=\"darkblue\") my_svg <- ugd_render(as=\"svg\") dev.off()  cat(my_svg) # Print the SVG as a string temp <- airquality$Temp  my_svg <- ugd_render_inline({   hist(temp, col=\"darkblue\") }, as=\"svg\")  cat(my_svg) # Print the SVG as a string"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"more-unigd-features","dir":"Articles","previous_headings":"","what":"More unigd features","title":"Plotting with unigd","text":"unigd offers number features go beyond base R graphics devices.","code":""},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"zoom","dir":"Articles","previous_headings":"More unigd features","what":"Zoom","title":"Plotting with unigd","text":"rendering function unigd offer zoom parameter. parameter can used increase (decrease) size objects inside plot (independently plot dimensions). example zoom=2 increase size objects 200%, zoom=0.5 decrease 50%.","code":"my_svg_1_0 <- ugd_render_inline({   hist(temp, col=\"darkblue\", main = \"Zoom 1.0\") }, as=\"png-base64\", width=300, height=300, zoom=1.0)  my_svg_1_5 <- ugd_render_inline({   hist(temp, col=\"darkblue\", main = \"Zoom 1.5\") }, as=\"png-base64\", width=300, height=300, zoom=1.5)  my_svg_0_5 <- ugd_render_inline({   hist(temp, col=\"darkblue\", main = \"Zoom 0.5\") }, as=\"png-base64\", width=300, height=300, zoom=0.5)  # (Output directly in this RMarkdown document) knitr::raw_html(paste0(sprintf(\"<img src=\\\"%s\\\" />\", c(my_svg_1_0, my_svg_1_5, my_svg_0_5))))"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"paging-by-index","dir":"Articles","previous_headings":"More unigd features","what":"Paging (by index)","title":"Plotting with unigd","text":"page parameter lets select plot history rendered. default set 0 use last created plot. Set number ≥ 1 select plot ’s index (oldest first). Use numbers ≤ 0 select plots newest-first: Note plots can deleted history way: Instead keeping track plot index, might change plots added removed, static plot IDs can obtained.","code":"ugd() for (i in 1:10) {   plot(1, main=paste0(\"Plot #\", i)) }  ugd_save(file=\"plot.png\", page = 3)  # Plot #3 ugd_save(file=\"plot.png\")            # Plot #10 ugd_save(file=\"plot.png\", page = -1) # Plot #9  dev.off() # ... ugd_remove()          # Remove last ugd_remove(page = -1) # Remove second-to-last ugd_clear()           # Remove all # ..."},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"plot-ids","dir":"Articles","previous_headings":"More unigd features","what":"Plot IDs","title":"Plotting with unigd","text":"want render plot later point without keep track index, can obtain ID point ’s creation. following example extensively demonstrates can used: Note typical use-case much simpler, just getting last ID plot calling ugd_id() subsequently.","code":"ugd()  plot(rnorm(50))           # A  first_plot_id <- ugd_id() # Get last ID (A at this point)  hist(rnorm(50))           # B  plot(sin((1:100)/3))      # C  other_id <- ugd_id(-1)    # Get the second-to-last ID (B at this point)  hist(runif(100))          # D  ugd_remove(3)             # Remove 3rd plot (C)  first_again <- ugd_id(1)  # Get the first ID (A)  ugd_save(file=\"plot_1.png\", page = first_plot_id) ugd_save(file=\"plot_2.png\", page = other_id) ugd_save(file=\"plot_3.png\", page = first_again)  dev.off()"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"special-renderers","dir":"Articles","previous_headings":"More unigd features","what":"(Special) renderers","title":"Plotting with unigd","text":"unigd also ships number ‘special’ renderers. guide go much detail topic noteworthy mentions: text elements inside plot Linebreak seperated plain text format used e.g. ‘search’ plots Meta information plot Guaranteed render time O(1) regardless number objects Includes complexity (number draw calls clipping planes) JSON format Contains information unigd one plot JSON format","code":""},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"performance-considerations","dir":"Articles","previous_headings":"","what":"Performance considerations","title":"Plotting with unigd","text":"unigd aims provide best performance case, considerations can make optimizing graphics rendering. point mentioned user applications readability prioritized performance , unless graphics rendering bottlenecking R script, can likely ignore section good conscience. optimizing rendering code, fundamental understand cases unigd needs call R graphics engine let plot re-drawn: Rendering done drawing. last drawn dimensions plot cached. can derive simple rules : Rendering plot different formats: Fast. Rendering plot different dimensions: Slow(er). means ordering rendering calls result faster execution: , unigd gives choice specifying render dimension plotting, can hint device creation time achieve best performance: dimensions omitted calling rendering functions, last known dimensions used rendering guaranteed fast: use ugd_*_inline functions also guaranteed fast. Note width height also interact zoom parameter. (.e.: Cached width = width / zoom).","code":"# SLOWER: ugd_save(file=\"my_plot1.png\", width=600, height=400) ugd_save(file=\"my_plot2.pdf\", width=300, height=300) # re-draw 1 ugd_save(file=\"my_plot3.pdf\", width=600, height=400) # re-draw 2  # FASTER: ugd_save(file=\"my_plot1.png\", width=600, height=400) ugd_save(file=\"my_plot3.pdf\", width=600, height=400) ugd_save(file=\"my_plot2.pdf\", width=300, height=300) # re-draw 1 # SLOWER: ugd() # default dimensions: 720 * 576 # ... ugd_save(file=\"my_plot1.png\", width=300, height=300) # re-draw  # FASTER: ugd(width=300, height=300) # ... ugd_save(file=\"my_plot1.png\", width=300, height=300) ugd_save(file=\"my_plot1.png\")"},{"path":"https://nx10.github.io/unigd/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Florian Rupprecht. Author, maintainer. Kun Ren. Contributor. Jeroen Ooms. Contributor. Hadley Wickham. Copyright holder.            Author included svglite code Lionel Henry. Copyright holder.            Author included svglite code Thomas Lin Pedersen. Copyright holder.            Author creator included svglite code T Jake Luciani. Copyright holder.            Author included svglite code Matthieu Decorde. Copyright holder.            Author included svglite code Vaudor Lise. Copyright holder.            Author included svglite code Tony Plate. Copyright holder.            Contributor included svglite code David Gohel. Copyright holder.            Contributor included svglite code Yixuan Qiu. Copyright holder.            Contributor included svglite code Håkon Malmedal. Copyright holder.            Contributor included svglite code RStudio. Copyright holder.            Copyright holder included svglite code Brett Robinson. Copyright holder.            Author included belle library Google. Copyright holder.            Copyright holder included material design icons Victor Zverovich. Copyright holder.            Author included fmt library Andrzej Krzemienski. Copyright holder.            Author included std::experimental::optional library","code":""},{"path":"https://nx10.github.io/unigd/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Rupprecht F (2024). unigd: Universal Graphics Device. R package version 0.1.0.9000,  https://nx10.github.io/unigd/, https://github.com/nx10/unigd.","code":"@Manual{,   title = {unigd: Universal Graphics Device},   author = {Florian Rupprecht},   year = {2024},   note = {R package version 0.1.0.9000,  https://nx10.github.io/unigd/},   url = {https://github.com/nx10/unigd}, }"},{"path":"https://nx10.github.io/unigd/index.html","id":"unigd-","dir":"","previous_headings":"","what":"Universal Graphics Device","title":"Universal Graphics Device","text":"unified R graphics backend. Render R graphics fast easy many common file formats. package provides thread-safe interface power interactive graphics clients httpgd.","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"features","dir":"","previous_headings":"","what":"Features","title":"Universal Graphics Device","text":"Fast plotting Plot resizing history Render various image formats (SVG, PNG, PDF, EPS, …) -memory access rendered graphics Platform independent Stateless thread-safe C client API package developers","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Universal Graphics Device","text":"can install development version unigd GitHub : See system requirements troubleshooting.","code":"# install.packages(\"remotes\") remotes::install_github(\"nx10/unigd\")"},{"path":"https://nx10.github.io/unigd/index.html","id":"getting-started","dir":"","previous_headings":"","what":"Getting started","title":"Universal Graphics Device","text":"See guide details.","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"contributions-welcome","dir":"","previous_headings":"","what":"Contributions welcome!","title":"Universal Graphics Device","text":"unigd mostly written C++, contributions tests (R) documentatation also always welcome!","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"about--license","dir":"","previous_headings":"","what":"About & License","title":"Universal Graphics Device","text":"Depends cpp11 systemfonts. Much font handling SVG rendering code modified code excellent svglite package. project licensed GPL v2.0. includes parts svglite (GPL ≥ 2) fmt (MIT). Full copies license agreements used components included ./inst/licenses.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":null,"dir":"Reference","previous_headings":"","what":"A unified R graphics backend. — ugd","title":"A unified R graphics backend. — ugd","text":"function initializes unigd graphics device.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"A unified R graphics backend. — ugd","text":"","code":"ugd(   width = getOption(\"unigd.width\", 720),   height = getOption(\"unigd.height\", 576),   bg = getOption(\"unigd.bg\", \"white\"),   pointsize = getOption(\"unigd.pointsize\", 12),   system_fonts = getOption(\"unigd.system_fonts\", list()),   user_fonts = getOption(\"unigd.user_fonts\", list()),   reset_par = getOption(\"unigd.reset_par\", FALSE) )"},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"A unified R graphics backend. — ugd","text":"width Graphics device width (pixels). height Graphics device height (pixels). bg Background color. pointsize Graphics device point size. system_fonts Named list font names aliased fonts installed system. unspecified, R default families sans, serif, mono symbol aliased family returned systemfonts::font_info(). user_fonts Named list fonts aliased font files provided user rather fonts properly installed system. aliases can fonts fontquiver package, strings containing path font file, list containing name file elements name indicating font alias SVG output file path font file. reset_par set TRUE, global graphics parameters saved device start reset every time ugd_clear() called (see graphics::par()).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"A unified R graphics backend. — ugd","text":"return value, called initialize graphics device.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"A unified R graphics backend. — ugd","text":"font settings descriptions adopted excellent 'svglite' package.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"A unified R graphics backend. — ugd","text":"","code":"if (FALSE) {  ugd() # Initialize graphics device and start server ugd_browse() # Or copy the displayed link in the browser  # Plot something x <- seq(0, 3 * pi, by = 0.1) plot(x, sin(x), type = \"l\")  dev.off() # alternatively: ugd_close() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":null,"dir":"Reference","previous_headings":"","what":"Clear all unigd plot pages. — ugd_clear","title":"Clear all unigd plot pages. — ugd_clear","text":"function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clear all unigd plot pages. — ugd_clear","text":"","code":"ugd_clear(which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clear all unigd plot pages. — ugd_clear","text":"device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Clear all unigd plot pages. — ugd_clear","text":"Whether pages remove.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Clear all unigd plot pages. — ugd_clear","text":"","code":"if (FALSE) {  ugd() plot(1, 1) hist(rnorm(100)) ugd_clear() hist(rnorm(100))  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":null,"dir":"Reference","previous_headings":"","what":"Close unigd device. — ugd_close","title":"Close unigd device. — ugd_close","text":"achieves effect grDevices::dev.(), close device unigd type.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Close unigd device. — ugd_close","text":"","code":"ugd_close(which = dev.cur(), all = FALSE)"},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Close unigd device. — ugd_close","text":"device (ID). running unigd devices closed.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Close unigd device. — ugd_close","text":"Number name new active device (specified device shut ).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Close unigd device. — ugd_close","text":"","code":"if (FALSE) {  ugd() ugd_browse() # open browser hist(rnorm(100)) ugd_close() # Equvalent to dev.off()  ugd() ugd() ugd() ugd_close(all = TRUE) }"},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":null,"dir":"Reference","previous_headings":"","what":"Query unigd plot IDs — ugd_id","title":"Query unigd plot IDs — ugd_id","text":"Query unigd graphics device static plot IDs. Available plot IDs starting index returned. limit specifies number plots. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query unigd plot IDs — ugd_id","text":"","code":"ugd_id(index = 0, limit = 1, which = dev.cur(), state = FALSE)"},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query unigd plot IDs — ugd_id","text":"index Plot index. set 0, last page selected. limit Limit number returned IDs. set value > 1 returned type list IDs. Set 0 . device (ID). state Include current device state returned result (see also: ugd_state()).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query unigd plot IDs — ugd_id","text":"TODO","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query unigd plot IDs — ugd_id","text":"","code":"if (FALSE) {  ugd() plot.new() text(.5, .5, \"#1\") plot.new() text(.5, .5, \"#2\") plot.new() text(.5, .5, \"#3\") third <- ugd_id() second <- ugd_id(2) all <- ugd_id(1, limit = Inf) ugd_remove(1) ugd_plot(second)  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd device information. — ugd_info","title":"unigd device information. — ugd_info","text":"Access general information unigd graphics device. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unigd device information. — ugd_info","text":"","code":"ugd_info(which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"unigd device information. — ugd_info","text":"device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unigd device information. — ugd_info","text":"List status variables following named items: $id: Server unique ID, $version: unigd library versions.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"unigd device information. — ugd_info","text":"","code":"if (FALSE) {  ugd() ugd_info()  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":null,"dir":"Reference","previous_headings":"","what":"Remove a unigd plot page. — ugd_remove","title":"Remove a unigd plot page. — ugd_remove","text":"function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Remove a unigd plot page. — ugd_remove","text":"","code":"ugd_remove(page = 0, which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Remove a unigd plot page. — ugd_remove","text":"page Plot page remove. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Remove a unigd plot page. — ugd_remove","text":"Whether page existed (thereby successfully removed).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Remove a unigd plot page. — ugd_remove","text":"","code":"if (FALSE) {  ugd() plot(1, 1) # page 1 hist(rnorm(100)) # page 2 ugd_remove(page = 1) # remove page 1  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":null,"dir":"Reference","previous_headings":"","what":"Render unigd plot and return it. — ugd_render","title":"Render unigd plot and return it. — ugd_render","text":"See ugd_save() saving rendered plots files. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Render unigd plot and return it. — ugd_render","text":"","code":"ugd_render(   page = 0,   width = -1,   height = -1,   zoom = 1,   as = \"svg\",   which = dev.cur() )"},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Render unigd plot and return it. — ugd_render","text":"page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. set -1, last width selected. height Height plot. set -1, last height selected. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Render unigd plot and return it. — ugd_render","text":"Rendered plot. Text renderers return strings, binary renderers return byte arrays.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Render unigd plot and return it. — ugd_render","text":"","code":"if (FALSE) {  ugd() plot(1, 1) ugd_render(width = 600, height = 400, as = \"svg\")  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":null,"dir":"Reference","previous_headings":"","what":"Inline plot rendering. — ugd_render_inline","title":"Inline plot rendering. — ugd_render_inline","text":"Convenience function quick inline plot rendering. similar ugd_render() plotting code specified inline unigd graphics device managed (created closed) automatically. Starting device ugd() therefore necessary.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Inline plot rendering. — ugd_render_inline","text":"","code":"ugd_render_inline(   code,   page = 0,   width = getOption(\"unigd.width\", 720),   height = getOption(\"unigd.height\", 576),   zoom = 1,   as = \"svg\",   ... )"},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Inline plot rendering. — ugd_render_inline","text":"code Plotting code. See examples information. page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. height Height plot. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. ... Additional parameters passed ugd(...)","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Inline plot rendering. — ugd_render_inline","text":"Rendered plot. Text renderers return strings, binary renderers return byte arrays.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Inline plot rendering. — ugd_render_inline","text":"","code":"if (FALSE) {  ugd_render_inline({   hist(rnorm(100)) }, as = \"svgz\")  s <- ugd_render_inline({   plot.new()   lines(c(0.5, 1, 0.5), c(0.5, 1, 1)) }) cat(s) }"},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd device renderers. — ugd_renderers","title":"unigd device renderers. — ugd_renderers","text":"Get list available renderers. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unigd device renderers. — ugd_renderers","text":"","code":"ugd_renderers()"},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unigd device renderers. — ugd_renderers","text":"List renderers following named items: $id: Renderer ID, $mime: File mime type, $ext: File extension, $name: Human readable name, $type: Renderer type (currently either plot ), $bin: file binary blob text.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"unigd device renderers. — ugd_renderers","text":"","code":"ugd_renderers() #>            id                   mime   ext          name type  text #> 1  png-base64             text/plain  .txt    Base64 PNG plot  TRUE #> 2         png              image/png  .png           PNG plot FALSE #> 3         eps application/postscript  .eps           EPS plot  TRUE #> 4          ps application/postscript   .ps            PS plot  TRUE #> 5       svgzp          image/svg+xml .svgz Portable SVGZ plot FALSE #> 6        svgz          image/svg+xml .svgz          SVGZ plot FALSE #> 7        meta       application/json .json          Meta data  TRUE #> 8     strings             text/plain  .txt       Strings data  TRUE #> 9         pdf        application/pdf  .pdf           PDF plot FALSE #> 10       tikz             text/plain  .tex          TikZ plot  TRUE #> 11       json       application/json .json          JSON plot  TRUE #> 12       svgp          image/svg+xml  .svg  Portable SVG plot  TRUE #> 13        svg          image/svg+xml  .svg           SVG plot  TRUE #>                                                        descr #> 1            Base64 encoded Portable Network Graphics (PNG). #> 2                           Portable Network Graphics (PNG). #> 3                             Encapsulated PostScript (EPS). #> 4                                           PostScript (PS). #> 5  Version of the SVG renderer that produces portable SVGZs. #> 6                Compressed Scalable Vector Graphics (SVGZ). #> 7                                     Plot meta information. #> 8                         List of strings contained in plot. #> 9                      Adobe Portable Document Format (PDF). #> 10                                          LaTeX TikZ code. #> 11                      Plot data serialized to JSON format. #> 12  Version of the SVG renderer that produces portable SVGs. #> 13                           Scalable Vector Graphics (SVG)."},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":null,"dir":"Reference","previous_headings":"","what":"Render unigd plot to a file. — ugd_save","title":"Render unigd plot to a file. — ugd_save","text":"See ugd_render() acessing plot data directly memory without saving file. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Render unigd plot to a file. — ugd_save","text":"","code":"ugd_save(   file,   page = 0,   width = -1,   height = -1,   zoom = 1,   as = \"auto\",   which = dev.cur() )"},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Render unigd plot to a file. — ugd_save","text":"file Filepath save plot. page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. set -1, last width selected. height Height plot. set -1, last height selected. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. set \"auto\" renderer inferred file extension. device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Render unigd plot to a file. — ugd_save","text":"Rendered SVG string.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Render unigd plot to a file. — ugd_save","text":"","code":"if (FALSE) {  ugd() plot(1, 1) ugd_save(file = tempfile(), width = 600, height = 400, as = \"png\")  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":null,"dir":"Reference","previous_headings":"","what":"Inline plot rendering to a file. — ugd_save_inline","title":"Inline plot rendering to a file. — ugd_save_inline","text":"Convenience function quick inline plot rendering. similar ugd_save() plotting code specified inline unigd graphics device managed (created closed) automatically. Starting device ugd() therefore necessary.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Inline plot rendering to a file. — ugd_save_inline","text":"","code":"ugd_save_inline(   code,   file,   page = 0,   width = getOption(\"unigd.width\", 720),   height = getOption(\"unigd.height\", 576),   zoom = 1,   as = \"auto\",   ... )"},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Inline plot rendering to a file. — ugd_save_inline","text":"code Plotting code. See examples information. file Filepath save plot. page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. height Height plot. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. ... Additional parameters passed ugd(...)","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Inline plot rendering to a file. — ugd_save_inline","text":"","code":"if (FALSE) {  ugd_save_inline({   plot.new()   lines(c(0.5, 1, 0.5), c(0.5, 1, 1)) }, file = \"plot.svg\") }"},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd device status. — ugd_state","title":"unigd device status. — ugd_state","text":"Access status information unigd graphics device. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unigd device status. — ugd_state","text":"","code":"ugd_state(which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"unigd device status. — ugd_state","text":"device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unigd device status. — ugd_state","text":"List status variables following named items: $hsize: Plot history size (many plots accessible), $upid: Update ID (changes device received new information), $active: device currently activated device.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"unigd device status. — ugd_state","text":"","code":"if (FALSE) {  ugd() ugd_state() plot(1, 1) ugd_state()  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_test_pattern.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","title":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","text":"Plot test pattern can used evaluate compare graphics devices.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_test_pattern.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","text":"","code":"ugd_test_pattern()"},{"path":"https://nx10.github.io/unigd/reference/ugd_test_pattern.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","text":"","code":"if (FALSE) {  ugd_test_pattern() }"},{"path":"https://nx10.github.io/unigd/reference/unigd-package.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd: Universal graphics device — unigd-package","title":"unigd: Universal graphics device — unigd-package","text":"Universal graphics device","code":""},{"path":[]},{"path":"https://nx10.github.io/unigd/reference/unigd-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"unigd: Universal graphics device — unigd-package","text":"Maintainer: Florian Rupprecht floruppr@gmail.com (ORCID) contributors: Kun Ren mail@renkun.[contributor] Jeroen Ooms jeroen@berkeley.edu (ORCID) [contributor] Hadley Wickham hadley@rstudio.com (Author included svglite code) [copyright holder] Lionel Henry lionel@rstudio.com (Author included svglite code) [copyright holder] Thomas Lin Pedersen thomas.pedersen@rstudio.com (Author creator included svglite code) [copyright holder] T Jake Luciani jake@apache.org (Author included svglite code) [copyright holder] Matthieu Decorde matthieu.decorde@ens-lyon.fr (Author included svglite code) [copyright holder] Vaudor Lise lise.vaudor@ens-lyon.fr (Author included svglite code) [copyright holder] Tony Plate (Contributor included svglite code) [copyright holder] David Gohel (Contributor included svglite code) [copyright holder] Yixuan Qiu (Contributor included svglite code) [copyright holder] Håkon Malmedal (Contributor included svglite code) [copyright holder] RStudio (Copyright holder included svglite code) [copyright holder] Brett Robinson (Author included belle library) [copyright holder] Google (Copyright holder included material design icons) [copyright holder] Victor Zverovich (Author included fmt library) [copyright holder] Andrzej Krzemienski (Author included std::experimental::optional library) [copyright holder]","code":""},{"path":"https://nx10.github.io/unigd/news/index.html","id":"unigd-0109000","dir":"Changelog","previous_headings":"","what":"unigd 0.1.0.9000","title":"unigd 0.1.0.9000","text":"Split graphics rendering R interface ‘httpgd’. Large refactoring rewrite. Add async C client API. Add custom inter process communication layer. Add TIFF renderer. Add Base64 PNG renderer. Fix crash querying capabilities R 4.2. Improve testing. Many small fixes improvements.","code":""}]
+[{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"system-requirements","dir":"Articles","previous_headings":"","what":"System requirements","title":"Installation","text":"libpng X11 required unix like systems (e.g. Linux, macOS). Cairo optional unix like systems enable PNG, PDF, EPS PS renderers. libtiff required unix like systems enable TIFF renderers.","code":""},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"macos","dir":"Articles","previous_headings":"System requirements","what":"macOS","title":"Installation","text":"libpng missing install via: X11 missing error message include text: Install XQuartz. (see: https://github.com/r-lib/systemfonts/issues/17)","code":"brew install libpng unable to load shared object [...] systemfonts/libs/systemfonts.so [...]"},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"linux","dir":"Articles","previous_headings":"System requirements","what":"Linux","title":"Installation","text":"source installation Linux, fontconfig freetype2 library required install systemfonts package, dependency unigd.","code":""},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"debian-ubuntu-etc-","dir":"Articles","previous_headings":"System requirements > Linux","what":"Debian, Ubuntu, etc.","title":"Installation","text":"","code":"apt install libfontconfig1-dev"},{"path":"https://nx10.github.io/unigd/articles/a00_installation.html","id":"fedora-centos-rhel-etc-","dir":"Articles","previous_headings":"System requirements > Linux","what":"Fedora, CentOS, RHEL, etc.","title":"Installation","text":"","code":"dnf install fontconfig-devel"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"plot-rendering-in-base-r","dir":"Articles","previous_headings":"","what":"Plot rendering in base R","title":"Plotting with unigd","text":"Rendering plot base R done (1) starting graphics device, (2) calling plot functions subsequently (3) closing device: Note unfortunate constraints: File format (png(), pdf(), svg(), …) Filepath (.e.: file=\"my_plot1.png\") Dimensions (.e.: width=600, height=400) …multiple formats. …multiple dimensions. easy way access plotting data without writing file first. Closing device dev.() must called every time. unigd solves issues employing different graphics device architecture.","code":"temp <- airquality$Temp                         # Fetch some data  png(file=\"my_plot1.png\", width=600, height=400) # (1) Start the 'png' device hist(temp, col=\"darkblue\")                      # (2) Plot a histogram dev.off()                                       # (3) Close the device"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"plot-rendering-with-unigd","dir":"Articles","previous_headings":"","what":"Plot rendering with unigd","title":"Plotting with unigd","text":"Let’s see render can created using unigd: Notice rendering explicit instruction plotting using unigd. way can also render plot multiple formats /dimensions: Starting closing device can cumbersome, especially plotting code aborts error leaves device open. reason unigd comes set functions called ugd_*_inline: Plotting way keeps create close device manually. Depending personal preference may also considered ‘readable’ code. can obtain full list included renderers ugd_renderers(). (’s growing every unigd update!) next section illustrate access render data directly without create file.","code":"library(unigd) temp <- airquality$Temp                              # Fetch some data  ugd()                                                # (1) Start the 'ugd' device hist(temp, col=\"darkblue\")                           # (2) Plot a histogram ugd_save(file=\"my_plot1.png\", width=600, height=400) # Render 600*400 PNG file dev.off()                                            # (3) Close the device # ... hist(temp, col=\"darkblue\") ugd_save(file=\"my_plot1.png\", width=600, height=400) # Render 600*400 PNG file ugd_save(file=\"my_plot2.pdf\", width=300, height=300) # Render 300*300 PDF file # ... library(unigd) temp <- airquality$Temp # Fetch some data  ugd_save_inline({   hist(temp, col=\"darkblue\") }, file=\"my_plot1.png\", width=600, height=400)"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"in-memory-render-access","dir":"Articles","previous_headings":"","what":"In-memory render access","title":"Plotting with unigd","text":"applications, might want access rendered data directly. Example use-cases might report generation, web services interactive applications. can likely think workarounds issue, unigd feature certainly lower code complexity increase performance. Rendering -memory done simply calling ugd_render(...) instead ugd_save(...): course also inline function :","code":"temp <- airquality$Temp  ugd() hist(temp, col=\"darkblue\") my_svg <- ugd_render(as=\"svg\") dev.off()  cat(my_svg) # Print the SVG as a string temp <- airquality$Temp  my_svg <- ugd_render_inline({   hist(temp, col=\"darkblue\") }, as=\"svg\")  cat(my_svg) # Print the SVG as a string"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"more-unigd-features","dir":"Articles","previous_headings":"","what":"More unigd features","title":"Plotting with unigd","text":"unigd offers number features go beyond base R graphics devices.","code":""},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"zoom","dir":"Articles","previous_headings":"More unigd features","what":"Zoom","title":"Plotting with unigd","text":"rendering function unigd offer zoom parameter. parameter can used increase (decrease) size objects inside plot (independently plot dimensions). example zoom=2 increase size objects 200%, zoom=0.5 decrease 50%.","code":"my_svg_1_0 <- ugd_render_inline({   hist(temp, col=\"darkblue\", main = \"Zoom 1.0\") }, as=\"png-base64\", width=300, height=300, zoom=1.0)  my_svg_1_5 <- ugd_render_inline({   hist(temp, col=\"darkblue\", main = \"Zoom 1.5\") }, as=\"png-base64\", width=300, height=300, zoom=1.5)  my_svg_0_5 <- ugd_render_inline({   hist(temp, col=\"darkblue\", main = \"Zoom 0.5\") }, as=\"png-base64\", width=300, height=300, zoom=0.5)  # (Output directly in this RMarkdown document) knitr::raw_html(paste0(sprintf(\"<img src=\\\"%s\\\" />\", c(my_svg_1_0, my_svg_1_5, my_svg_0_5))))"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"paging-by-index","dir":"Articles","previous_headings":"More unigd features","what":"Paging (by index)","title":"Plotting with unigd","text":"page parameter lets select plot history rendered. default set 0 use last created plot. Set number ≥ 1 select plot ’s index (oldest first). Use numbers ≤ 0 select plots newest-first: Note plots can deleted history way: Instead keeping track plot index, might change plots added removed, static plot IDs can obtained.","code":"ugd() for (i in 1:10) {   plot(1, main=paste0(\"Plot #\", i)) }  ugd_save(file=\"plot.png\", page = 3)  # Plot #3 ugd_save(file=\"plot.png\")            # Plot #10 ugd_save(file=\"plot.png\", page = -1) # Plot #9  dev.off() # ... ugd_remove()          # Remove last ugd_remove(page = -1) # Remove second-to-last ugd_clear()           # Remove all # ..."},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"plot-ids","dir":"Articles","previous_headings":"More unigd features","what":"Plot IDs","title":"Plotting with unigd","text":"want render plot later point without keep track index, can obtain ID point ’s creation. following example extensively demonstrates can used: Note typical use-case much simpler, just getting last ID plot calling ugd_id() subsequently.","code":"ugd()  plot(rnorm(50))           # A  first_plot_id <- ugd_id() # Get last ID (A at this point)  hist(rnorm(50))           # B  plot(sin((1:100)/3))      # C  other_id <- ugd_id(-1)    # Get the second-to-last ID (B at this point)  hist(runif(100))          # D  ugd_remove(3)             # Remove 3rd plot (C)  first_again <- ugd_id(1)  # Get the first ID (A)  ugd_save(file=\"plot_1.png\", page = first_plot_id) ugd_save(file=\"plot_2.png\", page = other_id) ugd_save(file=\"plot_3.png\", page = first_again)  dev.off()"},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"special-renderers","dir":"Articles","previous_headings":"More unigd features","what":"(Special) renderers","title":"Plotting with unigd","text":"unigd also ships number ‘special’ renderers. guide go much detail topic noteworthy mentions: text elements inside plot Linebreak separated plain text format used e.g. ‘search’ plots Meta information plot Guaranteed render time O(1) regardless number objects Includes complexity (number draw calls clipping planes) JSON format Contains information unigd one plot JSON format","code":""},{"path":"https://nx10.github.io/unigd/articles/b00_guide.html","id":"performance-considerations","dir":"Articles","previous_headings":"","what":"Performance considerations","title":"Plotting with unigd","text":"unigd aims provide best performance case, considerations can make optimizing graphics rendering. point mentioned user applications readability prioritized performance , unless graphics rendering bottlenecking R script, can likely ignore section good conscience. optimizing rendering code, fundamental understand cases unigd needs call R graphics engine let plot re-drawn: Rendering done drawing. last drawn dimensions plot cached. can derive simple rules : Rendering plot different formats: Fast. Rendering plot different dimensions: Slow(er). means ordering rendering calls result faster execution: , unigd gives choice specifying render dimension plotting, can hint device creation time achieve best performance: dimensions omitted calling rendering functions, last known dimensions used rendering guaranteed fast: use ugd_*_inline functions also guaranteed fast. Note width height also interact zoom parameter. (.e.: Cached width = width / zoom).","code":"# SLOWER: ugd_save(file=\"my_plot1.png\", width=600, height=400) ugd_save(file=\"my_plot2.pdf\", width=300, height=300) # re-draw 1 ugd_save(file=\"my_plot3.pdf\", width=600, height=400) # re-draw 2  # FASTER: ugd_save(file=\"my_plot1.png\", width=600, height=400) ugd_save(file=\"my_plot3.pdf\", width=600, height=400) ugd_save(file=\"my_plot2.pdf\", width=300, height=300) # re-draw 1 # SLOWER: ugd() # default dimensions: 720 * 576 # ... ugd_save(file=\"my_plot1.png\", width=300, height=300) # re-draw  # FASTER: ugd(width=300, height=300) # ... ugd_save(file=\"my_plot1.png\", width=300, height=300) ugd_save(file=\"my_plot1.png\")"},{"path":"https://nx10.github.io/unigd/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Florian Rupprecht. Author, maintainer. Kun Ren. Contributor. Jeroen Ooms. Contributor. Hadley Wickham. Copyright holder.            Author included svglite code Lionel Henry. Copyright holder.            Author included svglite code Thomas Lin Pedersen. Copyright holder.            Author creator included svglite code T Jake Luciani. Copyright holder.            Author included svglite code Matthieu Decorde. Copyright holder.            Author included svglite code Vaudor Lise. Copyright holder.            Author included svglite code Tony Plate. Copyright holder.            Contributor included svglite code David Gohel. Copyright holder.            Contributor included svglite code Yixuan Qiu. Copyright holder.            Contributor included svglite code Håkon Malmedal. Copyright holder.            Contributor included svglite code RStudio. Copyright holder.            Copyright holder included svglite code Brett Robinson. Copyright holder.            Author included belle library Google. Copyright holder.            Copyright holder included material design icons Victor Zverovich. Copyright holder.            Author included fmt library Andrzej Krzemienski. Copyright holder.            Author included std::experimental::optional library","code":""},{"path":"https://nx10.github.io/unigd/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Rupprecht F (2024). unigd: Universal Graphics Device. R package version 0.1.0.9000,  https://nx10.github.io/unigd/, https://github.com/nx10/unigd.","code":"@Manual{,   title = {unigd: Universal Graphics Device},   author = {Florian Rupprecht},   year = {2024},   note = {R package version 0.1.0.9000,  https://nx10.github.io/unigd/},   url = {https://github.com/nx10/unigd}, }"},{"path":"https://nx10.github.io/unigd/index.html","id":"unigd-","dir":"","previous_headings":"","what":"Universal Graphics Device","title":"Universal Graphics Device","text":"unified R graphics backend. Render R graphics fast easy many common file formats. package provides thread-safe interface power interactive graphics clients httpgd.","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"features","dir":"","previous_headings":"","what":"Features","title":"Universal Graphics Device","text":"Fast plotting Plot resizing history Render various image formats (SVG, PNG, PDF, EPS, …) -memory access rendered graphics Platform independent Stateless thread-safe C client API package developers","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Universal Graphics Device","text":"can install development version unigd GitHub : See system requirements troubleshooting.","code":"# install.packages(\"remotes\") remotes::install_github(\"nx10/unigd\")"},{"path":"https://nx10.github.io/unigd/index.html","id":"getting-started","dir":"","previous_headings":"","what":"Getting started","title":"Universal Graphics Device","text":"See guide details.","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"contributions-welcome","dir":"","previous_headings":"","what":"Contributions welcome!","title":"Universal Graphics Device","text":"unigd mostly written C++, contributions tests (R) documentation also always welcome!","code":""},{"path":"https://nx10.github.io/unigd/index.html","id":"about--license","dir":"","previous_headings":"","what":"About & License","title":"Universal Graphics Device","text":"Depends cpp11 systemfonts. Much font handling SVG rendering code modified code excellent svglite package. project licensed GPL v2.0. includes parts svglite (GPL ≥ 2) fmt (MIT). Full copies license agreements used components included ./inst/licenses.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":null,"dir":"Reference","previous_headings":"","what":"A unified R graphics backend. — ugd","title":"A unified R graphics backend. — ugd","text":"function initializes unigd graphics device.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"A unified R graphics backend. — ugd","text":"","code":"ugd(   width = getOption(\"unigd.width\", 720),   height = getOption(\"unigd.height\", 576),   bg = getOption(\"unigd.bg\", \"white\"),   pointsize = getOption(\"unigd.pointsize\", 12),   system_fonts = getOption(\"unigd.system_fonts\", list()),   user_fonts = getOption(\"unigd.user_fonts\", list()),   reset_par = getOption(\"unigd.reset_par\", FALSE) )"},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"A unified R graphics backend. — ugd","text":"width Graphics device width (pixels). height Graphics device height (pixels). bg Background color. pointsize Graphics device point size. system_fonts Named list font names aliased fonts installed system. unspecified, R default families sans, serif, mono symbol aliased family returned systemfonts::font_info(). user_fonts Named list fonts aliased font files provided user rather fonts properly installed system. aliases can fonts fontquiver package, strings containing path font file, list containing name file elements name indicating font alias SVG output file path font file. reset_par set TRUE, global graphics parameters saved device start reset every time ugd_clear() called (see graphics::par()).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"A unified R graphics backend. — ugd","text":"return value, called initialize graphics device.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"A unified R graphics backend. — ugd","text":"font settings descriptions adopted excellent 'svglite' package.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"A unified R graphics backend. — ugd","text":"","code":"if (FALSE) {  ugd() # Initialize graphics device and start server ugd_browse() # Or copy the displayed link in the browser  # Plot something x <- seq(0, 3 * pi, by = 0.1) plot(x, sin(x), type = \"l\")  dev.off() # alternatively: ugd_close() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":null,"dir":"Reference","previous_headings":"","what":"Clear all unigd plot pages. — ugd_clear","title":"Clear all unigd plot pages. — ugd_clear","text":"function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clear all unigd plot pages. — ugd_clear","text":"","code":"ugd_clear(which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clear all unigd plot pages. — ugd_clear","text":"device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Clear all unigd plot pages. — ugd_clear","text":"Whether pages remove.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_clear.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Clear all unigd plot pages. — ugd_clear","text":"","code":"if (FALSE) {  ugd() plot(1, 1) hist(rnorm(100)) ugd_clear() hist(rnorm(100))  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":null,"dir":"Reference","previous_headings":"","what":"Close unigd device. — ugd_close","title":"Close unigd device. — ugd_close","text":"achieves effect grDevices::dev.(), close device unigd type.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Close unigd device. — ugd_close","text":"","code":"ugd_close(which = dev.cur(), all = FALSE)"},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Close unigd device. — ugd_close","text":"device (ID). running unigd devices closed.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Close unigd device. — ugd_close","text":"Number name new active device (specified device shut ).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_close.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Close unigd device. — ugd_close","text":"","code":"if (FALSE) {  ugd() ugd_browse() # open browser hist(rnorm(100)) ugd_close() # Equvalent to dev.off()  ugd() ugd() ugd() ugd_close(all = TRUE) }"},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":null,"dir":"Reference","previous_headings":"","what":"Query unigd plot IDs — ugd_id","title":"Query unigd plot IDs — ugd_id","text":"Query unigd graphics device static plot IDs. Available plot IDs starting index returned. limit specifies number plots. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Query unigd plot IDs — ugd_id","text":"","code":"ugd_id(index = 0, limit = 1, which = dev.cur(), state = FALSE)"},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Query unigd plot IDs — ugd_id","text":"index Plot index. set 0, last page selected. limit Limit number returned IDs. set value > 1 returned type list IDs. Set 0 . device (ID). state Include current device state returned result (see also: ugd_state()).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Query unigd plot IDs — ugd_id","text":"TODO","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_id.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Query unigd plot IDs — ugd_id","text":"","code":"if (FALSE) {  ugd() plot.new() text(.5, .5, \"#1\") plot.new() text(.5, .5, \"#2\") plot.new() text(.5, .5, \"#3\") third <- ugd_id() second <- ugd_id(2) all <- ugd_id(1, limit = Inf) ugd_remove(1) ugd_plot(second)  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd device information. — ugd_info","title":"unigd device information. — ugd_info","text":"Access general information unigd graphics device. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unigd device information. — ugd_info","text":"","code":"ugd_info(which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"unigd device information. — ugd_info","text":"device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unigd device information. — ugd_info","text":"List status variables following named items: $id: Server unique ID, $version: unigd library versions.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_info.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"unigd device information. — ugd_info","text":"","code":"if (FALSE) {  ugd() ugd_info()  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":null,"dir":"Reference","previous_headings":"","what":"Remove a unigd plot page. — ugd_remove","title":"Remove a unigd plot page. — ugd_remove","text":"function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Remove a unigd plot page. — ugd_remove","text":"","code":"ugd_remove(page = 0, which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Remove a unigd plot page. — ugd_remove","text":"page Plot page remove. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Remove a unigd plot page. — ugd_remove","text":"Whether page existed (thereby successfully removed).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_remove.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Remove a unigd plot page. — ugd_remove","text":"","code":"if (FALSE) {  ugd() plot(1, 1) # page 1 hist(rnorm(100)) # page 2 ugd_remove(page = 1) # remove page 1  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":null,"dir":"Reference","previous_headings":"","what":"Render unigd plot and return it. — ugd_render","title":"Render unigd plot and return it. — ugd_render","text":"See ugd_save() saving rendered plots files. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Render unigd plot and return it. — ugd_render","text":"","code":"ugd_render(   page = 0,   width = -1,   height = -1,   zoom = 1,   as = \"svg\",   which = dev.cur() )"},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Render unigd plot and return it. — ugd_render","text":"page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. set -1, last width selected. height Height plot. set -1, last height selected. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Render unigd plot and return it. — ugd_render","text":"Rendered plot. Text renderers return strings, binary renderers return byte arrays.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Render unigd plot and return it. — ugd_render","text":"","code":"if (FALSE) {  ugd() plot(1, 1) ugd_render(width = 600, height = 400, as = \"svg\")  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":null,"dir":"Reference","previous_headings":"","what":"Inline plot rendering. — ugd_render_inline","title":"Inline plot rendering. — ugd_render_inline","text":"Convenience function quick inline plot rendering. similar ugd_render() plotting code specified inline unigd graphics device managed (created closed) automatically. Starting device ugd() therefore necessary.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Inline plot rendering. — ugd_render_inline","text":"","code":"ugd_render_inline(   code,   page = 0,   width = getOption(\"unigd.width\", 720),   height = getOption(\"unigd.height\", 576),   zoom = 1,   as = \"svg\",   ... )"},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Inline plot rendering. — ugd_render_inline","text":"code Plotting code. See examples information. page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. height Height plot. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. ... Additional parameters passed ugd(...)","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Inline plot rendering. — ugd_render_inline","text":"Rendered plot. Text renderers return strings, binary renderers return byte arrays.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_render_inline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Inline plot rendering. — ugd_render_inline","text":"","code":"if (FALSE) {  ugd_render_inline({   hist(rnorm(100)) }, as = \"svgz\")  s <- ugd_render_inline({   plot.new()   lines(c(0.5, 1, 0.5), c(0.5, 1, 1)) }) cat(s) }"},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd device renderers. — ugd_renderers","title":"unigd device renderers. — ugd_renderers","text":"Get list available renderers. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unigd device renderers. — ugd_renderers","text":"","code":"ugd_renderers()"},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unigd device renderers. — ugd_renderers","text":"List renderers following named items: $id: Renderer ID, $mime: File mime type, $ext: File extension, $name: Human readable name, $type: Renderer type (currently either plot ), $bin: file binary blob text.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_renderers.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"unigd device renderers. — ugd_renderers","text":"","code":"ugd_renderers() #>            id                   mime   ext          name type  text #> 1  png-base64             text/plain  .txt    Base64 PNG plot  TRUE #> 2         png              image/png  .png           PNG plot FALSE #> 3         eps application/postscript  .eps           EPS plot  TRUE #> 4          ps application/postscript   .ps            PS plot  TRUE #> 5       svgzp          image/svg+xml .svgz Portable SVGZ plot FALSE #> 6        svgz          image/svg+xml .svgz          SVGZ plot FALSE #> 7        meta       application/json .json          Meta data  TRUE #> 8     strings             text/plain  .txt       Strings data  TRUE #> 9         pdf        application/pdf  .pdf           PDF plot FALSE #> 10       tikz             text/plain  .tex          TikZ plot  TRUE #> 11       json       application/json .json          JSON plot  TRUE #> 12       svgp          image/svg+xml  .svg  Portable SVG plot  TRUE #> 13        svg          image/svg+xml  .svg           SVG plot  TRUE #>                                                        descr #> 1            Base64 encoded Portable Network Graphics (PNG). #> 2                           Portable Network Graphics (PNG). #> 3                             Encapsulated PostScript (EPS). #> 4                                           PostScript (PS). #> 5  Version of the SVG renderer that produces portable SVGZs. #> 6                Compressed Scalable Vector Graphics (SVGZ). #> 7                                     Plot meta information. #> 8                         List of strings contained in plot. #> 9                      Adobe Portable Document Format (PDF). #> 10                                          LaTeX TikZ code. #> 11                      Plot data serialized to JSON format. #> 12  Version of the SVG renderer that produces portable SVGs. #> 13                           Scalable Vector Graphics (SVG)."},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":null,"dir":"Reference","previous_headings":"","what":"Render unigd plot to a file. — ugd_save","title":"Render unigd plot to a file. — ugd_save","text":"See ugd_render() accessing plot data directly memory without saving file. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Render unigd plot to a file. — ugd_save","text":"","code":"ugd_save(   file,   page = 0,   width = -1,   height = -1,   zoom = 1,   as = \"auto\",   which = dev.cur() )"},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Render unigd plot to a file. — ugd_save","text":"file Filepath save plot. page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. set -1, last width selected. height Height plot. set -1, last height selected. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. set \"auto\" renderer inferred file extension. device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Render unigd plot to a file. — ugd_save","text":"Rendered SVG string.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Render unigd plot to a file. — ugd_save","text":"","code":"if (FALSE) {  ugd() plot(1, 1) ugd_save(file = tempfile(), width = 600, height = 400, as = \"png\")  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":null,"dir":"Reference","previous_headings":"","what":"Inline plot rendering to a file. — ugd_save_inline","title":"Inline plot rendering to a file. — ugd_save_inline","text":"Convenience function quick inline plot rendering. similar ugd_save() plotting code specified inline unigd graphics device managed (created closed) automatically. Starting device ugd() therefore necessary.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Inline plot rendering to a file. — ugd_save_inline","text":"","code":"ugd_save_inline(   code,   file,   page = 0,   width = getOption(\"unigd.width\", 720),   height = getOption(\"unigd.height\", 576),   zoom = 1,   as = \"auto\",   ... )"},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Inline plot rendering to a file. — ugd_save_inline","text":"code Plotting code. See examples information. file Filepath save plot. page Plot page render. set 0, last page selected. Can set numeric plot index plot ID (see ugd_id()). width Width plot. height Height plot. zoom Zoom level. (example: 2 corresponds 200%, 0.5 50%.) Renderer. ... Additional parameters passed ugd(...)","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_save_inline.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Inline plot rendering to a file. — ugd_save_inline","text":"","code":"if (FALSE) {  ugd_save_inline({   plot.new()   lines(c(0.5, 1, 0.5), c(0.5, 1, 1)) }, file = \"plot.svg\") }"},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd device status. — ugd_state","title":"unigd device status. — ugd_state","text":"Access status information unigd graphics device. function work starting device ugd().","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unigd device status. — ugd_state","text":"","code":"ugd_state(which = dev.cur())"},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"unigd device status. — ugd_state","text":"device (ID).","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unigd device status. — ugd_state","text":"List status variables following named items: $hsize: Plot history size (many plots accessible), $upid: Update ID (changes device received new information), $active: device currently activated device.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_state.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"unigd device status. — ugd_state","text":"","code":"if (FALSE) {  ugd() ugd_state() plot(1, 1) ugd_state()  dev.off() }"},{"path":"https://nx10.github.io/unigd/reference/ugd_test_pattern.html","id":null,"dir":"Reference","previous_headings":"","what":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","title":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","text":"Plot test pattern can used evaluate compare graphics devices.","code":""},{"path":"https://nx10.github.io/unigd/reference/ugd_test_pattern.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","text":"","code":"ugd_test_pattern()"},{"path":"https://nx10.github.io/unigd/reference/ugd_test_pattern.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Plot a test pattern that can be used to evaluate and compare graphics\ndevices. — ugd_test_pattern","text":"","code":"if (FALSE) {  ugd_test_pattern() }"},{"path":"https://nx10.github.io/unigd/reference/unigd-package.html","id":null,"dir":"Reference","previous_headings":"","what":"unigd: Universal graphics device — unigd-package","title":"unigd: Universal graphics device — unigd-package","text":"Universal graphics device","code":""},{"path":[]},{"path":"https://nx10.github.io/unigd/reference/unigd-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"unigd: Universal graphics device — unigd-package","text":"Maintainer: Florian Rupprecht floruppr@gmail.com (ORCID) contributors: Kun Ren mail@renkun.[contributor] Jeroen Ooms jeroen@berkeley.edu (ORCID) [contributor] Hadley Wickham hadley@rstudio.com (Author included svglite code) [copyright holder] Lionel Henry lionel@rstudio.com (Author included svglite code) [copyright holder] Thomas Lin Pedersen thomas.pedersen@rstudio.com (Author creator included svglite code) [copyright holder] T Jake Luciani jake@apache.org (Author included svglite code) [copyright holder] Matthieu Decorde matthieu.decorde@ens-lyon.fr (Author included svglite code) [copyright holder] Vaudor Lise lise.vaudor@ens-lyon.fr (Author included svglite code) [copyright holder] Tony Plate (Contributor included svglite code) [copyright holder] David Gohel (Contributor included svglite code) [copyright holder] Yixuan Qiu (Contributor included svglite code) [copyright holder] Håkon Malmedal (Contributor included svglite code) [copyright holder] RStudio (Copyright holder included svglite code) [copyright holder] Brett Robinson (Author included belle library) [copyright holder] Google (Copyright holder included material design icons) [copyright holder] Victor Zverovich (Author included fmt library) [copyright holder] Andrzej Krzemienski (Author included std::experimental::optional library) [copyright holder]","code":""},{"path":"https://nx10.github.io/unigd/news/index.html","id":"unigd-0109000","dir":"Changelog","previous_headings":"","what":"unigd 0.1.0.9000","title":"unigd 0.1.0.9000","text":"Split graphics rendering R interface ‘httpgd’. Large refactoring rewrite. Add async C client API. Add custom inter process communication layer. Add TIFF renderer. Add Base64 PNG renderer. Fix crash querying capabilities R 4.2. Improve testing. Many small fixes improvements.","code":""}]