The Hexpack is a piecepack expansion by Daniel Wilcox and Nathan Morse that essentially introduces hexagonal tiles and triagonal coins. In this demo we'll show how to configure a hexpack that matches our default piecepack and make a simple diagram using it as well as show how to use the built-in hexpack configurations that come with piecepackr.

Configuring a hexpack

The trickiest part of configuring a hexpack is figuring out the correct dimensions for the hexagonal tiles. The suggested size of the hexagonal tiles in a hexpack is one that allows the hexagons to circumscribe a 2" circumference circle which implies that they in turn are circumscribed by a 4 / sqrt(3) circumference circle:

hexpack <- pp_cfg(list(shape.tile="convex6", border_lex=3,
                   shape_t.tile="60",  dm_t.tile_face=-90,
                   width.tile=4/sqrt(3), height.tile=4/sqrt(3),
                   shape.coin="convex3", invert_colors.suited=TRUE))

When making hex diagrams it is often helpful to think in polar coordinates so piecepackr provides the helper functions to_x, to_y, to_t, and to_r to help developers convert back and forth between polar coordinates and Cartesian coordinates. We'll make a simple diagram using these functions and the hexpack configuration we just made:


x0 <- 5
y0 <- 4.5
df_t1 <- tibble(piece_side="tile_back", x=x0, y=y0)

theta <- seq(90, by=-60, length.out=6)
r <- 0.7
df_c <- tibble(piece_side="coin_face", rank=1:6,
               x=x0+to_x(theta,r), y=y0+to_y(theta,r),

r <- 2
df_t2 <- tibble(piece_side="tile_face",
                suit=1:6%%4+1, rank=1:6,
                x=x0+to_x(theta,r), y=y0+to_y(theta,r),

r <- 6/sqrt(3)
df_t3 <- tibble(piece_side="tile_back",
                x=x0+to_x(theta+30, r),
                y=y0+to_y(theta+30, r))

df <- dplyr::bind_rows(df_t1, df_c, df_t2, df_t3)
pmap_piece(df, cfg=hexpack, default.units="in",
           op_scale=0.5, op_angle=60, trans=op_transform)
Example hexpack diagram

Example hexpack diagram

Using the built-in hexpacks

piecepackr provides a couple built-in hexpack configurations via the function game_systems [1]:

df$cfg <- "hexpack"
pmap_piece(df, envir=game_systems("dejavu"), default.units="in",
           op_scale=0.5, op_angle=60, trans=op_transform)
## Loading required namespace: systemfonts
Example hexpack diagram with the built-in 'dejavu' hexpack

Example hexpack diagram with the built-in 'dejavu' hexpack

[1]New in piecepackr version 1.2.


There are no comments yet.

Add a Comment

You can use Markdown or restructuredText to format your comment.