geometry.screwは、閉じた平面断面を回転させながら軸方向に送り、実体のソリッドを作ります。断面は常に軸を含む平面に置きます。ねじ溝の断面を指定して工具を作り、母材から差し引くことで、実際に面を持つねじを作成できます。
geometry.screw
入力型はScrewParameters。実行方式はworkerです。計算結果がreadyになってからcad_commit_jobまたはCommitJobAsyncで反映します。
| 引数 | 必須・既定値 | 内容 |
|---|---|---|
| profileId | 必須 | 閉じた平面輪郭の図形ID。 |
| origin | 必須 | 軸上の基点。WCS mm。断面平面上に必要。 |
| axis | 必須 | 送り方向。長さを正規化して使用。ゼロベクトル不可。断面平面内に必要。 |
| pitch | 必須 | 1回転の送り量mm。正の値。 |
| turns | 必須 | 正の巻数、100以下。小数も指定可能。 |
| rightHanded | true | trueは右ねじ、falseは左ねじ。どちらも送りはaxisの正方向。右ねじは正の軸方向に対する右手の回転。 |
| deleteSource | false | trueなら成功を反映するときに元輪郭を消費。失敗時は保持。 |
断面全体を軸の片側に置いてください。軸との接触・横断、開いた輪郭、非平面輪郭は使えません。隣接する巻きの重複を防ぐため、断面の軸方向の幅は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}
めねじの作成手順
- 母材に下穴を作ります。ねじの呼び径と下穴径を区別してください。
- 軸を含む平面に、ねじ溝の閉断面を作ります。60度のメートルねじなら、山頂・谷底の平坦部も含めて断面を定義します。
- geometry.screwで工具を作り、結果のソリッドIDを取得します。
solid.booleanに{"entityIds":["母材ID","工具ID"],"kind":"subtract"}を渡します。- 結果の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で接続先の利用可否と実際のスキーマを確認してください。