setSoundProperties

Ajusta taxa de amostragem, tempo, tom e sentido da reprodução de uma só vez.

Sintaxe

bool setSoundProperties ( element oSom, number taxaDeAmostragem, number tempo, number pitch
                          [, bool invertido = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oSom	element	—	Som a ajustar.
taxaDeAmostragem	number	—	Taxa de amostragem da reprodução, em Hz.
tempo	number	—	Ajuste de andamento. 0 mantém o andamento original.
pitch	number	—	Ajuste de tom. 0 mantém o tom original.
invertido	bool	false	Com true, o som toca de trás para frente.

Retorno

true em caso de sucesso, false caso contrário.

Cuidado

Só funciona em sons carregados de arquivo. Streams abertos por URL não têm esse tratamento e a função devolve false neles.

Exemplo

-- meia oitava abaixo, sem mexer no andamento
setSoundProperties(musica, 44100, 0, -6)

Veja também

• setSoundVolume — Define o volume de um som.
• getSoundVolume — Devolve o volume configurado de um som.
• setSoundPan — Distribui um som 2D entre os canais esquerdo e direito.
• getSoundPan — Devolve o pan de um som 2D.
• setSoundSpeed — Define a velocidade de reprodução.
• getSoundSpeed — Devolve a velocidade de reprodução.
• getSoundProperties — Devolve as quatro propriedades ajustadas por setSoundProperties.