Источник
Источник представляет собой аудиоданные, которые можно воспроизводить. Вы можете выполнять интересные действия с источниками, например, устанавливать громкость, высоту тона и его положение относительно слушателя. Обратите внимание, что позиционное аудио работает только для моно (то есть не стерео) источников.
Управление источником (воспроизведение/пауза/остановка) выполняется в соответствии со следующей таблицей состояний.
| Воспроизведение | Пауза | |
|---|---|---|
| play() | Без изменений | Воспроизведение |
| stop() | Пауза + перемотка | Перемотка |
| pause() | Пауза | Без изменений |
И для поклонников блок-схем (прим.: пропущенные вызовы не имеют эффекта, остановка всегда перематывает).
Конструкторы
| love.audio.newQueueableSource | Создает новый источник, пригодный для воспроизведения звука в реальном времени с помощью Source:queue. | 11.0 | |
| love.audio.newSource | Создает новый Источник из файла, SoundData или Декодер. |
Функции
| Object:release | Немедленно уничтожает Lua-ссылку объекта. | 11.0 | |
| Object:type | Получает тип объекта в виде строки. | ||
| Object:typeOf | Проверяет, является ли объект определенного типа. | ||
| Source:clone | Создает точную копию Источника в состоянии остановки. | 0.9.1 | |
| Source:getActiveEffects | Получает список имен активных эффектов Источника. | 11.0 | |
| Source:getAirAbsorption | Получает количество поглощения воздуха, примененного к Источнику. | 11.2 | |
| Source:getAttenuationDistances | Получает эталонные и максимальные расстояния затухания Источника. | 0.9.0 | |
| Source:getChannelCount | Получает количество каналов в Источнике. | 11.0 | |
| Source:getChannels | Получает количество каналов в Источнике. | 0.9.0 | |
| Source:getCone | Получает конусы направленного звукового объема Источника. | 0.9.0 | |
| Source:getDirection | Получает направление Источника. | 0.7.0 | |
| Source:getDistance | Возвращает эталонное и максимальное расстояние источника. | 0.8.0 | 0.9.0 |
| Source:getDuration | Получает длительность Источника. | 0.10.0 | |
| Source:getEffect | Извлекает настройки фильтра, связанные с определенным эффектом. | 11.0 | |
| Source:getFilter | Получает настройки фильтра, в настоящее время примененные к Источнику. | 11.0 | |
| Source:getFreeBufferCount | Получает количество свободных слотов буфера для источника с возможностью очереди. | 11.0 | |
| Source:getPitch | Получает текущую высоту тона Источника. | ||
| Source:getPosition | Получает положение Источника. | 0.7.0 | |
| Source:getRolloff | Возвращает коэффициент затухания источника. | 0.8.0 | |
| Source:getType | Получает тип Источника. | 0.10.0 | |
| Source:getVelocity | Получает скорость Источника. | 0.7.0 | |
| Source:getVolume | Получает текущую громкость Источника. | ||
| Source:getVolumeLimits | Возвращает пределы громкости источника. | 0.8.0 | |
| Source:isLooping | Возвращает значение, указывающее, будет ли источник циклически повторяться. | ||
| Source:isPaused | Возвращает значение, указывающее, приостановлен ли источник. | 11.0 | |
| Source:isPlaying | Возвращает значение, указывающее, воспроизводится ли источник. | 0.9.0 | |
| Source:isRelative | Получает значение, указывающее, являются ли положение и направление Источника относительными к слушателю. | 0.9.0 | |
| Source:isStatic | Возвращает значение, указывающее, является ли источник статичным. | 0.7.0 | 0.10.0 |
| Source:isStopped | Возвращает значение, указывающее, остановлен ли источник. | 11.0 | |
| Source:pause | Приостанавливает источник. | 0.7.0 | |
| Source:play | Воспроизводит источник. | 0.7.0 | |
| Source:queue | Добавляет SoundData в очередь для воспроизведения в источнике с возможностью очереди. | 11.0 | |
| Source:resume | Возобновляет приостановленный источник. | 0.7.0 | 11.0 |
| Source:rewind | Перематывает источник. | 0.7.0 | 11.0 |
| Source:seek | Устанавливает текущую позицию воспроизведения в Источнике. | 0.8.0 | |
| Source:setAirAbsorption | Устанавливает количество поглощения воздуха, примененного к Источнику. | 11.2 | |
| Source:setAttenuationDistances | Устанавливает эталонные и максимальные расстояния затухания Источника. | 0.9.0 | |
| Source:setCone | Устанавливает конусы направленного звукового объема Источника. | 0.9.0 | |
| Source:setDirection | Устанавливает направление Источника. | 0.7.0 | |
| Source:setDistance | Устанавливает эталонное и максимальное расстояние источника. | 0.8.0 | 0.9.0 |
| Source:setEffect | Применяет аудио эффект к Источнику. | 11.0 | |
| Source:setFilter | Устанавливает фильтр низких, высоких или полосовых частот для применения при воспроизведении Источника. | 11.0 | |
| Source:setLooping | Устанавливает, должен ли источник циклически повторяться. | ||
| Source:setPitch | Устанавливает высоту тона Источника. | ||
| Source:setPosition | Устанавливает положение Источника. | 0.7.0 | |
| Source:setRelative | Устанавливает, являются ли положение и направление Источника относительными к слушателю. | 0.9.0 | |
| Source:setRolloff | Устанавливает коэффициент затухания. | 0.8.0 | |
| Source:setVelocity | Устанавливает скорость Источника. | 0.7.0 | |
| Source:setVolume | Устанавливает текущую громкость Источника. | ||
| Source:setVolumeLimits | Устанавливает пределы громкости источника. | 0.8.0 | |
| Source:stop | Останавливает источник. | 0.7.0 | |
| Source:tell | Получает текущую позицию воспроизведения в Источнике. | 0.8.0 |
Перечисления
| FilterType | Типы фильтров для источников. | 11.0 | |
| SourceType | Типы аудиоисточников. |
Наследуемые типы
См. также
© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/Source
