トップへ戻る Cdrom || Color || Cursors || Display || Draw || Event || Examples || Font || Gfxdraw || Image || Joystick || Key || Locals || Mask || Mixer || Mouse || Movie || Music || Overlay || Pixelarray || Pygame || Rect || Scrap || Sndarray || Sprite || Surface || Surfarray || Tests || Time || Transform
pygame.mixer.music
    pygame.mixer.music.load
      再生する音楽ファイルを読み込みます。
      pygame.mixer.music.load(filename): return None
      pygame.mixer.music.load(object): return None

      この命令で音楽ファイル名や音楽オブジェクトを読み込み、再生の準備をします。既に再生中の音楽があった場合、その再生は停止されます。この命令だけでは音楽の再生は始まりません。



    pygame.mixer.music.play
      音楽のストリーミング再生を開始します。
      pygame.mixer.music.play(loops=0, start=0.0): return None

      読み込んだ音楽をストリーミング再生します。既に再生中の音楽だった場合は、もう一度最初から再生が始まります。

      loops引数に値を設定することで、音楽の繰り返し再生回数を制御します。play(5)で実行すると、一度再生を行った後に5回の繰り返し再生が行われるので合計6回の再生されます。loops引数に-1が設定されていた場合、音楽再生は無限に繰り返されます。

      start引数を設定することで、音楽の再生開始位置を制御することができます。再生開始位置は、再生する音楽ファイルの形式によって左右されます。MP3ファイルやOGGファイルの場合、start引数に設定した開始位置はミリセカンド単位の時間として扱われます。MODファイルの場合だと再生するパターンの番号として扱われます(MODファイルではパターンと呼ばれる演奏データを順序良く並べて音楽を再生する)。設定できない値をstart引数に設定した場合、エラー:NotImplementedErrorが発生します。



    pygame.mixer.music.rewind
      音楽を最初から再生します。
      pygame.mixer.music.rewind(): return None

      現在再生されている音楽をリセットして、もう一度最初から再生を開始します。



    pygame.mixer.music.stop
      音楽の再生を終了します。
      pygame.mixer.music.stop(): return None

      音楽が再生中の場合、それを終了させます。



    pygame.mixer.music.pause
      音楽の再生を一時停止します。
      pygame.mixer.music.pause(): return None

      再生中の音楽を一時停止します。pygame.mixer.music.unpause命令を実行することで一時停止した音楽を再開できます。



    pygame.mixer.music.unpause
      停止した音楽を再開させます。
      pygame.mixer.music.unpause(): return None

      一時停止させた音楽の再生を再開させます。



    pygame.mixer.music.fadeout
      再生中の音楽の音を徐々に小さくしていった上で終了させます。
      pygame.mixer.music.fadeout(time): return None

      time引数で設定した時間(ミリ秒単位)の中で再生中の音楽の音を徐々に小さくしていった上で、再生を終了します。

      ※原文には「再生が終了するまでの間、この命令はプログラムのブロックを行います(Note, that this function blocks until the music has faded out.)」と記載されていますが、フェードアウト中でも音楽の停止や再生が行えるようなので、その部分の記載は省いています。



    pygame.mixer.music.set_volume
      音楽のボリュームを設定します。
      pygame.mixer.music.set_volume(value): return None

      再生する音楽のボリュームを設定します。value引数には0.0から1.0までの値を設定します。現在再生中のものとは別の音楽が新たに読み込まれた場合、設定したボリュームの値はリセットされます。



    pygame.mixer.music.get_volume
      音楽のボリュームを取得します。
      pygame.mixer.music.get_volume(): return value

      ミキサーの現在のボリュームを戻り値として取得します。取得されるボリュームは0.0から1.0までの値となります。



    pygame.mixer.music.get_busy
      音楽が再生中かどうかを確認します。
      pygame.mixer.music.get_busy(): return bool

      音楽が再生中の場合はTrueが戻り値として返されます。再生されていない場合はFalseが戻り値として返されます。



    pygame.mixer.music.get_pos
      音楽の再生時間を取得します。
      pygame.mixer.music.get_pos(): return time

      音楽が再生された時間をミリセカンド単位の値で取得します。ここで取得される時間は、単純に再生された時間のみを表します。;再生開始位置によって時間が加算されるようなことはありません。



    pygame.mixer.music.queue
      現在再生中の音楽が終了した後に再生されるように、音楽ファイルの再生準備をします。
      pygame.mixer.music.queue(filename): return None

      この命令では音楽ファイルを読み込み、再生の順番待ちに設定します。順番待ちの音楽は、現在再生中の音楽が正常に終了した後に再生が開始されます。再生中の音楽が途中で終了したり変更されたりした場合、順番待ち音楽の再生は行われません。

      下記の例ではbach.oggを6回再生した後にmozart.oggを1回再生します:

          pygame.mixer.music.load('bach.ogg')
          pygame.mixer.music.play(5)        #5回ではなく6回再生が行われます! 
          pygame.mixer.music.queue('mozart.ogg')
      


    pygame.mixer.music.set_endevent
      音楽の再生が終了した時に、指定したイベントを発生させます。
      pygame.mixer.music.set_endevent(): return None
      pygame.mixer.music.set_endevent(type): return None

      この命令によって、音楽の再生が終了した時にPygameがイベントキューの信号を発生させます。設定する引数によってキューに送られるイベントのタイプを決定します。

      設定されたイベントは一度限りのものではなく、音楽の再生が終了するたびに毎回発生します。イベントの発生を解除するためには、引数を設定せずにこの命令を実行します。



    pygame.mixer.music.get_endevent
      音楽の再生が終了した時に、発生するイベントを取得します。
      pygame.mixer.music.get_endevent(): return type

      音楽の再生が終了した時に発生するイベントの種類を戻り値として返します。終了イベントが設定されていない場合、pygame.NOEVENTの値が戻り値として返されます。



トップへ戻る Cdrom || Color || Cursors || Display || Draw || Event || Examples || Font || Gfxdraw || Image || Joystick || Key || Locals || Mask || Mixer || Mouse || Movie || Music || Overlay || Pixelarray || Pygame || Rect || Scrap || Sndarray || Sprite || Surface || Surfarray || Tests || Time || Transform