Terrain Layer
Usage
add_terrain_layer(
rdeck,
...,
id = uuid::UUIDgenerate(),
name = "TerrainLayer",
group_name = NULL,
data = NULL,
visible = TRUE,
pickable = FALSE,
opacity = 1,
wrap_longitude = FALSE,
position_format = "XY",
color_format = "RGBA",
auto_highlight = FALSE,
highlight_color = "#00008080",
get_tile_data = NULL,
extent = NULL,
tile_size = 512,
max_zoom = NULL,
min_zoom = 0,
max_cache_size = NULL,
max_cache_byte_size = NULL,
refinement_strategy = "best-available",
z_range = NULL,
max_requests = 6,
zoom_offset = 0,
elevation_data = NULL,
texture = NULL,
mesh_max_error = 4,
bounds = NULL,
color = "#ffffff",
elevation_decoder = list(rScaler = 1, gScaler = 0, bScaler = 0, offset = 0),
worker_url = NULL,
wireframe = FALSE,
material = TRUE,
blending_mode = "normal",
visibility_toggle = TRUE,
tooltip = NULL
)
update_terrain_layer(
rdeck,
...,
id,
name = cur_value(),
group_name = cur_value(),
data = cur_value(),
visible = cur_value(),
pickable = cur_value(),
opacity = cur_value(),
wrap_longitude = cur_value(),
position_format = cur_value(),
color_format = cur_value(),
auto_highlight = cur_value(),
highlight_color = cur_value(),
get_tile_data = cur_value(),
extent = cur_value(),
tile_size = cur_value(),
max_zoom = cur_value(),
min_zoom = cur_value(),
max_cache_size = cur_value(),
max_cache_byte_size = cur_value(),
refinement_strategy = cur_value(),
z_range = cur_value(),
max_requests = cur_value(),
zoom_offset = cur_value(),
elevation_data = cur_value(),
texture = cur_value(),
mesh_max_error = cur_value(),
bounds = cur_value(),
color = cur_value(),
elevation_decoder = cur_value(),
worker_url = cur_value(),
wireframe = cur_value(),
material = cur_value(),
blending_mode = cur_value(),
visibility_toggle = cur_value(),
tooltip = cur_value()
)
Arguments
- rdeck
<
rdeck
|rdeck_proxy
> An rdeck map instance.- ...
Additional parameters that will be forwarded to deck.gl javascript without validation nor processing. All dots must be named and will be
camelCased
when serialised. A warning is raised when dots are used, warning classrdeck_dots_nonempty
.- id
<
string
> The layer's identifier must be unique for among all layers of the same type for a map. Defaults touuid::UUIDgenerate()
, but should be explicitly defined for updatable layers in a shiny application.- name
<
string
> Identifies the layer on tooltips and legends. It does not need to be unique, but should be brief. Defaults to the deck.gl class name for the layer.- group_name
<
string
> Defines the group that this layer belongs to. Currently only effective on the layer selector, ifvisibility_toggle = TRUE
.- data
<
data.frame
|sf
|string
> The layer's data. Data frames and sf objects will contain all columns that are referenced by the layer's accessors. Strings will be interpreted as a URL and data will be retrieved dynamically in the browser.- visible
<
boolean
> Determines whether the layer is visible or not; also determines whether any legend elements for the layer will be displayed.- pickable
<
boolean
> Determines if the layer responds to pointer / touch events.- opacity
<
number
> Determines the layer's opacity.- wrap_longitude
<
boolean
> Normalises geometry longitudes.- position_format
<
"XY"
|"XYZ"
> Determines whether each coordinate has two (XY) or three (XYZ) elements.- color_format
<
"RGB"
|"RGBA"
> Determines whether the alpha channel of the colours will be ignored by accessors, making all colours opaque.- auto_highlight
<
boolean
> WhenTRUE
, the current object hovered by the cursor is highlighted byhighlight_color
.- highlight_color
<
accessor
|scale
|color
> Whenauto_highlight
andpickable
are enabled,highlight_color
determines the colour of the currently highlighted object. If a single colour value is supplied, that colour will be used to highlight all objects in the layer. Per-object highlighting is achieved with a colour scale, or a tidy-eval column of colours.- get_tile_data
<
JS
> retrieves the data of each tile. See deck.gl getTileData.- extent
<
c(min_x, min_y, max_x, max_y)
> Tiles in this bounding box will be rendered atmin_zoom
, when zoomed out belowmin_zoom
.- tile_size
<
number
> A power of 2 that is the pixel dimensions of the tile.- max_zoom
<
number
> Tiles above this zoom level are not shown. Defaults toNULL
.- min_zoom
<
number
> Tiles below this zoom level are not shown. Defaults to0
.- max_cache_size
<
number
> Maximum number of tiles that can be cached. Defaults to 5x the number of tiles in current viewport.- max_cache_byte_size
<
number
> Maximum memory used for caching tiles.- refinement_strategy
<
"best-available"
|"no-overlap"
|"never"
> How the tile layer refines visibility of tiles. Defaults to"best-available"
.- z_range
<
c(min, max)
> Array representing the range of heights in the tile.- max_requests
<
number
> Maximum number of concurrent HTTP requests across all specified tile provider domains. If a negative number is supplied no throttling occurs (HTTP/2 only).- zoom_offset
<
int
> The offset changes the zoom level at which the tiles are fetched.- elevation_data
url
- texture
not yet supported.
- mesh_max_error
number
- bounds
<
rct
/st_bbox
/wk-geometry
> The bounds of the image to fit x,y coordinates into. Requires CRS EPSG:4326. Must be supplied when using non-tiled elevation data.- color
color
- elevation_decoder
object
- worker_url
string
- wireframe
<
boolean
> IfTRUE
andextruded == TRUE
, draw a line wireframe of the object. The outline will have horizontal lines closing the top and bottom polygons and vertical lines for each vertex of the polygon.- material
<
boolean
>- blending_mode
<
"normal"
|"additive"
|"subtractive"
> Sets the blending mode. Blending modes:normal
: Normal blending doesn't alter colours of overlapping objects.additive
: Additive blending adds colours of overlapping objects. Useful for highlighting dot density on dark maps.subtractive
: Subtractive blending darkens overlapping objects. Useful for highlighting dot density on light maps.
- visibility_toggle
<
boolean
> Whether this layer will appear in the layer selector.- tooltip
<
tooltip
> Defines the columns (and their order) that will be displayed in the layer tooltip, ifpickable == TRUE
. Supports tidy-select if adata
is adata.frame
. Geometry columns are always removed.
See also
https://github.com/visgl/deck.gl/blob/8.7-release/docs/api-reference/geo-layers/terrain-layer.md
Other geo-layers:
great_circle_layer
,
h3_cluster_layer
,
h3_hexagon_layer
,
mvt_layer
,
quadkey_layer
,
s2_layer
,
tile_3d_layer
,
tile_layer
,
trips_layer
Other layers:
arc_layer
,
bitmap_layer
,
column_layer
,
contour_layer
,
cpu_grid_layer
,
geojson_layer
,
gpu_grid_layer
,
great_circle_layer
,
grid_cell_layer
,
grid_layer
,
h3_cluster_layer
,
h3_hexagon_layer
,
heatmap_layer
,
hexagon_layer
,
icon_layer
,
line_layer
,
mvt_layer
,
path_layer
,
point_cloud_layer
,
polygon_layer
,
quadkey_layer
,
s2_layer
,
scatterplot_layer
,
scenegraph_layer
,
screen_grid_layer
,
simple_mesh_layer
,
solid_polygon_layer
,
text_layer
,
tile_3d_layer
,
tile_layer
,
trips_layer