rodrigodd / audio-engine

A cross-platform rust crate for audio playback

Space Invaders Emulator

This is a emulator of the classic arcade game, Space Invaders (1978), write in Rust.

Test it: https://rodrigodd.github.io/space-invaders-emu/

Controls

'Z' is Shoot, 'Left' and 'Right' arrows to move, 'Return' for 1 Player Start button, and 'Backspace' for the 2 Player Button.

And for binary builds with the debug feature enable, press Escape to enter the debug mode.

debugger

When in debug mode, you can enter commands in the terminal:

• run to exit the debug mode;
• bp <HEX ADRESS> to place a breakpoint at an address;
• runto <HEX ADRESS> to run until the given address.

Compile

To compile and run to Windows, Linux or macOS, run the command cargo run --release.

Or cargo run --release --features=debug to enable the intel 8080 debugger.

WebAssembly

To compile to WebAssembly, you can use wasm-pack with the command:

wasm-pack build --target web --out-dir ../pkg  ./space-invaders-wasm

You can run it in a webpage by starting a http server in the root directory. You can use python for that, for example:

py -m http.server

audio-engine's Issues

Compiler error on WebAssembly

Is this engine capable to run under wasm32 ? Right now I get a compile error.

error[E0433]: failed to resolve: could not find `StreamInner` in `platform`
   --> /Users/markusmoenig/.cargo/registry/src/github.com-1ecc6299db9ec823/audio-engine-0.2.2/src/engine.rs:135:33
    |
135 |                 cpal::platform::StreamInner::WebAudio(x) => {
    |                                 ^^^^^^^^^^^ could not find `StreamInner` in `platform`

Send + Sync traits

Hi,

I am changing my app layout a bit and now require Send and Sync in my classes. Audio Engine fails with

Sender<audio_engine::engine::backend::StreamEvent> cannot be shared between threads safely
within ScreenEditor<'_>, the trait Sync is not implemented for Sender<audio_engine::engine::backend::StreamEvent>

I guess there are more traits which fail. Is it possible to add Send + Sync support ? Rhai for example has implemented this using a "Sync" feature.

Thanks

`set_volume` doesn't work for more than one added sounds

i think i discovered a bug. the volume field of more than 1 sound is completely ignored.
i went ahead and fixed it, you can check out my fork's volume-fix branch (https://github.com/tshrpl/audio-engine_by_Rodrigodd/tree/volume-fix), there's an example multiple_tracks demonstrating this issue

Crash on system with an external sound card

I have a beta user for eldiron.com who send me this screenshot of a crash inside the audio-engine. He said he has an external sound card, he is not a developer so unable to debug this further.

Mixing of two audio sources

Hi,

congrats! You are the first library which works for me both on desktop and web.

The only things I would need is volume settings and mixing of two audio sources (background music and effects). Do you plan to support it ?

Thanks a lot!

Put OGG and WAV support behind features

Some users may not want or need these features. As such, allow them to be disabled through Cargo features.

`stop` does nothing on sounds set to loop

If a sound is set to loop with set_loop(true), calling stop() and/or reset() on it does nothing.

`WavDecoder` don't support bit depth greater than 16

The WavDecoder uses hound to decode the WAV to i16 samples, but hound return a Result that errors when the target format is smaller than the bit depth of the file, or is in the wrong format (float vs int). audio-engine is currently unwrapping this Result and panicking.

audio-engine should not panic. Should at least decode the samples as i32 or f32 and convert them to i16 (and ideally support more sample formats).

Relevant source code:

audio-engine/src/wav.rs

Lines 36 to 48 in b256adb

	#[allow(clippy::needless_range_loop)]
	fn write_samples(&mut self, buffer: &mut [i16]) -> usize {
	let mut samples = self.reader.samples::<i16>();
	for i in 0..buffer.len() {
	if let Some(sample) = samples.next() {
	buffer[i] = sample.unwrap();
	} else {
	return i;
	}
	}
	buffer.len()
	}