ジオメトリ内の pattern に一致する最初のポイント番号を検索します。 このパターンは、APEXパスパターン構文のルールに従わなければなりません。 これによって、ワイルドカードと組み合わせたポイント名やタグとプロパティのようなカスタムメタデータなどの様々な基準に基づいてポイントを検索することができます。

ジオメトリがスケルトンの場合、APEXパスパターンの構文によってスケルトン階層を走査して特定のジョイントを検索するためのオプションが追加されます。 これには、スケルトンの末端ノードやルートノード、一連のジョイントの親や子を検索するためのオプションがあります。 また、階層内のパスを使用してジョイントを検索することもできます。

以下は、スケルトン用のパターンの例です。 このパターンは、my_ancestorジョイントから開始してスケルトン階層を走査して、my_jointで始まるすべての子ジョイントにマッチします:

my_ancestor/**/my_joint*

以下は、タグを使用したパターンの例です。 このパターンは、tagsPointアトリビュートにmy_tagとmy_other_tagを持ったジオメトリ(スケルトンかどうかは問いません)内のすべてのポイントにマッチします。

%tag(my_tag) & %tag(my_other_tag)

一致するノードが見つからなかった場合、空っぽの配列が返されます。