Convierte una capa de imágenes o mapas visible de Esri en un gráfico ráster estándar de AutoCAD y lo almacena como un archivo de gráficos en el directorio de archivos especificado. La capa de mapas o imágenes debe estar visible en el dibujo. Si es correcto, se devuelve una lista de (T). La capa de mapas permanece en el dibujo después de la extracción. Para eliminar una capa de mapas, utilice la función (esri_maplayer_remove).
Sintaxis
(esri_maplayer_extract maplayerid imagefilepath)
Argumentos
- maplayerid | entero | obligatorio | El número de identificación de la capa del mapa asociado a la capa que se puede obtener utilizando la función (esri_maplayers).
- imagefilepath | cadena de caracteres | obligatorio | La ruta de archivo al nuevo archivo de imagen que se crea a partir de la capa de imágenes o mapas especificada. No hay ninguna opción para sobrescribir el archivo especificado. El archivo no debe existir.
Uso de ejemplo
Intenta extraer la capa de imágenes o mapa con el número de índice 2 como imagen PNG denominada myExtractedLayer.png.(esri_maplayer_extract 2 "C:\\myExtractedFolder\\myExtractedLayer.png")
Uso de ejemplo de resultado
Copia la capa de mapa especificada a una entidad de imagen de AutoCAD dentro del dibujo y guarda una instantánea de la capa como archivo .png y, a continuación, devuelve una lista true:(T)
Valores de retorno
Esta función devuelve un valor.
- Si va bien, devuelve una lista true: (T)
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, se devuelve una lista asociada que contiene el valor de clave Error y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>")).
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Missing required argument."))
No se suministraron uno o más de los argumentos requeridos.
- (nil ("Error" . "No item selected."))
No se encontró la capa indexada.
- (nil ("Error" . "Index was outside the bounds of the array."))
Se incluyeron demasiados argumentos.
- (nil ("Error" . "Failed."))
El archivo de imagen ya existe.