Difference between revisions of "Multimedia Programming"

From Lazarus wiki
Jump to navigationJump to search
(→‎macOS: Expanded description of NSSound for macOS)
m (→‎macOS: Specify object class)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Multimedia Programming}}
 
{{Multimedia Programming}}
  
=Playing Videos=
+
== Playing Videos ==
  
 
The [[Video Playback Libraries]] page contains an annotated list of libraries for Windows, as well as any operating system which is supported by FFmpeg or by VLC. These libraries can be used to embed video playback in your applications.
 
The [[Video Playback Libraries]] page contains an annotated list of libraries for Windows, as well as any operating system which is supported by FFmpeg or by VLC. These libraries can be used to embed video playback in your applications.
  
=Playing Sound=
+
=== Native solutions ===
  
==Native solutions==
+
==== macOS ====
  
===macOS===
+
* [[macOS Video Player|AVPlayer]] - Native code for a customised video (and audio, particularly streaming audio) player.
 +
 
 +
== Playing Sound ==
 +
 
 +
=== Native solutions ===
 +
 
 +
==== macOS ====
  
 
* [[macOS_Play_Alert_Sound|System Sound Services]] For up to 30 second sound clips, alerts etc.  
 
* [[macOS_Play_Alert_Sound|System Sound Services]] For up to 30 second sound clips, alerts etc.  
* [[macOS Audio Player|AVAudioPlayer]] For longer audio files with volume control, pause, stop, resume, loop control, background music etc.
+
* [[macOS Audio Player|AVAudioPlayer]] For longer audio files with volume control, pause, stop, resume, loop control, background music etc. Note: does not work with streaming audio.
 +
* [[macOS Video Player|AVPlayer]] For streaming audio.
 
* [[macOS NSSound]] A very simple method for playing system sounds, application bundle sound files, other sound files with volume control, pause, stop, resume, loops etc.  
 
* [[macOS NSSound]] A very simple method for playing system sounds, application bundle sound files, other sound files with volume control, pause, stop, resume, loops etc.  
* [[#OpenAL_Library|OpenAL]] comes pre-installed on macOS.
+
* [[#OpenAL_Library|OpenAL]] comes pre-installed on macOS (Deprecated at WWDC2019; to be removed in a  future macOS release).
  
===Windows===
+
==== Windows ====
  
====Windows API====
+
===== Windows API =====
  
 
You can use the Windows API to play e.g. wav files:
 
You can use the Windows API to play e.g. wav files:
Line 34: Line 41:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
====Audiere Library====
+
===== Audiere Library =====
  
 
Has bindings for Delphi, but they do not work with FPC:
 
Has bindings for Delphi, but they do not work with FPC:
Line 40: Line 47:
 
* http://code.google.com/p/audiere-bind-delphi/
 
* http://code.google.com/p/audiere-bind-delphi/
  
====Squall sound====
+
===== Squall sound =====
  
 
Squall sound works fine with FPC. It has 3D audio and EAX effects, but just supports MP3, OGG and WAV formats. Open sourced in 2009 and appears dead. Windows only.
 
Squall sound works fine with FPC. It has 3D audio and EAX effects, but just supports MP3, OGG and WAV formats. Open sourced in 2009 and appears dead. Windows only.
Line 46: Line 53:
 
https://github.com/xtreme3d/squall
 
https://github.com/xtreme3d/squall
  
 +
=== Cross Platform ===
  
== Cross Platform ==
+
==== ACS (Audio Component Suite) ====
 
 
=== ACS (Audio Component Suite) ===
 
  
 
For more information, read the article about the [[ACS|Audio Component Suite]]
 
For more information, read the article about the [[ACS|Audio Component Suite]]
  
=== Audorra Library ===
+
==== Audorra Library ====
  
 
This library for Linux and Windows works well with Lazarus:  
 
This library for Linux and Windows works well with Lazarus:  
Line 59: Line 65:
 
http://sourceforge.net/projects/audorra/
 
http://sourceforge.net/projects/audorra/
  
=== BASS ===
+
==== BASS ====
 +
 
 +
Closed source. Free for non-commercial.
  
 
The BASS library can be downloaded from: http://www.un4seen.com/ and http://www.un4seen.com/forum/?topic=8682.0
 
The BASS library can be downloaded from: http://www.un4seen.com/ and http://www.un4seen.com/forum/?topic=8682.0
Line 66: Line 74:
 
https://sites.google.com/site/fiensprototyping/
 
https://sites.google.com/site/fiensprototyping/
  
=== FMOD ===
+
==== FMOD ====
  
 
[https://www.fmod.com/core FMOD Core] comes with an elegant API compatible with C, C++, C#, and Javascript, and runs on all major platforms. It is a closed source solution. It is free for use for non-comercial software, but requires the payment of license fees for commercial software.
 
[https://www.fmod.com/core FMOD Core] comes with an elegant API compatible with C, C++, C#, and Javascript, and runs on all major platforms. It is a closed source solution. It is free for use for non-comercial software, but requires the payment of license fees for commercial software.
  
=== FPSound ===
+
==== FPSound ====
  
 
FPSound is a new library being developed in the mold of fpspreadsheet and fpvectorial: it has independent modules to read, write and play sound files and also an intermediary representation for editing. See [[FPSound]]. Uses OpenAL. Appears dead and non-working.
 
FPSound is a new library being developed in the mold of fpspreadsheet and fpvectorial: it has independent modules to read, write and play sound files and also an intermediary representation for editing. See [[FPSound]]. Uses OpenAL. Appears dead and non-working.
  
=== OMEGA Engine ===
+
==== OMEGA Engine ====
  
 
The OMEGA Engine is a full game engine in single Omega.dll file which is just 50kb. It can successfully play FLAC, OGG, MP3, MP2, AMR and WMA files. It searches and uses installed audio codecs from the system. Windows and Linux only.
 
The OMEGA Engine is a full game engine in single Omega.dll file which is just 50kb. It can successfully play FLAC, OGG, MP3, MP2, AMR and WMA files. It searches and uses installed audio codecs from the system. Windows and Linux only.
Line 86: Line 94:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
=== OpenAL Library ===
+
==== OpenAL Library ====
  
{{Note|The OpenAL Library Framework is pre-installed on all Apple computers running macOS -- see /System/Library/Frameworks/OpenAL.framework}}
+
{{Note|The OpenAL Library Framework is pre-installed on all Apple computers running macOS -- see /System/Library/Frameworks/OpenAL.framework. Apple announced at WWD2019 that '''OpenAL is now deprecated''' and will be removed completely in a future release of macOS.}}
  
 
OpenAL is a cross-platform 3D audio API appropriate for use with gaming applications and many other types of audio applications.
 
OpenAL is a cross-platform 3D audio API appropriate for use with gaming applications and many other types of audio applications.
Line 102: Line 110:
 
* There is an alternative OpenAL sound manager unit to play wav files by [https://forum.lazarus.freepascal.org/index.php?action=profile;u=59515 Lulu] [https://github.com/Lulu04/OALSoundManager here]. Tested on macOS Mojave 10.14.
 
* There is an alternative OpenAL sound manager unit to play wav files by [https://forum.lazarus.freepascal.org/index.php?action=profile;u=59515 Lulu] [https://github.com/Lulu04/OALSoundManager here]. Tested on macOS Mojave 10.14.
  
=== Play Sound Package ===
+
==== Play Sound Package ====
  
 
The [[Play Sound Multiplatform|Play Sound Package]] takes a different approach to playing sound cross-platform. For Windows, it uses the native sound system; for Linux it searches the system for programs which will play sound and executes those asynchronously or synchronously via [[TProcess]] or [[TAsyncProcess]]. Note: only works with Windows and Linux.
 
The [[Play Sound Multiplatform|Play Sound Package]] takes a different approach to playing sound cross-platform. For Windows, it uses the native sound system; for Linux it searches the system for programs which will play sound and executes those asynchronously or synchronously via [[TProcess]] or [[TAsyncProcess]]. Note: only works with Windows and Linux.
  
=== PortAudio ===
+
==== PortAudio ====
  
 
Various bindings for [http://www.portaudio.com/ PortAudio], a cross-platform, open source library for audio playback and recording, are available.
 
Various bindings for [http://www.portaudio.com/ PortAudio], a cross-platform, open source library for audio playback and recording, are available.
Line 114: Line 122:
 
Some examples can be found [http://breakoutbox.de/pascal/pascal.html#PortAudio here].
 
Some examples can be found [http://breakoutbox.de/pascal/pascal.html#PortAudio here].
  
=== SDL + SDL_mixer ===
+
==== SDL + SDL_mixer ====
  
 
The basic SDL library comes with a very simple sound system. On top of that, SDL mixer adds more sound APIs which build a more flexible solution.
 
The basic SDL library comes with a very simple sound system. On top of that, SDL mixer adds more sound APIs which build a more flexible solution.
Line 120: Line 128:
 
Units for accessing SDL libraries are located in fpc/packages/sdl.  
 
Units for accessing SDL libraries are located in fpc/packages/sdl.  
  
=== SFML/CSFML for FPC ===
+
==== SFML/CSFML for FPC ====
  
 
[https://www.sfml-dev.org/ Simple and Fast Multimedia Library] aka SFML provides a simple interface to the various components of your PC, to ease the development of games and multimedia applications. It is composed of five modules: system, window, graphics, audio and network.  With SFML, your application can compile and run out of the box on the most common operating systems: Windows, Linux, macOS and soon Android & iOS.
 
[https://www.sfml-dev.org/ Simple and Fast Multimedia Library] aka SFML provides a simple interface to the various components of your PC, to ease the development of games and multimedia applications. It is composed of five modules: system, window, graphics, audio and network.  With SFML, your application can compile and run out of the box on the most common operating systems: Windows, Linux, macOS and soon Android & iOS.
Line 128: Line 136:
 
CSFML headers binding for FPC can be found at https://github.com/DJMaster/csfml-fpc
 
CSFML headers binding for FPC can be found at https://github.com/DJMaster/csfml-fpc
  
=== uos (United OpenLib of Sound) ===
+
==== uos (United OpenLib of Sound) ====
  
 
'''uos''': United OpenLib of Sound. '''uos''' unifies the best open-source audio libraries.
 
'''uos''': United OpenLib of Sound. '''uos''' unifies the best open-source audio libraries.
Line 135: Line 143:
 
*Listen to mp3, ogg, wav, flac, m4a, opus, cd audio, ... audio files.
 
*Listen to mp3, ogg, wav, flac, m4a, opus, cd audio, ... audio files.
 
*With 16, 32 or float 32 bit resolution.
 
*With 16, 32 or float 32 bit resolution.
*Record all types of input into file.
+
*Record all types of input into a file.
 
*Add DSP effects and filters, however many you want and record it.
 
*Add DSP effects and filters, however many you want and record it.
 
*Do web audio-streaming (listen to web-radio and apply filters).
 
*Do web audio-streaming (listen to web-radio and apply filters).
Line 152: Line 160:
 
http://github.com/fredvs/uos/
 
http://github.com/fredvs/uos/
  
= Recording Sound =
+
== Recording Sound ==
  
== Native solutions ==
+
=== Native solutions ===
  
=== macOS ===
+
==== macOS ====
  
 
* [[macOS Audio Recorder|AVAudioRecorder]] allows you to make audio recordings straight to a file with very little programming overhead.
 
* [[macOS Audio Recorder|AVAudioRecorder]] allows you to make audio recordings straight to a file with very little programming overhead.
  
= Text-To-Speech =
+
=== Cross platform solutions ===
 +
 
 +
==== uos (United OpenLib of Sound) ====
 +
 
 +
'''uos''': United OpenLib of Sound. '''uos''' unifies the best open-source audio libraries.
 +
 
 +
With '''uos''' you can:
 +
*Record all types of input into a file.
 +
*Add DSP effects and filters, however many you want and record it.
 +
 
 +
'''uos''' can use the PortAudio, SndFile, Mpg123, Faad, Mp4ff, OpusFile audio libraries and SoundTouch, Bs2b plug-in library.
 +
 
 +
Included in the package:
 +
 
 +
* examples.
 +
* binary libraries for Linux 32/64, Windows 32/64, macOS 32/64, FreeBSD 32/64 and ARM Rpi.
 +
 
 +
http://github.com/fredvs/uos/
 +
 
 +
== MIDI ==
 +
 
 +
Musical Instrument Digital Interface (MIDI) is a technical standard that describes a communications protocol, digital interface, and electrical connectors that connect a wide variety of electronic musical instruments, computers, and related audio devices for playing, editing and recording music.
 +
 
 +
See the [[MIDI]] article for more details about the MIDI software aspect.
 +
 
 +
== Text-To-Speech ==
  
 
See [[Speech Synthesis]] for native and cross-platform solutions.
 
See [[Speech Synthesis]] for native and cross-platform solutions.
  
=See also=
+
== See also ==
  
 
* [[Audio libraries]]
 
* [[Audio libraries]]
 
* [[Video Playback Libraries]]
 
* [[Video Playback Libraries]]

Latest revision as of 07:50, 3 November 2021

Deutsch (de) English (en) 日本語 (ja) 한국어 (ko) русский (ru) 中文(中国大陆)‎ (zh_CN)

Playing Videos

The Video Playback Libraries page contains an annotated list of libraries for Windows, as well as any operating system which is supported by FFmpeg or by VLC. These libraries can be used to embed video playback in your applications.

Native solutions

macOS

  • AVPlayer - Native code for a customised video (and audio, particularly streaming audio) player.

Playing Sound

Native solutions

macOS

  • System Sound Services For up to 30 second sound clips, alerts etc.
  • AVAudioPlayer For longer audio files with volume control, pause, stop, resume, loop control, background music etc. Note: does not work with streaming audio.
  • AVPlayer For streaming audio.
  • macOS NSSound A very simple method for playing system sounds, application bundle sound files, other sound files with volume control, pause, stop, resume, loops etc.
  • OpenAL comes pre-installed on macOS (Deprecated at WWDC2019; to be removed in a future macOS release).

Windows

Windows API

You can use the Windows API to play e.g. wav files:

...
uses MMSystem;
...
sndPlaySound('C:\sounds\test.wav', snd_Async or snd_NoDefault);

The fail-safe way, which will allow appending paths and nonlatin file names is:

sndPlaySound(pchar(UTF8ToSys('C:\sounds\test.wav')), snd_Async or snd_NoDefault);
Audiere Library

Has bindings for Delphi, but they do not work with FPC:

Squall sound

Squall sound works fine with FPC. It has 3D audio and EAX effects, but just supports MP3, OGG and WAV formats. Open sourced in 2009 and appears dead. Windows only.

https://github.com/xtreme3d/squall

Cross Platform

ACS (Audio Component Suite)

For more information, read the article about the Audio Component Suite

Audorra Library

This library for Linux and Windows works well with Lazarus:

http://sourceforge.net/projects/audorra/

BASS

Closed source. Free for non-commercial.

The BASS library can be downloaded from: http://www.un4seen.com/ and http://www.un4seen.com/forum/?topic=8682.0

There is a DJ application, for Windows, Linux and macOS, written with Lazarus and using Bass lib: https://sites.google.com/site/fiensprototyping/

FMOD

FMOD Core comes with an elegant API compatible with C, C++, C#, and Javascript, and runs on all major platforms. It is a closed source solution. It is free for use for non-comercial software, but requires the payment of license fees for commercial software.

FPSound

FPSound is a new library being developed in the mold of fpspreadsheet and fpvectorial: it has independent modules to read, write and play sound files and also an intermediary representation for editing. See FPSound. Uses OpenAL. Appears dead and non-working.

OMEGA Engine

The OMEGA Engine is a full game engine in single Omega.dll file which is just 50kb. It can successfully play FLAC, OGG, MP3, MP2, AMR and WMA files. It searches and uses installed audio codecs from the system. Windows and Linux only.

http://sourceforge.net/projects/omega-engine/files/

The project is dead, but it is very easy to use:

Media_Play('Music.mp3', TRUE);

OpenAL Library

Light bulb  Note: The OpenAL Library Framework is pre-installed on all Apple computers running macOS -- see /System/Library/Frameworks/OpenAL.framework. Apple announced at WWD2019 that OpenAL is now deprecated and will be removed completely in a future release of macOS.

OpenAL is a cross-platform 3D audio API appropriate for use with gaming applications and many other types of audio applications.

The library models a collection of audio sources moving in a 3D space that are heard by a single listener somewhere in that space. The basic OpenAL objects are a Listener, a Source, and a Buffer. There can be a large number of Buffers, which contain audio data. Each buffer can be attached to one or more Sources, which represent points in 3D space which are emitting audio. There is always one Listener object (per audio context), which represents the position where the sources are heard -- rendering is done from the perspective of the Listener.

  • A tutorial for Delphi can be found here.
  • Free Pascal comes with a unit for accessing OpenAL located in fpc/packages/openal as well as usage examples.
  • There is an alternative OpenAL sound manager unit to play wav files by Lulu here. Tested on macOS Mojave 10.14.

Play Sound Package

The Play Sound Package takes a different approach to playing sound cross-platform. For Windows, it uses the native sound system; for Linux it searches the system for programs which will play sound and executes those asynchronously or synchronously via TProcess or TAsyncProcess. Note: only works with Windows and Linux.

PortAudio

Various bindings for PortAudio, a cross-platform, open source library for audio playback and recording, are available.

Forum user FredvS has written a Pascal unit that dynamically loads PortAudio.

Some examples can be found here.

SDL + SDL_mixer

The basic SDL library comes with a very simple sound system. On top of that, SDL mixer adds more sound APIs which build a more flexible solution.

Units for accessing SDL libraries are located in fpc/packages/sdl.

SFML/CSFML for FPC

Simple and Fast Multimedia Library aka SFML provides a simple interface to the various components of your PC, to ease the development of games and multimedia applications. It is composed of five modules: system, window, graphics, audio and network. With SFML, your application can compile and run out of the box on the most common operating systems: Windows, Linux, macOS and soon Android & iOS.

Pre-compiled SDKs for your favorite OS are available on the download page.

CSFML headers binding for FPC can be found at https://github.com/DJMaster/csfml-fpc

uos (United OpenLib of Sound)

uos: United OpenLib of Sound. uos unifies the best open-source audio libraries.

With uos you can:

  • Listen to mp3, ogg, wav, flac, m4a, opus, cd audio, ... audio files.
  • With 16, 32 or float 32 bit resolution.
  • Record all types of input into a file.
  • Add DSP effects and filters, however many you want and record it.
  • Do web audio-streaming (listen to web-radio and apply filters).
  • Listen to multiple inputs and outputs.
  • Produce sound with built-in synthesizer.

uos can use the PortAudio, SndFile, Mpg123, Faad, Mp4ff, OpusFile audio libraries and SoundTouch, Bs2b plug-in library.

Included in the package:

  • examples.
  • binary libraries for Linux 32/64, Windows 32/64, macOS 32/64, FreeBSD 32/64 and ARM Rpi.

It can play mp3, ogg, wav, flac, m4a, opus, cda files.

http://github.com/fredvs/uos/

Recording Sound

Native solutions

macOS

  • AVAudioRecorder allows you to make audio recordings straight to a file with very little programming overhead.

Cross platform solutions

uos (United OpenLib of Sound)

uos: United OpenLib of Sound. uos unifies the best open-source audio libraries.

With uos you can:

  • Record all types of input into a file.
  • Add DSP effects and filters, however many you want and record it.

uos can use the PortAudio, SndFile, Mpg123, Faad, Mp4ff, OpusFile audio libraries and SoundTouch, Bs2b plug-in library.

Included in the package:

  • examples.
  • binary libraries for Linux 32/64, Windows 32/64, macOS 32/64, FreeBSD 32/64 and ARM Rpi.

http://github.com/fredvs/uos/

MIDI

Musical Instrument Digital Interface (MIDI) is a technical standard that describes a communications protocol, digital interface, and electrical connectors that connect a wide variety of electronic musical instruments, computers, and related audio devices for playing, editing and recording music.

See the MIDI article for more details about the MIDI software aspect.

Text-To-Speech

See Speech Synthesis for native and cross-platform solutions.

See also