Symbol Layer Descriptor
Descriptor for a Mapbox symbol layer using SymbolLayerPaint: icons, text labels, and optional fill/stroke.
Use after the backing source is registered (com.xweather.mapsgl.map.MapController.addSource). Typical sources are vector tiles with a named sourceLayer; GeoJSON point/line data can use null on sourceLayer when the style does not target a specific MVT layer.
For gridded encoded products (spacing, SamplePaint, etc.), use GridLayerDescriptor with GridLayerPaint instead—this type stays Mapbox-style-only so paint is not confused with grid sidecar fields.
See also
Constructors
Builds a symbol descriptor from a GridLayerPaint, the paint type this descriptor took through 1.6.0 before SymbolLayerPaint split the symbol-only fields out of it.
Properties
Optional Mapbox filter.
JS-style mask shorthand (mask: { layerIds: [...] }). Resolved to stencilLayerMask when stencilLayerMask is unset. Apple's maskConfiguration maps here / to stencilLayerMask.
Single mask layer id shorthand. Lowest precedence among mask fields.
List of mask layer ids (JS mask.layerIds). Lower precedence than layerMask.
Highest map zoom at which this layer draws. Not active in 1.8.0; see LayerDescriptor.maxZoom.
Lowest map zoom at which this layer draws. Not active in 1.8.0; see LayerDescriptor.minZoom.
Icon, text, and optional fill/stroke configuration.
Whether to preload low-resolution fallback tiles. Not active in 1.8.0; see LayerDescriptor.preloadLowQuality.
MVT layer name, or null for GeoJSON when applicable.
Advanced custom stencil mask. Takes precedence over layerMask / maskLayerIds / maskLayerId.
When true, MapsGL does not register a Mapbox fill / line / circle / symbol / heatmap style layer. The com.xweather.mapsgl.layers.tile.VectorTileLayer still exists for tile/GeoJSON consumers, MVT fetch (e.g. com.xweather.mapsgl.map.mapbox.GlStencilCustomMaskCoordinator), and GLES stencil mesh build in com.xweather.mapsgl.renderers.TileLayerRenderer — only screen drawing via Mapbox paint is skipped.
Optional per-layer timing (Apple timing). When non-null, com.xweather.mapsgl.map.MapController.addLayer copies these fields onto the created com.xweather.mapsgl.layers.tile.TileLayer.timing. Null keeps the layer's existing defaults (time-series sources may still enable interval mode).
When true, eligible fill/line/circle/symbol layers draw via MapsGL GLES instead of Mapbox style layers. MVT sources use com.xweather.mapsgl.renderers.VectorFillLayerRenderer / com.xweather.mapsgl.renderers.VectorLineLayerRenderer / etc. GeoJSON fill, line, circle, symbol, and heatmap layers also support GLES when this flag is set.