#' Create rayvertex board game piece objects
#'
#' `piece_mesh()` creates 3d board game piece objects for use with the rayvertex package.
#' @inheritParams piece3d
#' @return A rayvertex object.
#' @examples
#' \donttest{# May take more than 5 seconds on CRAN servers
#' if (requireNamespace("rayvertex", quietly = TRUE) && all(capabilities(c("cairo", "png")))) {
#' cfg <- game_systems("sans3d")$piecepack
#' rs <- function(shape) {
#' opt <- options(cores = getOption("Ncpus"))
#' light <- rayvertex::directional_light(c(0, 0, 1))
#' rayvertex::rasterize_scene(shape, light_info = light)
#' options(opt)
#' }
#' rs(piece_mesh("tile_face", suit = 3, rank = 3, cfg = cfg))
#' }
#' if (requireNamespace("rayvertex", quietly = TRUE) && all(capabilities(c("cairo", "png")))) {
#' rs(piece_mesh("coin_back", suit = 4, rank = 2, cfg = cfg))
#' }
#' if (requireNamespace("rayvertex", quietly = TRUE) && all(capabilities(c("cairo", "png")))) {
#' rs(piece_mesh("pawn_face", suit = 1, cfg = cfg))
#' }
#' }
#' @export
#' @seealso See \url{https://www.rayvertex.com} for more information about the \code{rayvertex} package.
#' See \code{\link{geometry_utils}} for a discussion of the 3D rotation parameterization.
piece_mesh <- function(piece_side = "tile_back", suit = NA, rank = NA, cfg = pp_cfg(), # nolint
x = 0, y = 0, z = NA,
angle = 0, axis_x = 0, axis_y = 0,
width = NA, height = NA, depth = NA,
envir = NULL, ..., scale = 1, res = 72) {
assert_suggested("rayvertex")
nn <- max(lengths(list(piece_side, suit, rank, x, y, z, angle, axis_x, axis_y, width, height, depth)))
piece_side <- rep(piece_side, length.out = nn)
suit <- rep(suit, length.out = nn)
rank <- rep(rank, length.out = nn)
x <- rep(x, length.out = nn)
y <- rep(y, length.out = nn)
z <- rep(z, length.out = nn)
angle <- rep(angle, length.out = nn)
axis_x <- rep(axis_x, length.out = nn)
axis_y <- rep(axis_y, length.out = nn)
width <- rep(width, length.out = nn)
height <- rep(height, length.out = nn)
depth <- rep(depth, length.out = nn)
scale <- rep(scale, length.out = nn)
cfg <- get_cfg(cfg, envir)
cfg <- rep(c(cfg), length.out = nn)
l <- lapply(seq(nn), function(i) {
cfg[[i]]$rayvertex(piece_side[i], suit[i], rank[i],
x[i], y[i], z[i],
angle[i], axis_x[i], axis_y[i],
width[i], height[i], depth[i],
scale = scale[i], res = res)
})
l <- Filter(Negate(is.null), l)
if (length(l) == 1L) {
l[[1L]]
} else if (length(l) > 1L) {
rayvertex::scene_from_list(l)
} else {
NULL
}
}
rv_piece_helper <- function(piece_side = "tile_back", suit = NA, rank = NA, cfg = pp_cfg(), # nolint
x = 0, y = 0, z = NA,
angle = 0, axis_x = 0, axis_y = 0,
width = NA, height = NA, depth = NA, scale = 1, res = 72) {
if (scale == 0) return(NULL)
obj <- save_piece_obj(piece_side, suit, rank, cfg,
x = x, y = y, z = z,
angle = angle, axis_x = axis_x, axis_y = axis_y,
width = width, height = height, depth = depth,
scale = scale, res = res)
rayvertex::obj_mesh(filename = obj$obj)
}
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.