MV1GetAttachAnimFrameLocalPosition

アタッチしているアニメーションの指定フレーム( ボーン )のローカル座標を取得する

val = MV1GetAttachAnimFrameLocalPosition(MHandle, AttachIndex, FrameIndex)

int MHandle : モデルのハンドル
int AttachIndex : アニメーション番号を取得するアニメーションのアタッチ番号
int FrameIndex : ローカル座標を取得するフレーム( ボーン )番号

(プラグイン / モジュール : DxLibW)

解説

アタッチしているアニメーションの指定フレーム(ボーン)の現在のローカル座標を取得します。

アニメーション再生中の特定のボーンの位置を知りたい場合に使用します。
例えば、キャラクターの手の位置にエフェクトを表示する場合などに便利です。

引数:
MHandle: モデルのハンドル
AttachIndex: アタッチ番号
FrameIndex: ローカル座標を取得するフレーム(ボーン)の番号

戻り値: 指定フレームのローカル座標(VECTOR)

関連関数: MV1GetFramePosition, MV1AttachAnim, MV1SearchFrame

※ この関数は #cfuncst (VECTOR) で宣言されています。
戻り値は構造体 VECTOR (12バイト) です。

代入するだけで自動的に構造体変数が作成されます:
  v = MV1GetAttachAnimFrameLocalPosition(...)   ; auto dim + copy
代入後はメンバにアクセスできます:
  mes v->x
  mes v->y
  mes v->z

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib 3Dモデル
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs