モジュールの関数

clearEvents(eventType=None)

現在イベントバッファにあるイベントを消去する。

引数で’mouse’, ‘joystick’, ‘keyboard’のいずれかを指定することによって、該当する種類のイベントのみ消去することができる。Noneを指定した場合、すべての種類のイベントが消去される。デフォルト値はNoneである。

デフォルトではすべてのイベントが消去される。

waitKeys(maxWait=inf, keyList=None, modifiers=False, timeStamped=False)

getKeysと同様にキーボードのキー押しイベントを取得するメソッドだが、(描画も含めて)すべての処理を停止してキーボードからの入力を待ち続ける。 内部でキーボードイベントが消去されるため、未取得のキー押しイベントはすべて失われる。

パラメータ 解説
maxWait 待ち時間の上限を秒で指定する。デフォルト値はinf、すなわち無限に待ち続ける。
modifiers TrueまたはFalse。Trueであればキー名のリストではなくタプルのリストが返される。それぞれのタプルには (keyname, modifiers)のように、第1要素にキー名、第2要素に修飾キーの状態を示す辞書オブジェクトが 含まれている。辞書オブジェクトからは’shift’、’ctrl’などの修飾キー名をキーとして各キーの状態を取得 することが出来る。

タイムアウトした場合はNoneが返される。

getKeys(keyList=None, modifiers=False, timeStamped=False)

キーボードの押されたキー名のリストを返す。

パラメータ 解説
keyList キー押しイベントを確認するキーを制限する。確認するキー名を並べたシーケンスで指定する。シーケンスに 含まれていないキーのキー押しイベントは削除されない(訳注:したがって、スペースキーとリターンキーの イベントがキューに含まれている時にkeyList=[‘space’]でgetKey()を実行するとスペースキーのイベントだけ が消去されてリターンキーのイベントは残る。続いてkeyList=[‘return’]でgetKey()を実行するとリターン キーのイベントを取得できる)。 Noneの場合はすべてのキーのキー押しイベントが返され、イベントキューは完全に空になる。
modifiers TrueまたはFalse。Trueであればキー名のリストではなくタプルのリストが返される。それぞれのタプルには (keyname, modifiers)のように、第1要素にキー名、第2要素に修飾キーの状態を示す辞書オブジェクトが 含まれている。辞書オブジェクトからは’shift’、’ctrl’などの修飾キー名をキーとして各キーの状態を取得 することが出来る。
timeStamped True, Falseまたはpsychopy.core.Clockオブジェクト。Trueであればタプルのリストが返される。それぞれの タプルは(keyname, time)の形式で、第2要素がタイムスタンプである。Clockオブジェクトが指定された 場合はClockが最後にリセットされてからの時間が返される。