Difference between revisions of "Multimedia Programming"

From Lazarus wiki
Jump to navigationJump to search
(Re-organised into native and cross-platform; updated and expanded)
(Fix heading levels; relocate MIDI content to MIDI page; add link to MIDI page)
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Multimedia Programming}}
 
{{Multimedia Programming}}
  
=Playing Videos=
+
== Playing Videos ==
  
Several [[Video_Playback_Libraries|Libraries]] exist for embedding video playback into 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.
  
==MPlayer==
+
== Playing Sound ==
  
'''mplayer''' is an open source and free movie player. It is available for Linux gtk2/X, FreeBSD, macOS and Windows.
+
=== Native solutions ===
  
As part of Lazarus-CCR, there is an LCL control [[TMPlayerControl]] embedding the mplayer, so you can build your own movie players or just play a video in your application. You can download the source here:
+
==== macOS ====
 
 
<pre>
 
svn checkout svn://svn.code.sf.net/p/lazarus-ccr/svn/components/mplayer mplayer
 
</pre>
 
 
 
=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.
* [[#OpenAL_Library|OpenAL]] comes pre-installed on macOS.
+
* [[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 (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 43: Line 34:
 
</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 49: Line 40:
 
* 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 55: Line 46:
 
https://github.com/xtreme3d/squall
 
https://github.com/xtreme3d/squall
  
 +
=== Cross Platform ===
  
==Cross Platform==
+
==== ACS (Audio Component Suite) ====
 
 
===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 works well with Lazarus:  
+
This library for Linux and Windows works well with Lazarus:  
  
 
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 75: Line 67:
 
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 95: Line 87:
 
</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 111: Line 103:
 
* 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]] take a different route to paying sound cross-platform. It searches the system for programs which will play sound and executes those asynchronously or synchronously via [[TProcess]] or [[TSsyncProcess]].
 
  
===PortAudio===
+
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.
  
Various bindings for [http://www.portaudio.com/ PortAudio], a cross-platform, open source library for audio playback and recording are available.
+
==== PortAudio ====
  
See [[http://wiki.lazarus.freepascal.org/Multimedia_Programming#Playing_Sounds]] for some versions.
+
Various bindings for [http://www.portaudio.com/ 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: [http://lazarus.freepascal.org/index.php/topic,17521.0.html]
+
Forum user FredvS has written a [http://lazarus.freepascal.org/index.php/topic,17521.0.html Pascal unit] that dynamically loads PortAudio.
  
Some examples can be found here: [http://breakoutbox.de/pascal/pascal.html#PortAudio]
+
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 131: Line 121:
 
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 139: Line 129:
 
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 146: Line 136:
 
*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 155: Line 145:
  
 
Included in the package:
 
Included in the package:
 +
 
* examples.
 
* examples.
 
* binary libraries for Linux 32/64, Windows 32/64, macOS 32/64, FreeBSD 32/64 and ARM Rpi.
 
* binary libraries for Linux 32/64, Windows 32/64, macOS 32/64, FreeBSD 32/64 and ARM Rpi.
Line 162: Line 153:
 
http://github.com/fredvs/uos/
 
http://github.com/fredvs/uos/
  
= Text-To-Speech =
+
== Recording Sound ==
 +
 
 +
=== Native solutions ===
 +
 
 +
==== macOS ====
 +
 
 +
* [[macOS Audio Recorder|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 [[Speech Synthesis]] for native and cross-platform solutions.
  
=See also=
+
== See also ==
  
 
* [[Audio libraries]]
 
* [[Audio libraries]]
 
* [[Video Playback Libraries]]
 
* [[Video Playback Libraries]]
 
[[Category:Multimedia]]
 
[[Category:Audio]]
 
[[Category:Video]]
 

Revision as of 02:38, 2 August 2020

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.

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.
  • 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