1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

/*
 * Copyright (c) 2022 Contributors to the Rrise project
 */

use crate::bindings::root::AK::MusicEngine::*;
use crate::settings::AkMusicSettings;
use crate::{ak_call_result, AkResult};

/// Initialize the music engine.
///
/// *Warning* This function must be called after the base sound engine has been properly initialized.
///
/// There should be no AK API call between [sound_engine::init](crate::sound_engine::init) and this call.
/// Any call done in between is potentially unsafe.
///
/// *Return* [AkResult::AK_Success] if the Init was successful, [AkResult::AK_Fail] otherwise.
pub fn init(mut init_settings: AkMusicSettings) -> Result<(), AkResult> {
    ak_call_result![Init(&mut init_settings)]?;
    Ok(())
}

/// Terminate the music engine.
///
/// *Warning* This function must be called before calling Term() on the base sound engine.
pub fn term() {
    unsafe {
        Term();
    }
}