Konvertiert einen sichtbaren Karten- oder Bild-Layer von Esri in eine standardmäßige AutoCAD-Raster-Grafik und speichert diese als Grafikdatei im angegebenen Dateiverzeichnis. Der Karten- oder Bild-Layer muss in der Zeichnung sichtbar sein. Falls erfolgreich, wird eine Liste mit "(T)" zurückgegeben. Der Karten-Layer verbleibt nach der Extraktion in der Zeichnung. Zum Entfernen eines Karten-Layers können Sie die Funktion (esri_maplayer_remove) verwenden.
Syntax
(esri_maplayer_extract maplayerid imagefilepath)
Argumente
- maplayerid | Integer | erforderlich | Die Karten-Layer-Identifikationsnummer, die mit dem Layer verknüpft ist, der mit der Funktion (esri_maplayers) abgerufen werden kann.
- imagefilepath | Zeichenfolge | erforderlich | Der Dateipfad zur neuen Bilddatei, die aus dem angegebenen Karten- oder Bild-Layer erstellt wird. Es gibt keine Option zum Überschreiben der angegebenen Datei. Die Datei darf nicht vorhanden sein.
Beispiel für die Verwendung
Versucht, den Karten- oder Bild-Layer mit der Indexnummer 2 als PNG-Bild namens myExtractedLayer.png zu extrahieren.(esri_maplayer_extract 1 "C:\\myExtractedFolder\\myExtractedLayer.png")
Ergebnis des Beispiels für die Verwendung
Kopiert den angegebenen Karten-Layer als AutoCAD-Bildobjekt innerhalb der Zeichnung, speichert einen Snapshot des Layers als .png-Datei und gibt dann eine Liste mit "true" zurück:(T)
Rückgabewerte
Von dieser Funktion wird ein Wert zurückgegeben.
- Bei erfolgreicher Ausführung wird eine Liste mit "true" zurückgegeben: (T)
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert Error sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ( "Error" . "<message>"))
Rückgabewerte mit Fehlern
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "Missing required argument."))
Mindestens eines der erforderlichen Argumente wurde nicht angegeben.
- (nil ("Error" . "No item selected"))
Der indizierte Layer wurde nicht gefunden.
- (nil ("Error" . "Index was outside the bounds of the array."))
Es wurden zu viele Argumente aufgenommen.
- (nil ("Error" . "Failed."))
Die Bilddatei ist bereits vorhanden.