MQTT协议从原理到C++ Qt客户端实现与避坑指南

MQTTC++ Qt客户端发布订阅模式
于 2026-10-29 08:40:27 修改
·本内容遵循CC 4.0 BY-SA版权协议

MQTT 这个协议我在好几个物联网项目里都用过,从最早用现成客户端工具调,到后来自己用 C++ 和 Qt 从零撸一个能跑在嵌入式板子上的客户端,中间踩的坑真不少。很多人第一次接触 MQTT,觉得它就是个"轻量级的消息队列",随便找个库调两个 API 就完事了,结果一上生产环境就发现消息丢、重连失败、订阅收不到、内存泄漏一堆问题。这篇内容我打算把 MQTT 协议本身讲透,再结合 C++ 和 Qt 给出一套完整的实现思路,从协议原理到代码落地,从环境搭建到避坑经验,尽量让零基础的朋友也能跟着走一遍,有经验的也能从中捞到点实用的东西。

1. 先把 MQTT 的通信模型掰开揉碎

1.1 为什么是发布订阅而不是请求响应

大多数人第一次听到 MQTT,脑子里第一反应是"这不就是个消息队列吗"。但如果你拿它跟 HTTP 那种请求响应模型去类比,会发现完全对不上。HTTP 是你问一句服务器答一句,客户端和服务器是强绑定的。MQTT 的核心是发布订阅模式,消息的发送方和接收方根本不知道对方的存在,中间靠一个 Broker 来转发。

这个设计带来的直接好处是解耦。我做过一个环境监测的项目,几十个传感器节点往 Broker 发数据,同时有好几个后端服务在订阅这些数据,有的负责存数据库,有的负责做实时告警,有的负责推送到前端大屏。如果换成 HTTP 轮询,每个后端服务都得去挨个问传感器要数据,传感器那边还得维护一堆连接状态,简直是灾难。用 MQTT 之后,传感器只管往对应主题发,后端谁需要谁订阅,加一个新服务就是加一个订阅者的事,对传感器完全无感。

另一个关键点是**主题(Topic)**的设计。主题是一个用斜杠分隔的字符串,比如 sensor/room1/temperature。发布者往这个主题发消息,订阅者通过订阅这个主题来接收。主题支持通配符,+ 匹配单层,# 匹配多层。比如订阅 sensor/+/temperature 就能收到所有房间的温度数据,订阅 sensor/# 就能收到 sensor 下面所有层级的所有消息。这个设计非常灵活,但也很容易用错,后面我会专门讲主题设计里的坑。

1.2 三种 QoS 到底该怎么选

QoS 是 MQTT 里最容易被误解的概念之一。很多人以为 QoS 越高越好,直接全上 QoS 2,结果性能拉胯还占带宽。实际上 QoS 是消息传递保证等级,分三档:

  • QoS 0(最多一次):发出去就不管了,不保证到达。适合那种丢一两条无所谓的场景,比如周期性上报的温度数据,丢一个点不影响整体趋势。
  • QoS 1(至少一次):发送方会一直重发直到收到接收方的 PUBACK 确认。保证消息不丢,但可能重复。适合告警类消息,重复收到总比漏掉强。
  • QoS 2(恰好一次):通过四次握手保证消息既不丢也不重。开销最大,适合计费、指令下发这种绝对不能出错的场景。

我实测下来,QoS 1 是性价比最高的选择。大部分业务场景用 QoS 1 加上应用层的幂等处理就够了,QoS 2 的握手开销在弱网环境下反而容易导致超时重连。有个细节要注意:QoS 等级是发布时指定的,但最终生效的 QoS 是发布 QoS 和订阅 QoS 中较小的那个。也就是说你发布用 QoS 2,订阅方用 QoS 0,实际传递就是 QoS 0。这个规则很多人不知道,调了半天发现 QoS 没生效,其实就是订阅端设低了。

1.3 会话保持与遗嘱消息的实战价值

MQTT 有一个 Clean Session 的标志位,这个参数决定了 Broker 是否为你保存会话状态。如果设为 false,Broker 会记住你的订阅关系和未确认的消息,等你重连之后继续推送。如果设为 true,每次连接都是全新的会话,之前的订阅全部失效。

这个参数在移动端和弱网设备上特别关键。我做过一个车载设备的数据上报,设备经常进出隧道导致断网。如果 Clean Session 设为 true,每次重连都得重新订阅一遍,中间断网期间的消息全丢了。设为 false 之后,设备重连时 Broker 会把断网期间积累的 QoS 1/2 消息补推过来,数据完整性就有保障了。但要注意,Broker 端会为每个持久会话维护状态,设备多了之后内存占用会上去,需要根据实际情况权衡。

遗嘱消息(Will Message) 是另一个很实用的机制。客户端在连接时可以向 Broker 注册一条遗嘱消息,当客户端异常断开(不是主动发 DISCONNECT)时,Broker 会自动把这条消息发布到指定主题。这个机制用来做设备离线告警特别合适。比如设备连接时注册遗嘱主题 device/status,消息内容 {"id":"dev001","status":"offline"},正常在线时定期发心跳到 device/status 发 online。一旦设备掉线,订阅 device/status 的后端服务立刻就能收到离线通知,不用自己写超时检测逻辑。

2. 用 C++ 和 Qt 搭一套 MQTT 客户端

2.1 为什么选 Qt 而不是裸 socket

有人会问,MQTT 协议本身不复杂,为什么不直接用 C++ 的 socket 自己实现?我的回答是:可以,但没必要。MQTT 协议虽然报文结构简单,但涉及变长整数编码、剩余长度计算、心跳保活、重连退避、QoS 状态机这些细节,自己实现一遍少说几百行代码,还得处理各种边界情况。

Qt 提供了 QTcpSocket 做底层网络通信,信号槽机制天然适合处理异步的 MQTT 报文收发。更重要的是 Qt 的跨平台特性,同一套代码在 Windows、Linux、树莓派上都能编译运行,这对物联网项目来说太重要了。我有个项目就是先在 Windows 上用 Qt Creator 开发调试,然后交叉编译到树莓派上跑,代码几乎不用改。

如果你不想自己实现协议,可以用 QMQTT 这个第三方库,它是基于 Qt 的 MQTT 客户端实现,API 设计得挺顺手。但如果你想深入理解协议,我还是建议自己动手实现一遍核心的报文编解码,这样遇到问题才能定位到根因。

2.2 环境准备里那些容易翻车的细节

Qt 的安装本身不复杂,从官网下载在线安装器,选好组件一路下一步就行。但有几个地方特别容易出问题:

版本选择。Qt 5.15 是最后一个采用离线安装包方式的 LTS 版本,之后的 Qt 6 系列改用在线安装。如果你要做嵌入式开发,Qt 5.15.2 是目前最稳的选择,社区资料也最全。Qt 6 虽然新,但很多第三方库还没跟上,交叉编译工具链也没那么成熟。

编译器匹配。Windows 上 Qt 官方提供 MinGW 和 MSVC 两个版本。MinGW 开箱即用,但如果你要调用 Windows 原生 API 或者跟 Visual Studio 项目混编,就得用 MSVC。这里有个坑:MSVC 版本必须和你的 Visual Studio 版本对应,比如 Qt 用 MSVC2019 编译的,你本地就得装 VS2019 或者对应的生成工具,否则链接会报错。

环境变量。装完 Qt 之后,如果要在命令行用 qmake 或者 windeployqt,需要把 Qt 的 bin 目录加到 PATH 里。我见过有人装完 Qt 在 Qt Creator 里能编译,一到命令行就找不到 qmake,就是环境变量没配。

运行时依赖。Qt 程序发布时需要带上对应的 DLL,用 windeployqt 工具可以自动拷贝依赖。但如果你用了 OpenSSL(MQTT over TLS 需要),还得手动把 libssl 和 libcrypto 的 DLL 拷过去,这个 windeployqt 不会自动处理。

2.3 核心报文编解码的实现思路

MQTT 报文结构分三部分:固定头(Fixed Header)、可变头(Variable Header)、有效载荷(Payload)。固定头最少两个字节,第一个字节高 4 位是报文类型,低 4 位是标志位;第二个字节开始是剩余长度,采用变长编码,最多 4 个字节。

变长整数的编码规则是:每个字节低 7 位存数据,最高位表示是否还有后续字节。比如剩余长度 321,二进制是 1 0100 0001,拆成 7 位一组就是 10 和 1000001,编码后第一个字节是 11000001(0xC1,最高位 1 表示还有后续),第二个字节是 00000010(0x02)。解码的时候反过来,遇到最高位是 0 的字节就结束。

CPP
// 编码剩余长度
QByteArray encodeRemainingLength(int length) {
QByteArray result;
do {
quint8 byte = length % 128;
length /= 128;
if (length > 0) byte |= 0x80;
result.append(static_cast<char>(byte));
} while (length > 0);
return result;
}
 
// 解码剩余长度
int decodeRemainingLength(const QByteArray &data, int &bytesUsed) {
int multiplier = 1;
int value = 0;
bytesUsed = 0;
quint8 byte;
do {
byte = static_cast<quint8>(data[bytesUsed]);
value += (byte & 0x7F) * multiplier;
multiplier *= 128;
bytesUsed++;
} while ((byte & 0x80) != 0 && bytesUsed < 4);
return value;
}

CONNECT 报文是客户端连上 Broker 后发的第一个报文,可变头包含协议名、协议级别、连接标志、保持连接时间。协议名是 "MQTT" 字符串,前面用两个字节表示长度。协议级别 MQTT 3.1.1 是 4,MQTT 5.0 是 5。连接标志里包含了 Clean Session、Will、用户名密码等标志位。Payload 部分按顺序是客户端 ID、Will 主题、Will 消息、用户名、密码,哪个标志位设了就有对应的字段。

PUBLISH 报文是消息发布的核心,可变头包含主题名和报文标识符(QoS 0 没有标识符)。Payload 就是实际的消息内容,可以是任意二进制数据。SUBSCRIBE 报文的可变头只有报文标识符,Payload 是主题过滤器加 QoS 的列表。

2.4 用信号槽把异步收发串起来

Qt 的 QTcpSocket 是异步的,数据到达时触发 readyRead 信号。MQTT 报文可能分多次到达,也可能一次到达多个报文,所以需要一个缓冲区来累积数据,然后循环解析。

CPP
void MqttClient::onReadyRead() {
m_buffer.append(m_socket->readAll());
while (m_buffer.size() >= 2) {
int bytesUsed = 0;
int remainingLength = decodeRemainingLength(m_buffer.mid(1), bytesUsed);
int totalLength = 1 + bytesUsed + remainingLength;
if (m_buffer.size() < totalLength) break; // 数据不完整,等下次
QByteArray packet = m_buffer.left(totalLength);
m_buffer.remove(0, totalLength);
processPacket(packet);
}
}

这个循环解析的逻辑很关键。我见过有人直接在 readyRead 里假设一次能收到完整报文,结果在弱网环境下报文被拆包,解析直接崩溃。正确的做法就是上面这样,先判断缓冲区里有没有完整的报文,不完整就等,完整就取出来处理,循环直到缓冲区里没有完整报文为止。

心跳保活也是必须处理的。CONNECT 报文里会指定 Keep Alive 时间,客户端需要在这个时间内至少发一次报文(PINGREQ 或者任何其他报文都行)。如果 Broker 在 1.5 倍 Keep Alive 时间内没收到任何报文,就会断开连接。我一般用 QTimer 定时发 PINGREQ,间隔设为 Keep Alive 的一半,这样即使有一次丢了也还有机会补上。

3. 主题设计与消息可靠性那些事

3.1 主题层级怎么设计才不给自己挖坑

主题设计看起来简单,实际上很容易埋雷。我见过最离谱的是把所有消息都发到一个主题上,靠 payload 里的字段来区分,这完全浪费了 MQTT 的主题过滤能力。

好的主题设计应该遵循几个原则。从大到小分层,比如 公司/项目/设备类型/设备ID/数据类型。避免用 # 订阅所有,除非你真的需要,否则一个订阅者会收到全系统的消息,带宽和处理压力都扛不住。不要在主题里放动态变化的内容,比如时间戳,否则订阅方没法用通配符匹配。

还有一个容易忽略的点:主题是大小写敏感的。Sensor/Room1 和 sensor/room1 是两个完全不同的主题。团队协作时一定要约定好命名规范,不然调试的时候找半天找不到消息去哪了。

通配符的使用也有讲究。+ 只能匹配一层,# 必须放在最后。sensor/+/temperature 能匹配 sensor/room1/temperature,但匹配不了 sensor/room1/sub/temperature。sensor/# 能匹配 sensor 下面的所有层级,包括 sensor 本身。这些规则在写订阅代码的时候一定要确认清楚。

3.2 消息不丢的完整保障链路

"MQTT 怎么保证不丢失消息"是个高频问题。答案不是简单一句"用 QoS 1 或 2"就能打发的,需要从发布端、Broker、订阅端三个环节一起看。

发布端用 QoS 1,消息发出去后等 PUBACK,没收到就重发。但这里有个坑:重发的时候 DUP 标志位要置 1,Broker 收到 DUP 为 1 的消息时知道这是重传,不会重复投递给订阅者(对于 QoS 1 来说 Broker 只保证至少一次,去重是订阅端的事)。如果发布端自己没处理好重发逻辑,消息可能在网络层就丢了。

Broker 端要开启持久化。以 Mosquitto 为例,配置文件里 persistence true 和 persistence_location 要设好,这样 Broker 重启后未投递的消息不会丢。但持久化有性能开销,高吞吐场景下要权衡。

订阅端用 QoS 1 订阅,收到消息后发 PUBACK。如果订阅端处理消息比较慢,PUBACK 发晚了,Broker 可能会重发。所以订阅端要做幂等处理,比如用消息 ID 去重,或者业务逻辑本身支持重复执行。

我实际项目里的做法是:关键指令用 QoS 2,状态上报用 QoS 1 加时间戳去重,周期性传感器数据用 QoS 0。这样在可靠性和性能之间取了个平衡。

3.3 断线重连不是调个 API 就完事

断线重连是 MQTT 客户端必须处理好的逻辑,但很多人就简单写个 connectToHost 在断开信号里调用,结果遇到 Broker 挂了的时候疯狂重连,把 CPU 跑满。

正确的重连策略应该包含指数退避。第一次断开后等 1 秒重连,失败等 2 秒,再失败等 4 秒,一直退到最大间隔比如 60 秒,然后保持这个间隔重试。这样既能快速恢复,又不会在 Broker 长时间不可用时造成风暴。

重连之后还要处理会话恢复。如果 Clean Session 是 false,重连后 Broker 会恢复之前的订阅,不需要重新订阅。但如果是 true,就得重新发 SUBSCRIBE。我一般会在重连成功后检查一下会话状态,如果是新会话就重新订阅所有主题。

还有一个细节:重连时要重新发送未确认的 QoS 1/2 消息。这些消息在断开前已经发出但没收到确认,重连后需要重发。如果客户端没有维护这个待确认队列,这些消息就永久丢了。

4. 调试与排错:那些让人抓狂的瞬间

4.1 用 MQTT Explorer 看清每一条报文

调试 MQTT 最怕的就是"消息发出去了但订阅端没收到",到底是发布端没发出去、Broker 没转发、还是订阅端没收到,光看日志很难判断。这时候 MQTT Explorer 这类可视化工具就派上用场了。

MQTT Explorer 连上 Broker 之后,能看到所有主题的实时消息,还能看到主题树的结构。我一般会先用它订阅 #,然后让发布端发一条测试消息,看 Explorer 里能不能收到。能收到说明发布端和 Broker 没问题,问题在订阅端;收不到就往发布端和 Broker 方向查。

除了 MQTT Explorer,命令行工具 mosquitto_sub 和 mosquitto_pub 也很好用。mosquitto_sub -h broker_ip -t "sensor/#" -v 能订阅并打印主题和消息,-v 参数会带上主题名,方便确认消息发到了哪个主题。

4.2 连接失败的常见原因排查

MQTT 连接失败的原因五花八门,我整理了一个排查顺序:

现象 可能原因 排查方法
连接被拒绝,返回码 1 协议版本不匹配 确认客户端和 Broker 支持的 MQTT 版本一致
连接被拒绝,返回码 2 客户端 ID 被拒绝 检查客户端 ID 是否为空或格式不合法
连接被拒绝,返回码 4 用户名密码错误 确认 Broker 是否开启了认证,凭据是否正确
连接被拒绝,返回码 5 未授权 检查 Broker 的 ACL 配置
连接超时 网络不通或端口错误 用 telnet 测试端口连通性,确认防火墙规则
连上就断 Keep Alive 设置过短或心跳未发 检查心跳定时器是否正常工作

返回码在 CONNACK 报文的可变头第二个字节里,解析出来对照上面的表基本能定位大部分问题。

4.3 内存与线程安全的坑

用 Qt 写 MQTT 客户端,有几个内存和线程的坑特别容易踩。

QTcpSocket 的线程归属。QTcpSocket 必须在创建它的线程里使用,不能跨线程调用。如果你把网络操作放在工作线程,那 socket 的创建、读写、销毁都得在这个线程里完成。跨线程调用会报 QObject: Cannot create children for a parent that is in a different thread 这类错误。

信号槽的连接方式。跨线程的信号槽默认是 Qt::AutoConnection,会根据接收者所在线程自动选择直连还是队列连接。但如果接收者是个没有事件循环的对象,队列连接就不会生效。我一般会显式指定 Qt::QueuedConnection,避免歧义。

缓冲区无限增长。如果解析逻辑有问题,比如剩余长度算错了导致一直认为报文不完整,缓冲区会越来越大直到内存耗尽。我一般会加一个上限检查,比如缓冲区超过 1MB 就强制清空并重连,防止内存泄漏。

对象生命周期。MQTT 客户端对象如果在收到消息的回调里被销毁,后续的信号槽调用会崩溃。用 QPointer 或者 deleteLater 能避免这类问题。

5. 从能跑到好用:性能与工程化

5.1 批量消息与流量控制

当发布频率很高的时候,一条一条发 PUBLISH 效率很低。MQTT 5.0 引入了共享订阅和主题别名等特性来优化,但如果你用的是 3.1.1,就得自己在应用层做批量。

我的做法是把短时间内的多条消息合并成一个 payload,用 JSON 数组或者自定义的二进制格式打包,订阅端收到后拆包处理。这样能显著减少报文数量,降低 Broker 的压力。但要注意单条报文不能太大,MQTT 协议本身没有限制 payload 大小,但 Broker 通常有配置上限,比如 Mosquitto 默认是 256MB,实际使用中建议控制在几 KB 到几十 KB。

流量控制方面,QoS 1 的消息如果发得太快,Broker 来不及回 PUBACK,客户端的待确认队列会堆积。我一般会设置一个在途消息上限,比如最多 100 条未确认消息,超过就暂停发送,等确认回来再继续。这样能避免内存暴涨和 Broker 过载。

5.2 日志与可观测性

生产环境的 MQTT 客户端必须有完善的日志。我一般会记录这几类信息:连接状态变化(连接、断开、重连)、订阅和取消订阅操作、发布和接收的消息(至少记录主题和 QoS,payload 视情况记录)、错误和异常。

日志级别要能动态调整,调试的时候开 DEBUG 看详细报文,生产环境用 INFO 或 WARN 减少开销。Qt 的 QLoggingCategory 很适合做分类日志,可以按模块控制日志级别。

另外建议加一些统计指标,比如消息发送数、接收数、重连次数、平均延迟。这些指标可以通过 MQTT 本身上报到一个监控主题,或者暴露给 Prometheus 这类监控系统。有了这些数据,线上出问题的时候才能快速定位。

5.3 交叉编译到嵌入式平台的注意事项

把 Qt MQTT 客户端交叉编译到树莓派或者其它 ARM 板子上,有几个地方要特别注意。

工具链匹配。交叉编译工具链的版本要和目标板的系统库兼容。比如树莓派 4 用的是 ARMv8 架构,工具链要选对应的 aarch64-linux-gnu。如果工具链的 glibc 版本比目标板上的新,编译出来的程序在板子上跑不起来,会报 GLIBC_2.xx not found。

Qt 库的交叉编译。如果目标板上没有现成的 Qt 库,需要自己交叉编译 Qt。这个过程比较耗时,而且配置选项很多,建议用 configure 脚本把不需要的模块都裁掉,只保留 Core、Network 这些必需的,能省不少编译时间和存储空间。

部署依赖。交叉编译出来的可执行文件需要带上 Qt 的共享库和插件。可以用 linuxdeployqt 或者手动拷贝,注意 platforms 插件目录必须带上,否则会报 could not find the Qt platform plugin。这个错误我见过太多次了,基本都是插件路径没设对。

测试顺序。先在开发机上用本地 Qt 跑通,再交叉编译到板子上。板子上先跑一个最简单的网络测试程序确认网络和 Qt 运行时没问题,再跑完整的 MQTT 客户端。这样出问题的时候能快速定位是环境问题还是代码问题。

6. 几个实际项目里踩出来的经验

6.1 客户端 ID 千万别用随机数

我早期做的一个项目,客户端 ID 用 rand() 生成,想着反正每次连接都是新会话。结果测试的时候发现有时候两个设备会互相踢下线,查了半天才发现是随机数种子相同导致生成了相同的 ID。MQTT 协议规定,如果 Broker 收到一个已存在的客户端 ID 的新连接,会把旧连接踢掉。所以客户端 ID 必须全局唯一,最好用设备序列号或者 MAC 地址加前缀。

6.2 订阅要在连接确认之后

CONNECT 发出去之后,Broker 会回 CONNACK。必须等收到 CONNACK 并且返回码是 0(连接成功)之后,才能发 SUBSCRIBE。我见过有人在 connectToHost 之后立刻发 SUBSCRIBE,结果 Broker 还没处理完 CONNECT,SUBSCRIBE 被丢弃了,订阅一直不生效。正确的做法是在 CONNACK 的处理逻辑里触发订阅。

6.3 大 payload 要分片

MQTT 协议本身支持大 payload,但实际网络传输中,太大的报文容易在弱网环境下丢包重传,效率很低。我一般会把超过 64KB 的数据分片发送,每片带上序号和总片数,接收端重组。这样即使某一片丢了,也只需要重传那一片,不用重传整个大消息。

6.4 别忘了处理 Broker 主动断开

Broker 可能因为各种原因主动断开客户端,比如认证过期、超过最大连接数、收到重复的客户端 ID 连接。客户端收到断开后不能傻等着,要根据情况决定是重连还是报错。如果是认证问题,重连多少次都没用,得先更新凭据。我一般会在重连逻辑里加一个判断,如果连续多次因为认证失败被断开,就停止重连并上报告警。

6.5 测试要用真实的弱网环境

本地开发的时候网络太稳了,什么问题都暴露不出来。我建议用 tc(Linux 的流量控制工具)模拟弱网,比如加 100ms 延迟、5% 丢包,看看客户端在这种环境下表现如何。很多重连和超时的问题只有在弱网下才会暴露。Windows 上可以用 Clumsy 这类工具模拟。实测下来,弱网测试能提前发现 80% 的线上问题。

这套 MQTT 客户端我在三个项目里迭代过,从最开始只能发发消息,到后来支持 QoS 2、遗嘱消息、自动重连、TLS 加密,代码量从几百行涨到几千行。每次踩坑都是一次对协议理解的加深。如果你刚开始做 MQTT,建议先把 QoS 0 和 QoS 1 跑通,把主题设计和重连逻辑做扎实,再逐步加高级特性。别一上来就追求大而全,先把核心链路跑稳比什么都重要。

基于Python+Open CV的手势识别算法设计
伴随着人工智能时代的到来,人机交互的领域也逐渐成为研究的一大方向;其中,手势识别是人机交互领域的一项关键技术,自此手势识别也迎来了一波高潮,近几年无论是在消费领域、电子领域、数码领域、家电领域甚至汽车领域上,都能或多或少的见到手势识别的身影。 手势识别在设计智能高效的人机界面方面具有至关重要的作用, 目前手势识别已应用到手语识别、智能监控、到虚拟现实等各个领域,手势识别的原理都是利用各种传感器(例如红外、摄像头等)对手部的形态进行捕捉并进行建模,形成一个模型信息的序列帧,而后将这些信息序列转换为机器能够识别的相对应指令(例如打开、切换菜单、移动等)来完成控制。 采用Python的集成开发环境Pycharm进行本次课程设计,在Pycharm中进行需要库(模块)的下载,调取电脑摄像头,按帧读取摄像头采集到的头像,形态学处理,图像旋转(由于摄像头采集到的图像是镜像,需要用cv2.flip将摄像头采集到的图像进行处理),选取图片中固定位置作为手势输入,用红线画出手势识别框,基于hsv的肤色检测,进行高斯滤波,找出轮廓,求出图像中手势的凹凸点,手指间角度求取。
努力学习前端的小陈
ArcGIS Pro入门制图教程
地理信息系统 (GIS) 是一种使用地图显示和分析数据的方式。在本教程中,您将学习桌面 GIS 应用程序 ArcGIS Pro 的基础知识。新加坡的一家旅行社希望制作一款宣传册,用于向游客介绍距离市中心热门目的地最近的火车站。该宣传册将与带有文本信息的地图相结合,并在城市的自助设备中出售。您将帮助该旅行社绘制旅游景点的地图,分析其与火车站的距离以及更改地图的外观以使其在视觉上更具吸引力。在 ArcGIS Pro 中,地图和数据通常被组织在一个工程中。开始制作地图之前,您将创建一个工程。
科研online
ArcGIS Pro 布局创建与地图加载全流程解析
本文详细解析了ArcGIS Pro中布局创建与地图加载的全流程。针对从ArcMap转来的用户,重点阐述了布局与地图解耦的核心设计理念,并提供了从新建布局、设置参考比例尺、加载地图框到深度控制与精细化排版的实用技巧,帮助用户高效制作专业地图。
您的账号已被封禁
ArcGIS PRO布局视图避坑指南:地图框添加与专题图制作的5个关键步骤
本文针对ArcGIS PRO用户在布局视图中制作专题图时遇到的常见问题,提供了地图框添加与专题图制作的5个关键步骤避坑指南。从理解布局视图思维、数据框预处理、地图元素协同配置,到深化视觉层次与最终输出检查,系统讲解了如何高效产出严谨美观的专业地图,帮助用户跨越从数据分析到地图输出的最后一公里。
冰炭不同炉
ROS-CV-ImageConverter:将ROS图像转换为OpenCV(cv :: Mat)类型的图像
ROS-CV图像转换器 依存关系 cv_bridge(ROS软件包)
Willis Wang
计算机视觉图像处理-CV2与图像插值算法
用最近邻插值与双线性插值原理完成图像缩放 最近邻插值,是指将目标图像中的点,对应到源图像中后,找到最相邻的整数点,作为插值后的输。缺点:使用最近邻插值算法处理图像放大时,在图象中可能出现明显的块状效应 双线性插值,在两个方向上做三次线性插值。使用双线性插值算法处理图像放大时,在图象中可能出现马赛克 代码 import cv2 img = cv2.imread(’./xiabang.jpg’, cv2.IMREAD_UNCHANGED) #缩放比例 scale_percent = 0.3 width = int(img.shape[1] * scale_percent) height = int
weixin_38697274
基于水平集CV模型的图像分割(Matlab代码)
基于水平集CV模型的图像分割(Matlab代码),全套代码
小宇QAQ
导向滤波(guide_filter)的python实现
导向滤波(guide_filter)的python实现,可以结合暗通道;理论实现比较好的图像去噪效果。
zachzhan_g
ArcGIS Pro 如何新建布局
你是否已经习惯了在ArcGIS中数据视图和布局视图之间来回切换,到了ArcGIS Pro中却找不到二者之间切换的按钮,即使新建布局后却发现地图怎么却是一片空白。从上面的图中可以看到,虽然新建了布局,但是地图还是空白的,如果想要显示地图还需要加载一下,将地图加载进来。在新建的布局上绘制一个框,作为地图显示的范围,绘制后可以看到地图已经完成加载,如下图所示。在菜单栏上选择插入,点击新建布局下拉箭头,选择一个合适的尺寸,如下图所示。点击后完成布局的新建,新建的布局如下图所示。
水经注GIS
ArcGIS Pro数据修复与图层管理实战指南
本文是ArcGIS Pro数据修复与图层管理的实战指南。针对数据源丢失导致的“红色叹号”问题,详细讲解了一键批量修复和进阶手动修复策略,并分享了使用相对路径、打包工程等防患于未然的黄金法则。同时,深入介绍了如何利用图层组进行高效的地图内容组织、比例尺控制与批量操作,帮助用户构建清晰、智能的专业地图,大幅提升GIS项目管理效率。
Tomato
ArcGIS Pro布局设计实战:从空白页面到专业地图输出的完整工作流
本文详细解析了ArcGIS Pro中从“新建布局”开始,到输出专业地图的完整工作流。内容涵盖布局哲学、地图框深度运用、制图元素集成及视觉排版等核心环节,旨在帮助中级用户掌握项目驱动的现代化制图方法,实现从数据到出版级地图的精准转化。
AnjneyMidha
ArcGIS PRO布局视图避坑指南:地图框添加与坐标系设置的5个常见错误
本文针对ArcGIS PRO用户在布局视图中常遇的难题,重点解析了地图框添加与坐标系设置的5个常见错误。从地图框的创建逻辑、坐标系冲突的根源剖析,到地图范围控制、元素联动更新以及打印导出设置,提供了一套完整的避坑指南与实战解决方案,帮助用户高效、精准地完成地图制图与输出工作。
重离子猫猫
ArcGIS Pro布局设计避坑指南:为什么你的地图总是显示空白?
本文深入解析ArcGIS Pro布局设计中地图显示空白的常见问题,提供从基础操作到高级排错的完整解决方案。重点讲解地图框的正确使用方法、布局元素配置技巧,以及多地图框协同工作等进阶功能,帮助用户快速掌握专业地图制作的核心技术。
习翔宇
CV算法(MATLAB)
chan 和 vese 提出的经典CV模型
beastLOVE
GrabCut:使用opencv-python cv2.grabCut交互式剪切图像
GrabCut 使用opencv-python cv2.grabCut交互式剪切图像
Aaron Gary
Opencv-Python图像透视变换cv2.warpPerspective的示例
今天小编就为大家分享一篇关于Opencv-Python图像透视变换cv2.warpPerspective的示例,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
weixin_38711369
leetcodecv-Kylin:CV算法岗面经&LeetCode刷题总结
leetcode cv Kylin CV算法岗面经 & LeetCode刷题总结 不断更新中。。。。 面试&笔试经验 LeetCode
weixin_38499553
基恩士CV-X系列相机控制器用户手册CV-X Series Users Manual_CHS.pdf
基恩士CV-X系列相机控制器用户手册CV-X Series Users Manual_CHS真的很不错,
weixin_43905342
ArcGIS布局视图方向调整与优化技巧
地图布局方向是GIS制图的基础设置,直接影响空间数据的可视化效果。横向(Landscape)和竖向(Portrait)布局通过调整页面长宽比例,可优化不同地理要素的展示方式。在ArcGIS等专业制图软件中,方向设置会联动影响比例尺、图例等核心元素的自动适配逻辑。本文以A4纸张为例,详解通过页面设置、Python脚本批处理等技术手段实现布局方向的高效调整,并针对比例尺失准、图例溢出等典型问题提供工程解决方案。特别适用于带状区域地图制作等需要最大化利用版面空间的场景,可提升40%以上的图面利用率。
塞音菩光
ArcGIS Pro 3.4必学新功能:符号系统与布局视图的可见性联动(含省时技巧)
ArcGIS Pro 3.4引入了符号系统与布局视图的可见性联动功能,通过唯一值符号化和复选框控制,实现原子级要素显示/隐藏。这一创新极大提升了制图效率,支持在符号系统窗格、内容窗格和布局视图中同步操作,特别适合城市规划、环境监测等需要动态展示的场景。
t8u9v0
ArcGIS Pro 布局创建与地图加载全攻略
本文详细解析了ArcGIS Pro中布局与地图分离的设计哲学,并提供了从新建布局到加载地图的完整操作指南。重点介绍了如何通过“插入”选项卡新建布局、选择合适的页面尺寸,以及使用地图框工具将项目中的地图动态链接至布局。文章还涵盖了地图范围控制、比例尺锁定、图例添加等深度定制技巧,帮助用户高效创建专业地图并导出为高质量成果。
milk8
ArcGIS多图布局实战:从数据框管理到批量导出的完整指南
在地理信息系统(GIS)制图领域,将多张地图高效整合到单一版面是提升分析报告专业性与表现力的关键技术。其核心原理在于理解并运用数据框与布局视图的分离机制,通过独立的数据框承载不同区域或专题的地理数据,并在统一的布局视图中进行精确排版与视觉整合。这项技术的核心价值在于实现了制图流程的标准化与自动化,避免了传统拼图方式带来的效率低下与更新困难问题,尤其适用于区域对比、时间序列分析、综合评估报告等需要多视角、多维度展示地理信息的应用场景。本文聚焦于ArcGIS Pro平台,深入剖析了多图布局中数据框范围联动、地图
aaa1231722
monolithic-cv:CV算法的集合
单片-cv 计算机视觉算法转储
晨曦姜
改进的cv图像分割
改进的cv图像分割,对学习cv模型有帮助
a904235765
C++实现基于暗通道与导向滤波的图像去雾算法
资源下载链接为: https://pan.quark.cn/s/1bfadf00ae14 在图像处理领域,图像去雾技术用于消除大气散射导致的模糊,提升图像清晰度和视觉质量。本文将介绍一种基于暗通道和导向滤波的图像去雾算法,并探讨如何使用C++和OpenCV库实现。 暗通道理论由Jia等人于2006年提出。他们发现自然场景中存在一些低亮度像素,通常位于无直射光区域。这些像素被称为暗通道像素,可用于估计大气散射模型中的透射率。具体方法是将图像分块,在每块中找到最暗像素值作为暗通道像素。 大气散射模型是图像去雾的基础,描述了光线在大气中传播时的散射影响。模型公式为: I(x)=T(x)×J(x)+A×(1−T(x)) 其中,T(x)是透射率,J(x)是无雾图像亮度,A是全局大气光。透射率与散射程度成反比,无雾图像亮度反映物体本身色彩。 利用暗通道先验,可以近似估计透射率。假设D(x)为暗通道像素,透射率T(x)可通过迭代公式计算: T k+1 (x)= max(D)+ϵ D(x) +(1− max(D)+ϵ D(x) )×T k (x) 其中,k是迭代次数,ϵ是小常数,用于避免除零。 估计透射率后,使用导向滤波器平滑透射率图,减少噪声和边缘失真。导向滤波是一种自适应局部滤波方法,可保持图像边缘细节,同时进行平滑处理。在图像去雾中,它根据图像梯度信息指导滤波过程,更好地恢复图像清晰度。 通过大气散射模型,可得到去雾后的图像: J out (x)= T(x) I(x)−A×(1−T(x)) +A 在C++中,可借助OpenCV库处理图像数据。首先读取输入图像,然后提取暗通道,估计透射率,应用导向滤波,最终恢复无雾图像。OpenCV提供了丰富的图像处理函数,如cv::split用于分离通道,cv::min用于找最小值,cv::filter2D用于导向滤波,cv::imwrite用于保存
KaiyuanCode
cv模型图像分割matlab源程序
cv模型 matlab 图像分割源码,逻辑清晰,注释详尽。
phoenix01
CV图像分割
从pud找到的CV图像分割代码,代码的通过较少的迭代次数就可以实现图像的分割,对学习CV分割有帮助。
a904235765
ArcGIS Pro 3.0 布局视图实战:5分钟搞定专业地图的图例、比例尺与指北针
本文详细介绍了ArcGIS Pro 3.0布局视图的实战技巧,帮助用户在5分钟内高效添加图例、比例尺与指北针,打造专业地图。通过智能图例、动态比例尺和现代化指北针设计,提升制图效率与美观度,特别适合GIS初学者和从ArcMap迁移的用户。
weixin_30652491
ArcGIS Pro界面突然消失?3种恢复方法+自定义布局技巧
本文针对ArcGIS Pro用户常见的操作界面元素突然消失问题,提供了三种核心恢复方法:通过“视图”功能区一键唤回、利用“重置窗格”命令恢复默认布局,以及通过应用程序设置进行深度恢复。文章还深入讲解了如何通过停靠、分组窗格以及自定义功能区等技巧,打造高效个性化的操作界面,帮助用户从被动解决问题转向主动优化工作环境。
nnn11
NC数据预处理避坑指南:从MATLAB读取到GeoTIFF导出,解决坐标翻转与值域异常
本文详细解析了NC数据预处理中的常见问题,包括MATLAB读取时的坐标翻转与GeoTIFF导出时的值域异常。通过实战案例,介绍了如何解决矩阵方向错乱、处理FillValue与scale_factor、精准移植空间参考等关键问题,帮助研究者高效完成气象数据的批量处理与GIS兼容性验证。
weixin_30788619