All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

load-sound Function

Summary

Converts data to a loaded sound object on Microsoft Windows and Cocoa.

Package

capi

Signature

load-sound source &key owner => sound

Arguments
source
A pathname designator or an array returned by read-sound-file.
owner
A CAPI interface, or nil.
Values
sound
An array of element type (unsigned-byte 8).
Description

The function load-sound converts source into a loaded sound which can be played by play-sound.

source can be a pathname designator or an array returned by read-sound-file.

owner should be a CAPI interface object, or nil which means that the sound's owner is the current top level interface.

The loaded sound sound will be unloaded (freed) automatically when its owner is destroyed. To create a sound that is never unloaded, pass the screen as the argument owner.

Notes
  1. The array sound contains the contents of the file. Its bytes are interpreted by the OS functions, so the format can be whatever they can deal with, for example WAV on Microsoft Windows. The fact that this date is represented as an (unsigned-byte 8) array in Lisp does not constrain the output size.
  2. load-sound is not implemented on GTK+ and Motif.
See also

free-sound
play-sound
read-sound-file
18.2 Sounds


CAPI User Guide and Reference Manual (Unix version) - 01 Dec 2021 19:32:42