Last CustomLayerRenderParameters.zoom from CustomLayerMatrixBridge.pushToCameraSync. Not cleared with customLayerRenderZoom so async CPU work (instanced wind gather) uses the same Mercator scale as the custom-layer projection matrices instead of MapboxMap.cameraState.zoom, which can diverge during pinch-zoom and causes rapid sub-pixel jitter.

mapboxModelViewMatrix

@JvmField

var mapboxModelViewMatrix: FloatArray?

mapboxProjectionMatrix

@JvmField

var mapboxProjectionMatrix: FloatArray?

Filled by CustomLayerMatrixBridge each com.mapbox.maps.CustomLayerHost.render frame. Encoded raster com.xweather.mapsgl.gl.RenderPass uses these (paired) so tiles share the same clip-space transform as the Mapbox basemap under pitch/bearing; do not mix with camera projection/view for that path.

mapZoom

var mapZoom: Double

MERCATOR_A

const val MERCATOR_A: Double

PROJECTION_WORLD_SIZE

const val PROJECTION_WORLD_SIZE: Double

RAD2DEG

const val RAD2DEG: Double

rotScalePitchMatrix

var rotScalePitchMatrix: Matrix4

scaleMatrix

var scaleMatrix: Matrix4

translationMatrix

var translationMatrix: Matrix4

WORLD_SIZE

const val WORLD_SIZE: Int = 1024000

worldMatrix

var worldMatrix: ProjectionMatrix

Functions

calculateCameraMatrixDeg

fun calculateCameraMatrixDeg(pitch: Float, bearing: Float, translateZ: Matrix4): Matrix4

Scale (tile zoom) then bearing (Z) then pitch (X), using post-multiplication so each rotation applies in map/tangent space: M = T_scale × R_z(-bearing) × R_x(pitch). The previous left-multiplication chain (R_x × R_z × T) put the map plane in the wrong orientation relative to the perspective camera except at specific bearing/pitch combos.

mercatorWorldPixelZoomFix

fun mercatorWorldPixelZoomFix(zBuild: Double): Float

CPU instance Mercator XY uses world pixels at zBuild (512×2^zBuild). Custom-layer P/MV are for zoomForCustomLayerInstancing. Apply this factor to stored positions in the vertex shader so they match the current matrices between async instance rebuilds (removes zoom jitter).

tileRasterOverscale

fun tileRasterOverscale(mapZoom: Double, tileZ: Int): Float

Extra scale for 512×512 raster tile quads in Mapbox custom-layer space relative to integer tile Z. Uses fractional mapZoom so encoded rasters track zoom between integers instead of stepping when mapZoom crosses whole numbers.

zoomForCustomLayerInstancing

fun zoomForCustomLayerInstancing(): Double

Zoom aligned with Mapbox custom-layer CustomLayerRenderParameters for this frame / last render.