DLLとMCPは共通の構造化操作を使います。cad_get_capabilitiesで利用可否を確認し、cad_get_operation_schemaで引数を取得してください。利用できる操作は接続先の版・ライセンスで確認してください。既存のFree版の板金・解析制限は変更していません。この2操作は通常の形状操作としてFree版からも利用できます。独自DLLの読込み制限は別です。実体のねじ山にはらせん回転ソリッド geometry.screwを使います。
geometry.helix — らせんパス
実行方式はworker。滑らかなスプラインのPathを1個返します。計算がreadyになった後にCommitJobAsync/cad_commit_jobで追加します。画面の[らせん]と同じ生成処理です。
| JSON引数 | 内容 |
|---|---|
| center | 開始端の軸中心、WCS mm。 |
| axis | 高さ方向。長さは無視し、向きだけを使います。ゼロベクトル不可。 |
| baseRadius / topRadius | 下端/上端の中心線半径。ともに正。円すいらせんにも対応。 |
| height | 軸方向の高さ、mm。負値可、ゼロ不可。 |
| turns | 正の巻数、1000以下。小数可。 |
| segmentsPerTurn | 補間用の分割指定、8~360、既定48。内部では1巻きごとにスプラインを作成します。 |
| clockwise | 既定false。正の軸の端から中心を見たときの時計回りをtrueで指定。 |
| startDirection | 省略可。開始角の方向。軸に直交する平面へ投影します。軸と平行な指定は不可。 |
{"center":{"x":145,"y":0,"z":258},"axis":{"x":0,"y":0,"z":1},
"baseRadius":46,"topRadius":46,"height":254,"turns":8,
"startDirection":{"x":1,"y":0,"z":0}}
この例の始点は(191,0,258)です。円断面の法線を始点の接線方向(0, 2π×46×8, 254)に合わせ、geometry.sweepのprofileIdとpathIdに指定するとばねになります。半径が変わる場合は接線に半径の変化分も含めてください。補間に失敗したAPIはエラーを返し、折れ線への置換はしません。
solid.interference — 干渉・面接触
既存の[干渉チェック]と同じSolidInterferenceCheckerを、図面を変更しないworker-dataとして実行します。対象は明示した2~100個のソリッドです。画面のコマンドでは結果形状を「干渉チェック」レイヤーに作成しますが、このAPIは数値と部品IDを返します。
| 引数 | 内容 |
|---|---|
| entityIds | 対象ソリッドID。再起動後は再取得。 |
| tolerance | 検証精度mm、既定0.000001。1e-9~0.01。 |
| pairs | 省略時は全組合せ。指定時はfirstEntityId / secondEntityIdの組を1~1000組。各IDはentityIds内に必要。同一ID同士、重複組は不可。 |
StartOperationAsync/cad_start_operation後、GetJobAsyncでcompletedを確認します。Commitは不要です。GetJobDataAsync/cad_get_job_dataでsectionをsummaryまたはpairsに指定します。
| status | 意味 |
|---|---|
| interference | 正の体積で重なる部分あり。commonVolumeはmm³。 |
| contact | 体積の重なりがなく、向きが反対の一致面あり。 |
| clear | この静止配置で検査した範囲に干渉・面接触なし。 |
| failed | 判定不能。diagnosticsを確認。干渉なしとは扱わない。 |
各組にはfirstEntityId、secondEntityId、commonVolume、contactFaceCount、diagnosticsを返します。タイムアウトはジョブのoperation_timeoutとして通知し、元図形は保持します。可動域全体、弾性変形、製造公差の検証は含みません。
var parameters = System.Text.Json.JsonSerializer.SerializeToElement(
new InterferenceParameters(new[] { firstId, secondId }),
new System.Text.Json.JsonSerializerOptions(System.Text.Json.JsonSerializerDefaults.Web));
var request = new OperationRequest(document.Id, document.Revision,
System.Guid.NewGuid().ToString(), "solid.interference", parameters);
var job = await api.StartOperationAsync(new StartOperationRequest(request, 60));
// GetJobAsyncでcompletedになるまで確認
var pairs = await api.GetJobDataAsync(new JobDataRequest(job.Id, "pairs"));
MCPでも同じ操作名とcamelCaseの引数を使います。接続済みのMCPツールが古い一覧を保持している場合は再接続してください。アプリ本体・ワーカー・API DLLは同じビルドのものを配置します。