Writes a stereolithography (STL) file that can be used in 3D printing.

save_3dprint(
filename,
maxwidth = 125,
unit = "mm",
rotate = TRUE,
remove_extras = TRUE,
clear = FALSE
)

## Arguments

filename String with the filename. If .stl is not at the end of the string, it will be appended automatically. Default 125. Desired maximum width of the 3D print in millimeters. Uses the units set in unit argument. Can also pass in a string, "125mm" or "5in". Default mm. Units of the maxwidth argument. Can also be set to inches with in. Default TRUE. If FALSE, the map will be printing on its side. This may improve resolution for some 3D printing types. Default TRUE. Removes non-topographic features from base: lines, water, labels, and the shadow. Default FALSE. If TRUE, the current rgl device will be cleared.

## Value

Writes an STL file to filename. Regardless of the unit displayed, the output STL is in millimeters.

## Examples

filename_stl = tempfile()

#Save the STL file into filename_stl
# \donttest{
volcano %>%
plot_3d(volcano,zscale=3)
render_snapshot()
save_3dprint(filename_stl, clear=TRUE)
#> Dimensions of model are: 125.0 mm x 91.8 mm x 60.1 mm
# }

#Save the STL file into filename_stl, setting maximum width to 100 mm
# \donttest{
volcano %>%
plot_3d(volcano,zscale=3)
render_snapshot()

save_3dprint(filename_stl, maxwidth = 100, clear=TRUE)
#> Dimensions of model are: 100.0 mm x 73.5 mm x 48.1 mm
# }

#'#Save the STL file into filename_stl, setting maximum width to 4 inches
# \donttest{
volcano %>%
plot_3d(volcano,zscale=3)
render_snapshot()
save_3dprint(filename_stl, maxwidth = 4, unit = "in", clear=TRUE)
#> Dimensions of model are: 4.00 in x 2.94 in x 1.92 in
# }
#'#'#Save the STL file into filename_stl, setting maximum width (character) to 120mm
# \donttest{
volcano %>%