get_skin_bones()

指定スロットのスキンボーンノードを取得します。右クリックメニュー Skin Bones に対応します。

シグネチャ

api.get_skin_bones(slot, select=0) -> dict

パラメータ

戻り値

{
    "success": bool,
    "slot": int,
    "category": "skin_bones",
    "count": int,
    "handles": list,               # list[int], 有効ノードのみ
    "names": list,                 # list[str], handles と 1:1
    "selected": int,               # 正規化済み select（0 または 1）
    "selected_count": int,
    "message": str,
}

例

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()

# 取得のみ
r = api.get_skin_bones(slot=0)
print(f"bones: {r['count']}")

# 取得 + シーン選択
api.get_skin_bones(slot=0, select=1)

ノート

• 空結果（count=0）はエラーではありません。
• 不正な slot/select は即例外です（TypeError / ValueError）。
• 共通契約・例外表は Get Nodes 概要ページを参照してください。