region

regionNode

An extra layer of boundaries over the environment's own basemap. The environment's in: already draws its pack, so a region is for what a basemap cannot say: a subset picked out in its own colours (only: France, Germany with a teal fill), a second pack layered over the first (us-states borders over a world map), or boundaries that arrive on a cue.

#Attributes

inImplicit
worldus-statescanada-provincesaustralia-statesuk-countiesnz-regionseurope-admin1reference
The boundary pack this layer draws. Defaults to the environment's own in:. It may instead be #id naming an attached .geojson dataset — in: #wards — which makes the attachment itself the boundaries.Can be written as shorthand: region:value
only
string-list
Draw only these regions. Names or ISO alpha-3 codes, matched case-insensitively — France, DEU and Ivory Coast all read.
except
string-list
Drop these regions from the layer. except: Antarctica is the usual world framing.
fillAnimatable
neutralredorangeyellowgreentealbluepurplepinkgreywhiteblack
A hue; the land fills with its tint. Absent, the land keeps the neutral basemap grey.
strokeAnimatable
neutralredorangeyellowgreentealbluepurplepinkgreywhiteblack
A hue for the borders. Absent, they are drawn as seams of the page background.
widthAnimatable
number
Border width in pixels.
Default1
opacityAnimatable
number
How solid the layer sits over the basemap, 0 to 1.
Default1
hiddenAnimatable
boolean
Declared but not drawn. Animatable, so hidden: true !cue.to{false}(at: 2) is the overlay's reveal.
Defaultfalse

#Allowed in

cue { }cue.draw { }cue.trace { }cue.highlight { }cue.spotlight { }canvas.geo { }

#Examples

region(in: world; only: France, Germany, Italy; fill: teal)
region(in: us-states; stroke: grey)
cue{
    region(in: canada-provinces; fill: orange)
}(
    in: 2
)