@ztgkzhaohao/geo-effect-kit 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { BoundingSphere, BillboardGraphics, CallbackPositionProperty, CallbackProperty, Cartesian2, Cartesian3, Cartesian4, CircleGeometry, Color, ColorMaterialProperty, ConstantPositionProperty, ConstantProperty, CustomDataSource, EllipsoidSurfaceAppearance, Event, GeometryInstance, GroundPrimitive, HeadingPitchRoll, HeadingPitchRange, HeightReference, HorizontalOrigin, Material, Math as CesiumMath, PointGraphics, PolylineGlowMaterialProperty, PolygonGeometry, PolygonHierarchy, PostProcessStage, Primitive, Rectangle, Transforms, VerticalOrigin, } from 'cesium';
+import { BoundingSphere, BillboardGraphics, CallbackPositionProperty, CallbackProperty, Cartesian2, Cartesian3, Cartesian4, CircleGeometry, Color, ColorMaterialProperty, ConstantPositionProperty, ConstantProperty, CustomDataSource, EllipsoidSurfaceAppearance, Event, GeometryInstance, GroundPrimitive, HeadingPitchRoll, HeadingPitchRange, HeightReference, HorizontalOrigin, Material, Math as CesiumMath, PointGraphics, PolylineArrowMaterialProperty, PolylineDashMaterialProperty, PolylineGlowMaterialProperty, PolylineOutlineMaterialProperty, PolygonGeometry, PolygonHierarchy, PostProcessStage, Primitive, Rectangle, Transforms, VerticalOrigin, } from 'cesium';
 import { decompressFrames, parseGIF } from 'gifuct-js';
 export const GEO_RADAR_SCAN_MATERIAL_TYPE = 'GeoRadarScanMaterial';
 export const GEO_RIPPLE_SPREAD_MATERIAL_TYPE = 'GeoRippleSpreadMaterial';
@@ -7,16 +7,42 @@ export const GEO_SCAN_CONE_MATERIAL_TYPE = 'GeoScanConeMaterial';
 export const GEO_SHIELD_DOME_MATERIAL_TYPE = 'GeoShieldDomeMaterial';
 export const GEO_TEMPERATURE_FIELD_MATERIAL_TYPE = 'GeoTemperatureFieldMaterial';
 export const GEO_WATER_SURFACE_MATERIAL_TYPE = 'GeoWaterSurfaceMaterial';
+export const GEO_MATERIAL_POLYLINE_MATERIAL_TYPE = 'GeoMaterialPolylineMaterial';
 export const RADAR_SCAN_TYPE_VALUES = ['classic', 'sector', 'pulse', 'grid'];
 export const RIPPLE_SPREAD_TYPE_VALUES = ['water', 'energy', 'soft'];
 export const SCENE_WEATHER_TYPE_VALUES = ['rain', 'snow', 'fog', 'lightning'];
 export const POST_PROCESS_TYPE_VALUES = ['bloom', 'night-vision', 'black-white', 'brightness', 'mosaic', 'depth-of-field'];
 export const POLYLINE_FLOW_TYPE_VALUES = ['dispatch', 'migration', 'attack', 'comet', 'electric'];
+export const MATERIAL_POLYLINE_STYLE_VALUES = [
+    'solid',
+    'outline',
+    'arrow',
+    'dash',
+    'dual-dash',
+    'flow',
+    'flow-color',
+    'three-dash',
+    'cross',
+    'navigation',
+];
+export const MATERIAL_POLYLINE_IMAGE_PRESET_VALUES = [
+    'pulse',
+    'gradual',
+    'arrow-blue',
+    'rainbow',
+    'arrow-repeat',
+    'dovetail',
+    'yellow-flow',
+    'transparent-flow',
+    'interval',
+    'small-arrow',
+    'gradient',
+];
 export const FLY_LINE_MODE_VALUES = ['single-arc', 'hub-spoke', 'bidirectional'];
 export const LIGHT_WALL_TYPE_VALUES = ['security', 'warning', 'data', 'fence', 'pulse'];
 export const SCAN_CONE_TYPE_VALUES = ['searchlight', 'radar', 'camera', 'drone', 'alarm'];
 export const SHIELD_DOME_TYPE_VALUES = ['hex', 'plasma', 'matrix', 'aegis', 'storm'];
-export const WATER_SURFACE_TYPE_VALUES = ['river', 'lake', 'flood'];
+export const WATER_SURFACE_TYPE_VALUES = ['river', 'lake', 'flood', 'flow'];
 export function createRadarScanEffect(viewer, options) {
     return new RadarScanEffect(viewer, options);
 }
@@ -32,6 +58,9 @@ export function createPostProcessEffect(viewer, options = {}) {
 export function createPolylineFlowEffect(viewer, options) {
     return new PolylineFlowEffect(viewer, options);
 }
+export function createMaterialPolylineEffect(viewer, options) {
+    return new MaterialPolylineEffect(viewer, options);
+}
 export function createFlyLineEffect(viewer, options) {
     return new FlyLineEffect(viewer, options);
 }
@@ -125,6 +154,27 @@ export function normalizePolylineFlowOptions(options) {
         visible: options.visible ?? true,
     };
 }
+export function normalizeMaterialPolylineOptions(options) {
+    const imagePreset = normalizeMaterialPolylineImagePreset(options.imagePreset);
+    return {
+        positions: normalizePositions(options.positions, false),
+        style: normalizeMaterialPolylineStyle(options.style),
+        color: options.color ?? '#33f7ff',
+        secondaryColor: options.secondaryColor ?? '#ffffff',
+        backgroundColor: options.backgroundColor ?? 'rgba(0, 64, 255, 0.35)',
+        width: Math.max(1, finiteOr(options.width ?? 8, 8)),
+        outlineWidth: Math.max(0, finiteOr(options.outlineWidth ?? 2, 2)),
+        speed: clamp(finiteOr(options.speed ?? 1, 1), 0.05, 8),
+        repeat: normalizeMaterialPolylineRepeat(options.repeat),
+        imagePreset,
+        image: options.image ?? getMaterialPolylinePresetImage(imagePreset),
+        arcHeight: Math.max(0, finiteOr(options.arcHeight ?? 0, 0)),
+        arcSamples: clampInteger(finiteOr(options.arcSamples ?? 48, 48), 2, 128),
+        cornerRadius: clamp(finiteOr(options.cornerRadius ?? 0, 0), 0, 0.45),
+        clampToGround: options.clampToGround ?? true,
+        visible: options.visible ?? true,
+    };
+}
 export function normalizeFlyLineOptions(options) {
     return {
         lines: normalizeFlyLineRoutes(options.lines),
@@ -264,6 +314,14 @@ export function shouldRebuildPolylineFlow(previous, next) {
         previous.positions.length !== next.positions.length ||
         !positionsEqual(previous.positions, next.positions));
 }
+export function shouldRebuildMaterialPolyline(previous, next) {
+    return (previous.clampToGround !== next.clampToGround ||
+        previous.arcHeight !== next.arcHeight ||
+        previous.arcSamples !== next.arcSamples ||
+        previous.cornerRadius !== next.cornerRadius ||
+        previous.positions.length !== next.positions.length ||
+        !positionsEqual(previous.positions, next.positions));
+}
 export function shouldRebuildFlyLine(previous, next) {
     return (previous.mode !== next.mode ||
         previous.arcHeight !== next.arcHeight ||
@@ -285,8 +343,7 @@ export function shouldRebuildLightWall(previous, next) {
 export function shouldRebuildScanCone(previous, next) {
     return (previous.radiusMeters !== next.radiusMeters ||
         previous.lengthMeters !== next.lengthMeters ||
-        previous.aperture !== next.aperture ||
-        !positionsEqual([previous.center], [next.center]));
+        previous.aperture !== next.aperture);
 }
 export function shouldRebuildShieldDome(previous, next) {
     return previous.radiusMeters !== next.radiusMeters || !positionsEqual([previous.center], [next.center]);
@@ -416,6 +473,53 @@ export function buildRippleSpreadMaterialSource() {
     }
   `;
 }
+export function buildMaterialPolylineMaterialSource() {
+    return `
+    // ${GEO_MATERIAL_POLYLINE_MATERIAL_TYPE}
+    czm_material czm_getMaterial(czm_materialInput materialInput)
+    {
+      czm_material material = czm_getDefaultMaterial(materialInput);
+      vec2 st = materialInput.st;
+      float time = fract(czm_frameNumber * 0.016667 * speed);
+      vec2 uv = vec2(fract(st.s * repeatX - time), fract(st.t * repeatY));
+      vec4 textureColor = texture(image, uv);
+      float flowEnabled = step(5.5, styleType) * (1.0 - step(6.5, styleType));
+      float flowColorEnabled = step(6.5, styleType) * (1.0 - step(7.5, styleType));
+      float threeDashEnabled = step(7.5, styleType) * (1.0 - step(8.5, styleType));
+      float crossEnabled = step(8.5, styleType) * (1.0 - step(9.5, styleType));
+      float navigationEnabled = step(9.5, styleType);
+      float dynamicEnabled = max(max(flowEnabled, flowColorEnabled), max(max(threeDashEnabled, crossEnabled), navigationEnabled));
+      float centerDistance = abs(st.t - 0.5);
+      float centerCore = smoothstep(0.18, 0.0, centerDistance);
+      float sideCore = smoothstep(0.08, 0.0, abs(centerDistance - 0.32));
+      float dash = smoothstep(0.68, 0.72, fract(st.s * repeatX - time));
+      float cross = max(
+        smoothstep(0.08, 0.0, centerDistance) * dash,
+        smoothstep(0.022, 0.0, abs(fract(st.s * repeatX - time) - 0.5))
+      );
+      float navCycle = fract(st.s * repeatX - time);
+      float navWhite = smoothstep(0.0, 0.08, navCycle) * (1.0 - smoothstep(0.22, 0.32, navCycle));
+      float navGreen = smoothstep(0.24, 0.34, navCycle) * (1.0 - smoothstep(0.86, 0.96, navCycle));
+      float textureAlpha = textureColor.a;
+      vec3 imageColor = textureColor.rgb;
+      float imageBrightness = max(max(imageColor.r, imageColor.g), imageColor.b);
+      float tintWeight = (1.0 - imageBrightness) * 0.45;
+      vec3 flowImageColor = mix(imageColor, imageColor * color.rgb, tintWeight);
+      vec3 flowColor = flowImageColor * flowEnabled + mix(color.rgb, secondaryColor.rgb, smoothstep(0.0, 1.0, uv.s)) * flowColorEnabled;
+      vec3 threeColor = (color.rgb * centerCore + secondaryColor.rgb * sideCore) * max(centerCore, sideCore) * threeDashEnabled;
+      vec3 crossColor = color.rgb * cross * crossEnabled;
+      vec3 navColor = (secondaryColor.rgb * navWhite + color.rgb * navGreen) * navigationEnabled;
+      vec3 mixed = flowColor + threeColor + crossColor + navColor;
+      float flowColorAlpha = smoothstep(0.02, 0.18, fract(uv.s)) * (1.0 - smoothstep(0.58, 0.98, fract(uv.s)));
+      float patternAlpha = max(max(textureAlpha * flowEnabled + flowColorAlpha * flowColorEnabled, max(centerCore, sideCore) * threeDashEnabled), max(cross * crossEnabled, max(navWhite, navGreen) * navigationEnabled));
+      float backgroundAlpha = backgroundColor.a * dynamicEnabled * (1.0 - patternAlpha) * 0.58;
+      material.diffuse = mix(backgroundColor.rgb, mixed, clamp(patternAlpha + 0.1, 0.0, 1.0));
+      material.emission = mixed * (0.32 + patternAlpha * 0.84);
+      material.alpha = clamp(backgroundAlpha + patternAlpha * color.a, 0.0, 1.0);
+      return material;
+    }
+  `;
+}
 export function buildSceneWeatherPostProcessSource() {
     return `
     uniform sampler2D colorTexture;
@@ -725,6 +829,13 @@ export function buildWaterSurfaceMaterialSource() {
       float riverWave = mix(waveA, max(riverFlow, waveB * 0.72), 0.45);
       float wave = mix(waveA, max(riverWave, lakeShimmer), waveStrength);
       wave = max(wave, floodPulse * floodEnabled);
+      // flow mirrors the yunzhou-onemap WaterPrimitive water surface style without changing river/lake/flood.
+      float flowEnabled = step(3.5, waterType);
+      float yunzhouFlow = smoothstep(0.46, 1.0, waterNoise(moving * 18.0 + flow * time * 2.2)) * (0.52 + waveA * 0.48);
+      float flowWash = smoothstep(0.42, 1.0, waterNoise(moving * 7.0 + crossFlow * time * 0.28));
+      float flowHighlight = max(yunzhouFlow, flowWash * waveB * 0.74);
+      float flowWave = mix(waveA, flowHighlight, 0.62);
+      wave = mix(wave, flowWave, flowEnabled);
       vec3 viewDirection = normalize(materialInput.positionToEyeEC);
       float viewFacing = clamp(1.0 - abs(dot(normalize(materialInput.normalEC), -viewDirection)), 0.0, 1.0);
       float fresnel = pow(viewFacing, fresnelPower) * reflectivity;
@@ -733,7 +844,10 @@ export function buildWaterSurfaceMaterialSource() {
       vec3 lakeTint = mix(color.rgb, vec3(0.36, 0.92, 0.86), 0.22);
       vec3 floodTint = mix(color.rgb, vec3(0.42, 0.68, 1.0), 0.36);
       vec3 waterColor = riverTint * riverEnabled + lakeTint * lakeEnabled + floodTint * floodEnabled;
+      vec3 flowTint = mix(color.rgb, vec3(0.0, 0.47, 0.50), 0.18);
+      waterColor = mix(waterColor, flowTint, flowEnabled);
       vec3 deepColor = mix(waterColor, vec3(0.015, 0.11, 0.18), 0.46);
+      deepColor = mix(deepColor, mix(flowTint, vec3(0.015, 0.11, 0.18), 0.54), flowEnabled);
       vec3 refractionColor = mix(deepColor, waterColor, 0.42 + wave * 0.34);
       refractionColor += vec3(0.02, 0.12, 0.16) * refractionStrength * (0.5 + waveB * 0.5);
       vec3 skyReflection = mix(vec3(0.58, 0.86, 1.0), vec3(1.0), pow(smallWave, 5.0));
@@ -744,6 +858,7 @@ export function buildWaterSurfaceMaterialSource() {
       material.normal = surfaceNormal;
       material.diffuse = finalColor * (0.56 + wave * 0.18);
       material.emission = reflectionColor * (0.14 + fresnel * 0.42) + waterColor * ((riverFlow * 0.08 + waveB * 0.06) * riverEnabled + floodPulse * floodEnabled * 0.22);
+      material.emission = mix(material.emission, reflectionColor * (0.14 + fresnel * 0.42) + waterColor * (flowHighlight * 0.11), flowEnabled);
       material.alpha = opacity * (0.62 + wave * 0.12 + fresnel * 0.2 + refractionStrength * 0.06);
       return material;
     }
@@ -797,7 +912,8 @@ export function buildScanConeMaterialSource() {
       vec2 centered = st - vec2(0.5);
       float radius = length(centered) * 2.0;
       float angle = atan(centered.y, centered.x) / 6.28318530718 + 0.5;
-      float time = fract((czm_frameNumber * 0.016667 * speed));
+      float scanTimeSeconds = max(timeSeconds, czm_frameNumber * 0.016667);
+      float time = fract(scanTimeSeconds * speed);
       float verticalFade = smoothstep(0.0, 0.12, st.t) * (1.0 - smoothstep(0.92, 1.0, st.t));
       float sweepBand = smoothstep(0.08, 0.0, abs(fract(angle - time) - 0.5));
       float radialGrid = smoothstep(0.012, 0.0, abs(fract(radius * 7.0 - time * 2.0) - 0.5));
@@ -2370,6 +2486,211 @@ export class FlyLineEffect {
         this.renderFrame = 0;
     }
 }
+export class MaterialPolylineEffect {
+    viewer;
+    dataSource;
+    options;
+    routeEntity = null;
+    material = null;
+    renderFrame = 0;
+    destroyed = false;
+    constructor(viewer, options) {
+        this.viewer = viewer;
+        this.options = normalizeMaterialPolylineOptions(options);
+        this.dataSource = new CustomDataSource('geo-effect-kit-material-polyline');
+        this.dataSource.show = this.options.visible;
+        this.viewer.dataSources.add(this.dataSource);
+        this.renderEntity();
+        this.startRenderLoop();
+        this.viewer.scene.requestRender();
+    }
+    update(options) {
+        if (this.destroyed)
+            return;
+        const nextImage = options.image !== undefined
+            ? options.image
+            : options.imagePreset !== undefined
+                ? normalizeMaterialPolylineOptions({ positions: this.options.positions, imagePreset: options.imagePreset }).image
+                : this.options.image;
+        const next = normalizeMaterialPolylineOptions({
+            ...this.options,
+            ...options,
+            positions: options.positions ?? this.options.positions,
+            repeat: options.repeat ?? this.options.repeat,
+            image: nextImage,
+            clampToGround: options.clampToGround ?? this.options.clampToGround,
+            visible: options.visible ?? this.options.visible,
+        });
+        const rebuildEntity = shouldRebuildMaterialPolyline(this.options, next);
+        const materialClassChanged = isNativeMaterialPolylineStyle(this.options.style) !== isNativeMaterialPolylineStyle(next.style);
+        this.options = next;
+        if (rebuildEntity || materialClassChanged) {
+            this.renderEntity();
+        }
+        else {
+            this.applyEntityOptions();
+        }
+        this.dataSource.show = this.options.visible;
+        if (this.options.visible)
+            this.startRenderLoop();
+        else
+            this.stopRenderLoop();
+        this.viewer.scene.requestRender();
+    }
+    show() {
+        if (this.destroyed)
+            return;
+        this.options = { ...this.options, visible: true };
+        this.dataSource.show = true;
+        this.startRenderLoop();
+        this.viewer.scene.requestRender();
+    }
+    hide() {
+        if (this.destroyed)
+            return;
+        this.options = { ...this.options, visible: false };
+        this.dataSource.show = false;
+        this.stopRenderLoop();
+        this.viewer.scene.requestRender();
+    }
+    flyTo(options = {}) {
+        if (this.destroyed)
+            return;
+        const { center, radius } = getPositionBounds(this.getRenderPositions(), Math.max(2000, this.options.width * 900));
+        this.viewer.camera.flyToBoundingSphere(new BoundingSphere(center, radius), {
+            duration: options.duration ?? 1,
+            offset: new HeadingPitchRange(0, options.pitch ?? -0.62, radius * (options.rangeMultiplier ?? 2.4)),
+        });
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.stopRenderLoop();
+        this.dataSource.entities.removeAll();
+        this.routeEntity = null;
+        this.material = null;
+        this.viewer.dataSources.remove(this.dataSource, true);
+        this.viewer.scene.requestRender();
+    }
+    isVisible() {
+        return this.options.visible;
+    }
+    isDestroyed() {
+        return this.destroyed;
+    }
+    getOptions() {
+        return {
+            ...this.options,
+            positions: clonePositions(this.options.positions),
+            repeat: { ...this.options.repeat },
+        };
+    }
+    renderEntity() {
+        clearEntities(this.dataSource);
+        this.material = null;
+        const positions = positionsToCartesians(this.getRenderPositions());
+        const material = this.createMaterial();
+        this.routeEntity = this.dataSource.entities.add({
+            id: 'geo-effect-kit-material-polyline-route',
+            polyline: {
+                positions,
+                width: this.options.width,
+                clampToGround: this.options.clampToGround && this.options.arcHeight <= 0,
+                material,
+            },
+        });
+    }
+    applyEntityOptions() {
+        if (!this.routeEntity?.polyline)
+            return;
+        this.routeEntity.polyline.width = new ConstantProperty(this.options.width);
+        if (this.material) {
+            this.applyDynamicMaterialUniforms(this.material);
+        }
+        else {
+            this.routeEntity.polyline.material = this.createMaterial();
+        }
+    }
+    createMaterial() {
+        if (this.options.style === 'solid') {
+            return new ColorMaterialProperty(Color.fromCssColorString(this.options.color));
+        }
+        if (this.options.style === 'outline') {
+            return new PolylineOutlineMaterialProperty({
+                color: Color.fromCssColorString(this.options.color),
+                outlineColor: Color.fromCssColorString(this.options.secondaryColor),
+                outlineWidth: this.options.outlineWidth,
+            });
+        }
+        if (this.options.style === 'arrow') {
+            return new PolylineArrowMaterialProperty(Color.fromCssColorString(this.options.color));
+        }
+        if (this.options.style === 'dash' || this.options.style === 'dual-dash') {
+            return new PolylineDashMaterialProperty({
+                color: Color.fromCssColorString(this.options.color),
+                gapColor: Color.fromCssColorString(this.options.style === 'dual-dash' ? this.options.secondaryColor : 'rgba(0, 0, 0, 0)'),
+                dashLength: Math.max(4, this.options.repeat.x * 4),
+                dashPattern: this.options.style === 'dual-dash' ? 0b1111000000 : 255,
+            });
+        }
+        registerMaterialPolylineMaterial();
+        const material = new DynamicCesiumMaterialProperty(GEO_MATERIAL_POLYLINE_MATERIAL_TYPE, {});
+        this.material = material;
+        this.applyDynamicMaterialUniforms(material);
+        return material;
+    }
+    applyDynamicMaterialUniforms(material) {
+        material.uniforms.color = Color.fromCssColorString(this.options.color).withAlpha(1);
+        material.uniforms.secondaryColor = Color.fromCssColorString(this.options.secondaryColor).withAlpha(1);
+        material.uniforms.backgroundColor = Color.fromCssColorString(this.options.backgroundColor);
+        material.uniforms.image = this.options.image;
+        material.uniforms.speed = this.options.speed;
+        material.uniforms.repeatX = this.options.repeat.x;
+        material.uniforms.repeatY = this.options.repeat.y;
+        material.uniforms.styleType = getMaterialPolylineStyleUniform(this.options.style);
+    }
+    getRenderPositions() {
+        const rounded = roundPolylineCorners(this.options.positions, this.options.cornerRadius);
+        if (this.options.arcHeight <= 0)
+            return rounded;
+        const result = [];
+        for (let index = 1; index < rounded.length; index += 1) {
+            const from = rounded[index - 1];
+            const to = rounded[index];
+            if (!from || !to)
+                continue;
+            const segment = sampleFlyLineArc({ from, to }, this.options.arcHeight, this.options.arcSamples);
+            segment.forEach((position, segmentIndex) => {
+                if (index > 1 && segmentIndex === 0)
+                    return;
+                result.push(position);
+            });
+        }
+        return result.length >= 2 ? result : rounded;
+    }
+    startRenderLoop() {
+        if (this.renderFrame || !this.options.visible || typeof window === 'undefined')
+            return;
+        const tick = () => {
+            if (this.destroyed || !this.options.visible) {
+                this.renderFrame = 0;
+                return;
+            }
+            this.viewer.scene.requestRender();
+            this.renderFrame = window.requestAnimationFrame(tick);
+        };
+        this.renderFrame = window.requestAnimationFrame(tick);
+    }
+    stopRenderLoop() {
+        if (!this.renderFrame || typeof window === 'undefined') {
+            this.renderFrame = 0;
+            return;
+        }
+        window.cancelAnimationFrame(this.renderFrame);
+        this.renderFrame = 0;
+    }
+}
 export class PipeFlowEffect {
     viewer;
     dataSource;
@@ -3186,6 +3507,17 @@ function createRadarScanMaterial(options) {
     });
     return material;
 }
+export function createRadarScanMaterialProperty(options) {
+    const normalized = normalizeRadarScanOptions(options);
+    registerRadarScanMaterial(normalized);
+    return new DynamicCesiumMaterialProperty(GEO_RADAR_SCAN_MATERIAL_TYPE, {
+        color: Color.fromCssColorString(normalized.color).withAlpha(1),
+        opacity: normalized.opacity,
+        ringsEnabled: normalized.rings ? 1 : 0,
+        radarType: getRadarScanTypeUniform(normalized.type),
+        scanDurationMs: normalized.scanDurationMs,
+    });
+}
 function registerRippleSpreadMaterial(options) {
     const cache = Material._materialCache;
     if (!cache || cache.getMaterial(GEO_RIPPLE_SPREAD_MATERIAL_TYPE))
@@ -3270,7 +3602,7 @@ function createTemperatureFieldUniforms(options) {
         ...createTemperatureFieldSampleUniforms(options),
     };
 }
-class DynamicCesiumMaterialProperty {
+export class DynamicCesiumMaterialProperty {
     definitionChanged = new Event();
     isConstant = false;
     uniforms;
@@ -3300,14 +3632,16 @@ function createLightWallMaterialProperty(options) {
         breathing: options.breathing ? 1 : 0,
     });
 }
-function createScanConeMaterialProperty(options) {
+export function createScanConeMaterialProperty(options) {
+    const normalized = normalizeScanConeOptions(options);
     registerScanConeMaterial();
     return new DynamicCesiumMaterialProperty(GEO_SCAN_CONE_MATERIAL_TYPE, {
-        color: Color.fromCssColorString(options.color).withAlpha(1),
-        opacity: options.opacity,
-        speed: options.speed,
-        coneType: getScanConeTypeUniform(options.type),
-        aperture: options.aperture,
+        color: Color.fromCssColorString(normalized.color).withAlpha(1),
+        opacity: normalized.opacity,
+        speed: normalized.speed,
+        timeSeconds: -1,
+        coneType: getScanConeTypeUniform(normalized.type),
+        aperture: normalized.aperture,
     });
 }
 function createShieldDomeMaterialProperty(options) {
@@ -3355,6 +3689,7 @@ function registerScanConeMaterial() {
         color: Color.CYAN,
         opacity: 0.62,
         speed: 1,
+        timeSeconds: -1,
         coneType: 1,
         aperture: 34,
     }, buildScanConeMaterialSource());
@@ -3384,6 +3719,18 @@ function registerWaterSurfaceMaterial() {
         flowDirection: 90,
     }, buildWaterSurfaceMaterialSource());
 }
+function registerMaterialPolylineMaterial() {
+    registerMaterial(GEO_MATERIAL_POLYLINE_MATERIAL_TYPE, {
+        color: Color.CYAN,
+        secondaryColor: Color.WHITE,
+        backgroundColor: Color.BLUE.withAlpha(0.35),
+        image: getMaterialPolylinePresetImage('pulse'),
+        speed: 1,
+        repeatX: 4,
+        repeatY: 1,
+        styleType: 6,
+    }, buildMaterialPolylineMaterialSource());
+}
 function registerMaterial(type, uniforms, source) {
     const cache = Material._materialCache;
     if (!cache || cache.getMaterial(type))
@@ -3414,6 +3761,20 @@ function normalizePostProcessType(type) {
 function normalizePolylineFlowType(type) {
     return POLYLINE_FLOW_TYPE_VALUES.includes(type) ? type : 'dispatch';
 }
+function normalizeMaterialPolylineStyle(style) {
+    return MATERIAL_POLYLINE_STYLE_VALUES.includes(style) ? style : 'flow';
+}
+function normalizeMaterialPolylineImagePreset(imagePreset) {
+    return MATERIAL_POLYLINE_IMAGE_PRESET_VALUES.includes(imagePreset)
+        ? imagePreset
+        : 'pulse';
+}
+function normalizeMaterialPolylineRepeat(repeat) {
+    return {
+        x: clamp(finiteOr(repeat?.x ?? 4, 4), 1, 64),
+        y: clamp(finiteOr(repeat?.y ?? 1, 1), 1, 16),
+    };
+}
 function normalizeFlyLineMode(mode) {
     return FLY_LINE_MODE_VALUES.includes(mode) ? mode : 'single-arc';
 }
@@ -3467,6 +3828,9 @@ function getPostProcessTypeUniform(type) {
         return 5;
     return 6;
 }
+function getMaterialPolylineStyleUniform(style) {
+    return MATERIAL_POLYLINE_STYLE_VALUES.indexOf(style) + 1;
+}
 function getLightWallTypeUniform(type) {
     if (type === 'security')
         return 1;
@@ -3505,7 +3869,57 @@ function getWaterSurfaceTypeUniform(type) {
         return 1;
     if (type === 'lake')
         return 2;
-    return 3;
+    if (type === 'flood')
+        return 3;
+    return 4;
+}
+function isNativeMaterialPolylineStyle(style) {
+    return style === 'solid' || style === 'outline' || style === 'arrow' || style === 'dash' || style === 'dual-dash';
+}
+function getMaterialPolylinePresetImage(imagePreset) {
+    const presets = {
+        pulse: createMaterialPolylineTextureDataUrl('pulse', '#ffffff', '#00ff66'),
+        gradual: createMaterialPolylineTextureDataUrl('gradual', '#e8fff5', '#66bd63'),
+        'arrow-blue': createMaterialPolylineTextureDataUrl('arrow-blue', '#ffffff', '#1f78ff'),
+        rainbow: createMaterialPolylineTextureDataUrl('rainbow', '#ff4d4d', '#42e8ff'),
+        'arrow-repeat': createMaterialPolylineTextureDataUrl('arrow-repeat', '#d9ffff', '#00d4ff'),
+        dovetail: createMaterialPolylineTextureDataUrl('dovetail', '#e9ffd8', '#a6d96a'),
+        'yellow-flow': createMaterialPolylineTextureDataUrl('yellow-flow', '#f2ff6a', '#95ff2f'),
+        'transparent-flow': createMaterialPolylineTextureDataUrl('transparent-flow', '#59f9ff', '#0bfbff'),
+        interval: createMaterialPolylineTextureDataUrl('interval', '#ffffff', '#59f9ff'),
+        'small-arrow': createMaterialPolylineTextureDataUrl('small-arrow', '#ffffff', '#33f7ff'),
+        gradient: createMaterialPolylineTextureDataUrl('gradient', '#ffffff', '#33f7ff'),
+    };
+    return presets[imagePreset];
+}
+function createMaterialPolylineTextureDataUrl(kind, first, second) {
+    const svg = getMaterialPolylineTextureSvg(kind, first, second);
+    return `data:image/svg+xml;utf8,${encodeURIComponent(svg)}`;
+}
+function getMaterialPolylineTextureSvg(kind, first, second) {
+    if (kind === 'rainbow') {
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><linearGradient id="g" x1="0" x2="1"><stop stop-color="#ff2347"/><stop offset=".25" stop-color="#ffec3d"/><stop offset=".5" stop-color="#4dff73"/><stop offset=".75" stop-color="#42e8ff"/><stop offset="1" stop-color="#b34dff"/></linearGradient><rect width="128" height="16" fill="none"/><path d="M0 8H128" stroke="url(#g)" stroke-width="11" stroke-linecap="round"/></svg>`;
+    }
+    if (kind === 'arrow-blue' || kind === 'arrow-repeat' || kind === 'small-arrow') {
+        const repeat = kind === 'small-arrow' ? 'M16 3l10 5-10 5V9H0V7h16z M48 3l10 5-10 5V9H32V7h16z M80 3l10 5-10 5V9H64V7h16z' : 'M42 2l22 6-22 6V9H0V7h42z M106 2l22 6-22 6V9H64V7h42z';
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><rect width="128" height="16" fill="none"/><path d="${repeat}" fill="${second}" opacity=".95"/><path d="M0 8H128" stroke="${first}" stroke-width="2" opacity=".55"/></svg>`;
+    }
+    if (kind === 'dovetail') {
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><rect width="128" height="16" fill="none"/><path d="M0 2h38l10 6-10 6H0l10-6z M64 2h38l10 6-10 6H64l10-6z" fill="${second}" opacity=".88"/><path d="M0 8H128" stroke="${first}" stroke-width="2" opacity=".45"/></svg>`;
+    }
+    if (kind === 'interval') {
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><rect width="128" height="16" fill="none"/><path d="M0 8H18M32 8H50M64 8H82M96 8H114" stroke="${first}" stroke-width="8" stroke-linecap="round"/><path d="M18 8H32M50 8H64M82 8H96M114 8H128" stroke="${second}" stroke-width="4" stroke-linecap="round" opacity=".82"/></svg>`;
+    }
+    if (kind === 'gradient') {
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><linearGradient id="g" x1="0" x2="1"><stop stop-color="${second}" stop-opacity="0"/><stop offset=".55" stop-color="${second}" stop-opacity=".86"/><stop offset="1" stop-color="${first}"/></linearGradient><rect width="128" height="16" fill="none"/><path d="M0 8H128" stroke="url(#g)" stroke-width="10" stroke-linecap="round"/></svg>`;
+    }
+    if (kind === 'transparent-flow') {
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><linearGradient id="g" x1="0" x2="1"><stop stop-color="${second}" stop-opacity="0"/><stop offset=".45" stop-color="${second}" stop-opacity=".35"/><stop offset="1" stop-color="${first}" stop-opacity=".95"/></linearGradient><rect width="128" height="16" fill="none"/><path d="M0 8H128" stroke="url(#g)" stroke-width="9" stroke-linecap="round"/></svg>`;
+    }
+    if (kind === 'yellow-flow') {
+        return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><rect width="128" height="16" fill="none"/><path d="M0 8H128" stroke="${second}" stroke-width="9" stroke-linecap="round" opacity=".72"/><path d="M64 8H128" stroke="${first}" stroke-width="5" stroke-linecap="round"/></svg>`;
+    }
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="16" viewBox="0 0 128 16"><linearGradient id="g" x1="0" x2="1"><stop stop-color="${second}" stop-opacity="0"/><stop offset=".62" stop-color="${second}" stop-opacity=".78"/><stop offset="1" stop-color="${first}"/></linearGradient><rect width="128" height="16" fill="none"/><path d="M0 8H128" stroke="url(#g)" stroke-width="10" stroke-linecap="round"/><circle cx="108" cy="8" r="5" fill="${first}"/></svg>`;
 }
 function getPolylineFlowColor(type, color) {
     const base = Color.fromCssColorString(color);