bm_shadow() adds a basic "shadow" effect to the bitmap(s). bm_bold() is a variant with different defaults to create a basic "bold" effect. bm_glow() adds a basic "glow" effect to the bitmap(s).

bm_shadow(
  bm_object,
  value = 2L,
  top = NULL,
  right = NULL,
  bottom = NULL,
  left = NULL,
  extend = TRUE
)

bm_bold(
  bm_object,
  value = 1L,
  top = NULL,
  right = NULL,
  bottom = NULL,
  left = NULL,
  extend = TRUE
)

bm_glow(bm_object, value = 2L, extend = TRUE, corner = FALSE)

Arguments

bm_object

Either a bm_bitmap(), bm_list(), or bm_font() object.

value

The integer value for the shadow, bold, or glow effect.

top

How many pixels above should the shadow go.

right

How many pixels right should the shadow go. if top, right, bottom, and left are all NULL then defaults to 1L.

bottom

How many pixels below should the shadow go. if top, right, bottom, and left are all NULL then defaults to 1L for bm_shadow() and 0L for bm_embolden().

left

How many pixels left should the shadow go.

extend

Make the bitmap larger to give the new glyph more "room".

corner

Fill in the corners.

Value

Either a bm_bitmap(), bm_list(), or bm_font() object.

See also

Examples

font_file <- system.file("fonts/spleen/spleen-8x16.hex.gz", package = "bittermelon") font <- read_hex(font_file) capital_r <- font[[str2ucp("R")]] print(capital_r, px = px_ascii)
#> -------- #> -------- #> @@@@@@-- #> @@---@@- #> @@---@@- #> @@---@@- #> @@@@@@-- #> @@---@@- #> @@---@@- #> @@---@@- #> @@---@@- #> @@---@@- #> -------- #> -------- #> -------- #> --------
print(bm_shadow(capital_r), px = px_ascii)
#> --------- #> --------- #> @@@@@@--- #> @@+++@@-- #> @@+--@@+- #> @@+--@@+- #> @@@@@@++- #> @@+++@@-- #> @@+--@@+- #> @@+--@@+- #> @@+--@@+- #> @@+--@@+- #> -++---++- #> --------- #> --------- #> --------- #> ---------
print(bm_bold(capital_r), px = px_ascii)
#> --------- #> --------- #> @@@@@@@-- #> @@@--@@@- #> @@@--@@@- #> @@@--@@@- #> @@@@@@@-- #> @@@--@@@- #> @@@--@@@- #> @@@--@@@- #> @@@--@@@- #> @@@--@@@- #> --------- #> --------- #> --------- #> ---------
print(bm_glow(capital_r), px = px_ascii)
#> ---------- #> ---------- #> -++++++--- #> +@@@@@@+-- #> +@@+++@@+- #> +@@+-+@@+- #> +@@+++@@+- #> +@@@@@@+-- #> +@@+++@@+- #> +@@+-+@@+- #> +@@+-+@@+- #> +@@+-+@@+- #> +@@+-+@@+- #> -++---++-- #> ---------- #> ---------- #> ---------- #> ----------
print(bm_glow(capital_r, corner = TRUE), px = px_ascii)
#> ---------- #> ---------- #> ++++++++-- #> +@@@@@@++- #> +@@+++@@+- #> +@@+-+@@+- #> +@@+++@@+- #> +@@@@@@++- #> +@@+++@@+- #> +@@+-+@@+- #> +@@+-+@@+- #> +@@+-+@@+- #> +@@+-+@@+- #> ++++-++++- #> ---------- #> ---------- #> ---------- #> ----------