纯 QWidget 实现高性能电子地图控件：多线程瓦片加载与图形覆盖

在地图加载与配置保存方面，我们通过 MapHelper 统一管理瓦片源和类型，确保离线路径和缓存策略正确应用。

void frmOverlay::saveConfig() {
    AppConfig::OverlaySource = ui->cboxTileSource->itemData(
        ui->cboxTileSource->currentIndex()).toInt();
    AppConfig::OverlayType = ui->cboxTileType->itemData(
        ui->cboxTileType->currentIndex()).toInt();
    AppConfig::OverlayOffline = ui->cboxOffline->currentIndex();
    AppConfig::OverlayCache = ui->cboxCache->currentIndex();
    AppConfig::writeConfig();
}

void frmOverlay::loadMap() {
    this->reset();
    int tileSource = ui->cboxTileSource->itemData(
        ui->cboxTileSource->currentIndex()).toInt();
    ui->mapWidget->setTileSource(TileSource(tileSource));

    int tileType = ui->cboxTileType->itemData(
        ui->cboxTileType->currentIndex()).toInt();
    ui->mapWidget->setTileType(TileType(tileType));

    QString offlinePath = TileHelper::getOfflinePath(TileSource(tileSource));
    ui->mapWidget->setOffline(ui->cboxOffline->currentIndex() == 1);
    ui->mapWidget->setOfflinePath(offlinePath);

    QString cachePath = (ui->cboxCache->currentIndex() == 1 ? 
                         QtHelper::appPath() + "/mapcache" : "");
    ui->mapWidget->setCachePath(cachePath);
}

对于图形覆盖物的管理，我们提供了丰富的接口来添加、更新和删除各类元素。例如，添加标注点时，可以指定图标文件、文本内容及对齐方式；添加多边形或圆形时，则需计算合适的半径或顶点列表。

void frmOverlay::on_btnAddMarker_clicked() {
    QString file = ":/image/marker.png";
    OverlayBase *marker = ui->mapWidget->addMarker(flag, lng, lat, file);
    OverlayHelper::updateText(marker, "标注点文本", "#000000", 4, 0, "");
    this->addIndex();
}

void frmOverlay::on_btnAddPolygon_clicked() {
    QPointF point(lng, lat);
    QList<QPointF> points = MapHelper::getRandPoints(point, 3, 0.15);
    ui->mapWidget->addPolygon(flag, points, "#00ff00", 2, QColor(0, 255, 0, 100));
    this->addIndex();
}

void frmOverlay::on_btnAddCircle_clicked() {
    int distance = MapHelper::getDistance(ui->mapWidget->getZoom());
    qreal radius = MapHelper::getRadius(distance);
    ui->mapWidget->addCircle(flag, lng, lat, radius, "#0000ff", 3, 
                             QColor(0, 0, 255, 50));
    this->addIndex();
}

void frmOverlay::on_btnAddWidget_clicked() {
    MagicFish *widget = new MagicFish(ui->mapWidget);
    ui->mapWidget->addWidget(flag, lng, lat, widget);
    this->addIndex();
}

批量操作时，建议先禁用重绘以提升效率，待所有数据准备完毕后再统一触发绘制。

void frmOverlay::on_btnAddOverlays_clicked() {
    OverlayHelper::redraw = false;
    on_btnClearOverlay_clicked();
    ui->mapWidget->setZoom(10);
    ui->mapWidget->setCenter(121.424362, 31.175942);

    for (int i = 0; i < 1000; ++i) {
        qreal lng = QtHelper::getRandFloat(121.135250, 121.77727);
        qreal lat = QtHelper::getRandFloat(30.99056, 31.43569);
        qreal r = QtHelper::getRandFloat(0.02, 0.07);
        QColor color = QtHelper::getRandColor();
        QColor bgColor = color;
        bgColor.setAlpha(150);
        ui->mapWidget->addCircle(QString("circle%1").arg(i), lng, lat, r, 
                                 color, 3, bgColor);
    }
    OverlayHelper::redraw = true;
}

功能特性

1. 多源支持：兼容天地图、高德、腾讯、谷歌等多种瓦片服务，支持自定义地址格式。
2. 坐标系标准：采用 WGS-84 地球坐标系与默卡托投影，易于拓展其他规则。
3. 离线与缓存：支持在线/离线双模式，可指定缓存路径，优先读取本地文件。
4. 多线程优化：瓦片下载与绘制均使用多线程，内存中预加载可见区域四周两倍范围，减少拖拽卡顿。
5. 双缓冲技术：所有图层与覆盖物合成至一张图片后绘制，不可见区域不触发渲染，降低 CPU 占用。
6. 丰富覆盖物：内置标注点、折线、多边形、矩形、圆形等，支持边框颜色、填充色及透明度调节。
7. 动态属性：标注点支持旋转、GIF 动图切换及相对位置文本提示；所有覆盖物支持 Z-index 层叠顺序调整。
8. Widget 嵌入：支持将任意 QWidget 对象作为覆盖物叠加，跟随地图移动，极大扩展了 UI 灵活性。
9. 按需绘制：支持手动控制重绘时机，批量操作时关闭重绘可显著提升性能。
10. 环境兼容：纯 QWidget 实现，不依赖 QML 或浏览器控件，适配 Linux 嵌入式及各类国产系统。
11. 截图导出：支持将可视区域或指定经纬度范围拼接保存为图片文件。
12. 性能表现：相比 Web 方案，在低配置环境下处理数万个覆盖物时性能提升显著。