phoenix_title wx.adv.Sound

This class represents a short sound (loaded from Windows WAV file), that can be stored in memory and played.

Currently this class is implemented on Windows and Unix and can use either Open Sound System (OSS) or Simple DirectMedia Layer (SDL) under the latter. Notice that OSS is not provided any more by most, and maybe even all, Linux systems in 2017 and osspd (OSS Proxy Daemon) package typically needs to be installed to make it work.


class_hierarchy Class Hierarchy

Inheritance diagram for class Sound:

method_summary Methods Summary

__init__

Default constructor.

Create

Constructs a wave object from a file or resource.

CreateFromData

Create a sound object from data in a memory buffer in WAV format.

IsOk

Returns True if the object contains a successfully loaded file or resource, False otherwise.

Play

Plays the sound file.

PlaySound

Plays the sound file.

Stop

If a sound is played, this function stops it.

__bool__

__nonzero__


api Class API

class wx.adv.Sound(Object)

Possible constructors:

Sound()

Sound(fileName)

This class represents a short sound (loaded from Windows WAV file), that can be stored in memory and played.


Methods

__init__(self, *args, **kw)

overload Overloaded Implementations:



__init__ (self)

Default constructor.



__init__ (self, fileName)

Constructs a wave object from a file or, under Windows, from a Windows resource.

Call IsOk to determine whether this succeeded.

Parameters:

fileName (string) – The filename or Windows resource.





Create(self, fileName)

Constructs a wave object from a file or resource.

Parameters:

fileName (string) – The filename or Windows resource.

Return type:

bool

Returns:

True if the call was successful, False otherwise.



CreateFromData(self, data)

Create a sound object from data in a memory buffer in WAV format.

Return type:

bool



IsOk(self)

Returns True if the object contains a successfully loaded file or resource, False otherwise.

Return type:

bool



Play(self, flags=SOUND_ASYNC)

Plays the sound file.

If another sound is playing, it will be interrupted.

Returns True on success, False otherwise. Note that in general it is possible to delete the object which is being asynchronously played any time after calling this function and the sound would continue playing, however this currently doesn’t work under Windows for sound objects loaded from memory data.

The possible values for flags are:

  • wx.adv.SOUND_SYNC: Play will block and wait until the sound is replayed.

  • wx.adv.SOUND_ASYNC: Sound is played asynchronously, Play returns immediately.

  • SOUND_ASYNC|wxSOUND_LOOP: Sound is played asynchronously and loops until another sound is played, Stop is called or the program terminates.

The static form is shorthand for this code:

wx.adv.Sound(filename).Play(flags)
Parameters:

flags

Return type:

bool



static PlaySound(filename, flags=SOUND_ASYNC)

Plays the sound file.

If another sound is playing, it will be interrupted.

Returns True on success, False otherwise. Note that in general it is possible to delete the object which is being asynchronously played any time after calling this function and the sound would continue playing, however this currently doesn’t work under Windows for sound objects loaded from memory data.

The possible values for flags are:

  • wx.adv.SOUND_SYNC: Play will block and wait until the sound is replayed.

  • wx.adv.SOUND_ASYNC: Sound is played asynchronously, Play returns immediately.

  • SOUND_ASYNC|wxSOUND_LOOP: Sound is played asynchronously and loops until another sound is played, Stop is called or the program terminates.

The static form is shorthand for this code:

wx.adv.Sound(filename).Play(flags)
Parameters:
  • filename (string) –

  • flags

Return type:

bool



static Stop()

If a sound is played, this function stops it.



__bool__(self)
Return type:

int



__nonzero__(self)
Return type:

int