esri_maplayer_extract (AutoLISP)

将可见的 Esri 地图或影像图层转换为标准 AutoCAD 栅格图形并将其存储为指定文件目录中的图形文件。 地图图层或影像图层必须在工程图中可见。 如果成功，将返回 (T) 列表。 地图图层在提取后仍保留在工程图中。 要移除地图图层，使用 (esri_maplayer_remove) 函数。

语法

(esri_maplayer_extract maplayerid imagefilepath)

参数

• maplayerid | 整型 | 必填 | 可以使用 (esri_maplayers) 函数获取的与图层关联的地图图层标识号。
• imagefilepath | 字符串 | 必填 | 基于指定地图或影像图层创建的新图像文件的路径。 没有覆盖指定文件的选项。 文件不得存在。

示例用法

尝试将索引编号为 2 的地图或影像图层提取为名为 myExtractedLayer.png 的 PNG 图像。

(esri_maplayer_extract 2 "C:\\myExtractedFolder\\myExtractedLayer.png")

结果示例用法

将指定地图图层复制到工程图内的 AutoCAD 图像实体，并将图层的快照另存为 .png 文件，然后返回一个 true 列表：

(T)

返回值

该函数将返回一个值。

• 如果成功，则返回一个 true 列表：(T)
• 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后将返回一个包含键值 Error 的关联列表以及字符串形式的关联错误消息：(nil ( "Error" . "<message>"))。

失败的返回值

出于以下任一原因，可能出现失败的返回值：

• (nil ("Error" . "Missing required argument."))

  未提供一个或多个必填参数。

• (nil ("Error" . "No item selected."))

  未找到索引图层。

• (nil ("Error" . "Index was outside the bounds of the array."))

  包含的参数过多。

• (nil ("Error" . "Failed."))

  图像文件已存在。