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

背景与动机

在嵌入式开发或低配置硬件环境中，依赖浏览器控件（Web）或 QML 往往会导致性能瓶颈。浏览器内核占用高，GPU 加速支持有限，甚至在一些老旧板子上无法运行新版 Qt 的 Location 组件。为了获得极致的控制度和渲染性能，我们尝试过基于纯 QWidget 绘制电子地图的方案。

经过长期迭代，这套方案解决了两个核心难点：一是地理坐标到像素坐标的高效映射，二是多线程下载与分层绘制机制。通过双缓冲技术和预加载策略，即使在资源受限环境下也能保证流畅的交互体验。

核心实现逻辑

地图绘制的本质是不断将经纬度转换为屏幕像素点。对于多边形等自适应图形和固定大小的标注点，都需要在拖动地图时实时计算位置偏移。下面展示的是主界面类 frmOverlay 的核心初始化与瓦片加载逻辑，这里采用了信号槽机制来解耦 UI 操作与底层绘图。

#include "frmoverlay.h"
#include "ui_frmoverlay.h"
#include "qthelper.h"
#include "maphelper.h"
#include "overlayhelper.h"
#include "magicfish.h"

frmOverlay::frmOverlay(QWidget *parent)
    : QWidget(parent), ui(new Ui::frmOverlay) {
    ui->setupUi(this);
    this->initForm();
    this->initConfig();
    this->loadMap();
}

frmOverlay::~frmOverlay() {
    delete ui;
}

void frmOverlay::initForm() {
    lng = 121.424362;
    lat = 31.175942;
    connect(ui->mapWidget, SIGNAL(receivePoint(qreal, qreal)), 
            , ((qreal, qreal)));
    (ui->cboxFlag->(), ((QString)), 
            , ((QString)));
}

{
    
    MapHelper::(ui->cboxTileSource, AppConfig::OverlaySource);
    (ui->cboxTileSource, (()), 
            , (()));
    (ui->cboxTileSource, (()), 
            , (()));

    MapHelper::(ui->cboxTileType, AppConfig::OverlayType);
    (ui->cboxTileType, (()), 
            , (()));
    (ui->cboxTileType, (()), 
            , (()));

    ui->cboxOffline->(AppConfig::OverlayOffline);
    (ui->cboxOffline, (()), 
            , (()));
    (ui->cboxOffline, (()), 
            , (()));

    ui->cboxCache->(AppConfig::OverlayCache);
    (ui->cboxCache, (()), 
            , (()));
    (ui->cboxCache, (()), 
            , (()));
}

{
    AppConfig::OverlaySource = ui->cboxTileSource->(
        ui->cboxTileSource->()).();
    AppConfig::OverlayType = ui->cboxTileType->(
        ui->cboxTileType->()).();
    AppConfig::OverlayOffline = ui->cboxOffline->();
    AppConfig::OverlayCache = ui->cboxCache->();
    AppConfig::();
}

{
    index = ;
    flag = ;
    ui->cboxFlag->();
    ui->cboxFlag->()->(flag);
}

{
    ->();
     tileSource = ui->cboxTileSource->(
        ui->cboxTileSource->()).();
    ui->mapWidget->((tileSource));

     tileType = ui->cboxTileType->(
        ui->cboxTileType->()).();
    ui->mapWidget->((tileType));

    QString offlinePath = TileHelper::((tileSource));
    ui->mapWidget->(ui->cboxOffline->() == );
    ui->mapWidget->(offlinePath);

    QString cachePath = (ui->cboxCache->() ==  ? 
                         QtHelper::() +  : );
    ui->mapWidget->(cachePath);
}

{
    ->lng = lng;
    ->lat = lat;
    ui->txtLng->(QString::(lng, , ));
    ui->txtLat->(QString::(lat, , ));
}