fix: 修正 WebMapV3 线符号方向处理

- 按地图版本翻转旧版线符号
- 统一 WebMap 线图案方向
- 补充 Sprite 回调和图片翻转测试

AI-GEN: 90% gpt5.6-luna

Author: xiongjiaojiao

src/common/mapping/WebMapV3.js

@@ -2,7 +2,7 @@
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 import { FetchRequest } from '../util/FetchRequest';
-import { getLayerCatalogRenderLayers, getLayerInfosFromCatalogs, getMainLayerFromCatalog, isSameRasterLayer, mergeFeatures, transformUrl } from './utils/util';
+import { getLayerCatalogRenderLayers, getLayerInfosFromCatalogs, getMainLayerFromCatalog, isSameRasterLayer, mergeFeatures, transformUrl, flipImageVertically } from './utils/util';
 import { SourceListModelV3 } from './utils/SourceListModelV3';
 import cloneDeep from 'lodash.clonedeep';
 
@@ -289,6 +289,9 @@ export function createWebMapV3Extending(SuperClass, { MapManager, mapRepo, crsMa
     // 初始化 map
     const mapOptions = {
       ...this.mapOptions,
+      // 统一线图案方向，避免 Mapbox GL 默认方向与 WebMap 符号方向约定不一致；旧版资源翻转由 _getSpriteLoad 按地图版本处理。
+      linePatternOrientation: 'west-to-east',
+      onSpriteLoad: this._getSpriteLoad(),
       transformRequest: this._getTransformRequest(),
       container: this.options.target,
       crs: this._baseProjection,
@@ -315,6 +318,23 @@ export function createWebMapV3Extending(SuperClass, { MapManager, mapRepo, crsMa
     });
   }
 
+  _getSpriteLoad() {
+    const version = this._mapInfo && this._mapInfo.version;
+    const [major, minor, patch] = typeof version === 'string' ? version.split('.').map(Number) : [];
+    // 3.3.7 及以前的地图线符号需要垂直翻转；新版本由地图数据自身保证方向。
+    if (major > 3 || (major === 3 && minor > 3) || (major === 3 && minor === 3 && patch > 7)) {
+      return;
+    }
+    return (id, imageData, width, height) => {
+      // 翻转所有 line- 开头的图案
+      if (id && id.startsWith('line-')) {
+        return flipImageVertically(imageData, width, height);
+      }
+
+      return null;
+    };
+  }
+
   _getTransformRequest() {
     if (this.mapOptions.transformRequest) {
       return this.mapOptions.transformRequest;

src/common/mapping/utils/util.js

@@ -216,4 +216,19 @@ export function getLayerCatalogRenderLayers(parts, catalogId, layersOnMap) {
 export function getMainLayerFromCatalog(layerParts, catalogId, layersOnMap) {
   const renderLayers = getLayerCatalogRenderLayers(layerParts, catalogId, layersOnMap);
   return layersOnMap.find(item => item.id === renderLayers[0]);
-}
+}
+
+// 垂直翻转 RGBA 图片，保持像素顺序并避免逐通道复制。
+export function flipImageVertically(imageData, width, height) {
+  const sourceData = imageData.data || imageData;
+  const flipped = new Uint8Array(sourceData.length);
+  const rowSize = width * 4;
+
+  for (let row = 0; row < height; row++) {
+    const sourceRowStart = row * rowSize;
+    const targetRowStart = (height - row - 1) * rowSize;
+    flipped.set(sourceData.subarray(sourceRowStart, sourceRowStart + rowSize), targetRowStart);
+  }
+
+  return flipped;
+}

test/common/mapping/WebMapV3Spec.js

@@ -125,6 +125,52 @@ describe('WebMapV3 - addLocalIdeographFontFamily', () => {
       inst._createMap();
       expect(capturedOptions).toBeDefined();
       expect(capturedOptions.localIdeographFontFamily).toBe('sans-serif,PingFang SC Regular');
+      expect(capturedOptions.linePatternOrientation).toBe('west-to-east');
+      expect(capturedOptions.onSpriteLoad).toEqual(jasmine.any(Function));
+    });
+  });
+
+  describe('_getSpriteLoad', () => {
+    it('should flip line sprites for maps at version 3.3.7', () => {
+      instance._mapInfo = { version: '3.3.7' };
+      const onSpriteLoad = instance._getSpriteLoad();
+      const imageData = new Uint8Array([
+        1, 2, 3, 4,
+        5, 6, 7, 8
+      ]);
+
+      expect(onSpriteLoad('line-pattern', imageData, 1, 2)).toEqual(new Uint8Array([
+        5, 6, 7, 8,
+        1, 2, 3, 4
+      ]));
+      expect(onSpriteLoad('point-pattern', imageData, 1, 2)).toBeNull();
+    });
+
+    it('should not add a sprite callback for maps newer than version 3.3.7', () => {
+      instance._mapInfo = { version: '3.3.8' };
+
+      expect(instance._getSpriteLoad()).toBeUndefined();
+    });
+
+    it('should compare version components numerically', () => {
+      instance._mapInfo = { version: '3.3.10' };
+
+      expect(instance._getSpriteLoad()).toBeUndefined();
+    });
+
+    it('should disable the callback for higher major and minor versions', () => {
+      ['4.0.0', '3.4.0'].forEach(version => {
+        instance._mapInfo = { version };
+        expect(instance._getSpriteLoad()).toBeUndefined();
+      });
+    });
+
+    it('should keep the callback when the map version is missing', () => {
+      instance._mapInfo = {};
+      const onSpriteLoad = instance._getSpriteLoad();
+
+      expect(onSpriteLoad).toEqual(jasmine.any(Function));
+      expect(onSpriteLoad(null, new Uint8Array(4), 1, 1)).toBeNull();
     });
   });
 });

test/common/mapping/utils/UtilSpec.js

@@ -1,6 +1,26 @@
-import { isSameRasterLayer } from '../../../../src/common/mapping/utils/util';
+import { flipImageVertically, isSameRasterLayer } from '../../../../src/common/mapping/utils/util';
 
 describe('util', () => {
+  describe('flipImageVertically', () => {
+    it('flips RGBA rows in a typed array', () => {
+      const pixels = new Uint8Array([
+        1, 2, 3, 4, 5, 6, 7, 8,
+        9, 10, 11, 12, 13, 14, 15, 16
+      ]);
+
+      expect(flipImageVertically(pixels, 2, 2)).toEqual(new Uint8Array([
+        9, 10, 11, 12, 13, 14, 15, 16,
+        1, 2, 3, 4, 5, 6, 7, 8
+      ]));
+    });
+
+    it('accepts ImageData-like objects and a single-row image', () => {
+      const pixels = new Uint8ClampedArray([1, 2, 3, 4, 5, 6, 7, 8]);
+      const result = flipImageVertically({ data: pixels }, 2, 1);
+
+      expect(result).toEqual(new Uint8Array(pixels));
+    });
+  });
   it('isSameRasterLayer', (done) => {
     let res = isSameRasterLayer(
       { type: 'raster', tiles: ['http:17.0.0.1:8190/iserver/rest/maps/China'] },