Combine bitmap objects — c.bm_bitmap • bittermelon

c() combines bitmap objects into bm_list() or bm_font() objects. In particular when using it to combine fonts the later fonts "update" the glyphs in the earlier fonts.

# S3 method for bm_bitmap
c(...)

# S3 method for bm_font
c(...)

# S3 method for bm_list
c(...)

Arguments

...: bm_bitmap(), bm_list(), and/or bm_font() objects to combine.

Value

Either a bm_list() or bm_font() object. See Details for more info.

Details

The various bitmap objects are "reduced" in the following ways:

First	Second	Result
`bm_bitmap()`	`bm_bitmap()`	`bm_list()`
`bm_bitmap()`	`bm_list()`	`bm_list()`
`bm_bitmap()`	`bm_font()`	`bm_font()`
`bm_list()`	`bm_bitmap()`	`bm_list()`
`bm_list()`	`bm_list()`	`bm_list()`
`bm_list()`	`bm_font()`	`bm_font()`
`bm_font()`	`fm_bitmap()`	`bm_font()`
`bm_font()`	`fm_list()`	`bm_font()`
`bm_font()`	`fm_font()`	`bm_font()`

When combining with a bm_font() object if any bm_bitmap() objects share the same name we only keep the last one. Although names are preserved other attributes such as font comments and properties are not guaranteed to be preserved.

Examples

font_file <- system.file("fonts/spleen/spleen-8x16.hex.gz", package = "bittermelon")
font <- read_hex(font_file)
capital_r <- font[[str2ucp("R")]]
stats <- as_bm_list("STATS", font = font)
is_bm_list(c(capital_r, capital_r))
#> [1] TRUE
rstats <- c(capital_r, stats)
print(bm_call(rstats, cbind), px = px_ascii)
#> ------------------------------------------------
#> ------------------------------------------------
#> @@@@@@---@@@@@@-@@@@@@@@-@@@@@--@@@@@@@@-@@@@@@-
#> @@---@@-@@---------@@---@@---@@----@@---@@------
#> @@---@@-@@---------@@---@@---@@----@@---@@------
#> @@---@@-@@---------@@---@@---@@----@@---@@------
#> @@@@@@---@@@@@-----@@---@@@@@@@----@@----@@@@@--
#> @@---@@------@@----@@---@@---@@----@@--------@@-
#> @@---@@------@@----@@---@@---@@----@@--------@@-
#> @@---@@------@@----@@---@@---@@----@@--------@@-
#> @@---@@------@@----@@---@@---@@----@@--------@@-
#> @@---@@-@@@@@@-----@@---@@---@@----@@---@@@@@@--
#> ------------------------------------------------
#> ------------------------------------------------
#> ------------------------------------------------
#> ------------------------------------------------