Symbol
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.
Icon, text, and optional fill/stroke configuration.
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.