@deck.gl-community/infovis-layers 9.3.2 → 9.3.7

package/dist/layers/block-layer/block-layer-vertex.glsl.js

@@ -0,0 +1,67 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export default `\
+#version 300 es
+#define SHADER_NAME block-layer-vertex-shader
+
+in vec3 positions;
+in vec3 instancePositions;
+in vec3 instancePositions64Low;
+in vec2 instanceSizes;
+in float instanceLineWidths;
+in vec4 instanceFillColors;
+in vec4 instanceLineColors;
+in vec3 instancePickingColors;
+
+out vec2 unitPosition;
+flat out vec4 vFillColor;
+flat out vec4 vLineColor;
+flat out float lineWidth;
+flat out vec2 size;
+
+// This needs to be added back to the project module
+vec2 project_size_to_pixel(vec2 size, int unit) {
+  if (unit == UNIT_PIXELS) return size;
+  if (unit == UNIT_COMMON && project.projectionMode != PROJECTION_MODE_IDENTITY) {
+    return size * project.scale;
+  }
+  return project_size(size) * project.scale;
+}
+
+float clamp_signed_size(float size, float minPixels, float maxPixels) {
+  float clampedMagnitude = clamp(abs(size), minPixels, maxPixels);
+  if (size < 0.0) {
+    return -clampedMagnitude;
+  }
+  return clampedMagnitude;
+}
+
+void main(void) {
+  geometry.worldPosition = instancePositions;
+  geometry.pickingColor = instancePickingColors;
+  geometry.uv = positions.xy;
+
+  vec2 pixelSize = project_size_to_pixel(instanceSizes, block.sizeUnits);
+  pixelSize.x = clamp_signed_size(pixelSize.x, block.widthMinPixels, block.sizeMaxPixels);
+  pixelSize.y = clamp_signed_size(pixelSize.y, block.heightMinPixels, block.sizeMaxPixels);
+  unitPosition = positions.xy;
+  size = pixelSize;
+  lineWidth = project_size_to_pixel(vec2(instanceLineWidths, 0.0), block.lineWidthUnits).x;
+
+  // Find the center of the point and add the current vertex
+  vec3 offset = vec3(unitPosition * project_pixel_size(pixelSize), 0.0);
+  DECKGL_FILTER_SIZE(offset, geometry);
+
+  gl_Position = project_position_to_clipspace(instancePositions, instancePositions64Low, offset, geometry.position);
+  DECKGL_FILTER_GL_POSITION(gl_Position, geometry);
+
+  // Apply opacity to instance color, or return instance picking color
+  vFillColor = vec4(instanceFillColors.rgb, instanceFillColors.a * layer.opacity);
+  DECKGL_FILTER_COLOR(vFillColor, geometry);
+
+  vLineColor = vec4(instanceLineColors.rgb, instanceLineColors.a * layer.opacity);
+  DECKGL_FILTER_COLOR(vLineColor, geometry);
+}
+`;
+//# sourceMappingURL=block-layer-vertex.glsl.js.map

package/dist/layers/block-layer/block-layer-vertex.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-layer-vertex.glsl.js","sourceRoot":"","sources":["../../../src/layers/block-layer/block-layer-vertex.glsl.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAEpC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Dd,CAAC"}

package/dist/layers/block-layer/block-layer.d.ts

@@ -0,0 +1,71 @@
+import { Accessor, AccessorFunction, Color, DefaultProps, Layer, LayerDataSource, LayerProps, Position, Unit, UpdateParameters } from '@deck.gl/core';
+import { Model } from '@luma.gl/engine';
+/** Properties supported by {@link BlockLayer}. */
+export type BlockLayerProps<DataT = unknown> = _BlockLayerProps<DataT> & LayerProps;
+/** Properties added by BlockLayer. */
+type _BlockLayerProps<DataT> = {
+    /** Data objects rendered as rectangular blocks. */
+    data: LayerDataSource<DataT>;
+    /**
+     * The units of the block size, one of `'meters'`, `'common'`, and `'pixels'`.
+     * @defaultValue 'meters'
+     */
+    sizeUnits?: Unit;
+    /**
+     * The minimum width in pixels. This prop can be used to prevent the block from getting too small when zoomed out.
+     * @defaultValue 0
+     */
+    widthMinPixels?: number;
+    /**
+     * The minimum height in pixels. This prop can be used to prevent the block from getting too small when zoomed out.
+     * @defaultValue 0
+     */
+    heightMinPixels?: number;
+    /**
+     * The maximum width or height in pixels. This prop can be used to prevent the block from getting too big when zoomed in.
+     * @defaultValue Number.MAX_SAFE_INTEGER
+     */
+    sizeMaxPixels?: number;
+    /**
+     * The units of the stroke width, one of `'meters'`, `'common'`, and `'pixels'`.
+     * @defaultValue 'pixels'
+     */
+    lineWidthUnits?: Unit;
+    /**
+     * The outline width of each object.
+     * @defaultValue 1
+     */
+    getLineWidth?: Accessor<DataT, number>;
+    /**
+     * Method called to retrieve the position of each object.
+     * @defaultValue object => object.position
+     */
+    getPosition?: AccessorFunction<DataT, Position>;
+    /** Width and height of each block. @defaultValue [10, 10] */
+    getSize?: Accessor<DataT, [number, number]>;
+    /**
+     * The rgba color is in the format of `[r, g, b, [a]]`
+     * @defaultValue [0, 0, 0, 255]
+     */
+    getLineColor?: Accessor<DataT, Color>;
+    /**
+     * The rgba color is in the format of `[r, g, b, [a]]`
+     * @defaultValue [0, 0, 0, 255]
+     */
+    getFillColor?: Accessor<DataT, Color>;
+};
+/** Renders axis-aligned rectangular blocks with fill and outline colors. */
+export declare class BlockLayer<DataT = any, ExtraPropsT extends {} = {}> extends Layer<ExtraPropsT & Required<_BlockLayerProps<DataT>>> {
+    static layerName: string;
+    static defaultProps: DefaultProps<BlockLayerProps<unknown>>;
+    state: {
+        model?: Model;
+    };
+    getShaders(): any;
+    initializeState(): void;
+    updateState(params: UpdateParameters<this>): void;
+    draw(): void;
+    protected _getModel(): Model;
+}
+export {};
+//# sourceMappingURL=block-layer.d.ts.map

package/dist/layers/block-layer/block-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-layer.d.ts","sourceRoot":"","sources":["../../../src/layers/block-layer/block-layer.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAEhB,KAAK,EACL,YAAY,EACZ,KAAK,EACL,eAAe,EACf,UAAU,EAEV,QAAQ,EAGR,IAAI,EACJ,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAW,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAuBhD,kDAAkD;AAClD,MAAM,MAAM,eAAe,CAAC,KAAK,GAAG,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;AAEpF,sCAAsC;AACtC,KAAK,gBAAgB,CAAC,KAAK,IAAI;IAC7B,mDAAmD;IACnD,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7B;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,IAAI,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChD,6DAA6D;IAC7D,OAAO,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvC,CAAC;AAEF,4EAA4E;AAC5E,qBAAa,UAAU,CAAC,KAAK,GAAG,GAAG,EAAE,WAAW,SAAS,EAAE,GAAG,EAAE,CAAE,SAAQ,KAAK,CAC7E,WAAW,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAChD;IACC,OAAgB,SAAS,SAAgB;IACzC,OAAgB,YAAY,yCAAgB;IAEnC,KAAK,EAAE;QACd,KAAK,CAAC,EAAE,KAAK,CAAC;KACf,CAAM;IAEE,UAAU;IAQnB,eAAe;IAoCN,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,IAAI;IAUjD,IAAI;IAcb,SAAS,CAAC,SAAS,IAAI,KAAK;CAgB7B"}

package/dist/layers/block-layer/block-layer.js

@@ -0,0 +1,108 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { color, Layer, picking, project32, UNIT } from '@deck.gl/core';
+import { Geometry, Model } from '@luma.gl/engine';
+import fs from './block-layer-fragment.glsl';
+import { blockUniforms } from "./block-layer-uniforms.js";
+import vs from './block-layer-vertex.glsl';
+const DEFAULT_COLOR = [0, 0, 0, 255];
+const defaultProps = {
+    sizeUnits: 'meters',
+    widthMinPixels: { type: 'number', min: 0, value: 0 },
+    heightMinPixels: { type: 'number', min: 0, value: 0 },
+    sizeMaxPixels: { type: 'number', min: 0, value: Number.MAX_SAFE_INTEGER },
+    lineWidthUnits: 'pixels',
+    getPosition: { type: 'accessor', value: (x) => x.position },
+    getSize: { type: 'accessor', value: [10, 10] },
+    getLineWidth: { type: 'accessor', value: 1 },
+    getFillColor: { type: 'accessor', value: DEFAULT_COLOR },
+    getLineColor: { type: 'accessor', value: DEFAULT_COLOR }
+};
+/** Renders axis-aligned rectangular blocks with fill and outline colors. */
+export class BlockLayer extends Layer {
+    static layerName = 'BlockLayer';
+    static defaultProps = defaultProps;
+    state = {};
+    getShaders() {
+        return super.getShaders({
+            vs,
+            fs,
+            modules: [project32, color, picking, blockUniforms]
+        });
+    }
+    initializeState() {
+        this.getAttributeManager().addInstanced({
+            instancePositions: {
+                size: 3,
+                type: 'float64',
+                fp64: this.use64bitPositions(),
+                transition: true,
+                accessor: 'getPosition'
+            },
+            instanceSizes: {
+                size: 2,
+                transition: true,
+                accessor: 'getSize'
+            },
+            instanceLineWidths: {
+                size: 1,
+                transition: true,
+                accessor: 'getLineWidth'
+            },
+            instanceLineColors: {
+                size: this.props.colorFormat.length,
+                type: 'unorm8',
+                transition: true,
+                accessor: 'getLineColor',
+                defaultValue: DEFAULT_COLOR
+            },
+            instanceFillColors: {
+                size: this.props.colorFormat.length,
+                type: 'unorm8',
+                transition: true,
+                accessor: 'getFillColor',
+                defaultValue: DEFAULT_COLOR
+            }
+        });
+    }
+    updateState(params) {
+        const { changeFlags } = params;
+        super.updateState(params);
+        if (changeFlags.extensionsChanged) {
+            this.state.model?.destroy();
+            this.state.model = this._getModel();
+            this.getAttributeManager().invalidateAll();
+        }
+    }
+    draw() {
+        const { sizeUnits, widthMinPixels, heightMinPixels, sizeMaxPixels, lineWidthUnits } = this.props;
+        const model = this.state.model;
+        const blockProps = {
+            sizeUnits: UNIT[sizeUnits],
+            widthMinPixels,
+            heightMinPixels,
+            sizeMaxPixels,
+            lineWidthUnits: UNIT[lineWidthUnits]
+        };
+        model.shaderInputs.setProps({ block: blockProps });
+        model.draw(this.context.renderPass);
+    }
+    _getModel() {
+        // a square
+        const positions = [0, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 0];
+        return new Model(this.context.device, {
+            ...this.getShaders(),
+            id: this.props.id,
+            bufferLayout: this.getAttributeManager().getBufferLayouts(),
+            geometry: new Geometry({
+                topology: 'triangle-strip',
+                attributes: {
+                    positions: new Float32Array(positions)
+                }
+            }),
+            isInstanced: true
+        });
+    }
+}
+//# sourceMappingURL=block-layer.js.map

package/dist/layers/block-layer/block-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-layer.js","sourceRoot":"","sources":["../../../src/layers/block-layer/block-layer.ts"],"names":[],"mappings":"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"}

package/dist/layers/fast-text-layer/fast-text-layer.d.ts

@@ -0,0 +1,148 @@
+import { Layer } from '@deck.gl/core';
+import { Buffer, Texture } from '@luma.gl/core';
+import { Model } from '@luma.gl/engine';
+import { FastTextFontAtlasManager } from "./font-atlas.js";
+import type { FastTextAlignmentBaseline, FastTextAnchor, FastTextClipRect, FastTextContentAlign, FastTextGlyphData, FastTextUtf8Column, FastTextUtf8ViewAccessor } from "./fast-text-layout.js";
+import type { FastTextCharacterMapping, FastTextFontAtlas, FastTextFontSettings } from "./font-atlas.js";
+import type { Accessor, Color, DefaultProps, LayerContext, LayerDataSource, LayerProps, Position, Unit, UpdateParameters } from '@deck.gl/core';
+/** Fast text layer props that intentionally cover dense Tracevis-style span labels. */
+export type _FastTextLayerProps<DataT> = {
+    /** Source label rows. */
+    data: LayerDataSource<DataT>;
+    /** If true, labels face the camera in screen space. */
+    billboard?: boolean;
+    /** Text size multiplier. */
+    sizeScale?: number;
+    /** Units for `size`, matching deck.gl size units. */
+    sizeUnits?: Unit;
+    /** Minimum rendered text size in screen pixels. */
+    sizeMinPixels?: number;
+    /** Maximum rendered text size in screen pixels. */
+    sizeMaxPixels?: number;
+    /** Fragment alpha cutoff below which a glyph pixel is discarded. */
+    alphaCutoff?: number;
+    /** Character set to place in the generated atlas, or `auto` to scan `getText`. */
+    characterSet?: FastTextFontSettings['characterSet'] | 'auto';
+    /** CSS font family used for generated atlases. */
+    fontFamily?: FastTextFontSettings['fontFamily'];
+    /** CSS font weight used for generated atlases. */
+    fontWeight?: FastTextFontSettings['fontWeight'];
+    /** Unitless line-height multiplier. */
+    lineHeight?: number;
+    /** Layer-wide text size. */
+    size?: number;
+    /** Layer-wide pixel offset applied after glyph layout. */
+    pixelOffset?: readonly [number, number];
+    /** Compatibility alias for callers that still inspect TextLayer-style pixel offset props. */
+    getPixelOffset?: readonly [number, number];
+    /** Additional atlas rasterization settings. */
+    fontSettings?: FastTextFontSettings;
+    /** Optional prebuilt mapping, supplied together with `fontAtlas`. */
+    characterMapping?: FastTextCharacterMapping | null;
+    /** Optional prebuilt atlas, supplied together with `characterMapping`. */
+    fontAtlas?: FastTextFontAtlas | null;
+    /** Label text accessor. */
+    getText?: Accessor<DataT, string>;
+    /** Optional UTF-8 text column used instead of `getText`. */
+    textUtf8Column?: FastTextUtf8Column | null;
+    /** Row accessor into `textUtf8Column`. Defaults to the source row index. */
+    getTextUtf8Row?: Accessor<DataT, number | null>;
+    /** Optional accessor that fills a reused UTF-8 byte view instead of calling `getText`. */
+    getTextUtf8?: FastTextUtf8ViewAccessor<DataT> | null;
+    /** Whether labels are expected to contain one line with no newline handling. */
+    singleLine?: boolean;
+    /** Label anchor position accessor. */
+    getPosition?: Accessor<DataT, Position>;
+    /** Label color accessor. */
+    getColor?: Accessor<DataT, Color>;
+    /** Layer-wide horizontal alignment. */
+    textAnchor?: FastTextAnchor;
+    /** Layer-wide vertical alignment. */
+    alignmentBaseline?: FastTextAlignmentBaseline;
+    /** Per-row content clip rectangle accessor. */
+    getClipRect?: Accessor<DataT, FastTextClipRect>;
+    /** Compatibility alias for callers that still inspect TextLayer-style content boxes. */
+    getContentBox?: Accessor<DataT, FastTextClipRect>;
+    /** Minimum visible content box dimensions in screen pixels. */
+    contentCutoffPixels?: readonly [width: number, height: number];
+    /** Horizontal alignment mode inside the visible content box. */
+    contentAlignHorizontal?: FastTextContentAlign;
+    /** Vertical alignment mode inside the visible content box. */
+    contentAlignVertical?: FastTextContentAlign;
+};
+/** Props accepted by {@link FastTextLayer}. */
+export type FastTextLayerProps<DataT = unknown> = _FastTextLayerProps<DataT> & LayerProps;
+/** Lightweight bitmap text layer backed by one typed-array glyph instance stream. */
+export declare class FastTextLayer<DataT = any, ExtraPropsT extends {} = {}> extends Layer<ExtraPropsT & Required<_FastTextLayerProps<DataT>>> {
+    static defaultProps: DefaultProps<FastTextLayerProps<unknown>>;
+    static layerName: string;
+    state: FastTextLayerState;
+    /** Return the shader set used by the direct glyph instance model. */
+    getShaders(): any;
+    /** Initialize the model and atlas manager. */
+    initializeState(): void;
+    /** Rebuild text layout or update dynamic glyph attributes when inputs change. */
+    updateState(params: UpdateParameters<this>): void;
+    /** Draw the glyph model when atlas texture and glyph buffers are ready. */
+    draw(): void;
+    /** Release GPU buffers, atlas texture, and the luma model. */
+    finalizeState(context: LayerContext): void;
+    /** Build a luma model for instanced glyph quads. */
+    private getModel;
+    /** Rebuild CPU glyph data, GPU vertex buffers, and the font atlas texture. */
+    private rebuildGlyphState;
+    /** Rewrite dynamic glyph attributes in place without rebuilding text layout. */
+    private updateDynamicGlyphState;
+    /** Return whether source data or UTF-8 column growth invalidated the current glyph layout. */
+    private hasMutableLayoutSourceChanged;
+    /** Resolve a caller-supplied atlas or rebuild the local generated atlas. */
+    private resolveFontAtlas;
+    /** Resolve the atlas pixel size used by glyph offsets. */
+    private resolveFontSize;
+    /** Resolve whether the current atlas should be sampled as SDF data. */
+    private resolveSdfEnabled;
+    /** Resolve the SDF smoothing width for the current atlas. */
+    private resolveSdfSmoothing;
+    /** Upload a new atlas texture when the atlas object changes. */
+    private syncAtlasTexture;
+}
+type FastTextLayerState = {
+    /** Atlas manager owned by this layer when no external atlas is supplied. */
+    fontAtlasManager: FastTextFontAtlasManager;
+    /** Luma model used to draw glyph quads. */
+    model?: Model;
+    /** Last expanded CPU glyph data. */
+    glyphData?: FastTextGlyphData;
+    /** Primitive source-shape values captured when `glyphData` was built. */
+    layoutSourceSignature?: FastTextLayoutSourceSignature;
+    /** GPU buffers for the current glyph data. */
+    buffers?: FastTextLayerBuffers;
+    /** Atlas object currently uploaded to `atlasTexture`. */
+    textureAtlas?: FastTextFontAtlas;
+    /** GPU texture for the current font atlas. */
+    atlasTexture?: Texture;
+    /** Atlas font size in pixels for the current glyph offsets. */
+    fontSize?: number;
+};
+type FastTextLayerBuffers = {
+    /** Packed glyph offsets, atlas frames, clip rectangles, and colors. */
+    instanceGlyphData: Buffer;
+    /** Repeated per-glyph anchor positions. */
+    instancePositions: Buffer;
+};
+type FastTextLayoutSourceSignature = {
+    /** Number of source rows visible through the data iterable. */
+    dataRowCount: number;
+    /** Whether source text comes from a row-level UTF-8 view accessor. */
+    hasTextUtf8Accessor: boolean;
+    /** Number of rows in the optional UTF-8 text column. */
+    textUtf8ColumnRowCount: number;
+    /** Number of chunks in the optional UTF-8 text column. */
+    textUtf8ColumnChunkCount: number;
+    /** Total entries across UTF-8 offset buffers. */
+    textUtf8ColumnOffsetCount: number;
+    /** Total bytes across UTF-8 value buffers. */
+    textUtf8ColumnValueByteLength: number;
+};
+export {};
+//# sourceMappingURL=fast-text-layer.d.ts.map

package/dist/layers/fast-text-layer/fast-text-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-text-layer.d.ts","sourceRoot":"","sources":["../../../src/layers/fast-text-layer/fast-text-layer.ts"],"names":[],"mappings":"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"}