love.audio.setEffect (日本語)

LÖVE 11.0 から使用可能
この関数は以前のバージョンでは非対応です。

Source で使うエフェクトを定義します。

すべてのシステムで音声エフェクトに対応しているわけではありません。対応状況は love.audio.isEffectsSupported にてご確認ください。

関数

概要

love.audio.setEffect(name, settings)

引数

string name
エフェクトの名前です。
table settings
このエフェクトの使用時の設定をするときは、下記のフィールドを記入します:
EffectType type
使用するエフェクトの種類。
number volume
エフェクトの音量。
number ...
エフェクトの詳細設定。利用可能なエフェクトと対応する設定値については EffectType を参照してください。

返値

boolean success
エフェクトの作成に成功したかどうか。

関数

概要

love.audio.setEffect(name, enabled)

引数

string name
エフェクトの名前です。
boolean enabled (true)
true ならば指定されたエフェクトを設定しますが、 false ならエフェクトを無効にします。

返値

boolean success
エフェクトの無効化に成功したかどうか。

用例

音楽にリバーブをかけて再生します

love.audio.setEffect('myEffect', {type = 'reverb'})
local source = love.audio.newSource('music.ogg', 'stream')
source:setEffect('myEffect')
source:play()

音楽にディストーションをかけて再生します

love.audio.setEffect('myEffect', {
	type = 'distortion',
	gain = .5,
	edge = .25,
})
local source = love.audio.newSource('music.ogg', 'stream')
source:setEffect('myEffect')
source:play()

関連



そのほかの言語