Free版とカスタマイズの利用条件
Free版は配布時の「APIサンプル」10コマンドだけを利用できます。独自DLLと変更したサンプルの実行には、有効なSTDまたはProライセンスが必要です。Free版ではサンプルの名前・IDを使っても外部DLLのコードは実行せず、本体に同梱されたサンプルを実行します。変更が反映されない場合は[読込状況]とプランを確認してください。C#/VB.NETの実習サンプルを自作DLLとして読み込む場合もSTD/Proが必要です。
MCPはFree版でも使用できます。通常の作図・編集APIは利用でき、板金・解析のAPIはライセンス判定で拒否されます。独自DLLの読込み制限とMCP接続の可否は別です。
[APIサンプル]タブの10コマンドは、公開APIだけで作れるカスタマイズの例です。文字処理、複写、選択、整理、集計を組み合わせています。[カスタマイズ]タブの[読込状況][DLLフォルダー]は従来どおりです。

用途の参考にしたのはAutoCAD Express Toolsのコマンド一覧、TCOUNT、COPYMです。JDesignCAD向けに独自実装したサンプルで、Express Toolsとのコマンド・ファイル・動作互換を提供するものではありません。
使い方
- モデル空間で対象を選択します。文字コマンドは通常の文字、同種・同層選択は基準図形1個を選びます。ブロック集計には選択は不要です。
- [APIサンプル]のコマンドを押し、距離や文字を入力します。文字編集は変更内容、重複線整理は削除件数の確認後に適用します。
- 図形を変更するコマンドは1回の[元に戻す]で取り消せます。選択と集計は図形を変更しません。
単位はWCS・mmです。UCSや表示単位を変更していても同じです。図面が処理中に変更された場合は古い入力を反映せず、選択し直して再実行します。
10個のコマンドとAPI
| コマンド | 動作と範囲 | 公開API |
|---|---|---|
| 文字連番 | 開始番号・増分・前後の文字・X昇順/Y降順/API一覧順・全体置換/先頭追加/末尾追加。例:開始5、増分3、前の文字P-でP-5、P-8…。クリックした順序の保証はありません。 | QueryAsync(geometry) → text.update |
| 文字置換 | 選択文字内の一致部分を全て置換。大文字・小文字を区別。正規表現は使いません。変更後の文字全体が空になる置換は拒否します。 | QueryAsync(geometry) → text.update |
| 大文字・小文字 | 英字などを大文字/小文字に変更。通常の日本語は変化しません。変更のない文字にはUndoを追加しません。 | QueryAsync(geometry) → text.update |
| 文字囲み | 文字ごとに矩形または円を追加。WCS XYに平行な文字のみ。文字の実際の外接範囲に余白を足し、円はその矩形を囲みます。囲みは文字と同じZ、色・レイヤーは現在の作図設定です。傾斜した3D文字、追従する関連付けは対象外。 | EntityInfo.Bounds → geometry.create |
| 等間隔複写 | X・Y・Zの間隔と複写数を入力。元の図形は残し、1倍、2倍…の位置へ複写。複写数は元を含みません。生成図形は合計1000個まで。 | entities.array.linear |
| 同種・同層選択 | 基準の1図形と同じKind・レイヤーの図形をモデル直下から選択。ブロック内部は検索しません。色は条件に含めません。検索10万図形、結果1000個まで。 | GetEntitiesAsync → SetSelectionAsync |
| 重複線整理 | 選択した線分・円が全体として重なり、レイヤー・色指定・線種・線幅が同じ場合に1つを残す。既定許容差0.001 mm。反対向きの線も判定。ロック中、部分重複、円弧・ポリラインは対象外。任意の拡張メタデータは比較していません。 | GetEntityDetailsAsync + GetAttributesAsync → DeleteEntitiesAsync |
| 色をByLayer | 選択図形の色だけをレイヤーに合わせる。レイヤー・線種・線幅は変更しません。ロックされた対象が含まれる場合は全体を変更せず終了します。 | attributes.set |
| 長さ・面積集計 | 選択曲線の長さと閉じた平面曲線の面積を集計。100図形まで。mm/m、mm²/m²を表示。重なりや入れ子の穴は差し引かず、個別面積を加算。文字・ソリッド等は長さの対象外として数えます。計算中に中止できます。 | StartOperationAsync(measure.geometry) → GetJobDataAsync |
| ブロック集計 | アクティブモデル直下に直接挿入した名前付きブロックを名前別に集計。入れ子の内部、紙空間、無名ブロックは除外。定義1000件に達した場合は結果が一部の可能性を表示。 | QueryAsync(blocks) |
文字処理は選択中の通常文字1~100個、全コマンドの選択取得は1000図形までです。ブロック内文字・属性定義・寸法文字の編集例ではありません。text.updateはフォント、太字・斜体、位置、配置基準、文字高さ、向き、色・層、IDを保持します。
Visual Studioで変更する
- 本体フォルダーの
Customization\SDK全体を開発用フォルダーにコピーし、Samples\Customization.Sample\Customization.Sample.csprojを開きます。 - ターゲットは
net8.0-windows、UseWindowsForms=trueです。公開DLLの参照先は../../Api/JDesignCAD.Api.dll、ローカルにコピーはFalseです。 - Releaseでビルドします。ソースを読んでボタン名やパラメータ、処理を変更できます。別の拡張として追加する場合はaddin.jsonのidとnameを変更してください。同じサンプルを更新する場合はidを維持します。
- 本体を終了し、出力DLL・addin.json・20枚のPNGを
%LOCALAPPDATA%\JDesignCAD\Addins\JDesignCAD.Customization.Sampleに配置して再起動します。変更前のフォルダーはAddinsの外へ保存してください。
| ソース | 読む内容 |
|---|---|
| SampleAddin.cs | タブと3グループ、10ボタン、アイコンの登録。タブ名はAPIサンプル。 |
| ToolCommand.cs | 選択取得、入力、revision付き要求、APIの組み合わせ、Undo単位、ジョブの中止。 |
| ToolGeometry.cs | 公開DTOだけで行う重複判定と計測結果の集計。 |
| ToolDialogs.cs | WinForms入力・確認・結果表示。IToolUiを差し替えると画面操作なしで検証可能。 |
| Build-Icons.ps1 / *.png | 独自の簡易ベクター図案から24/48pxのPNGを生成。ビルド済みPNGを同梱。 |
文字内容だけを更新する最小例
var selected = await api.GetSelectionAsync(cancellationToken: ct);
var cad = (ICadAutomationApi)api;
await cad.ExecuteOperationAsync(selected.Document.Operation(
"text.update",
new UpdateTextParameters([
new TextUpdate(selected.Entities[0].Id, "P-001")
])), ct);通常文字を1個選んだ場合の例です。実際のサンプルは空選択・件数・変更前内容を確認します。文字内容だけの編集にはtext.updateを使います。geometry.updateにTextDefinitionを渡す方法は文字定義の置換となり、取得DTOに含まれない書式まで保持する用途には向きません。
MCPでも同じ処理を呼ぶ
タブの入力ダイアログはDLL側のUIです。MCPでは選択取得・geometry照会で対象IDを読み、同じ公開操作に入力値を指定します。文字編集はcad_execute_operationのrequest.operation="text.update"、parametersは次の形です。documentId・expectedRevision・新しいoperationIdも必要です。
{
"updates": [ { "entityId": "取得した文字ID", "content": "P-001" } ]
}複写はentities.array.linear、色変更はattributes.set、計測はcad_start_operationからmeasure.geometryを呼びます。サンプル固有の並べ替えや重複判定は呼出し側で行います。MCPからサンプルのダイアログを直接操作する仕様ではありません。