JDesignCAD / API 1.4 / 2026-10-20

らせん回転ソリッドと実体ねじ

geometry.screwは、閉じた平面断面を回転させながら軸方向に送り、実体のソリッドを作ります。断面は常に軸を含む平面に置きます。ねじ溝の断面を指定して工具を作り、母材から差し引くことで、実際に面を持つねじを作成できます。

① 軸と閉断面② らせん工具③ 穴の母材から差し引く軸

geometry.screw

入力型はScrewParameters。実行方式はworkerです。計算結果がreadyになってからcad_commit_jobまたはCommitJobAsyncで反映します。

引数必須・既定値内容
profileId必須閉じた平面輪郭の図形ID。
origin必須軸上の基点。WCS mm。断面平面上に必要。
axis必須送り方向。長さを正規化して使用。ゼロベクトル不可。断面平面内に必要。
pitch必須1回転の送り量mm。正の値。
turns必須正の巻数、100以下。小数も指定可能。
rightHandedtruetrueは右ねじ、falseは左ねじ。どちらも送りはaxisの正方向。右ねじは正の軸方向に対する右手の回転。
deleteSourcefalsetrueなら成功を反映するときに元輪郭を消費。失敗時は保持。

断面全体を軸の片側に置いてください。軸との接触・横断、開いた輪郭、非平面輪郭は使えません。隣接する巻きの重複を防ぐため、断面の軸方向の幅はpitchより小さくします。作られたソリッドの全長は、pitch×turnsに断面の軸方向幅を加えた値です。

{"profileId":"取得した輪郭ID",
 "origin":{"x":0,"y":0,"z":0},"axis":{"x":0,"y":0,"z":1},
 "pitch":3,"turns":8,"rightHanded":true,"deleteSource":true}

めねじの作成手順

  1. 母材に下穴を作ります。ねじの呼び径と下穴径を区別してください。
  2. 軸を含む平面に、ねじ溝の閉断面を作ります。60度のメートルねじなら、山頂・谷底の平坦部も含めて断面を定義します。
  3. geometry.screwで工具を作り、結果のソリッドIDを取得します。
  4. solid.booleanに{"entityIds":["母材ID","工具ID"],"kind":"subtract"}を渡します。
  5. 結果のIDとrevisionを取り直します。面一覧でHelicalSurfaceのねじ面があること、穴径・ピッチ・ねじ長さ、入口と出口を確認します。

APIはねじ規格やはめあい公差を自動選択しません。ピッチ、断面寸法、右/左ねじ、有効長さ、逃げを呼び出し側で決めます。M24並目P3、M56並目P5.5などの基本寸法を使っても、完成品の公差等級を保証するものではありません。

C#からの呼び出し

var parameters = new ScrewParameters(profileId,
    new Point3(0, 0, 0), new Point3(0, 0, 1),
    Pitch: 3, Turns: 8, RightHanded: true, DeleteSource: true);
var request = new OperationRequest(document.Id, document.Revision,
    Guid.NewGuid().ToString(), "geometry.screw",
    JsonSerializer.SerializeToElement(parameters,
        new JsonSerializerOptions(JsonSerializerDefaults.Web)));
var job = await api.StartOperationAsync(new StartOperationRequest(request, 180));
// GetJobAsyncでreadyを確認し、元のdocumentId/revisionでCommitJobAsync。
// failed / cancelled / timed-outを完了扱いしない。

エラーと利用条件

入力条件の違反はinvalid_argument、計算・検証の失敗はジョブのerrorCodeとmessage、タイムアウトはoperation_timeoutで確認します。2026-10-20の差演算修正では、コアが失敗して元形状を保護した場合もAPIへ失敗を伝えます。元図形が残ったことだけで加工成功と判断しないでください。正常に非交差と判定された差演算は引き続き成功します。

MCPはFree版からも接続でき、geometry.screwは通常の形状操作として利用できます。板金・解析APIと独自DLLのライセンス制限は従来どおりです。最初にcad_get_capabilities、次にcad_get_operation_schemaで接続先の利用可否と実際のスキーマを確認してください。