Download Latest Version ao18feb24.7z (12.1 MB)
Email in envelope

Get an email when there's a new version of Portable OpenAL Sound

Home / 19oct2021
Name Modified Size InfoDownloads / Week
Parent folder
adaOal19oct21.7z 2021-10-19 15.1 MB
READMEao.md 2021-10-19 3.1 kB
Totals: 2 Items   15.1 MB 0

https://sourceforge.net/projects/portable-openal-sound/

Portable Sound -- using Ada tasking and OpenAL

ver 1.1.0 -- 19oct2021 * Now builds on GPL-GNAT as well as all versions of AdaCore.

ver 1.0.1 -- 17feb2021

  • Added important guard statement for robustness.

  • Update 6nov: added DLL to example directory.

  • Update 12nov: added W64,OSX build scripts + EXEs to C++ example.

Description

This package is a thick, cross-platform Ada binding to OpenAL. It can play WAV files on Windows, OSX, and Linux, using Ada tasking and OpenAL libraries.

It provides sound-playing capabilities for Ada apps to * asynchronously start and stop music/sound loops, * and initiate transient sounds.

Examples for each O.S. are included.

It is suitable for any Ada application that requires background or transient sound effects; eg. games, simulations.

There are no software dependencies; this package is self-contained.


Usage:

The proper command to extract the archive and maintain the directory structure is "7z x filename".

See the simple interface description in file snd4ada.ads.

Generally, when you initialize a sound or soundloop, you specify its file name and retrieve an integer "key" that is used to play it sometime later.

Note: an error occurs whenever there is something fishy about the WAV file. I always get good results with WAV files output from, or processed through "sox".

========================================================

What is so great about this package?

This package is a non-platform-specific Ada code that compiles on Windows as well as OSX and Linux. It is now used in my two flagship games: AdaGate and AdaVenture (on GitHub & SourceForge).

========================================================

Ada Examples:

See ./adaExample/one.adb See ./adaExample/two.adb

The examples come with 3 compilation scripts: lcmp.sh, ocmp.sh, wcmp.bat

C++ Examples

See ./cppExample/two.cpp

This comes with scripts for linux and Windows. It shows how to use the Ada package from a C++ main. If any Mac experts out there can show me how to build on OSX, I would like to include it.


SoundFiles

Kick & choir sound is from freesound.org, so is covered by the Creative Commons Noncommercial License; see http://creativecommons.org/licenses/by-nc/3.0/legalcode/

License:

This app is covered by the GNU GPL v3 as indicated in the sources:

Copyright (C) 2021 fastrgv@gmail.com

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You may read the full text of the GNU General Public License at http://www.gnu.org/licenses/.

Source: READMEao.md, updated 2021-10-19