表示されている 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."))
1 つ以上の必須引数が指定されていません。
- (nil ("Error" . "No item selected."))
インデックス付きレイヤーが見つかりませんでした。
- (nil ("Error" . "Index was outside the bounds of the array."))
指定した引数が多すぎます。
- (nil ("Error" . "Failed."))
画像ファイルはすでに存在します。