アニメーションクリップ設定を取得
gpgetanim var,objid,index,prmid
var : 情報が代入される変数 objid(0) : オブジェクトID index(0) : アニメーションクリップのインデックス(0~) prmid(0) : パラメーターID
(プラグイン / モジュール : hgimg4)
指定されたアニメーションクリップの設定を取得してvarで指定された変数に代入します。
objidで設定を取得するオブジェクトIDを、indexにアニメーションクリップのインデックスを指定します。
アニメーションクリップのインデックスは、オブジェクトが保持しているアニメーションクリップに順番に割り振られる番号です。0,1,2,3…のような0から始まる整数値で、存在しないインデックスが指定された場合はシステム変数に-1(エラー)が代入されます。
prmidでどのような情報を取得するかを指定します。prmidで指定できる値は以下の通りです。
マクロ名 値 内容
----------------------------------------------------------------------------
GPANIM_OPT_START_FRAME 0 開始フレーム(ミリ秒単位)
GPANIM_OPT_END_FRAME 1 終了フレーム(ミリ秒単位)
GPANIM_OPT_DURATION 2 再生の長さ(ミリ秒単位)
GPANIM_OPT_ELAPSED 3 経過時間(ミリ秒単位)
GPANIM_OPT_BLEND 4 ブレンド係数(%単位)
GPANIM_OPT_PLAYING 5 再生中フラグ(0=停止/1=再生)
GPANIM_OPT_SPEED 6 再生スピード(%単位)
GPANIM_OPT_NAME 16 アニメーションクリップ名
GPANIM_OPT_ELAPSED_FLOAT 35 経過時間(ミリ秒単位の実数)
GPANIM_OPT_BLEND_FLOAT 36 ブレンド係数(0.0~1.0の実数)
GPANIM_OPT_SPEED_FLOAT 38 再生スピード(実数)
取得される変数は適切な型で初期化されます。GPANIM_OPT_NAMEの場合は、文字列型となります。
「*_FLOAT」が付加されたマクロは、実数型で情報が取得されます。それ以外の場合は、整数型になります。
処理が正常に終了した場合は、システム変数statに0が代入されます。エラーが発生した場合は、システム変数statはマイナス値が代入されます。
| プラグイン / モジュール | hgimg4 |
| バージョン | 3.7 |
| 作成日 | 2025/07/08 |
| 著作者 | onitama |
| URL | https://hsp.tv/make/hgimg4.html |
| 備考 | hgimg4.asまたはhgimg4dx.asをインクルードすること。 |
| タイプ | 拡張命令 |
| グループ | 拡張画面制御命令 |
| 対応環境 |
|
| 移植のヒント | Windows/Linux/android/iOS等HGIMG4をサポートするシステム上で動作します。
Windowsの場合は、OpenGL3.1以降/DirectX9が必要です。 |
| hs ファイル | hsphelp\hgimg4.hs |