シーケンスインスタンス構造体

Game Maker Language リファレンス > 組み込み関数 用途別 > リソース操作 > リソース操作・シーケンス > シーケンスインスタンス構造体

シーケンスインスタンス構造体 †

基本プロパティ †

room に配置されたシーケンスは、レイヤーの要素として配置され、この要素にはシーケンスインスタンスが含まれます。 このシーケンスインスタンスの構造体には、次のプロパティがあります。

sequence †

これは、シーケンスインスタンスが作成された シーケンスオブジェクト構造体 のIDです（詳細については、 シーケンスオブジェクト構造体 を参照してください）。 この構造体を取得または設定して、インスタンスが参照している基本シーケンスを変更できます

headPosition †

これは、シーケンスインスタンスの現在の再生ヘッド位置（フレーム単位）です。 この値は取得または設定できますが、現在定義されている再生領域よりも大きい値または小さい値に設定すると、シーケンスに設定された再生のタイプに応じて異なる効果が得られることに注意してください。 詳細については、layer_sequence_headpos() を参照してください。

headDirection †

これは、シーケンスインスタンスの現在の再生方向です。 この値は、次の定数を使用して取得または設定できます（レイヤー関数 layer_sequence_get_headdir()? および layer_sequence_headdir() を使用して、構造体に直接アクセスする必要なく、この値を取得または設定できることに注意してください）。

speedScale †

このプロパティを使用して、再生速度のスケールを取得または設定できます。 速度スケールは乗数です。1はデフォルトの再生速度であり、1未満の値は再生を遅くし、1より大きい値は速度を上げます。たとえば、値 0.5 は半分の再生速度、値 2 は 倍の再生速度になります。 レイヤー関数 layer_sequence_get_speedscale()? およびlayer_sequence_speedscale()? を使用して、構造体に直接アクセスしなくても、この値を取得または設定できることに注意してください

paused †

このプロパティをチェックして、シーケンスが一時停止されているかどうかを確認できます。一時停止されている場合は true、そうでない場合は false になります。 これは読み取り専用のプロパティですが、レイヤー関数 layer_sequence_pause()? を使用して再生を一時停止し、layer_sequence_play()? を使用して必要に応じてそれを再開できます。 このプロパティは、構造体のプロパティを直接チェックするのではなく、レイヤー関数 layer_sequence_is_paused() を使用してチェックすることもできます

finished †

このプロパティをチェックして、シーケンスの再生が終了したかどうかを確認できます。終了した場合は true を返し、それ以外の場合はfalseを返します。 これは読み取り専用のプロパティであり、ループまたはピンポンに設定されていないトラックに対してのみtrueを返します。 このプロパティは、構造体のプロパティを直接チェックするのではなく、レイヤー関数 layer_sequence_is_finished() を使用してチェックすることもできます

elementID †

このプロパティは、シーケンス要素のIDを保持します。 このiDは、ルームエディターのレイヤーに関連付けられている単純な識別値であり、適切な レイヤー関数 と共に使用して、シーケンスが割り当てられているレイヤーを検索したり、構造体として扱わなくても特定のシーケンスプロパティを変更したりできます

activeTracks †

このプロパティは、シーケンス内の各アセットトラックの現在の状態に関する情報（グラフィック、シーケンス、オーディオなど）を含む「評価」構造体の配列を保持します。 これらは最上位のトラックのみであり、返される配列は読み取り専用です。 各配列エントリで返されるアセットトラック構造の内容については、以下のセクションをご覧ください

シーケンストラック構造体 にアクセスするときのプロパティ †

次のリストには、トラック構造体にアクセスするときに使用できるプロパティ（上で説明した親シーケンス構造体の activeTracks プロパティによって返される）が含まれています。 各アセットトラック構造体には、トラックが参照しているアセットのタイプに応じて、以下のプロパティの一部またはすべてが含まれる場合があります（読み取り専用として指定されている場合を除き、これらすべてのプロパティを取得または設定できます）。返されるすべての値は 現在の再生ヘッドの位置

matrix †

これは、トラック（スプライト、インスタンス、シーケンストラック）の描画に使用される変換行列です。

posx †

現在の再生ヘッドの位置にあるトラックのX軸に沿ったシーケンス内のアセットの位置（すべてのアセット）。

posy †

現在の再生ヘッドの位置にあるトラックのY軸に沿ったシーケンス内のアセットの位置（すべてのアセット）。

scalex †

現在の再生ヘッド位置にあるトラック（スプライト、インスタンス、シーケンストラック）のX軸に沿ったシーケンス内のアセットのスケール。

scaley †

現在の再生ヘッド位置にあるトラック（スプライト、インスタンス、シーケンストラック）のY軸に沿ったシーケンス内のアセットのスケール。

xorigin †

トラックのアセットのX原点（すべてのアセット）。

yorigin †

トラックのアセットのY原点（すべてのアセット）。

width †

トラック（スプライト、インスタンス、シーケンストラック）のアセットの幅（ピクセル単位）。

height †

トラック（スプライト、インスタンス、シーケンストラック）のアセットの高さ（ピクセル単位）。

imageindex †

現在の再生ヘッド位置にあるシーケンスのトラック上のアセットのイメージインデックス（スプライトおよびインスタンストラック）。

imagespeed †

現在の再生ヘッド位置でのシーケンス内のトラック上のアセットの画像速度（スプライトおよびインスタンストラック）。

colourMultiply †

現在の再生ヘッド位置（スプライト、インスタンス、シーケンストラック）でのシーケンス内のトラック上のアセットのカラー乗算値。 この値は、[A、R、G、B]という形式の4つのARGB値の配列になります。 各コンポーネントの値は0と1の間で表されることに注意してください。0はHEX値＃00に対応し、1はHEX値#FFに対応します（シーケンスのカラー乗算トラックのカラーピッカーに示されているように0-255） 編集者）。

gain †

現在の再生ヘッド位置のトラック（オーディオトラック）のゲイン（ボリューム）。

pitch †

現在の再生ヘッド位置のトラックのピッチ（オーディオトラック）。

trac †

トラックデータは、このトラックが基づいていることを示します（すべてのアセット、読み取り専用の値）。

parent †

トラックの親シーケンスインスタンスID（すべてのアセット、読み取り専用の値）。

activeTracks †

これは、アセットトラックに含まれる各パラメータートラックの評価構造体の配列です（すべてのアセット、読み取り専用の値）。 配列内の各構造体の内容は、 シーケンストラック構造体 セクションにリストされています。