定义并生成镶嵌数据集的概视图。
此工具支持镶嵌数据集的默认设置，而不支持对镶嵌数据集图层所设置的属性。例如，此工具不接受如波段计数、镶嵌方法、范围或查询等图层属性变化，这些属性由镶嵌数据集及其默认属性所确定。
必须选中定义缺失概视图切片、生成概视图，或者同时选中这两项。
概视图的第一个级别在镶嵌数据集的全分辨率下创建。后续各个级别均在上一次生成的概视图级别基础上构建。
如果需要对概视图的定义进行更多控制，请优先使用定义概视图工具。
默认情况下，如果概视图是针对文件地理数据库中的镶嵌数据集而生成的，它们将存储在文件夹 <gdbname>.Overviews 中，该文件夹与包含镶嵌数据集的地理数据库处于同一位置。在企业级地理数据库上生成的镶嵌数据集概视图存储在包含镶嵌数据集的地理数据库中。更改这些位置优先使用定义概视图工具，并指定新位置。
不能为引用的镶嵌数据集构建概视图。
| 标注 | 说明 | 数据类型 |
镶嵌数据集 | 用来构建概视图的镶嵌数据集。 | Mosaic Layer |
查询定义 (可选) | 用来在镶嵌数据集中选择特定栅格的 SQL 语句。选定栅格将构建其自己的概视图。 | SQL Expression |
定义缺失概视图切片 (可选) | 识别需要概视图的位置并定义概视图。
| Boolean |
生成概视图 (可选) | 生成所有需要创建或重新创建的概视图。这包括缺失的概视图和过时的概视图。
| Boolean |
仅生成缺失概视图影像 (可选) | 在已经定义但尚未生成概视图时使用。
| Boolean |
仅重新生成过时概视图影像 (可选) | 更改基础栅格数据集或修改其属性时，会导致概视图过时。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 更新的镶嵌数据集 | 已更新的镶嵌数据集。 | 镶嵌图层 |
arcpy.management.BuildOverviews(in_mosaic_dataset, {where_clause}, {define_missing_tiles}, {generate_overviews}, {generate_missing_images}, {regenerate_stale_images})| 名称 | 说明 | 数据类型 |
in_mosaic_dataset | 用来构建概视图的镶嵌数据集。 | Mosaic Layer |
where_clause (可选) | 用来在镶嵌数据集中选择特定栅格的 SQL 语句。选定栅格将构建其自己的概视图。 | SQL Expression |
define_missing_tiles (可选) | 识别需要概视图的位置并定义概视图。
| Boolean |
generate_overviews (可选) | 生成所有需要创建或重新创建的概视图。这包括缺失的概视图和过时的概视图。
| Boolean |
generate_missing_images (可选) | 在已经定义但尚未生成概视图时使用。
| Boolean |
regenerate_stale_images (可选) | 更改基础栅格数据集或修改其属性时，会导致概视图过时。
| Boolean |
| 名称 | 说明 | 数据类型 |
| out_mosaic_dataset | 已更新的镶嵌数据集。 | 镶嵌图层 |
这是 BuildOverviews 的 Python 示例。
import arcpy
arcpy.BuildOverviews_management(
"C:/Workspace/Overviews.gdb/md", "OBJECTID<5", "DEFINE_MISSING_TILES",
"NO_GENERATE_OVERVIEWS", "IGNORE_MISSING_IMAGES", "IGNORE_STALE_IMAGES")这是 BuildOverviews 的 Python 脚本示例。
# Define Overviews for selected items only
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.BuildOverviews_management("Overviews.gdb/md", "OBJECTID<5",
"DEFINE_MISSING_TILES",
"NO_GENERATE_OVERVIEWS", "#", "#")