MV1DetachAnim

アニメーションをデタッチする

MV1DetachAnim MHandle, AttachIndex

int MHandle : アニメーションをデタッチするモデルのハンドル
int AttachIndex : デタッチするアニメーションのアタッチ番号

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

解説

MHandle のモデルハンドルが示すモデルにアタッチしたアニメーションをデタッチ( 外すこと )します。

アニメーションは同時に幾つでもアタッチすることができ、
MV1SetAttachAnimBlendRate
関数でアタッチしている各アニメーションの影響率も設定することができるので、
一応、すべてのアニメーションをアタッチして、MV1SetAttachAnimBlendRate
関数で表示したいアニメーションの影響率だけを上げるということもできるのですが、
それをすると使用メモリや処理負荷が多少上昇します。

なので、DXライブラリのモデル機能では使用するアニメーションのみをアタッチして、
再生が終わったらこの関数でアタッチしたアニメーションをデタッチする( 外す )ことを想定しています。

因みに、
MV1DeleteModel 関数でモデルを削除する際にアタッチしたアニメーションは自動的にデタッチされますので、
削除する前にアタッチしたすべてのアニメーションをこの関数でデタッチしておかなければならないということはありません。

戻り値:
  0:成功

情報

プラグイン / モジュール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