R: Specify a Symbol Font

cairoSymbolFont {grDevices} | R Documentation

## Specify a Symbol Font

### Description

Specify a symbol font for a Cairo-based graphics device. This function provides the opportunity to specify whether the font supports Private Use Area code points.

### Usage

    cairoSymbolFont(family, usePUA = TRUE)

### Arguments

`family` | A character vector giving the symbol font family name.
`usePUA` | Does the font support Private Use Area code points?

### Details

On Cairo-based graphics devices, when drawing with a symbol font (e.g., plotmath), Adobe Symbol Encoding characters are converted to UTF-8 code points. This conversion can use Private Use Area code points or not. It is useful to be able to specify this option because some fonts (e.g., the OpenSymbol font that is included in LibreOffice) have glyphs mapped to the Private Use Area and some fonts (e.g., Nimbus Sans L, the URW Fonts equivalent of Helvetica) do not.

### Value

An object of class `"CairoSymbolFont"`.

### See Also

`cairo_pdf`.

### Examples

    ## Not run:
    ## If a font uses PUA, we can just specify the font name ...
    cairo_pdf(symbolfamily="OpenSymbol")
    dev.off()
    ## ... or equivalently ...
    cairo_pdf(symbolfamily=cairoSymbolFont("OpenSymbol"))
    dev.off()

    ## If a font does not use PUA, we must indicate that ...
    cairo_pdf(symbolfamily=cairoSymbolFont("Nimbus Sans", usePUA=FALSE))
    dev.off()

    ## End(Not run)

[Package grDevices version 4.0.5 Index]