Преобразует видимую карту Esri или слой изображения в стандартную растровую графику AutoCAD и сохраняет ее как графический файл в указанной папке. Слой карты или слой изображения должен быть видимым в чертеже. В случае успеха будет возвращен список (T). После извлечения слой карты останется в чертеже. Чтобы удалить слой карты, воспользуйтесь функцией (esri_maplayer_remove).
Синтаксис
(esri_maplayer_extract maplayerid imagefilepath)
Аргументы
- maplayerid | целое число | обязательный | Идентификационный номер слоя карты, связанный со слоем, который можно получить с помощью функции (esri_maplayers).
- imagefilepath | строка | обязательный | Путь к новому файлу изображения, созданному на основе указанной карты или слоя изображения. Перезаписать указанный файл нельзя. Файл не должен существовать.
Пример использования
Попытаться извлечь карту или слой изображения с порядковым номером 2 как изображение PNG с именем myExtractedLayer.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."))
Файл изображения уже существует.