Android 13 DocumentsUI 源码解析:SAF 前端架构与定制实战

Android 13DocumentsUISAF
于 2026-10-29 05:30:14 修改
·本内容遵循CC 4.0 BY-SA版权协议

Android 13 上把 DocumentsUI 从系统镜像里单独拎出来编译、调试、改需求,是这两年做定制 ROM 和文件管理类应用的同学绕不开的一件事。它表面上只是「文件选择器」,实际上承担了存储访问框架(SAF)的整套前端交互:从三方应用调起 ACTION_OPEN_DOCUMENT,到用户点选目录、授权持久化 URI,再到 MTP、下载、最近文件这些入口的聚合,全都压在这一个 APK 里。很多人第一次拿到源码会懵——它既不是普通的单 Activity 应用,也不是标准的 MVVM 分层,而是带着 AOSP 特有的 Loader、Provider、DialogFragment 混搭风格。这篇就把我在 Android 13 源码树里反复翻 DocumentsUI 的收获整理出来,从模块边界、核心组件、数据流到实际改造时踩过的坑,尽量讲透。适合正在做 ROM 定制、系统应用二次开发,或者单纯想搞懂 SAF 前端怎么运转的 Android 工程师。

1. 先搞清楚 DocumentsUI 到底管了多大一摊事

1.1 它在系统里的真实定位

很多人以为 DocumentsUI 就是「文件管理器」,这个认知偏差会直接导致改造方向跑偏。准确说,它是 SAF(Storage Access Framework)的官方前端实现,包名是 com.android.documentsui,在 Android 13 里源码路径位于 packages/apps/DocumentsUI。它自己不直接读磁盘,所有文件数据都来自实现了 DocumentsProvider 的各类 Provider——比如 ExternalStorageProvider(内部存储和 SD 卡)、DownloadStorageProvider(下载)、MediaDocumentsProvider(图片视频音频)、MtpDocumentsProvider(连接电脑时的 MTP),以及三方 App 自己注册的 Provider。

理解这一点非常关键:DocumentsUI 是一个纯 UI 壳 + 交互协调层。它通过 ContentResolver 去查询 Provider 暴露的 DocumentsContract 接口,拿到 Cursor 后渲染列表。所以你在 DocumentsUI 里看到的每一个文件条目,背后都是一次跨进程的 Provider 查询。这也解释了为什么它大量使用 Loader 而不是直接 query()——因为跨进程查询慢且需要异步、需要生命周期感知、需要在数据变化时自动刷新。

从业务架构角度看,它属于典型的「前端聚合层」:向下屏蔽了不同 Provider 的差异,向上给三方应用提供统一的文件选择体验。这跟物联网三层架构里「平台层聚合设备差异、应用层统一调用」的思路其实是一回事,只不过这里聚合的是存储源,不是传感器。

1.2 模块划分与依赖关系

Android 13 的 DocumentsUI 在 Gradle 层面被拆成了几个模块,这是它和很多系统应用不一样的地方:

模块 职责 关键产物
app 主应用,Activity、Fragment、Adapter 全在这 DocumentsUI.apk
libs 公共工具、Provider 交互封装 静态库
tests 单元测试与集成测试 测试 APK
prebuilts 预编译依赖 —

主模块内部又按功能包划分:com.android.documentsui(根,放 Activity 和核心逻辑)、base(DialogFragment 基类、状态管理)、dir(目录列表页)、recents(最近文件)、search(搜索)、sidepanel(侧边栏 Roots 列表)、picker(选择模式)、files(文件列表项)、model(数据模型)、selection(多选管理)。

我建议第一次读源码的人从 BaseActivity 和 DocumentsActivity 入手,而不是从 DirectoryFragment。因为 Activity 决定了整个应用的启动模式、Intent 分发、权限校验,是理解全局的钥匙。DocumentsActivity 继承自 BaseActivity,而 BaseActivity 里做了大量「根据 Intent 决定当前是 pick 模式还是 manage 模式」的判断,这是整个应用行为分叉的源头。

1.3 两种运行模式的本质区别

DocumentsUI 启动后只有两种身份,靠 Intent 的 action 区分:

  • Pick 模式:三方应用调 ACTION_OPEN_DOCUMENT / ACTION_CREATE_DOCUMENT / ACTION_GET_CONTENT 时进入。此时界面顶部有「取消/选择」按钮,用户选中后通过 setResult 把 URI 回传给调用方,并且可以申请持久化权限。
  • Manage 模式:从设置里的「文件」入口、或者 ACTION_VIEW 某个目录时进入。此时是完整的文件浏览体验,可以重命名、删除、新建文件夹、压缩等。

这两种模式共用同一套 Fragment 和 Adapter,差异通过 State 对象和 Menu 配置来控制。BaseActivity.getDisplayState() 返回的 State 里有个 action 字段,取值 ACTION_OPEN、ACTION_CREATE、ACTION_GET_CONTENT、ACTION_VIEW 等,后续所有 UI 分支几乎都围绕它展开。改造时如果你想加一个自定义入口,第一步就是确认它落在哪个 action 分支里,否则很容易出现「按钮显示了但点了没反应」的情况。

2. 核心组件是怎么串起来的

2.1 Activity 层的启动与 Intent 解析

DocumentsActivity 是整个应用的唯一主 Activity(DocumentsLauncherActivity 只是个别场景的别名)。它的 onCreate 里最关键的一步是 mState = getDisplayState(),这个方法在 BaseActivity 中实现,逻辑大致是:

  1. 读取 Intent 的 action、type、extra(如 EXTRA_INITIAL_URI、EXTRA_MIME_TYPES、EXTRA_ALLOW_MULTIPLE)。
  2. 结合 getCallingActivity() 判断是内部调用还是外部调用。
  3. 构造一个 State 对象,里面包含 action、allowMultiple、allowCreate、stack(初始目录栈)等。

这里有个容易忽略的点:EXTRA_INITIAL_URI 的合法性校验。如果调用方传了一个当前 Provider 无法访问的 URI,DocumentsUI 不会崩溃,而是回退到默认根目录。这个回退逻辑在 State.build() 里,通过 DocumentsContract.isDocumentUri() 和 Root.getRootForUri() 双重判断。我在定制时遇到过调用方传了 content://com.thirdparty.provider/... 但该 Provider 没注册的情况,结果就是静默回退,排查了半天才发现是 Provider 侧的问题,不是 DocumentsUI 的锅。

2.2 Fragment 体系与 Loader 机制

界面主体是 DirectoryFragment,它负责渲染一个目录下的子项列表。它内部持有一个 DirectoryLoader(继承自 AsyncTaskLoader<DirectoryResult>),在 onCreateLoader 里创建,在 onLoadFinished 里拿到 Cursor 并交给 DirectoryAdapter。

为什么用 Loader 而不是 ViewModel + LiveData?这是历史包袱也是合理选择:Loader 天然绑定 LoaderManager,能在配置变更(旋转屏幕)时自动重连,且 ContentResolver 的 query 配合 Loader 的 onContentChanged 能实现数据变更自动刷新。Android 13 里虽然官方推荐 ViewModel,但 DocumentsUI 并没有迁移,因为迁移成本高且收益有限。你如果要做深度定制,不建议动 Loader 这套机制,牵一发动全身。

DirectoryResult 里除了 Cursor,还带了 exception、mIsSearchResult、mIsPartial 等状态。mIsPartial 表示当前目录只加载了一部分(比如 MTP 设备),UI 上会显示「正在加载更多」。这个字段在处理大目录时很有用,但很多二次开发者会忽略它,导致列表滚动到底部没有加载提示。

2.3 Provider 交互与 Roots 管理

侧边栏的「根目录」列表来自 RootsFragment + RootsLoader。RootsLoader 会遍历系统里所有注册了 DocumentsProvider 的包,调用每个 Provider 的 queryRoots(),把返回的 Root 聚合成侧边栏条目。

这里有个性能陷阱:Provider 数量多的时候,queryRoots() 是串行调用的。如果你在 ROM 里预装了很多带 Provider 的应用,冷启动时侧边栏会明显卡顿。我在一个项目里预装了 6 个带 Provider 的应用,冷启动侧边栏要 1.2 秒才出来。优化手段是给 RootsLoader 加并发查询,但要注意 Provider 的 queryRoots 可能不是线程安全的,需要加锁或限制并发数。实测并发数控制在 3 以内比较稳。

Root 对象里有个 mFlags 字段,常见取值有 FLAG_LOCAL_ONLY、FLAG_SUPPORTS_CREATE、FLAG_SUPPORTS_DELETE、FLAG_SUPPORTS_RECENTS 等。UI 会根据这些 flag 决定是否显示「新建文件夹」「删除」等菜单项。如果你自定义 Provider 时忘了设 flag,就会出现「菜单项灰掉」的问题,这是最高频的踩坑点之一。

3. 数据流与状态管理:一次点击到底发生了什么

3.1 从用户点击到 URI 回传的完整链路

假设用户在 Pick 模式下点了一个文件,完整链路是这样的:

  1. DirectoryAdapter 的 onBindViewHolder 里给 item 绑定了 OnClickListener,点击后调用 SelectionManager.toggleSelection()。
  2. SelectionManager 更新选中集合,通知 DirectoryFragment 刷新 UI(底部「选择」按钮变为可用)。
  3. 用户点「选择」,PickerFragment 或 BaseActivity 的 onClick 触发 finishWithResult()。
  4. finishWithResult() 从 SelectionManager 取出选中的 DocumentInfo,调用 DocumentsContract.buildDocumentUri() 构造最终 URI。
  5. 如果是 ACTION_OPEN_DOCUMENT 且需要持久化,调用 ContentResolver.takePersistableUriPermission()。
  6. setResult(RESULT_OK, intent) 并 finish()。

这条链路里第 5 步是重灾区。takePersistableUriPermission 要求 Provider 在 queryDocument 返回的 Cursor 里设置了 FLAG_SUPPORTS_PERSISTABLE_URI_PERMISSION,否则会抛 SecurityException。很多三方 Provider 没设这个 flag,导致调用方拿到的 URI 在进程重启后失效。排查时可以在 finishWithResult 里加日志打印 flag 值,一眼就能定位。

3.2 State 对象与配置变更

State 是 DocumentsUI 里一个被低估的类。它实现了 Parcelable,在 Activity 重建时通过 onSaveInstanceState 保存。它里面存了当前 action、当前目录栈、选中项、搜索状态等。理解 State 的序列化边界很重要:它只存 URI 和基本类型,不存 Cursor。所以旋转屏幕后,Fragment 会重新走一遍 Loader 加载流程,而不是复用旧数据。

这个设计带来的一个实际问题是:大目录旋转屏幕后会重新查询。如果目录里有几千个文件,旋转时会白屏一下。缓解办法是在 DirectoryFragment 里加一个「保留上次结果」的缓存,但要注意缓存失效问题。我一般不建议改,因为改动风险大于收益,除非你的场景对旋转体验有硬要求。

3.3 搜索与 Recents 的数据来源

搜索功能由 SearchFragment + SearchLoader 实现,它调用的是 Provider 的 querySearchDocuments() 接口。注意:不是所有 Provider 都支持搜索,只有设置了 FLAG_SUPPORTS_SEARCH 的 Root 才会出现在搜索结果里。如果你发现搜索不到某个目录,先查这个 flag。

Recents(最近文件)由 RecentsLoader 实现,它调用 Provider 的 queryRecentDocuments()。这个接口在 Android 13 里对 ExternalStorageProvider 的实现是基于 MediaStore 的,所以「最近文件」实际上反映的是媒体库的最近变更,而不是文件系统的最近访问。这个语义差异经常被误解,做需求时要跟产品讲清楚。

4. 改造实战:从编译到功能定制的完整路径

4.1 单独编译与调试环境搭建

在 AOSP 源码树里单独编译 DocumentsUI:

BASH
source build/envsetup.sh
lunch aosp_arm64-userdebug
mmm packages/apps/DocumentsUI

产物在 out/target/product/<device>/system/priv-app/DocumentsUI/DocumentsUI.apk。推送到设备:

BASH
adb root
adb remount
adb push out/target/product/<device>/system/priv-app/DocumentsUI/DocumentsUI.apk /system/priv-app/DocumentsUI/
adb reboot

调试时建议用 Android Studio 的「Attach to Process」,进程名是 com.android.documentsui。注意它是 priv-app,需要平台签名才能正常访问某些 Provider,用普通 debug 签名编译出来的 APK 推上去可能无法查询 ExternalStorageProvider,表现为列表空白。这是新手最容易卡住的地方——必须用平台签名,或者把 APK 放到 /system/app 并确保签名匹配。

4.2 常见定制需求与实现位置

需求 改动位置 注意事项
隐藏侧边栏某个 Root RootsLoader 过滤 别直接改 Provider,影响面太大
默认打开某个目录 State.build() 里改 stack 要校验 URI 合法性
增加自定义菜单项 DirectoryFragment.onCreateOptionsMenu 注意 pick/manage 模式差异
修改文件排序 DirectoryAdapter 的 Comparator 要同步改 Model 层
禁用删除功能 Root.mFlags 去掉 FLAG_SUPPORTS_DELETE 改 Provider 侧更彻底

我重点说「默认打开某个目录」这个需求。很多人直接在 DocumentsActivity.onCreate 里 setIntent 改 URI,结果发现不生效。正确做法是在 State.build() 里,当 EXTRA_INITIAL_URI 为空时,注入你的默认 URI。但要注意:这个 URI 必须能被某个已注册的 Root 覆盖,否则会被回退逻辑吃掉。验证方法是打印 Root.getRootForUri() 的返回值,非 null 才算合法。

4.3 踩坑实录:Provider flag 缺失导致的菜单失效

有一次产品要求「在下载目录里支持新建文件夹」,我改了半天 UI 代码都没用,菜单项始终是灰的。排查链路是这样的:

  1. 先确认 DirectoryFragment 的 onPrepareOptionsMenu 里判断条件是什么——发现是 mState.canCreate()。
  2. 追 canCreate(),发现它读的是当前 Root 的 FLAG_SUPPORTS_CREATE。
  3. 打印当前 Root 的 flags,发现 DownloadStorageProvider 返回的 Root 没有这个 flag。
  4. 去 DownloadStorageProvider 源码里看,发现它的 queryRoots 里确实没加 FLAG_SUPPORTS_CREATE。
  5. 结论:不是 DocumentsUI 的问题,是 Provider 侧没声明能力。

这个坑的教训是:DocumentsUI 的 UI 能力完全由 Provider 的 flag 驱动,遇到「功能不显示」先查 flag,别急着改 UI。类似地,FLAG_SUPPORTS_RECENTS 决定是否出现在最近列表,FLAG_SUPPORTS_SEARCH 决定是否可搜索,FLAG_SUPPORTS_THUMBNAIL 决定是否显示缩略图。建议在调试时写个工具方法,把当前 Root 的所有 flag 打出来,能省大量时间。

4.4 踩坑实录:MTP 目录加载卡顿的优化

MTP 场景下,MtpDocumentsProvider 的 queryChildDocuments 是同步阻塞的,且一次只返回一批。DocumentsUI 的 DirectoryLoader 在 loadInBackground 里会循环调用直到拿完或达到上限。默认上限是 DirectoryLoader.LOADER_MAX_COUNT(我记得是 1000 左右)。如果 MTP 设备里文件很多,加载会非常慢。

优化思路有两个:一是调小单批数量、加快首屏渲染,让用户先看到一部分;二是给 DirectoryLoader 加超时,超时后显示「部分加载」。我实测把首批数量控制在 200 左右,首屏时间从 3 秒降到 800 毫秒。但要注意 mIsPartial 状态要正确设置,否则用户以为加载完了,实际还有数据没出来。

5. 架构层面的取舍与延伸思考

5.1 为什么它没有采用现代 Android 架构

DocumentsUI 的代码风格停留在 Loader + Fragment + 静态工具类的时代,没有 ViewModel、没有 Hilt、没有 Kotlin 协程。这不是团队懒,而是系统应用的稳定性优先级远高于架构先进性。它要跑在几亿台设备上,任何架构迁移都可能引入难以复现的崩溃。而且它大量依赖 ContentResolver 和 LoaderManager 的生命周期绑定,迁移到 ViewModel 需要重写数据层,收益不明显。

从业务架构视角看,这其实是一个「稳定优先、演进保守」的典型案例。跟物联网三层架构里平台层往往用最成熟而非最新的技术栈是一个道理——底层越稳,上层越敢创新。你做定制时如果非要引入协程,建议只在新增的独立功能里用,别动存量代码。

5.2 与三方文件管理器的边界

经常有人问:能不能基于 DocumentsUI 改一个完整的文件管理器?技术上可以,但要注意它的定位是「选择器」,很多文件管理器的能力它天生没有:比如批量重命名、文件压缩解压、FTP/SMB 挂载、root 权限访问。这些要么依赖 Provider 扩展,要么得自己加。我的建议是:如果只是要一个「能选文件」的界面,改 DocumentsUI 最省事;如果要做完整文件管理,另起一个应用更合适,否则你会在一堆 SAF 约束里挣扎。

5.3 后续可扩展的方向

如果你已经把 DocumentsUI 跑通并做了基础定制,可以往这几个方向延伸:一是自定义 DocumentsProvider,把自己的业务数据(比如云盘、数据库记录)暴露成文件树,这样不用改 DocumentsUI 就能接入;二是研究 DocumentsContract 的 Cursor 列定义,理解 COLUMN_DOCUMENT_ID、COLUMN_MIME_TYPE、COLUMN_FLAGS 这些字段怎么影响 UI;三是看 Root 的 COLUMN_ROOT_ID 和 COLUMN_AVAILABLE_BYTES,做存储空间展示。

我个人在实际操作中的体会是:DocumentsUI 的复杂度不在代码量,而在它和 Provider 之间的契约。你把 DocumentsContract 那套接口吃透,再看 DocumentsUI 的代码就会觉得顺理成章。反过来,如果只盯着 UI 层改,遇到问题会一直在表面打转。最后分享一个小技巧:调试 Provider 相关问题时,用 adb shell content query --uri content://com.android.externalstorage.documents/root 直接查 Provider 返回的数据,比在代码里打断点快得多。

基于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
Gamit 数据处理,相关的文件配置
一、处理前准备 1、在主文件夹内新建test项目文件,项目内新建brdc、igs和rinex三个文件夹,分别存放广播星历,精密星历几观测值文件,所用的命令分别为sh_get_nav、sh_get_orbits和sh_get_rinex (若文件为.Z,用gunzip命令解压,若仍为d,用命令sh_crx2rnx -f 命令解压为o文件) 2、进入test项目文件夹,链接tables,运行 sh_setup -yr 2015 -apr itrf08_com.apr 3、生成station.info文件。 将t
CodeDoraemon