Platform SDK: DirectX |
DirectMusicSegment.SetLoopPoints メソッドは、セグメント内のループ部分の開始ポイントと終了ポイントを設定する。反復回数は DirectMusicSegment.SetRepeats メソッドによって設定される。
object.SetLoopPoints(mtStart As Long, mtEnd As Long)
失敗すればエラーが発生し、Err.Number に DMUS_E_OUT_OF_RANGE が設定される。
セグメントの演奏時には、開始タイムから mtEnd まで演奏し、mtStart にループする。次に、ループ部分を DirectMusicSegment.SetRepeats によって設定される回数だけ反復し、最後まで演奏する。
デフォルト値は、最初から最後までセグメント全体をループさせるように設定されている。
mtStart の値がセグメントの長さ以上の場合、または mtEnd の値がセグメントの長さを超える場合、メソッドは失敗する。mtEnd が 0 の場合、mtStart も 0 でなければならない。
このメソッドは、このセグメントから作成された、現在演奏中のセグメント状態に影響を及ぼすことはない。
再利用されるセグメントは、内部キャッシュからロードされる可能性もある。その場合、そのセグメントのループ ポイントは、最後に設定された値と同じ値を持つ。オブジェクトを解放またはリセットする前には、ループ ポイントを 0 にリセットするとよい。
DirectMusicSegment.GetLoopPointStart、DirectMusicSegment.GetLoopPointEnd、DirectMusicSegment.SetRepeats