leaflet-city-mapper 0.0.8 → 0.1.0

package/src/geometry/polygon.js

@@ -1,6 +1,13 @@
 import { line } from './line.js';
 import { fillNativePolygon } from './fillNativePolygon.js';
 
+/**
+ * Project polygon or line rings and append their fill and stroke geometry.
+ *
+ * @param {Object} context Projection, style and geometry buffers.
+ * @param {Array<Array<L.LatLng>>} rings Geographic rings or lines.
+ * @param {boolean} closed Whether to close and optionally fill the rings.
+ */
 export function polygon(context, rings, closed) {
   const { options, map } = context;
   const projected = /* alloc */ [];

package/src/geometry/quad.js

@@ -1,3 +1,17 @@
+/**
+ * Append a quad as two triangles at a common height.
+ *
+ * @param {Function} addTriangle Triangle destination callback.
+ * @param {Object} color Triangle color.
+ * @param {Object} a First corner.
+ * @param {Object} b Second corner.
+ * @param {Object} c Third corner.
+ * @param {Object} d Fourth corner.
+ * @param {number} height Quad height.
+ * @param {number|Array<number>} nx Normal x component or complete normal vector.
+ * @param {number} ny Normal y component when nx is numeric.
+ * @param {number} nz Normal z component when nx is numeric.
+ */
 export function quad(addTriangle, color, a, b, c, d, height, nx, ny, nz) {
   if (typeof nx !== 'number') {
     addTriangle(a, height, b, height, c, height, ...nx, color);

package/src/geometry/restoreGeometry.js

@@ -1,3 +1,9 @@
+/**
+ * Recreate geometry buffers on a device from retained CPU attributes.
+ *
+ * @param {Object} geometry Geometry and attribute data to restore.
+ * @param {GPUDevice} device Device receiving the buffers.
+ */
 export function restoreGeometry(geometry, device) {
   if (geometry.attributes.index?.data instanceof Uint8Array) {
     geometry.attributes.index.data = /* alloc */ new Uint16Array(geometry.attributes.index.data);

package/src/geometry/roofCoverage.js

@@ -1,11 +1,18 @@
-import { headerByLayer } from '../weakmaps/headerByLayer.js';
-import { rasterTilesByLayer } from '../weakmaps/rasterTilesByLayer.js';
-import { tileZoomByLayer } from '../weakmaps/tileZoomByLayer.js';
-
+import { headerByLayer } from '../weakmaps/headerByLayer.js';
+import { rasterTilesByLayer } from '../weakmaps/rasterTilesByLayer.js';
+import { tileZoomByLayer } from '../weakmaps/tileZoomByLayer.js';
 import { roofFootprint } from './roofFootprint.js';
 import { subtractRoofTile } from './subtractRoofTile.js';
 
-/** Test the mesh's ground footprint against loaded imagery, including coarse parent tiles. */
+/**
+ * Test the mesh's ground footprint against loaded imagery, including coarse parent tiles.
+ *
+ * @param {Object} mesh Mesh whose footprint is tested.
+ * @param {L.Layer} layer Rendering layer.
+ * @param {Array<L.Layer>} rasters Raster layers to inspect.
+ *
+ * @returns {boolean} Whether the footprint is covered or needs no imagery.
+ */
 export function roofCoverage(mesh, layer, rasters) {
   let intersectsArchive = false, pending = false;
   let rasterLayer, footprint, remaining, tile;

package/src/geometry/roofFootprint.js

@@ -1,10 +1,18 @@
-import { headerByLayer } from '../weakmaps/headerByLayer.js';
-import { sceneOriginByLayer } from '../weakmaps/sceneOriginByLayer.js';
-import { tileZoomByLayer } from '../weakmaps/tileZoomByLayer.js';
-
+import { headerByLayer } from '../weakmaps/headerByLayer.js';
+import { sceneOriginByLayer } from '../weakmaps/sceneOriginByLayer.js';
+import { tileZoomByLayer } from '../weakmaps/tileZoomByLayer.js';
 import { radians } from '../globals/radians.js';
 import { earthCirc } from '../globals/earthCirc.js';
 
+/**
+ * Project a mesh's bounding box into raster pixels and clip it to archive bounds.
+ *
+ * @param {Object} mesh Mesh with bounds and world matrix.
+ * @param {L.Layer} layer Rendering layer.
+ * @param {L.Layer} rasterLayer Raster layer providing zoom and archive bounds.
+ *
+ * @returns {Array<number>|null} Pixel rectangle, or null when outside the archive.
+ */
 export function roofFootprint(mesh, layer, rasterLayer) {
   const map = layer._map, bounds = mesh.geometry.bounds, world = mesh.worldMatrix;
   const zoom = tileZoomByLayer.get(rasterLayer)

package/src/geometry/routeGeometry.js

@@ -1,7 +1,12 @@
 import { appendRouteSegment } from './appendRouteSegment.js';
 
-/** Dashed lane outline, in layer-local metres. */
-
+/**
+ * Build dashed lane geometry in layer-local metres.
+ *
+ * @param {Array<Object>} lanes Lanes with points, cumulative lengths and optional route colors.
+ *
+ * @returns {Object} Flat position, normal and color arrays.
+ */
 export function routeGeometry(lanes) {
   const position = /* alloc */ [];
   const normal = /* alloc */ [];

package/src/geometry/samePoint.js

@@ -1,3 +1,11 @@
+/**
+ * Compare two 2D coordinates with the geometry tolerance.
+ *
+ * @param {Array<number>} a First coordinate.
+ * @param {Array<number>} b Second coordinate.
+ *
+ * @returns {boolean} Whether both components are within tolerance.
+ */
 export function samePoint(a, b) {
   return Math.abs(a[0] - b[0]) < 1e-10 && Math.abs(a[1] - b[1]) < 1e-10;
 }

package/src/geometry/segment.js

@@ -2,6 +2,15 @@ import { L } from '../globals/L.js';
 import { triangle } from './appendNativeTriangle.js';
 import { disk } from './disk.js';
 
+/**
+ * Append a stroke segment with optional square or round caps.
+ *
+ * @param {Object} context Line style and geometry buffers.
+ * @param {L.Point} a Segment start.
+ * @param {L.Point} b Segment end.
+ * @param {boolean} startCap Whether to add a start cap.
+ * @param {boolean} endCap Whether to add an end cap.
+ */
 export function segment(context, a, b, startCap, endCap) {
   const { options, width, stroke, point } = context;
   const radius = width / 2;

package/src/geometry/setVertexColor.js

@@ -1,11 +1,11 @@
 /**
  * Paints the vertices `[start, end)` of a mesh and marks its color buffer dirty.
+ *
  * @param {Object} mesh Layer-created mesh with a color attribute.
  * @param {number} start Inclusive vertex index, not an offset into the RGB array.
  * @param {number} end Exclusive vertex index.
  * @param {Object} color sRGB {r,g,b}, typically from parseColor().
  */
-
 export function setVertexColor(mesh, start, end, color) {
   const rgb = /* alloc */ [];
   let i;

package/src/geometry/shadowBounds.js

@@ -1,6 +1,14 @@
 import { computeBounds } from './computeBounds.js';
 import { meshShadowBounds } from './meshShadowBounds.js';
 
+/**
+ * Compute combined world-space mesh bounds including ground below them.
+ *
+ * @param {Array<Object>} meshes Shadow meshes.
+ * @param {Object} [output] Bounds object to populate.
+ *
+ * @returns {Object} Combined minimum and maximum bounds.
+ */
 export function shadowBounds(meshes, output = /* alloc */ {
   min: /* alloc */ [Infinity, Infinity, Infinity],
   max: /* alloc */ [-Infinity, -Infinity, -Infinity],

package/src/geometry/subtractRoofTile.js

@@ -1,3 +1,12 @@
+/**
+ * Subtract a raster tile's footprint from uncovered roof rectangles.
+ *
+ * @param {Array<Array<number>>} remaining Uncovered pixel rectangles.
+ * @param {Object} tile Raster tile with XYZ coordinates.
+ * @param {number} zoom Zoom used by the rectangles.
+ *
+ * @returns {Array<Array<number>>} Remaining uncovered rectangles.
+ */
 export function subtractRoofTile(remaining, tile, zoom) {
   const size = 256 * 2 ** (zoom - tile.coords.z);
   const left = tile.coords.x * size, top = tile.coords.y * size;

package/src/geometry/subtractVector.js

@@ -1,3 +1,11 @@
+/**
+ * Subtract one vector from another component by component.
+ *
+ * @param {ArrayLike<number>} a First vector.
+ * @param {ArrayLike<number>} b Vector to subtract.
+ *
+ * @returns {Array<number>} Difference vector.
+ */
 export function sub(a, b) {
   const result = /* alloc */ new Array(a.length);
   let i;

package/src/geometry/surface.js

@@ -1,7 +1,17 @@
 import { ringDirections } from '../globals/ringDirections.js';
-
 import { ring } from './createTreeRing.js';
 
+/**
+ * Generate the side surface between two eight-sided tree rings.
+ *
+ * @param {Object} point Ring center and ground height.
+ * @param {Function} addTriangle Triangle destination callback.
+ * @param {number} lowRadius Lower ring radius.
+ * @param {number} low Lower ring height.
+ * @param {number} highRadius Upper ring radius.
+ * @param {number} high Upper ring height.
+ * @param {Object} color Surface color.
+ */
 export function surface(point, addTriangle, lowRadius, low, highRadius, high, color) {
   const lower = ring(point, lowRadius), upper = ring(point, highRadius);
   let i, next, slope, length, nx, nz, ny, normalX, normalZ;

package/src/geometry/terrainBuffers.js

@@ -1,9 +1,16 @@
-import { rendererByLayer } from '../weakmaps/rendererByLayer.js';
-import { terrainGridsByLayer } from '../weakmaps/terrainGridsByLayer.js';
-
+import { rendererByLayer } from '../weakmaps/rendererByLayer.js';
+import { terrainGridsByLayer } from '../weakmaps/terrainGridsByLayer.js';
 import { demBuffer } from '../globals/demBuffer.js';
 import { terrainGrid } from './terrainGrid.js';
 
+/**
+ * Get or create cached GPU buffers for a terrain grid subdivision count.
+ *
+ * @param {L.Layer} layer Terrain layer owning the cache.
+ * @param {number} divisions Grid subdivisions per side.
+ *
+ * @returns {Object} GPU-backed grid attributes.
+ */
 export function terrainBuffers(layer, divisions) {
   const device = rendererByLayer.get(layer).device
   let attributes = terrainGridsByLayer.get(layer).get(divisions);

package/src/geometry/terrainGrid.js

@@ -1,5 +1,10 @@
-/** Unit tile grid; the vertex shader supplies the elevation. */
-
+/**
+ * Create a unit tile grid; the vertex shader supplies the elevation.
+ *
+ * @param {number} divisions Grid subdivisions per side.
+ *
+ * @returns {Object} Position, normal, UV and index attributes.
+ */
 export function terrainGrid(divisions) {
   const vertices = (divisions + 1) ** 2;
   const positions = /* alloc */ new Float32Array(vertices * 3);

package/src/geometry/terrainTileGeometry.js

@@ -1,8 +1,17 @@
-import { demByLayer } from '../weakmaps/demByLayer.js';
-import { rendererByLayer } from '../weakmaps/rendererByLayer.js';
-import { terrainOriginElevationByLayer } from '../weakmaps/terrainOriginElevationByLayer.js';
-
+import { demByLayer } from '../weakmaps/demByLayer.js';
+import { rendererByLayer } from '../weakmaps/rendererByLayer.js';
+import { terrainOriginElevationByLayer } from '../weakmaps/terrainOriginElevationByLayer.js';
 
+/**
+ * Create terrain tile geometry with bounds covering DEM-displaced elevations.
+ *
+ * @param {L.Layer} layer Terrain layer.
+ * @param {Object} attributes Shared terrain grid attributes.
+ * @param {number} sizeX Tile width in scene units.
+ * @param {number} sizeZ Tile depth in scene units.
+ *
+ * @returns {Object} Tile geometry and bounds.
+ */
 export function terrainTileGeometry(layer, attributes, sizeX, sizeZ) {
   const base = terrainOriginElevationByLayer.get(layer)
   const bottom = Math.min(demByLayer.get(layer).low, base) - base, top = Math.max(demByLayer.get(layer).high, base) - base;

package/src/geometry/treeGeometry.js

@@ -1,13 +1,16 @@
 import { roundProfile } from '../globals/roundProfile.js';
-
-
 import { parseColor } from "../colors/parseColor.js";
 import { ring } from './createTreeRing.js';
 import { surface } from './surface.js';
 import { validateTree } from './validateTree.js';
 
-/** Low-poly tree, sharing the source block's buffers, picking and terrain offset. */
-
+/**
+ * Generate a low-poly tree in the source block's geometry buffers.
+ *
+ * @param {Object} point Projected position and ground height.
+ * @param {Object} style Tree dimensions, crown shape and colors.
+ * @param {Function} addTriangle Triangle destination callback.
+ */
 export function treeGeometry(point, style, addTriangle) {
   const { top, bottom = 0, trunkRadius, crownRadius, crownBottom, crownShape = 'round' } = style;
   validateTree(trunkRadius, crownRadius, crownBottom, bottom, top, crownShape);

package/src/geometry/triangle.js

@@ -1,3 +1,14 @@
+/**
+ * Append a colored triangle and its normalized face normal.
+ *
+ * @param {Array<number>} position Destination positions.
+ * @param {Array<number>} normal Destination normals.
+ * @param {Array<number>} color Destination colors.
+ * @param {Array<number>} a First vertex.
+ * @param {Array<number>} b Second vertex.
+ * @param {Array<number>} c Third vertex.
+ * @param {Array<number>} tint RGB color.
+ */
 export function triangle(position, normal, color, a, b, c, tint) {
   const ux = b[0] - a[0], uy = b[1] - a[1], uz = b[2] - a[2];
   const vx = c[0] - a[0], vy = c[1] - a[1], vz = c[2] - a[2];

package/src/geometry/validateTree.js

@@ -1,3 +1,15 @@
+/**
+ * Validate tree radii, crown height and crown shape.
+ *
+ * @param {number} trunkRadius Trunk radius.
+ * @param {number} crownRadius Crown radius.
+ * @param {number} crownBottom Height where the crown begins.
+ * @param {number} bottom Tree bottom height.
+ * @param {number} top Tree top height.
+ * @param {string} crownShape Crown shape.
+ *
+ * @throws {Error} If dimensions or crown shape are invalid.
+ */
 export function validateTree(trunkRadius, crownRadius, crownBottom, bottom, top, crownShape) {
   if (!Number.isFinite(trunkRadius) || !Number.isFinite(crownRadius) || !Number.isFinite(crownBottom) ||
     trunkRadius <= 0 || crownRadius < trunkRadius || crownBottom <= bottom || crownBottom >= top ||

package/src/geometry/vertexNormals.js

@@ -1,5 +1,11 @@
-/** Area-weighted vertex normals, for indexed or non-indexed triangles. */
-
+/**
+ * Compute area-weighted vertex normals for indexed or non-indexed triangles.
+ *
+ * @param {ArrayLike<number>} p Flat vertex positions.
+ * @param {ArrayLike<number>} [indices] Optional triangle vertex indices.
+ *
+ * @returns {Float32Array} Normalized vertex normals.
+ */
 export function vertexNormals(p, indices) {
   // Accumulate area-weighted face normals for shared vertices, then normalize.
   const normals = /* alloc */ new Float32Array(p.length);

package/src/geometry/visitNativeCoordinates.js

@@ -1,6 +1,13 @@
 import { L } from '../globals/L.js';
 import { polygon } from './polygon.js';
 
+/**
+ * Visit nested native coordinates and generate polygon or line geometry.
+ *
+ * @param {Object} context Projection, style and geometry buffers.
+ * @param {Array} coordinates Nested Leaflet coordinates.
+ * @param {boolean} closed Whether the geometry is closed.
+ */
 export function visit(context, coordinates, closed) {
   if (!coordinates.length) return;
   let child;

package/src/globals/CELL.js

@@ -1,3 +1,7 @@
-// Walls (non-horizontal triangles) of a mesh in world space, bucketed by 8 m cells; `origin` is the world translation
-// at build time, since layer roots only move vertically with the terrain afterwards.
+/**
+ * Collision grid cell size in meters for world-space wall triangles. The cached
+ * origin is the build-time world translation; layer roots subsequently move only vertically.
+ *
+ * @type {number}
+ */
 export const CELL = 8;

package/src/globals/Compass.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for the compass camera handler constructor.
+ *
+ * @type {{value: Function|undefined}}
+ */
 export const Compass = { value: undefined };

package/src/globals/ContainerResize.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for the container resize camera handler constructor.
+ *
+ * @type {{value: Function|undefined}}
+ */
 export const ContainerResize = { value: undefined };

package/src/globals/HEIGHT.js

@@ -1 +1,6 @@
+/**
+ * Height over which model terrain-conformance weight falls to zero.
+ *
+ * @type {number}
+ */
 export const HEIGHT = 8;

package/src/globals/L.js

@@ -1 +1,6 @@
+/**
+ * Leaflet namespace supplied by the host environment.
+ *
+ * @type {Object}
+ */
 export const L = globalThis.L;

package/src/globals/PitchDrag.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for the pitch drag camera handler constructor.
+ *
+ * @type {{value: Function|undefined}}
+ */
 export const PitchDrag = { value: undefined };

package/src/globals/README.md

@@ -0,0 +1,28 @@
+# Shared globals
+
+[Source guide](../README.md) | [Project README](../../README.md)
+
+Holds shared constants, reusable buffers and descriptors, queues and mutable
+holders. Each module owns a single shared binding; callers should respect whether
+its contents are reusable mutable scratch state or an immutable constant.
+
+## Shared is not per-layer
+
+```mermaid
+flowchart LR
+  Globals["Shared module bindings"] --> Constants["Constants / saved methods"]
+  Globals --> Scratch["Reusable arrays / descriptors"]
+  Globals --> Queues["Shared queues / mutable holders"]
+  Queues --> Frames["Coalesced scene frames"]
+  Objects["Map / layer / mesh"] --> WeakMaps["Per-object WeakMaps"]
+```
+
+Scratch values are reused: do not retain them as private layer state. Clear
+temporary resource references as existing consumers do. Per-object lifetime
+belongs in [weakmaps](../weakmaps/README.md).
+
+- [L.js](./L.js): host Leaflet namespace.
+- [geometryWorkerUrl.js](./geometryWorkerUrl.js): default worker URL.
+- [pendingUpdates.js](./pendingUpdates.js): queued scene updates.
+
+Related: [weakmaps](../weakmaps/README.md), [scene](../scene/README.md).

package/src/globals/ShiftRotate.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for the shift-key rotation handler constructor.
+ *
+ * @type {{value: Function|undefined}}
+ */
 export const ShiftRotate = { value: undefined };

package/src/globals/TILE_RADIUS.js

@@ -1 +1,6 @@
+/**
+ * Maximum raster tile selection radius around the map center.
+ *
+ * @type {number}
+ */
 export const TILE_RADIUS = 6;

package/src/globals/TILE_SIZE.js

@@ -1 +1,6 @@
+/**
+ * Raster tile width and height in pixels.
+ *
+ * @type {number}
+ */
 export const TILE_SIZE = 256;

package/src/globals/TouchMode.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for the camera touch-mode handler constructor.
+ *
+ * @type {{value: Function|undefined}}
+ */
 export const TouchMode = { value: undefined };

package/src/globals/alphaBlend.js

@@ -1,3 +1,8 @@
+/**
+ * WebGPU blend configuration for transparent material color and alpha.
+ *
+ * @type {Object}
+ */
 export const alphaBlend = {
   color: {
     srcFactor: 'src-alpha',

package/src/globals/archiveDecoder.js

@@ -1 +1,6 @@
+/**
+ * Text decoder reused for archive source data.
+ *
+ * @type {TextDecoder}
+ */
 export const archiveDecoder = new TextDecoder();

package/src/globals/archiveNorthWest.js

@@ -1 +1,6 @@
+/**
+ * Reusable latitude-longitude pair for an archive's northwest corner.
+ *
+ * @type {Array<number>}
+ */
 export const archiveNorthWest = [0, 0];

package/src/globals/archiveSouthEast.js

@@ -1 +1,6 @@
+/**
+ * Reusable latitude-longitude pair for an archive's southeast corner.
+ *
+ * @type {Array<number>}
+ */
 export const archiveSouthEast = [0, 0];

package/src/globals/atmosphereColor.js

@@ -1 +1,6 @@
+/**
+ * Reusable color buffer for interpolated atmospheric gradients.
+ *
+ * @type {Array<number>}
+ */
 export const atmosphereColor = [0, 0, 0];

package/src/globals/atmosphereStops.js

@@ -1,3 +1,8 @@
+/**
+ * Sun elevation stops with sky, horizon and light colors for atmospheric interpolation.
+ *
+ * @type {Array}
+ */
 export const atmosphereStops = [
   [-18, [3, 7, 20],
     [17, 28, 54],

package/src/globals/blobParts.js

@@ -1 +1,6 @@
+/**
+ * Reusable one-element buffer for constructing raster tile blobs.
+ *
+ * @type {Array}
+ */
 export const blobParts = [null];

package/src/globals/cameraAngles.js

@@ -1 +1,6 @@
+/**
+ * Reusable buffer for camera bearing and pitch sine and cosine values.
+ *
+ * @type {Array<number>}
+ */
 export const cameraAngles = [1, 0, 1, 0];

package/src/globals/cameraAnimatedOptions.js

@@ -1,3 +1,8 @@
+/**
+ * Default animated options for resetting camera orientation.
+ *
+ * @type {Object}
+ */
 export const cameraAnimatedOptions = Object.freeze({
   animate: true
 });

package/src/globals/cameraAnimationFrame.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for the shared scheduled camera animation frame.
+ *
+ * @type {{value: number|null}}
+ */
 export const cameraAnimationFrame = { value: null };

package/src/globals/cameraAnimations.js

@@ -1 +1,6 @@
+/**
+ * Pending camera animations keyed by map.
+ *
+ * @type {Map<Object, Object>}
+ */
 export const cameraAnimations = new Map();

package/src/globals/cameraBearingSensitivity.js

@@ -1 +1,6 @@
+/**
+ * Drag sensitivities for bearing-only camera controls.
+ *
+ * @type {ReadonlyArray<number>}
+ */
 export const cameraBearingSensitivity = Object.freeze([0.8, 0]);

package/src/globals/cameraDragSensitivity.js

@@ -1 +1,6 @@
+/**
+ * Default bearing and pitch drag sensitivities for camera controls.
+ *
+ * @type {ReadonlyArray<number>}
+ */
 export const cameraDragSensitivity = Object.freeze([0.8, 0.5]);

package/src/globals/cameraDrags.js

@@ -1 +1,6 @@
+/**
+ * Mutable holder for active camera drag states.
+ *
+ * @type {{value: Set<Object>}}
+ */
 export const cameraDrags = { value: new Set() };

package/src/globals/cameraEmptyOptions.js

@@ -1 +1,6 @@
+/**
+ * Shared immutable empty options for camera operations.
+ *
+ * @type {Object}
+ */
 export const cameraEmptyOptions = Object.freeze({});

package/src/globals/cameraFocusOptions.js

@@ -1,3 +1,8 @@
+/**
+ * Focus options that prevent camera interaction from scrolling the page.
+ *
+ * @type {Object}
+ */
 export const cameraFocusOptions = Object.freeze({
   preventScroll: true
 });

package/src/globals/cameraFov.js

@@ -1,3 +1,8 @@
 import { degrees } from './degrees.js';
 
+/**
+ * Camera vertical field of view in degrees.
+ *
+ * @type {number}
+ */
 export const cameraFov = 2 * Math.atan(1 / 3) * degrees;

package/src/globals/cameraListenerOptions.js

@@ -1,3 +1,8 @@
+/**
+ * Capture and non-passive options for camera interaction listeners.
+ *
+ * @type {Object}
+ */
 export const cameraListenerOptions = Object.freeze({
   capture: true,
   passive: false

package/src/globals/cameraTouchStates.js

@@ -1 +1,6 @@
+/**
+ * Active camera touch states, used to end interactions on window blur.
+ *
+ * @type {Set<Object>}
+ */
 export const cameraTouchStates = new Set();

package/src/globals/cameraZeroPadding.js

@@ -1 +1,6 @@
+/**
+ * Default zero padding for camera bounds calculations.
+ *
+ * @type {ReadonlyArray<number>}
+ */
 export const cameraZeroPadding = Object.freeze([0, 0]);