@meteo-render/raster 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/LICENSE +201 -0
  2. package/dist/index.cjs +2 -0
  3. package/dist/index.mjs +2 -0
  4. package/dist/index.umd.js +2 -0
  5. package/dist/leaflet.cjs +2 -0
  6. package/dist/leaflet.mjs +2 -0
  7. package/dist/leaflet.umd.js +2 -0
  8. package/dist/types/coreAdapter.d.ts +31 -0
  9. package/dist/types/image-overlay/leafletLayer.d.ts +2 -0
  10. package/dist/types/image-overlay/types.d.ts +19 -0
  11. package/dist/types/index.d.ts +15 -0
  12. package/dist/types/leaflet.d.ts +9 -0
  13. package/dist/types/point-overlay/data.d.ts +26 -0
  14. package/dist/types/point-overlay/frame.d.ts +4 -0
  15. package/dist/types/point-overlay/index.d.ts +3 -0
  16. package/dist/types/point-overlay/leafletLayer.d.ts +2 -0
  17. package/dist/types/point-overlay/rendering/canvasRenderer.d.ts +17 -0
  18. package/dist/types/point-overlay/rendering/color.d.ts +4 -0
  19. package/dist/types/point-overlay/rendering/createRenderer.d.ts +3 -0
  20. package/dist/types/point-overlay/rendering/iconResource.d.ts +3 -0
  21. package/dist/types/point-overlay/rendering/index.d.ts +3 -0
  22. package/dist/types/point-overlay/rendering/renderData.d.ts +3 -0
  23. package/dist/types/point-overlay/rendering/types.d.ts +30 -0
  24. package/dist/types/point-overlay/rendering/webgl2Renderer.d.ts +22 -0
  25. package/dist/types/point-overlay/rendering/webglRenderer.d.ts +25 -0
  26. package/dist/types/point-overlay/rendering/webgpuRenderer.d.ts +28 -0
  27. package/dist/types/point-overlay/types.d.ts +153 -0
  28. package/dist/types/raster-overlay/color.d.ts +11 -0
  29. package/dist/types/raster-overlay/core.d.ts +36 -0
  30. package/dist/types/raster-overlay/index.d.ts +8 -0
  31. package/dist/types/raster-overlay/leaflet-renderers/createRenderer.d.ts +3 -0
  32. package/dist/types/raster-overlay/leaflet-renderers/renderer.d.ts +1 -0
  33. package/dist/types/raster-overlay/leafletLayer.d.ts +77 -0
  34. package/dist/types/raster-overlay/leafletTypes.d.ts +21 -0
  35. package/dist/types/raster-overlay/query.d.ts +20 -0
  36. package/dist/types/raster-overlay/rasterTypes.d.ts +73 -0
  37. package/dist/types/raster-overlay/rendering/cpuRasterRenderer.d.ts +36 -0
  38. package/dist/types/raster-overlay/rendering/createRasterRenderer.d.ts +4 -0
  39. package/dist/types/raster-overlay/rendering/index.d.ts +7 -0
  40. package/dist/types/raster-overlay/rendering/rasterRenderState.d.ts +27 -0
  41. package/dist/types/raster-overlay/rendering/renderer.d.ts +15 -0
  42. package/dist/types/raster-overlay/rendering/webgl2RasterRenderer.d.ts +34 -0
  43. package/dist/types/raster-overlay/rendering/webglRasterRenderer.d.ts +36 -0
  44. package/dist/types/raster-overlay/rendering/webgpuRasterRenderer.d.ts +42 -0
  45. package/dist/types/raster-overlay/tooltipController.d.ts +22 -0
  46. package/dist/types/raster-overlay/types.d.ts +2 -0
  47. package/dist/types/raster-point-overlay/frameTypes.d.ts +52 -0
  48. package/dist/types/raster-point-overlay/index.d.ts +3 -0
  49. package/dist/types/raster-point-overlay/leafletLayer.d.ts +2 -0
  50. package/dist/types/raster-point-overlay/pointFrame.d.ts +2 -0
  51. package/dist/types/raster-point-overlay/types.d.ts +81 -0
  52. package/dist/types/raster-rendering/index.d.ts +8 -0
  53. package/dist/types/raster-rendering/types.d.ts +13 -0
  54. package/dist/types/raster-rendering/webgpuRasterTileRenderer.d.ts +29 -0
  55. package/dist/types/road-overlay/coordinateTransform.d.ts +1 -0
  56. package/dist/types/road-overlay/index.d.ts +11 -0
  57. package/dist/types/road-overlay/leaflet-renderers/createRenderer.d.ts +3 -0
  58. package/dist/types/road-overlay/leaflet-renderers/renderer.d.ts +1 -0
  59. package/dist/types/road-overlay/leafletLayer.d.ts +26 -0
  60. package/dist/types/road-overlay/options.d.ts +19 -0
  61. package/dist/types/road-overlay/rendering/index.d.ts +4 -0
  62. package/dist/types/road-overlay/rendering/renderer.d.ts +54 -0
  63. package/dist/types/road-overlay/rendering/roadRenderState.d.ts +137 -0
  64. package/dist/types/road-overlay/rendering/webgl2RoadRenderer.d.ts +38 -0
  65. package/dist/types/road-overlay/rendering/webgpuRoadRenderer.d.ts +134 -0
  66. package/dist/types/road-overlay/roadData.d.ts +17 -0
  67. package/dist/types/road-overlay/roadGeometry.d.ts +7 -0
  68. package/dist/types/road-overlay/roadMesh.d.ts +9 -0
  69. package/dist/types/road-overlay/types.d.ts +162 -0
  70. package/package.json +70 -0
@@ -0,0 +1,31 @@
1
+ import { type PointData, type RasterData } from '@meteo-render/core';
2
+ import type { IPointColumnData } from './point-overlay/types';
3
+ import type { RasterGrid } from './raster-overlay/rasterTypes';
4
+ export interface RasterGridAdapterOptions {
5
+ crs?: string;
6
+ noData?: number;
7
+ }
8
+ export interface CoreRasterGridAdapterOptions {
9
+ noData?: number;
10
+ maxDimension?: number;
11
+ }
12
+ export interface GeographicRasterBounds {
13
+ minLng: number;
14
+ maxLng: number;
15
+ minLat: number;
16
+ maxLat: number;
17
+ }
18
+ export interface RasterSourceWindow {
19
+ rowStart: number;
20
+ rowEnd: number;
21
+ columnStart: number;
22
+ columnEnd: number;
23
+ }
24
+ /** Adapt the legacy center-bounded grid without changing its sampled values. */
25
+ export declare const rasterGridToRasterData: (grid: RasterGrid, options?: RasterGridAdapterOptions) => RasterData;
26
+ /** Convert a core raster to the center-bounded EPSG:4326 grid shared by all raster backends. */
27
+ export declare const rasterDataToRasterGrid: (data: RasterData, options?: CoreRasterGridAdapterOptions) => RasterGrid;
28
+ /** Resolve a geographic viewport to source rows and columns for a GEOS raster. */
29
+ export declare const geographicBoundsToGeostationaryWindow: (data: RasterData, bounds: GeographicRasterBounds, paddingRatio?: number) => RasterSourceWindow | undefined;
30
+ /** Convert core point columns without materializing per-point objects. */
31
+ export declare const pointDataToPointColumnData: (data: PointData, noData?: number) => IPointColumnData;
@@ -0,0 +1,2 @@
1
+ import type { ImageLeafletLayer, ImageLeafletLayerCreateOptions } from './types';
2
+ export declare const createImageLeafletLayer: (options: ImageLeafletLayerCreateOptions) => ImageLeafletLayer;
@@ -0,0 +1,19 @@
1
+ import type * as L from 'leaflet';
2
+ import type { RasterRendererType, RasterSampleMode } from '../raster-overlay/rasterTypes';
3
+ export type ImageOverlaySource = string | Blob | CanvasImageSource;
4
+ export interface ImageLeafletLayerCreateOptions extends L.LayerOptions {
5
+ source: ImageOverlaySource;
6
+ bounds: L.LatLngBoundsExpression;
7
+ rendererType: RasterRendererType;
8
+ sampleMode?: RasterSampleMode;
9
+ opacity?: number;
10
+ crossOrigin?: '' | 'anonymous' | 'use-credentials';
11
+ }
12
+ export interface ImageLeafletLayer extends L.Layer {
13
+ setSource(source: ImageOverlaySource): Promise<void>;
14
+ setBounds(bounds: L.LatLngBoundsExpression): void;
15
+ setSampleMode(sampleMode: RasterSampleMode): void;
16
+ setOpacity(opacity: number): void;
17
+ redraw(): void;
18
+ getCanvas(): HTMLCanvasElement | null;
19
+ }
@@ -0,0 +1,15 @@
1
+ export * from './raster-rendering';
2
+ export * from './coreAdapter';
3
+ export { createImageLeafletLayer } from './image-overlay/leafletLayer';
4
+ export type { ImageLeafletLayer, ImageLeafletLayerCreateOptions, ImageOverlaySource } from './image-overlay/types';
5
+ export { createRasterPointFrame } from './raster-point-overlay/pointFrame';
6
+ export type * from './raster-point-overlay/frameTypes';
7
+ export { createPointFrame, normalizePointData } from './point-overlay/frame';
8
+ export type * from './point-overlay/types';
9
+ export { parseRoadGeoJson } from './road-overlay/roadGeometry';
10
+ export { buildRoadMesh } from './road-overlay/roadMesh';
11
+ export { prepareRoadData } from './road-overlay/roadData';
12
+ export { normalizeRoadLayerOptions } from './road-overlay/options';
13
+ export * from './road-overlay/rendering';
14
+ export type * from './road-overlay/types';
15
+ export type * from './raster-overlay/leafletTypes';
@@ -0,0 +1,9 @@
1
+ export { createRasterLeafletLayer } from './raster-overlay/leafletLayer';
2
+ export type { RasterLeafletLayer } from './raster-overlay/leafletLayer';
3
+ export { createRasterTooltipController } from './raster-overlay/tooltipController';
4
+ export type { RasterTooltipController } from './raster-overlay/tooltipController';
5
+ export { createPointLeafletLayer } from './point-overlay/leafletLayer';
6
+ export { createRasterPointLeafletLayer } from './raster-point-overlay/leafletLayer';
7
+ export { createRoadLeafletLayer } from './road-overlay/leafletLayer';
8
+ export { createImageLeafletLayer } from './image-overlay/leafletLayer';
9
+ export type { ImageLeafletLayer, ImageLeafletLayerCreateOptions, ImageOverlaySource } from './image-overlay/types';
@@ -0,0 +1,26 @@
1
+ import type { IPointColumnData, IPointFeature, PointDataSource, PointIdArray, PointNameArray, PointProperties, PointValueArray } from './types';
2
+ export interface IPointSpatialIndex {
3
+ bounds: {
4
+ minX: number;
5
+ maxX: number;
6
+ minY: number;
7
+ maxY: number;
8
+ };
9
+ cellCount: number;
10
+ offsets: Uint32Array;
11
+ indices: Uint32Array;
12
+ }
13
+ export interface INormalizedPointData {
14
+ x: IPointColumnData['x'];
15
+ y: IPointColumnData['y'];
16
+ values: PointValueArray;
17
+ ids?: PointIdArray;
18
+ names?: PointNameArray;
19
+ properties?: readonly (PointProperties | undefined)[];
20
+ noData?: number;
21
+ index: IPointSpatialIndex;
22
+ }
23
+ export declare const normalizePointData: (source: PointDataSource) => INormalizedPointData;
24
+ export declare const normalizePointDataAsync: (source: PointDataSource, isCurrent?: () => boolean) => Promise<INormalizedPointData | null>;
25
+ export declare const replacePointValues: (data: INormalizedPointData, values: PointValueArray) => INormalizedPointData;
26
+ export declare const getPointFeature: (data: INormalizedPointData, index: number) => IPointFeature;
@@ -0,0 +1,4 @@
1
+ import type { INormalizedPointData } from './data';
2
+ import type { IPointFrame, IPointFrameOptions, MapCrs, MapRenderViewport } from './types';
3
+ export { normalizePointData } from './data';
4
+ export declare const createPointFrame: (data: INormalizedPointData, viewport: MapRenderViewport, crs: MapCrs, options?: IPointFrameOptions) => IPointFrame;
@@ -0,0 +1,3 @@
1
+ export { createPointLeafletLayer } from './leafletLayer';
2
+ export { createPointFrame, normalizePointData } from './frame';
3
+ export type { IPointCircleIcon, IPointAlwaysVisibleStation, IPointAlwaysVisibleStyle, IPointColorOptions, IPointColumnData, IPointDataItem, IPointFeature, IPointFrame, IPointFrameOptions, IPointInteractionOptions, IPointLabelPartOptions, IPointLeafletLayer, IPointLeafletLayerCreateOptions, IPointLodOptions, IPointPngIcon, IPointSvgIcon, PointCallback, PointAlwaysVisible, PointColorMode, PointCoordinateArray, PointDataSource, PointIconOptions, PointId, PointIdArray, PointLabelContent, PointLabelOptions, PointLabelPosition, PointNameArray, PointProperties, PointRendererType, PointValueArray } from './types';
@@ -0,0 +1,2 @@
1
+ import { IPointLeafletLayer, IPointLeafletLayerCreateOptions } from './types';
2
+ export declare const createPointLeafletLayer: (options: IPointLeafletLayerCreateOptions) => IPointLeafletLayer;
@@ -0,0 +1,17 @@
1
+ import type { IPointRenderer, IPointRenderInput } from './types';
2
+ import type { PointIconOptions } from '../types';
3
+ export declare class CanvasPointRenderer implements IPointRenderer {
4
+ private readonly canvas;
5
+ readonly type: 'cpu';
6
+ private icon;
7
+ private iconGeneration;
8
+ private readonly tintedIcons;
9
+ constructor(canvas: HTMLCanvasElement);
10
+ setIcon(icon: PointIconOptions): Promise<void>;
11
+ resize(width: number, height: number): void;
12
+ render(input: IPointRenderInput): void;
13
+ clear(): void;
14
+ destroy(): void;
15
+ private drawPoint;
16
+ private getTintedIcon;
17
+ }
@@ -0,0 +1,4 @@
1
+ import type { ColorStop } from '@meteo-render/rendering';
2
+ import type { PointColorMode } from '../types';
3
+ export declare const resolvePointColor: (value: number, mode: PointColorMode, fixedColor: readonly [number, number, number, number], colorStops: readonly ColorStop[]) => readonly [number, number, number, number];
4
+ export declare const rgbaToCss: (color: readonly [number, number, number, number]) => string;
@@ -0,0 +1,3 @@
1
+ import type { PointRendererType } from '../types';
2
+ import type { IPointRenderer } from './types';
3
+ export declare const createPointRenderer: (canvas: HTMLCanvasElement, requestedType?: PointRendererType) => IPointRenderer;
@@ -0,0 +1,3 @@
1
+ import type { PointIconOptions } from '../types';
2
+ import type { IPointIconResource } from './types';
3
+ export declare const loadPointIconResource: (icon: PointIconOptions) => Promise<IPointIconResource>;
@@ -0,0 +1,3 @@
1
+ export { createPointRenderer } from './createRenderer';
2
+ export type { IPointRenderer, IPointRenderInput } from './types';
3
+ export { createPointRenderData } from './renderData';
@@ -0,0 +1,3 @@
1
+ import type { IPointRenderInput } from './types';
2
+ /** Build the backend-neutral per-instance position/value color stream. */
3
+ export declare const createPointRenderData: (input: IPointRenderInput) => Float32Array<ArrayBuffer>;
@@ -0,0 +1,30 @@
1
+ import type { ColorStop } from '@meteo-render/rendering';
2
+ import type { INormalizedPointData } from '../data';
3
+ import type { IPointFrame, PointColorMode, PointIconOptions, PointRendererType } from '../types';
4
+ export interface IPointIconResource {
5
+ type: PointIconOptions['type'];
6
+ image: CanvasImageSource | null;
7
+ width: number;
8
+ height: number;
9
+ anchorX: number;
10
+ anchorY: number;
11
+ radius: number;
12
+ strokeColor: readonly [number, number, number, number];
13
+ strokeWidth: number;
14
+ }
15
+ export interface IPointRenderInput {
16
+ data: INormalizedPointData;
17
+ frame: IPointFrame;
18
+ colorMode: PointColorMode;
19
+ colorStops: readonly ColorStop[];
20
+ fixedColor: readonly [number, number, number, number];
21
+ opacity: number;
22
+ }
23
+ export interface IPointRenderer {
24
+ readonly type: Exclude<PointRendererType, 'canvas'>;
25
+ setIcon(icon: PointIconOptions): Promise<void>;
26
+ render(input: IPointRenderInput): void;
27
+ resize(width: number, height: number): void;
28
+ clear(): void;
29
+ destroy(): void;
30
+ }
@@ -0,0 +1,22 @@
1
+ import type { PointIconOptions } from '../types';
2
+ import type { IPointRenderer, IPointRenderInput } from './types';
3
+ export declare class Webgl2PointRenderer implements IPointRenderer {
4
+ private readonly canvas;
5
+ readonly type: 'webgl2';
6
+ private readonly gl;
7
+ private readonly program;
8
+ private readonly pointBuffer;
9
+ private readonly texture;
10
+ private icon;
11
+ private iconGeneration;
12
+ constructor(canvas: HTMLCanvasElement);
13
+ setIcon(icon: PointIconOptions): Promise<void>;
14
+ resize(width: number, height: number): void;
15
+ render(input: IPointRenderInput): void;
16
+ clear(): void;
17
+ destroy(): void;
18
+ private initialize;
19
+ private uploadTexture;
20
+ private updateUniforms;
21
+ private location;
22
+ }
@@ -0,0 +1,25 @@
1
+ import type { PointIconOptions } from '../types';
2
+ import type { IPointRenderer, IPointRenderInput } from './types';
3
+ export declare class WebglPointRenderer implements IPointRenderer {
4
+ private readonly canvas;
5
+ readonly type: 'webgl';
6
+ private readonly gl;
7
+ private readonly instancing;
8
+ private readonly program;
9
+ private readonly pointBuffer;
10
+ private readonly cornerBuffer;
11
+ private readonly texture;
12
+ private icon;
13
+ private iconGeneration;
14
+ constructor(canvas: HTMLCanvasElement);
15
+ setIcon(icon: PointIconOptions): Promise<void>;
16
+ resize(width: number, height: number): void;
17
+ render(input: IPointRenderInput): void;
18
+ clear(): void;
19
+ destroy(): void;
20
+ private initialize;
21
+ private uploadTexture;
22
+ private bindAttribute;
23
+ private updateUniforms;
24
+ private location;
25
+ }
@@ -0,0 +1,28 @@
1
+ import type { PointIconOptions } from '../types';
2
+ import type { IPointRenderer, IPointRenderInput } from './types';
3
+ export declare class WebgpuPointRenderer implements IPointRenderer {
4
+ private readonly canvas;
5
+ readonly type: 'webgpu';
6
+ private device;
7
+ private context;
8
+ private pipeline;
9
+ private paramsBuffer;
10
+ private pointBuffer;
11
+ private pointBufferSize;
12
+ private texture;
13
+ private sampler;
14
+ private bindGroup;
15
+ private icon;
16
+ private iconGeneration;
17
+ private destroyed;
18
+ private readonly ready;
19
+ constructor(canvas: HTMLCanvasElement);
20
+ setIcon(icon: PointIconOptions): Promise<void>;
21
+ resize(width: number, height: number): void;
22
+ render(input: IPointRenderInput): void;
23
+ clear(): void;
24
+ destroy(): void;
25
+ private initialize;
26
+ private ensurePointBuffer;
27
+ private uploadTexture;
28
+ }
@@ -0,0 +1,153 @@
1
+ import type * as L from 'leaflet';
2
+ import type { ColorRange, ColorStopInput } from '@meteo-render/rendering';
3
+ import type { MapCrs, MapRenderViewport } from '@meteo-render/rendering';
4
+ export type PointCoordinateArray = Float32Array | Float64Array;
5
+ export type PointValueArray = Float32Array | Float64Array;
6
+ export type PointId = string | number;
7
+ export type PointIdArray = readonly PointId[] | Uint32Array;
8
+ export type PointNameArray = readonly string[] | Uint32Array;
9
+ export type PointProperties = Record<string, unknown>;
10
+ export type PointLabelContent = 'none' | 'value' | 'name' | 'name-value';
11
+ export type PointLabelPosition = 'top' | 'bottom';
12
+ export interface IPointDataItem {
13
+ id?: PointId;
14
+ x: number;
15
+ y: number;
16
+ value: number;
17
+ name?: string | number;
18
+ properties?: PointProperties;
19
+ }
20
+ export interface IPointLabelPartOptions {
21
+ position?: PointLabelPosition;
22
+ color?: string;
23
+ font?: string;
24
+ }
25
+ export interface PointLabelOptions {
26
+ content?: PointLabelContent;
27
+ getName?: (point: IPointFeature) => string | null | undefined;
28
+ formatter?: (point: IPointFeature, name: string | null) => string;
29
+ valueFormatter?: (value: number | string, point: IPointFeature) => string;
30
+ minZoom?: number;
31
+ color?: string;
32
+ font?: string;
33
+ offset?: number;
34
+ lineHeight?: number;
35
+ position?: PointLabelPosition;
36
+ name?: IPointLabelPartOptions;
37
+ value?: IPointLabelPartOptions;
38
+ }
39
+ export interface IPointColumnData {
40
+ x: PointCoordinateArray;
41
+ y: PointCoordinateArray;
42
+ values: PointValueArray;
43
+ ids?: PointIdArray;
44
+ names?: PointNameArray;
45
+ properties?: readonly (PointProperties | undefined)[];
46
+ noData?: number;
47
+ }
48
+ export type PointDataSource = readonly IPointDataItem[] | IPointColumnData;
49
+ export interface IPointFeature extends IPointDataItem {
50
+ index: number;
51
+ }
52
+ export interface IPointFrame {
53
+ indices: Uint32Array;
54
+ screenX: Float32Array;
55
+ screenY: Float32Array;
56
+ }
57
+ export interface IPointFrameOptions {
58
+ minSpacing?: number;
59
+ maxPoints?: number;
60
+ candidateFactor?: number;
61
+ fullDisplayZoom?: number;
62
+ alwaysVisible?: readonly PointAlwaysVisible[];
63
+ colorRange?: ColorRange | null;
64
+ }
65
+ export interface IPointAlwaysVisibleStyle {
66
+ radius?: number;
67
+ fillColor?: string;
68
+ strokeColor?: string;
69
+ strokeWidth?: number;
70
+ opacity?: number;
71
+ }
72
+ /** Priority station data, matched by ID when present and otherwise by exact x/y. */
73
+ export interface IPointAlwaysVisibleStation extends IPointDataItem {
74
+ style?: IPointAlwaysVisibleStyle;
75
+ }
76
+ export type PointAlwaysVisible = IPointAlwaysVisibleStation;
77
+ export interface IPointCircleIcon {
78
+ type: 'circle';
79
+ radius?: number;
80
+ strokeColor?: string;
81
+ strokeWidth?: number;
82
+ }
83
+ export interface IPointImageIconBase {
84
+ source: string | CanvasImageSource;
85
+ width?: number;
86
+ height?: number;
87
+ anchorX?: number;
88
+ anchorY?: number;
89
+ }
90
+ export interface IPointSvgIcon extends IPointImageIconBase {
91
+ type: 'svg';
92
+ }
93
+ export interface IPointPngIcon extends IPointImageIconBase {
94
+ type: 'png';
95
+ }
96
+ export interface IPointNoneIcon {
97
+ type: 'none';
98
+ }
99
+ export type PointIconOptions = IPointCircleIcon | IPointSvgIcon | IPointPngIcon | IPointNoneIcon;
100
+ export type PointColorMode = 'fixed' | 'value';
101
+ export interface IPointColorOptions {
102
+ mode?: PointColorMode;
103
+ color?: string;
104
+ colorStops?: ColorStopInput[];
105
+ colorRange?: ColorRange | null;
106
+ }
107
+ export interface IPointLodOptions {
108
+ minSpacing?: number;
109
+ maxPoints?: number;
110
+ candidateFactor?: number;
111
+ /** Show every visible station at and above this zoom. */
112
+ fullDisplayZoom?: number;
113
+ /** Priority station data objects that always bypass visual LOD. */
114
+ alwaysVisible?: readonly PointAlwaysVisible[];
115
+ }
116
+ export interface IPointInteractionOptions {
117
+ hover?: boolean;
118
+ click?: boolean;
119
+ selectOnClick?: boolean;
120
+ hitRadius?: number;
121
+ tooltip?: {
122
+ enabled?: boolean;
123
+ formatter?: (point: IPointFeature) => string;
124
+ };
125
+ }
126
+ /** Point rendering backend. `canvas` is kept as a compatibility alias of `cpu`. */
127
+ export type PointRendererType = 'cpu' | 'webgl' | 'webgl2' | 'webgpu' | 'canvas';
128
+ export type PointCallback = (point: IPointFeature) => void;
129
+ export interface IPointLeafletLayerCreateOptions extends L.LayerOptions {
130
+ data: PointDataSource;
131
+ rendererType?: PointRendererType;
132
+ icon?: PointIconOptions;
133
+ color?: IPointColorOptions;
134
+ lod?: IPointLodOptions;
135
+ label?: PointLabelOptions;
136
+ opacity?: number;
137
+ interaction?: IPointInteractionOptions;
138
+ onHover?: PointCallback;
139
+ onClick?: PointCallback;
140
+ }
141
+ export interface IPointLeafletLayer extends L.Layer {
142
+ setData: (data: PointDataSource) => Promise<void>;
143
+ setValues: (values: PointValueArray) => void;
144
+ setIcon: (icon: PointIconOptions) => Promise<void>;
145
+ setColorOptions: (color: IPointColorOptions) => void;
146
+ setLodOptions: (lod: IPointLodOptions) => void;
147
+ setInteractionOptions: (interaction: IPointInteractionOptions) => void;
148
+ setOpacity: (opacity: number) => void;
149
+ redraw: () => void;
150
+ getCanvas: () => HTMLCanvasElement | null;
151
+ clearSelection: () => void;
152
+ }
153
+ export type { ColorRange, ColorStopInput, MapCrs, MapRenderViewport };
@@ -0,0 +1,11 @@
1
+ import type { RasterColorStopInput, RasterColorStop } from './rasterTypes';
2
+ /**
3
+ * 归一化到 0-1的rgba
4
+ * @param colorStops
5
+ */
6
+ export declare const normalizeColorStops: (colorStops: RasterColorStopInput[]) => RasterColorStop[];
7
+ /**
8
+ * 解析颜色
9
+ * @param color
10
+ */
11
+ export declare const parseRasterColor: (color: string) => RasterColorStop['color'];
@@ -0,0 +1,36 @@
1
+ import type { RasterGrid, RasterLoadOptions, RasterParams, RasterSource } from './rasterTypes';
2
+ /**
3
+ * 根据直接参数创建统一栅格数据
4
+ * @param params
5
+ * @param options
6
+ */
7
+ export declare const createGridFromParams: (params: RasterParams, options?: RasterLoadOptions) => RasterGrid;
8
+ /**
9
+ * 解析 MICAPS4 文本内容并转换为统一栅格数据
10
+ * @param text
11
+ * @param options
12
+ */
13
+ export declare const parseMicaps4Text: (text: string, options?: RasterLoadOptions) => RasterGrid;
14
+ /**
15
+ * 从URL加载M4文件
16
+ * @param url
17
+ * @param options
18
+ */
19
+ export declare const loadMicaps4Grid: (url: string, options?: RasterLoadOptions) => Promise<RasterGrid>;
20
+ /**
21
+ * 从URL加载tif, 首个图像
22
+ * @param url
23
+ * @param options
24
+ */
25
+ export declare const loadTifGrid: (url: string, options?: RasterLoadOptions) => Promise<RasterGrid>;
26
+ /**
27
+ * 根据数据源加载统一的栅格数据
28
+ * @param source
29
+ * @param options
30
+ */
31
+ export declare const loadRasterGrid: (source: RasterSource, options?: RasterLoadOptions) => Promise<RasterGrid>;
32
+ /**
33
+ * 验证栅格数据的合法性
34
+ * @param grid
35
+ */
36
+ export declare const validateRasterGrid: (grid: RasterGrid) => RasterGrid;
@@ -0,0 +1,8 @@
1
+ export { createGridFromParams, loadMicaps4Grid, loadRasterGrid, loadTifGrid, parseMicaps4Text, validateRasterGrid } from './core';
2
+ export { normalizeColorStops, parseRasterColor } from './color';
3
+ export { queryRasterValue, queryRasterValues } from './query';
4
+ export { createRasterLeafletLayer } from './leafletLayer';
5
+ export type { RasterLeafletLayer } from './leafletLayer';
6
+ export { CpuRasterRenderer, RasterRenderState, WebglRasterRenderer, Webgl2RasterRenderer, WebgpuRasterRenderer } from './rendering';
7
+ export type { RasterRenderer } from './rendering';
8
+ export type { RasterColorRange, RasterColorStopInput, RasterColorStop, RasterGrid, RasterLeafletLayerCreateOptions, RasterRendererType, RasterColorMode, RasterSampleMode, RasterQueryPoint, RasterQueryReason, RasterQueryResult, RasterQueryOptions, RasterQueryCallback, RasterQueryEvent, RasterTooltipOptions, RasterSource, RasterClipOptions, RasterClipMode, RasterParams, RasterLoadOptions, RasterRendererCreateOptions } from './types';
@@ -0,0 +1,3 @@
1
+ import type { RasterRendererCreateOptions, RasterRendererType } from '../types';
2
+ import type { RasterRenderer } from '../rendering/renderer';
3
+ export declare const createRasterLeafletRenderer: (rendererType: RasterRendererType, options: RasterRendererCreateOptions) => RasterRenderer;
@@ -0,0 +1 @@
1
+ export type { RasterRenderer as RasterLeafletRenderer } from '../rendering/renderer';
@@ -0,0 +1,77 @@
1
+ import * as L from 'leaflet';
2
+ import type { RasterColorRange, RasterColorStopInput, RasterGrid, RasterLeafletLayerCreateOptions, RasterParams, RasterSource, RasterColorMode, RasterSampleMode, RasterQueryPoint, RasterQueryResult } from './types';
3
+ import type { ClipMode } from '@meteo-render/rendering';
4
+ export interface RasterLeafletLayer extends L.Layer {
5
+ /**
6
+ * 使用直接参数更新栅格数据
7
+ */
8
+ setParams: (params: RasterParams) => Promise<void>;
9
+ /**
10
+ * 使用TIF、MICAPS4或参数数据源更新栅格数据
11
+ */
12
+ setSource: (source: RasterSource) => Promise<void>;
13
+ /**
14
+ * 重绘当前视口
15
+ */
16
+ redraw: () => void;
17
+ /**
18
+ * 获取当前图层的canvas, 导出图片可能会用到这个功能
19
+ */
20
+ getCanvas: () => HTMLCanvasElement | null;
21
+ /**
22
+ * 更新显示值范围
23
+ * @param range
24
+ */
25
+ setColorRange: (range: RasterColorRange) => void;
26
+ /**
27
+ * 更新颜色映射模式
28
+ * @param colorMode
29
+ */
30
+ setColorMode: (colorMode: RasterColorMode) => void;
31
+ /**
32
+ * 更新栅格空间采样模式
33
+ * @param sampleMode
34
+ */
35
+ setSampleMode: (sampleMode: RasterSampleMode) => void;
36
+ /**
37
+ * 更新图层透明度
38
+ * @param opacity
39
+ */
40
+ setOpacity: (opacity: number) => void;
41
+ /**
42
+ * 更新栅格数据并重新上传GPU纹理
43
+ */
44
+ setGrid: (grid: RasterGrid) => Promise<void>;
45
+ /**
46
+ * 更新外部字符串色标配置
47
+ */
48
+ setColorStops: (colorStops: RasterColorStopInput[]) => void;
49
+ /** 控制裁剪区域外是否仍执行查询和提示。 */
50
+ setQueryOutsideClip: (enabled: boolean) => void;
51
+ setClipMode: (mode: ClipMode) => void;
52
+ /**
53
+ * Query the raster value at a normalized x/y coordinate.
54
+ * 按统一的 x/y 坐标查询栅格值
55
+ */
56
+ queryValueAt: (point: RasterQueryPoint) => RasterQueryResult;
57
+ /**
58
+ * Query raster values at normalized x/y coordinates.
59
+ * 按统一的 x/y 坐标批量查询栅格值
60
+ */
61
+ queryValuesAt: (points: readonly RasterQueryPoint[]) => RasterQueryResult[];
62
+ /**
63
+ * Query the raster value at a Leaflet latLng.
64
+ * 按 Leaflet 的经纬度查询栅格值
65
+ */
66
+ queryValueAtLatLng: (latLng: L.LatLngExpression) => RasterQueryResult;
67
+ /**
68
+ * Query raster values at Leaflet latLngs.
69
+ * 按 Leaflet 经纬度批量查询栅格值
70
+ */
71
+ queryValuesAtLatLng: (latLngs: readonly L.LatLngExpression[]) => RasterQueryResult[];
72
+ }
73
+ /**
74
+ * leaflet 栅格图层工厂函数
75
+ * @param options
76
+ */
77
+ export declare const createRasterLeafletLayer: (options: RasterLeafletLayerCreateOptions) => RasterLeafletLayer;
@@ -0,0 +1,21 @@
1
+ import type * as L from 'leaflet';
2
+ import type { RasterColorStopInput, RasterQueryCallback, RasterQueryResult, RasterRendererCreateOptions, RasterRendererType } from './rasterTypes';
3
+ /** Leaflet 栅格图层创建配置。 */
4
+ export interface RasterLeafletLayerCreateOptions extends RasterRendererCreateOptions<RasterColorStopInput> {
5
+ pane?: string;
6
+ rendererType: RasterRendererType;
7
+ onHover?: RasterQueryCallback;
8
+ onClick?: RasterQueryCallback;
9
+ tooltip?: RasterTooltipOptions;
10
+ queryOutsideClip?: boolean;
11
+ }
12
+ export interface RasterQueryEvent extends L.LeafletEvent {
13
+ result: RasterQueryResult;
14
+ latlng: L.LatLng;
15
+ originalEvent: MouseEvent;
16
+ }
17
+ export interface RasterTooltipOptions {
18
+ enabled?: boolean;
19
+ position?: 'follow' | 'fixed';
20
+ formatter?: (result: RasterQueryResult) => string;
21
+ }
@@ -0,0 +1,20 @@
1
+ import type { RasterGrid, RasterQueryPoint, RasterQueryResult, RasterQueryOptions } from './rasterTypes';
2
+ export declare const formatRasterQueryResult: (result: RasterQueryResult) => string;
3
+ /**
4
+ * Query a raster value with the sampling rules used by the renderers.
5
+ * 使用和渲染器一样的采样规则查询栅格
6
+ *
7
+ * @param grid
8
+ * @param point
9
+ * @param options
10
+ */
11
+ export declare const queryRasterValue: (grid: RasterGrid, point: RasterQueryPoint, options?: RasterQueryOptions) => RasterQueryResult;
12
+ /**
13
+ * Query raster values while preserving the input point order.
14
+ * 按输入点顺序批量查询栅格值
15
+ *
16
+ * @param grid
17
+ * @param points
18
+ * @param options
19
+ */
20
+ export declare const queryRasterValues: (grid: RasterGrid, points: readonly RasterQueryPoint[], options?: RasterQueryOptions) => RasterQueryResult[];