Processing:Библиотеки/Sound/Класс SoundFile/play(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
 
Нет описания правки
 
(не показана 1 промежуточная версия этого же участника)
Строка 4: Строка 4:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


{{Черновик}}
 


=play()<ref>[https://processing.org/reference/libraries/sound/SoundFile_play_.html processing.org - play()]</ref>=
=play()<ref>[https://processing.org/reference/libraries/sound/SoundFile_play_.html processing.org - play()]</ref>=
Строка 10: Строка 10:
==Класс==
==Класс==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
SoundFile
SoundFile
</syntaxhighlight>
</syntaxhighlight>
Строка 16: Строка 16:
==Обозначение==
==Обозначение==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
play()
play()
</syntaxhighlight>
</syntaxhighlight>
Строка 26: Строка 26:
==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
.play()
.play()
.play(rate)
.play(rate)
Строка 37: Строка 37:
==Параметры==
==Параметры==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
rate – относительная скорость проигрывания аудиофайла. Если задать «1», аудиофайл будет проигрываться с обычной скоростью, если «0.5» – скорость проигрывания будет в 2 раза ниже обычной, а частота звука упадет на одну октаву, если «2.0» – скорость проигрывания увеличится в 2 раза, а частота звука возрастет на 1 октаву. Тип данных – float
rate – относительная скорость проигрывания аудиофайла. Если задать «1», аудиофайл будет проигрываться с обычной скоростью, если «0.5» – скорость проигрывания будет в 2 раза ниже обычной, а частота звука упадет на одну октаву, если «2.0» – скорость проигрывания увеличится в 2 раза, а частота звука возрастет на 1 октаву. Тип данных – float
pos – задает стерео-значение аудиофайла. Значения варьируются от «-1.0» (звук будет звучать только в левом «ухе») до «1.0» (звук будет звучать только в правом «ухе»). Работает только с моно-аудиофайлами! Тип данных – float
pos – задает стерео-значение аудиофайла. Значения варьируются от «-1.0» (звук будет звучать только в левом «ухе») до «1.0» (звук будет звучать только в правом «ухе»). Работает только с моно-аудиофайлами! Тип данных – float
Строка 47: Строка 47:
==Возвращаемое значение==
==Возвращаемое значение==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
void
void
</syntaxhighlight>
</syntaxhighlight>
Строка 53: Строка 53:
==Пример==
==Пример==


<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
import processing.sound.*;
import processing.sound.*;
SoundFile file;
SoundFile file;
Строка 92: Строка 92:
|Высота логотипа издателя для schemaNewsArticle=45
|Высота логотипа издателя для schemaNewsArticle=45
}}
}}
{{Навигационная таблица/Справочник языка Processing}}
{{Навигационная таблица/Портал/Processing}}

Текущая версия от 11:58, 20 мая 2023


Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.



play()[1]

Класс

SoundFile

Обозначение

play()

Описание

Запускает проигрывание аудиофайла. Проигрывает аудиофайл только один раз, т.е. курсор воспроизведения доходит до конца аудиофайла, а потом останавливается. Если ранее в программе была вызвана функция cue() или pause(), то проигрывание аудиофайла возобновится с позиции, заданной с помощью какой-либо из этих функций.

Синтаксис

.play()
.play(rate)
.play(rate, amp)
.play(rate, pos, amp)
.play(rate, pos, amp, add)
.play(rate, pos, amp, add, cue)

Параметры

rate – относительная скорость проигрывания аудиофайла. Если задать «1», аудиофайл будет проигрываться с обычной скоростью, если «0.5» – скорость проигрывания будет в 2 раза ниже обычной, а частота звука упадет на одну октаву, если «2.0» – скорость проигрывания увеличится в 2 раза, а частота звука возрастет на 1 октаву. Тип данных – float
pos – задает стерео-значение аудиофайла. Значения варьируются от «-1.0» (звук будет звучать только в левом «ухе») до «1.0» (звук будет звучать только в правом «ухе»). Работает только с моно-аудиофайлами! Тип данных – float
amp – задает громкость аудиофайла. Значения варьируются от «0.0» (полная тишина) до «1.0» (полная громкость). Тип данных – float
add – корректирует так называемое «смещение постоянного тока» (от англ. «DC offset»), т.е. смещает звуковую волну на заданное значение относительно нулевого уровня. Более подробно читайте http://wikisound.org/Постоянное_амплитудное_смещение. Тип данных – float
cue – позиция в аудиофайле, с которой нужно начать проигрывание (в секундах). Тип данных – float

Возвращаемое значение

void

Пример

import processing.sound.*;
SoundFile file;

void setup() {
  size(640, 360);
  background(255);
    
  // загружаем аудиофайл из папки «data» скетча
  // и начинаем проигрывать этот аудиофайл:
  file = new SoundFile(this, "sample.mp3");
  file.play();
}

void draw() {
}

См.также

Внешние ссылки