Fusion 360 を Pythonで動かそう その10 理解しづらかったことのおさらい

#はじめに
Fusion 360 を Pythonで動かそう その１～９で公式ドキュメントのサンプルをいくつか触ってみました。そのなかから自分が理解しづらかったことのメモ書きとしてまとめた記事です
###過去の記事はこちら
　その１　スクリプトの新規作成
　その２　スケッチに円を描いてみる
　その３　スケッチに3つの接線で円を描く
　その４　スケッチにいろんな方法で線を描く
　その５　最初と最後のおまじないを読んでみる
　その６　スケッチポイントを描く
　その７　点を通過するスプライン作成
　その８　スケッチのフィレットとオフセット
　その９　スケッチの交差　

#理解しづらかったこと・・・
##Point3D オブジェクト
Fusion 360 API Reference Manual ： Point3D Object によると・・・

トランジェント（一時的な） 3D ポイント。トランジェントポイントは、ドキュメントに表示されたり保存されたりしません。トランジェント 3D ポイントは、生の 3D ポイント情報を扱うためのラッパーとして使用されます。Point3D クラスの create メソッドを使用して静的に作成されます。

Point3Dはスケッチで円や線を描くための座標指定に多用されていました。一時的なポイントなのでそのままではFusion360に作図されません。点を作図するにはスケッチポイントやコンストラクションポイントとして配置する必要があります。

例えば SketchPoints.add メソッド：指定した場所に点を作成します。これは、ユーザーインターフェイスの Point コマンドを使用してスケッチポイントを作成するのと同等であり、グラフィックスウィンドウ内に可視ポイントを作成します。

##「s 有りオブジェクト」と「s 無しオブジェクト」
同じような名前で「 s 」が有ったり無かったりで結構混乱してしまいました。
スケッチの円を例にして整理すると・・・

• SketchCircles オブジェクト（s 有り） ： スケッチ内の円のコレクションです。これは既存の円へのアクセスを提供し、新しい円を作成するためのメソッドをサポートします。 addByCenterRadius メソッドで新しい円を描いたり、item メソッドで既存の円を指定したりできる（指定した結果は 「s 無しオブジェクト」が取得できる）
• SketchCircle オブジェクト（s 無し） ： スケッチ内の円。deleteMe メソッドで削除したり、area プロパティで円の面積を取得したりできる

「s 無しオブジェクト」は円そのもの。「s 有りオブジェクト」は「s 無しオブジェクト」のコレクション。「s 無しオブジェクト」を作るときはコレクションに追加する形で作成するということ

##「s 有りオブジェクト」と同じ名前の「s 有りプロパティ」
こちらもスケッチの円を例にすると・・・

• SketchCurves.sketchCircles プロパティ ：SketchCurves オブジェクトのプロパティのひとつ。このスケッチに関連付けられた「スケッチの円のコレクション = SketchCircles オブジェクト（s 有りオブジェクト）」を返す。

オブジェクトと全く同じ「sketchCircles」という名前なので混乱した😅

Input オブジェクトに慣れていこう

例えば押し出しを作成するのであれば・・・

• 想像していた方法 ： ExtrudeFeatures.add メソッドにプロファイルや距離などの引数を指定すると押し出しができる
• 実際の方法 ： ExtrudeFeatures.add メソッドの引数は ExtrudeFeatureInput オブジェクトひとつだけ。このInput オブジェクトのメソッドやプロパティで押し出しの方法を指定する

分かってしまえばそういうことなんだろうけど想像と違っていたので戸惑った
Fusion 360 API Reference Manual ： Getting Started with Fusion 360's API > Input Objects によると

入力オブジェクトは、より複雑なオブジェクトを作成するために必要なすべての入力を定義するために使用されます。入力オブジェクトは、APIのコマンドダイアログと同等のものと考えることができます。

とのこと。構築の平面、軸、点の作成も同様にInput オブジェクトが出てくる。UI操作のダイアログでの操作を想像しながら考えればしっくりくるようになりそう？

#今後の課題
##ObjectCollection を活用できるようになりたい
ObjectCollection オブジェクト ：任意のオブジェクト型のリストを扱うために使用される汎用コレクション
Grasshopper のリストやツリーのように活用して複数のオブジェクトを効率よく扱うことができるか？今後の課題です。

##グローバル座標系とスケッチの座標系とPoint3Dの座標値
グローバル座標系とスケッチの中での座標系とPoint3Dで入力している座標値との関係が理解しきれていないので要調査。

#まとめ
Grasshopperのようなビジュアルプログラミングと比べてしまうと Fusion 360 API にはどうしてもとっつきにくさはあるけどもとても大きな可能性を感じるので引き続き学習を進めていきたい！