love.sound.newSoundData (Українська)

Створює новий об'єкт звукових даних (SoundData) на основі шляху до файлу, файлового об'єкту File чи об'єкту Decoder. Також може створити SoundData з певною частотою семплування, каналами та бітовою глибиною.

Звук буде розкодований в нестиснений формат в пам'яті. Рекомендується створювати тільки короткі звуки, такі як звукові ефекти, бо пісня на 3 хвилини буде займати 30 MB пам'яті, якщо її відкрити цією функцією.

Функція

Вигляд

soundData = love.sound.newSoundData( filename )

Аргументи

string filename
Ім'я файлу, який буде загружений.

Повертає

SoundData soundData
Новий об'єкт SoundData.

Функція

Вигляд

soundData = love.sound.newSoundData( file )

Аргументи

File file
Об'єкт File, що вказує на аудіофайл.

Повертає

SoundData soundData
Новий об'єкт SoundData.

Функція

Вигляд

soundData = love.sound.newSoundData( decoder )

Аргументи

Decoder decoder
Об'єкт Decoder, який буде використано для розкодування до мітки кінця файлу (EOF).

Повертає

SoundData soundData
Новий об'єкт SoundData.

Функція

Вигляд

soundData = love.sound.newSoundData( samples, rate, bits, channels )

Аргументи

number samples
Загальна кількість семплів.
number rate (44100)
Кількість семплів в секунду
number bits (16)
Кількість біт на семпл (8 чи 16).
number channels (2)
1 для моно, 2 для стерео.

Повертає

SoundData soundData
Новий об'єкт SoundData.

Приклади

Завантаження об'єкта SoundData з файлів

wav = love.sound.newSoundData("doom.wav")
-- Обережно: якщо doom.mp3 — великий файл,
-- розкодування буде дуже довгим.
mp3 = love.sound.newSoundData("doom.mp3")

Див. також


Іншими мовами