sfxr.lua/README.md

49 lines
1.0 KiB
Markdown

sfxr.lua
========
A port of the sfxr sound effect synthesizer to pure Lua, designed to be used
together with the *awesome* [LÖVE](https://love2d.org) game framework.
Demo
----
To run the demo application you first need to download
[LoveFrames](https://github.com/NikolaiResokav/LoveFrames) as a submodule:
```
git submodule init
love demo
```
Example usage
-------------
These examples should play a randomly generated sound.
With [Löve](http://love2d.org) 0.9.x:
```lua
local sfxr = require("sfxr")
function love.load()
local sound = sfxr.newSound()
sound:randomize()
sound:play()
end
```
With [lao](https://github.com/TheLinx/lao):
```lua
require("ao")
local sfxr = require("sfxr")
local driverId = ao.defaultDriverId()
local device = ao.openLive(driverId, {bits = 16, rate = 44100, channels = 1})
local sound = sfxr.newSound()
sound:randomize()
local buffer = sound:generateString()
device:play(buffer, #buffer)
```
**More documentation is available at the [Project Wiki](https://github.com/nucular/sfxrlua/wiki)**