showtext_auto: Automatically Using 'showtext' for New Graphics Devices
In showtext: Using Fonts More Easily in R Graphs

Description Usage Arguments Author(s) See Also Examples

View source: R/showtext.R

The two versions of this function are equivalent, but the "underscore" naming is preferred.

This function could turn on/off the automatic use of showtext functionality. If turned on, any newly opened graphics devices will use showtext to draw text. This helps to avoid the repeated calls of showtext_begin() and showtext_end().

1
2
3

showtext_auto(enable = TRUE, record = TRUE)

showtext.auto(enable = TRUE, record = TRUE)

`enable`	`TRUE` to turn on and `FALSE` to turn off.
`record`	If `TRUE`, then `showtext_begin()` is added to the display list of the current graphics device (via `recordGraphics()`), so that it may be "replayed" at a later time point (via `replayPlot()`).

Yixuan Qiu <https://statr.me/>

showtext_begin(), showtext_end()

## Not run: 
pdf("test1.pdf")
plot(1, main = "\u6b22\u8fce")  ## may not render properly
dev.off()

## Automatically use showtext for future devices
showtext_auto()
plot(1, main = "\u6b22\u8fce", family = "wqy-microhei")

pdf("test2.pdf")
plot(1, main = "\u6b22\u8fce", family = "wqy-microhei")
dev.off()

## Turn off if needed
showtext_auto(FALSE)

## End(Not run)