JDesignCAD / API 1.4 追加操作 / 2026-10-16

らせんと干渉チェック

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は同じビルドのものを配置します。