read_monobit {bittermelon} | R Documentation |
Read and write bitmap font files using monobit
Description
read_monobit()
reads in bitmap font file as a bm_font()
object while write_monobit()
writes a bm_font()
object as a bitmap font file.
It uses the file extension to determine the appropriate bitmap font format to use.
Usage
read_monobit(
file,
quietly = FALSE,
monobit_path = getOption("bittermelon.monobit_path", "monobit-convert")
)
write_monobit(
font,
file,
quietly = FALSE,
monobit_path = getOption("bittermelon.monobit_path", "monobit-convert")
)
Arguments
file |
A character string of a filename. |
quietly |
If |
monobit_path |
Path/name of |
font |
A |
Details
-
read_monobit()
andwrite_monobit()
require that themonobit-convert
command is available on the system. -
read_monobit()
andwrite_monobit()
usesmonobit-convert
to convert to/from the yaff font format which this package can natively read/write from/to. One may install
monobit-convert
usingpip3 install monobit
.For more information about
monobit
see https://github.com/robhagemans/monobit.
Value
read_monobit()
returns a bm_font()
object. write_monobit()
returns NULL
invisibly and
as a side effect writes file
.
See Also
bm_font()
for more information about bitmap font objects.
read_hex()
, write_hex()
, read_yaff()
, write_yaff()
for pure R bitmap font readers and writers.
Examples
# May take more than 5 seconds on CRAN servers
if (Sys.which("monobit-convert") != "") {
try({
font_file <- system.file("fonts/spleen/spleen-8x16.hex.gz", package = "bittermelon")
font <- read_monobit(font_file)
capital_r <- font[[str2ucp("R")]]
print(capital_r)
filename <- tempfile(fileext = ".yaff")
write_monobit(font, filename)
})
}