Playback
Play your music!
The playback tools in the Basolia library contains two separate sections: the actual playback tools and the playback positioning tools.
Playback tools
The playback tools shipped with the Basolia library is a key feature for every single music player.
Playing music
There are two ways to play the music: synchronously and asynchronously. For normal console applications, you'd typically use Play()
for a single audio player, or this function in a thread for a music player, such as BassBoom.Cli.
However, for GUI application, it's best to use the asynchronous version whenever possible, PlayAsync()
, to avoid blocking the main thread.
Pausing and stopping music
If you want to pause the music, you can use the Pause()
function. It'll stop the music, but stays at the current position. If you want to start over, you can use the Stop()
function.
Volume Controls
For controlling the volume that the Basolia library controls, you can use both the SetVolume()
and the GetVolume()
functions. SetVolume()
allows you to set the current volume to the new volume from 0.0 (0%) to 1.0 (100%). Additionally, if you've enabled the volume boost option, you can set the volume up to 3.0 (300%), though this may cause audio artifacts in some cases where parts of an audio file is loud.
Getting the current volume using the GetVolume()
function returns three variables that describe the following:
baseLinear
: The base linear volume from 0.0 to 1.0actualLinear
: The actual linear volume from 0.0 to 1.0decibelsRva
: The RVA value in decibels (dB)
Playback states
When either Play()
, Pause()
, or Stop()
functions are called, the playback state changes, depending on the action. You can get the current playback state by using the GetState
function.
You can also quickly determine whether Basolia is busy playing a song using the IsPlaying
function:
The playback states are the following:
Stopped
: Music has either stopped or not played yetPlaying
: Music is playingPaused
: Music has been paused by the user or by the call to thePause()
function
Opening the output
If you want to open the output to your selected device and driver or to a pre-determined device and driver as selected by your OS, you can use the below function:
You don't usually need to call this function, unless you have a reason to. Playback tools already use this function internally.
Starting the output
If you want to start the output at a selected rate, channel count, and encoding, you can use the below function:
You don't usually need to call this function, unless you have a reason to. Playback tools already use this function internally.
Closing the output
If you no longer want to output anything, you can use this function:
Use this function carefully, as reckless usage could cause the underlying application to crash with an access violation error.
Positioning tools
In addition to the playback tools, you can also get access to the positioning tools to perform seek operations to jump to a specific section of a song, regardless of whether the song is playing or not.
Current duration
You can get the current duration in two units: Samples and time span. If you want to get the current duration using the samples, you can use the GetCurrentDuration()
function:
Similarly, you can also get the current duration in the timespan for easier representation by using the GetCurrentDurationSpan()
function:
Seeking controls
If you want to seek the music file either to a selected position using a frame number or to the beginning of the song (frame 0), you can simply use one of the two functions:
Dropping MPEG frames
If you want to flush all MPEG frames to the device for any reason, you can use this function:
Equalizer tools
BassBoom's Basolia library also allows you to modify the equalizer settings during playback so that you can listen to enhanced music. It currently supports 32 bands as MPG123 supports.
You can run this tool on either left, right, or both speakers.
Getting current equalizer values
If you want to get the current equalizer values, you can use the below function:
Setting equalizer values
If you want to set the equalizer values for one or more bands to make your music sound better, you can use the below function:
Resetting equalizer values
If you want to reset the equalizer values to their natural states (1.00
), you can use the below function:
Getting native state
If you want to get the native state of the output stream that represents the currently playing music, you can use this function:
The mpg123_state
enumeration has the following states for you to get:
MPG123_ACCURATE: Accurate rendering
MPG123_BUFFERFILL: Buffer fill
MPG123_DEC_DELAY: Decode delay in milliseconds
MPG123_ENC_DELAY: Encode delay in milliseconds
MPG123_ENC_PADDING: Encoding padding
MPG123_FRANKENSTEIN: Frankenstein stream?
MPG123_FRESH_DECODER: Fresh decoder
Last updated