Method

FolderItem.OpenAsSound


Warning

This item was deprecated in version 2019r2. Please use Sound.Open as a replacement.

Description

Opens the FolderItem to be read and returns its contents as a sound object.

Notes

On macOS OpenAsSound recognizes sound formats that Core Audio can play.

On Windows WAVs, WMAs, MP3s, and MIDI files can be played, but only WAVs play with DirectSound (this allows individual pan and volume settings for each sound. You can also play multiple sounds simultaneously).

On Linux GStreamer, xine, or libsndfile is used (in that order if available). Nil is returned if the sound can't be read or isn't a sound file at all.

Sample code

This example loads a sound file called “hello.mp3” from the current directory (folder) into a Sound object and plays it.

Dim f As FolderItem
f = GetFolderItem("hello.mp3")

If f <> Nil And f.Exists Then
  Dim s As Sound
  s = f.OpenAsSound
  s.Play
End If

Compatibility

All project types on all supported operating systems.