360 度视频转定向影像 (Indoors 工具)

汇总

将 360 度影像从 360 度视频提取到定向影像数据集中。该工具的输出可添加至 ArcGIS Pro 中的楼层感知型地图和场景。

用法

此工具支持由 360 度相机拍摄的 360 度 MP4 视频。视频必须采用等距制图表达。
此工具适用于正常速度和时间压缩的 360 度视频。请使用以下视频捕捉类型参数选项之一来指定视频的录制方式：
- 实时—该视频以正常速度播放（无时间压缩）。
- 速度（倍数）—该视频以高于实时速度录制，并以倍数形式表示。例如，“2 倍速”视频会使移动的速度看起来是正常速度的两倍。
- 间隔（秒）—相机每隔固定秒数捕获一帧画面，而不是录制连续视频。例如，“0.5 秒的间隔”意味着相机每半秒捕获一帧。
注:

有些相机将以较低的帧速率 (FPS) 录制，而非间隔。要将 FPS 转换为以秒为单位的间隔，请将 1 除以 FPS。例如，2 FPS -> 0.5 秒间隔。
指定视频捕获类型参数值后，可以使用视频捕获速率参数来指定速度或间隔，例如：
- 对于以 5 倍速捕获的视频，请将视频捕获类型参数设置为“速度（倍数）”，并将视频捕获速率参数设为 5。
- 对于以半秒间隔捕获的视频，请将视频捕获类型参数设置为“间隔（秒）”，并将视频捕获速率参数设置为 0.5。
注:

如果时间压缩倍率未知，则可以通过观看视频并观察其速度来进行有根据的估计。即使只是粗略估计，通常也能得到可用的结果。
目标定向影像参数值需为已启用 Z 值的定向影像图层。

注:

可使用创建定向影像数据集工具创建定向影像数据集。
目标定向影像图层可以来自本地定向影像数据集或托管要素服务。将照片导入托管要素服务时，要素服务必须支持要素附件。
使用控制点 1 和控制点 2 参数对输出要素进行地理配准。按以下方式设置参数值：
- 视频时间—指定视频播放时间戳（格式为 hh:mm:ss.s）以确定相机位置。
  
  使用距离视频开始或结束至少 5 秒的时间戳，且控制点之间的时间间隔至少为 5 秒。
  
  注:
  
  该工具将使用实时等效数据来检查时间戳。例如，对于 2 倍速视频，应使用距离视频开始或结束至少 2.5 秒（对应实际时间的 5 秒）的时间戳，并且控制点之间的间隔至少为 2.5 秒。
- 相机位置—在地图上放置一个点，反映相机在指定时间戳所处的位置。
  
  相机位置必须至少相隔 1 米。
提示：

使用彼此距离尽可能远的控制点，以提高地理配准的精度。
使用以下视频提取参数指定沿视频路径自动提取图像的方式：
- 提取间隔—输出图像之间的时间间隔。默认值为 2 秒，相当于以平均步速移动约 9 英尺（3 米）。
注:

该工具将实时测量输出图像之间的时间。对于时间压缩视频，应采用与实时视频相同的值。
- 开始时间戳—从视频中开始提取图像的时间戳（格式为 hh:mm:ss.s）。例如，使用值 00:15:10 表示在视频开始后 15 分 10 秒处开始提取。默认为视频的开始处。
- 结束时间戳—停止从视频中提取图像的时间戳（格式为 hh:mm:ss.s）。例如，使用值 01:10:00 表示在视频开始后 1 小时 10 分处结束提取。默认为视频的结尾。
注:

实际的开始时间、结束时间和提取图像之间的时间间隔可能因输入视频质量而异。
- 掩膜下半部分—要掩膜或涂黑的输出图像底部的百分比。由此将从输出图像中移除摄像师。默认值为 0%：表示无掩膜；最大值为 50%：要掩膜整个下半球。
此工具使用视觉同步定位与地图构建 (VSLAM) 技术来确定提取图像的相对位置和方向。 VSLAM 的精度取决于运动模糊、环境中可跟踪位置（边缘、角落、纹理）的数量、相机移动速度以及录制视频时所使用的时间压缩量等因素。

注:

当检测到受支持的硬件时，此工具将使用 GPU 加速以提升性能；否则，其将在 CPU 上运行，输出质量不变
如果输入视频在 Indoors 模型中的某个层级重叠，请使用输入层级要素参数。由此工具能够在目标定向影像图层中填充层级 ID 值，以便将其配置为楼层感知型图层。
- 如果未指定控制点，输出要素将移动并缩放至所选层级要素的范围和高程。所有输出要素均被分配所选层级要素的层级 ID 值。
- 指定控制点后，输出要素将根据控制点进行地理配准（移动、旋转和缩放）。位于所选层级要素范围内的地理配准要素将被分配此层级的 ID 和高程；位于此层级外的要素将被分配 Null ID 和高程值 0。
使用层级参数以在输入层级要素参数值内选择特定层级。只能指定一个层级。
使用楼层字段参数在目标定向影像图层中创建字段或者指定现有字段，以存储层级 ID 值。该工具将按以下方式设置该字段：
- 可以提供自定义字段名称。如果目标定向影像图层中不存在具有此名称的字段，则该工具将创建一个字段，并使用重叠层级要素的层级 ID 值填充该字段。
- 如果将目标定向影像图层配置为楼层感知型图层，则将使用该图层的已配置楼层字段自动填充此参数。
- 如果目标定向影像图层未配置为楼层感知型图层，或者未提供任何值，则该工具将创建一个名为 LEVEL_ID 的字段（如果该字段不存在），并使用重叠层级要素的层级 ID 值填充该字段。

标注	说明	数据类型
输入 360 度视频	包含可从中提取 360 度图像的 360° 视频的输入 `.mp4` 文件。	File
目标定向影像	将添加要素的目标定向影像图层。	Oriented Imagery Layer
目标图像文件夹	将写入图像文件的现有文件夹。	Folder
控制点 1 （可选）	将用于对输出要素进行地理配准的第一个控制点。值表列： Video Time—The video timestamp in hh:mm:ss.s format. Camera Location—The point feature representing the camera's location in the map at the specified video timestamp.	Value Table
控制点 2 （可选）	将用于对输出要素进行地理配准的第二个控制点。值表列： Video Time—The video timestamp in hh:mm:ss.s format. Camera Location—The point feature representing the camera's location in the map at the specified video timestamp.	Value Table
输入楼层要素（可选）	来自 Indoors 模型的输入楼层图层。	Feature Layer
楼层（可选）	输入楼层要素参数值中的楼层表示视频捕获全部或部分内容的位置。该工具将此楼层的 `LEVEL_ID` 字段值分配给与该要素重叠的定向影像要素的楼层字段。	String
楼层字段（可选）	将使用层级参数的关联层级 ID 来填充目标定向影像参数值中的字段。该工具将按以下方式设置楼层字段：如果目标定向影像参数值是楼层感知型图层，则此参数将默认为该图层的已配置楼层字段参数值。否则，该参数将默认为 `LEVEL_ID`。还可以提供自定义字段名，该工具将创建指定的字段。	Field
提取时间间隔（可选）	从输入视频中提取图像的时间间隔。您可以选择毫秒、秒或分钟作为时间间隔单位。默认值为 2 秒，最小值为 0.2 秒（200 毫秒）。	Time Unit
开始时间戳（可选）	视频中开始提取图像的起始点。接受的输入格式为 hh:mm:ss.s。	String
结束时间戳（可选）	视频中结束提取图像的终点。接受的输入格式为 hh:mm:ss.s。	String
视频捕获类型（可选）	指定捕获的视频类型。该参数用于处理时间压缩视频。实时—该视频以正常速度播放，并非时间压缩视频。这是默认设置。速度（倍数）—该视频以高于实时速度录制，并以倍数形式表示。例如，2 倍速视频的播放速度是正常速度的两倍。间隔（秒）—相机每隔固定秒数捕获一帧画面，而不是录制连续视频。例如，0.5 秒的间隔意味着相机每半秒捕获一帧。	String
视频捕获速率（可选）	视频的录制速率。默认值为 1。如果将视频捕获类型参数设置为实时，则会忽略此参数。如果将视频捕获类型参数设置为速度，请指定速度乘数。例如，如果视频是以 5 倍速捕获的，请指定值为 5。如果将视频捕获类型参数设置为间隔，请指定秒数。例如，如果视频的帧间隔为 0.5 秒，请指定值为 0.5。
掩膜下半部分（可选）	要掩膜的输出图像所占的百分比，从图像底部开始计算。该值必须介于 0（无掩膜）和 50（掩膜整个下半球）之间。	Double

派生输出

标注	说明	数据类型
更新后的定向影像	更新的定向影像数据集。导入过程中将保留现有的定向影像数据。将为输入数据中的每个图像追加一个新的点要素，并将关联的图像作为附件添加。将根据输入图像文件的属性设置新的点要素的属性。	Oriented Imagery Layer
更新后的图像文件夹	将写入图像文件的更新后的文件夹。	Folder

arcpy.indoors.ThreeSixtyVideoToOrientedImagery(in_360_video, target_oriented_imagery, target_image_folder, {control_point_1}, {control_point_2}, {in_levels_feature}, {level}, {floor_field}, {extraction_interval}, {start_timestamp}, {end_timestamp}, {capture_type}, {capture_rate}, {mask_lower_portion})

名称	说明	数据类型
in_360_video	包含可从中提取 360 度图像的 360° 视频的输入 `.mp4` 文件。	File
target_oriented_imagery	将添加要素的目标定向影像图层。	Oriented Imagery Layer
target_image_folder	将写入图像文件的现有文件夹。	Folder
control_point_1 [control_point_1,...] （可选）	将用于对输出要素进行地理配准的第一个控制点。值表列： `Video Time`—The video timestamp in hh:mm:ss.s format. `Camera Location`—The point feature representing the camera's location in the map at the specified video timestamp.	Value Table
control_point_2 [control_point_2,...] （可选）	将用于对输出要素进行地理配准的第二个控制点。值表列： `Video Time`—The video timestamp in hh:mm:ss.s format. `Camera Location`—The point feature representing the camera's location in the map at the specified video timestamp.	Value Table
in_levels_feature （可选）	来自 Indoors 模型的输入楼层图层。	Feature Layer
level （可选）	`in_levels_feature` 参数值中的楼层表示视频捕获全部或部分内容的位置。该工具将此楼层的 `LEVEL_ID` 字段值分配给与该要素重叠的定向影像要素的楼层字段。	String
floor_field （可选）	将使用 `level` 参数的关联层级 ID 来填充 `target_oriented_imagery` 参数值中的字段。如果 `target_oriented_imagery` 参数值中不存在已定义字段，则系统将创建一个具有所提供名称的新字段，并使用层级 ID 字段值对其进行填充。如果未定义 `floor_field` 参数，则工具将在 `target_oriented_imagery` 参数值中创建 `LEVEL_ID` 字段（如果该字段不存在）。	Field
extraction_interval （可选）	从输入视频中提取图像的时间间隔。您可以选择毫秒、秒或分钟作为时间间隔单位。默认值为 2 秒，最小值为 0.2 秒（200 毫秒）。	Time Unit
start_timestamp （可选）	视频中开始提取图像的起始点。接受的输入格式为 hh:mm:ss.s。	String
end_timestamp （可选）	视频中结束提取图像的终点。接受的输入格式为 hh:mm:ss.s。	String
capture_type （可选）	指定捕获的视频类型。该参数用于处理时间压缩视频。 `REALTIME`—该视频以正常速度播放，并非时间压缩视频。这是默认设置。 `SPEED`—该视频以高于实时速度录制，并以倍数形式表示。例如，2 倍速视频的播放速度是正常速度的两倍。 `INTERVAL`—相机每隔固定秒数捕获一帧画面，而不是录制连续视频。例如，0.5 秒的间隔意味着相机每半秒捕获一帧。	String
capture_rate （可选）	视频的录制速率。默认值为 1。当 `capture_type` 参数设置为 `REALTIME` 时，将忽略此参数。如果将 `capture_type` 参数设置为 `SPEED`，请指定速度乘数。例如，如果视频是以 5 倍速捕获的，请指定值为 5。如果将 `capture_type` 参数设置为 `INTERVAL`，请指定秒数。例如，如果视频的帧间隔为 0.5 秒，请指定值为 0.5。
mask_lower_portion （可选）	要掩膜的输出图像所占的百分比，从图像底部开始计算。该值必须介于 0（无掩膜）和 50（掩膜整个下半球）之间。	Double

派生输出

名称	说明	数据类型
updated_oriented_imagery	更新的定向影像数据集。导入过程中将保留现有的定向影像数据。将为输入数据中的每个图像追加一个新的点要素，并将关联的图像作为附件添加。将根据输入图像文件的属性设置新的点要素的属性。	Oriented Imagery Layer
updated_image_folder	将写入图像文件的更新后的文件夹。	Folder

代码示例

ThreeSixtyVideoToOrientedImagery 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 ThreeSixtyVideoToOrientedImagery 函数。

import arcpy

# Note: Video timestamps are strings in format hh:mm:ss.s

arcpy.indoors.ThreeSixtyVideoToOrientedImagery(
    r"C:\SiteFootage\Building1_Floor1.mp4", r"C:\Campus.gdb\OIDataset",
    r"C:\Data\ImagesFolder")

ThreeSixtyVideoToOrientedImagery 示例 2（Python 窗口）

以下独立脚本演示了如何使用 ThreeSixtyVideoToOrientedImagery 函数。

# Import system modules
import arcpy

# Create temporary control point feature classes in memory for camera locations
sr = arcpy.SpatialReference(102100) # WGS 1984 Web Mercator (Auxiliary Sphere)
arcpy.management.CreateFeatureClass("memory", "point_1_fc", "POINT", spatial_reference=sr)
arcpy.management.CreateFeatureClass("memory", "point_2_fc", "POINT", spatial_reference=sr)

# Add camera locations to the temporary control point feature classes
with arcpy.da.InsertCursor(r"memory\point_1_fc", ["SHAPE@XY"]) as cursor:
    cursor.insertRow([arcpy.Point(-13046063.3, 4036427.6)])
with arcpy.da.InsertCursor(r"memory\point_2_fc", ["SHAPE@XY"]) as cursor:
    cursor.insertRow([arcpy.Point(-13046055.9, 4036422.1)])

# Set local variables

# Set the control point parameter values
# Note: Video timestamps are strings in format hh:mm:ss.s
control_point_1 = ["00:05:40.7", r"memory\point_1_fc"]
control_point_2 = ["00:11:25.3", r"memory\point_2_fc"]

# Specify indoor level information
in_levels_feature = 'C:/Indoors/ExampleCampus.gdb/Indoor/Levels'
level = '{9D73FC13-9BBF-47E5-BDF3-AAF0688C3AAC}'
floor_field = "FLOOR"

# Set remaining parameter variables
in_360_video = r"C:\SiteVideos\Building1_Floor1.mp4"
target_oriented_imagery = r"C:\Campus.gdb\OIDataset"
target_image_folder = r"C:\Data\ImagesFolder"
extraction_interval = "5 Seconds"
start_timestamp = "00:05:35"
end_timestamp = "00:15:00"
mask_lower_portion = 20.0

# Run the tool
arcpy.indoors.ThreeSixtyVideoToOrientedImagery(
    in_360_video, target_oriented_imagery, target_image_folder,
    control_point_1, control_point_2, in_levels_feature, extraction_interval,
    start_timestamp, end_timestamp, level, floor_field, mask_lower_portion)

# Release memory
del cursor
arcpy.management.Delete(r"memory\point_1_fc")
arcpy.management.Delete(r"memory\point_2_fc")

环境

此工具不使用任何地理处理环境。

许可信息

基本: 否
标准: 否
高级: 需要 ArcGIS Indoors Pro 或 ArcGIS Indoors Maps

360 度视频转定向影像 (Indoors 工具)

汇总

用法

注:

注:

注:

注:

提示：

注:

注:

注:

参数

派生输出

环境

许可信息

相关主题