documentation.HELP! SFML v1.6 Documentation

SFML - Simple and Fast Multimedia Library

SFML v1.6

previous page next page

sf::Sound Class Reference

Sound defines the properties of a sound such as position, volume, pitch, etc. More...

#include <Sound.hpp>

Inheritance diagram for sf::Sound:

List of all members.

Public Types
enum	Status {   Stopped,   Paused,   Playing }
	Enumeration of the sound states. More...
Public Member Functions
	Sound ()
	Default constructor.
	Sound (const SoundBuffer &Buffer, bool Loop=false, float Pitch=1.f, float Volume=100.f, const Vector3f &Position=Vector3f(0, 0, 0))
	Construct the sound from its parameters.
	Sound (const Sound &Copy)
	Copy constructor.
	~Sound ()
	Destructor.
void	Play ()
	Play the sound.
void	Pause ()
	Pause the sound.
void	Stop ()
	Stop the sound.
void	SetBuffer (const SoundBuffer &Buffer)
	Set the source buffer.
void	SetLoop (bool Loop)
	Set the sound loop state.
void	SetPitch (float Pitch)
	Set the sound pitch.
void	SetVolume (float Volume)
	Set the sound volume.
void	SetPosition (float X, float Y, float Z)
	Set the sound position (take 3 values).
void	SetPosition (const Vector3f &Position)
	Set the sound position (take a 3D vector).
void	SetRelativeToListener (bool Relative)
	Make the sound's position relative to the listener's position, or absolute.
void	SetMinDistance (float MinDistance)
	Set the minimum distance - closer than this distance, the listener will hear the sound at its maximum volume.
void	SetAttenuation (float Attenuation)
	Set the attenuation factor - the higher the attenuation, the more the sound will be attenuated with distance from listener.
void	SetPlayingOffset (float TimeOffset)
	Set the current playing position of the sound.
const SoundBuffer *	GetBuffer () const
	Get the source buffer.
bool	GetLoop () const
	Tell whether or not the sound is looping.
float	GetPitch () const
	Get the pitch.
float	GetVolume () const
	Get the volume.
Vector3f	GetPosition () const
	Get the sound position.
bool	IsRelativeToListener () const
	Tell if the sound's position is relative to the listener's position, or if it's absolute.
float	GetMinDistance () const
	Get the minimum distance.
float	GetAttenuation () const
	Get the attenuation factor.
Status	GetStatus () const
	Get the status of the sound (stopped, paused, playing).
float	GetPlayingOffset () const
	Get the current playing position of the sound.
Sound &	operator= (const Sound &Other)
	Assignment operator.
void	ResetBuffer ()
	Reset the internal buffer.
Friends
class	SoundStream

---

Detailed Description

Sound defines the properties of a sound such as position, volume, pitch, etc.

Definition at line 45 of file Sound.hpp.

---

Member Enumeration Documentation

enum sf::Sound::Status

Enumeration of the sound states.

Enumerator:

Stopped	Sound is not playing.
Paused	Sound is paused.
Playing	Sound is playing.

Definition at line 52 of file Sound.hpp.

---

Constructor & Destructor Documentation

sf::Sound::Sound

(

)

Default constructor.

Definition at line 38 of file Sound.cpp.

sf::Sound::Sound	(	const SoundBuffer &	Buffer,
		bool	Loop = false,
		float	Pitch = 1.f,
		float	Volume = 100.f,
		const Vector3f &	Position = Vector3f(0, 0, 0)
	)			[explicit]

Construct the sound from its parameters.

Parameters:

	Buffer	: Sound buffer to play (NULL by default)
	Loop	: Loop flag (false by default)
	Pitch	: Value of the pitch (1 by default)
	Volume	: Volume (100 by default)
	Position	: Position (0, 0, 0 by default)

Definition at line 48 of file Sound.cpp.

sf::Sound::Sound

(

const Sound &

Copy

)

Copy constructor.

Parameters:

Copy

: Instance to copy

Definition at line 64 of file Sound.cpp.

sf::Sound::~Sound

(

)

Destructor.

Definition at line 85 of file Sound.cpp.

---

Member Function Documentation

float sf::Sound::GetAttenuation

(

)

const

Get the attenuation factor.

Returns:

Attenuation factor of the sound

Definition at line 319 of file Sound.cpp.

const SoundBuffer * sf::Sound::GetBuffer

(

)

const

Get the source buffer.

Returns:

Sound buffer bound to the sound (can be NULL)

Definition at line 237 of file Sound.cpp.

bool sf::Sound::GetLoop

(

)

const

Tell whether or not the sound is looping.

Returns:

True if the sound is looping, false otherwise

Reimplemented in sf::SoundStream.

Definition at line 246 of file Sound.cpp.

float sf::Sound::GetMinDistance

(

)

const

Get the minimum distance.

Returns:

Minimum distance for the sound

Definition at line 307 of file Sound.cpp.

float sf::Sound::GetPitch

(

)

const

Get the pitch.

Returns:

Pitch value

Definition at line 258 of file Sound.cpp.

float sf::Sound::GetPlayingOffset

(

)

const

Get the current playing position of the sound.

Returns:

Current playing position, expressed in seconds

Reimplemented in sf::SoundStream.

Definition at line 331 of file Sound.cpp.

Vector3f sf::Sound::GetPosition

(

)

const

Get the sound position.

Returns:

Position of the sound in the world

Definition at line 282 of file Sound.cpp.

Sound::Status sf::Sound::GetStatus

(

)

const

Get the status of the sound (stopped, paused, playing).

Returns:

Current status of the sound

Reimplemented in sf::SoundStream.

Definition at line 343 of file Sound.cpp.

float sf::Sound::GetVolume

(

)

const

Get the volume.

Returns:

Volume value (in range [1, 100])

Definition at line 270 of file Sound.cpp.

bool sf::Sound::IsRelativeToListener

(

)

const

Tell if the sound's position is relative to the listener's position, or if it's absolute.

Tell if the sound's position is relative to the listener's position, or if it's absolute.

Returns:

True if the position is relative, false if it's absolute

Definition at line 295 of file Sound.cpp.

Sound & sf::Sound::operator=

(

const Sound &

Other

)

Assignment operator.

Parameters:

Other

: Instance to assign

Returns:

Reference to the sound

Definition at line 363 of file Sound.cpp.

void sf::Sound::Pause

(

)

Pause the sound.

Definition at line 112 of file Sound.cpp.

void sf::Sound::Play

(

)

Play the sound.

Reimplemented in sf::SoundStream.

Definition at line 103 of file Sound.cpp.

void sf::Sound::ResetBuffer

(

)

Reset the internal buffer.

This function is for internal use only, you don't have to use it.

Definition at line 394 of file Sound.cpp.

void sf::Sound::SetAttenuation

(

float

Attenuation

)

Set the attenuation factor - the higher the attenuation, the more the sound will be attenuated with distance from listener.

Set the attenuation factor - the higher the attenuation, the more the sound will be attenuated with distance from listener.

The default attenuation factor 1.0

Parameters:

Attenuation

: New attenuation factor for the sound

The default attenuation factor 1.0

Definition at line 219 of file Sound.cpp.

void sf::Sound::SetBuffer

(

const SoundBuffer &

Buffer

)

Set the source buffer.

Parameters:

Buffer

: New sound buffer to bind to the sound

Definition at line 130 of file Sound.cpp.

void sf::Sound::SetLoop

(

bool

Loop

)

Set the sound loop state.

This parameter is disabled by default

Parameters:

Loop

: True to play in loop, false to play once

Reimplemented in sf::SoundStream.

Definition at line 149 of file Sound.cpp.

void sf::Sound::SetMinDistance

(

float

MinDistance

)

Set the minimum distance - closer than this distance, the listener will hear the sound at its maximum volume.

Set the minimum distance - closer than this distance, the listener will hear the sound at its maximum volume.

The default minimum distance is 1.0

Parameters:

MinDistance

: New minimum distance for the sound

The default minimum distance is 1.0

Definition at line 208 of file Sound.cpp.

void sf::Sound::SetPitch

(

float

Pitch

)

Set the sound pitch.

The default pitch is 1

Parameters:

Pitch

: New pitch

Definition at line 158 of file Sound.cpp.

void sf::Sound::SetPlayingOffset

(

float

TimeOffset

)

Set the current playing position of the sound.

Parameters:

TimeOffset

: New playing position, expressed in seconds

Definition at line 228 of file Sound.cpp.

void sf::Sound::SetPosition

(

const Vector3f &

Position

)

Set the sound position (take a 3D vector).

The default position is (0, 0, 0)

Parameters:

Position

: Position of the sound in the world

The default position is (0, 0, 0)

Definition at line 186 of file Sound.cpp.

void sf::Sound::SetPosition	(	float	X,
		float	Y,
		float	Z
	)

Set the sound position (take 3 values).

The default position is (0, 0, 0)

Parameters:

X,Y,Z

: Position of the sound in the world

The default position is (0, 0, 0)

Definition at line 176 of file Sound.cpp.

void sf::Sound::SetRelativeToListener

(

bool

Relative

)

Make the sound's position relative to the listener's position, or absolute.

Make the sound's position relative to the listener's position, or absolute.

The default value is false (absolute)

Parameters:

Relative

: True to set the position relative, false to set it absolute

The default value is false (absolute)

Definition at line 197 of file Sound.cpp.

void sf::Sound::SetVolume

(

float

Volume

)

Set the sound volume.

The default volume is 100

Parameters:

Volume

: Volume (in range [0, 100])

Definition at line 167 of file Sound.cpp.

void sf::Sound::Stop

(

)

Stop the sound.

Reimplemented in sf::SoundStream.

Definition at line 121 of file Sound.cpp.

---

The documentation for this class was generated from the following files:

• Sound.hpp
• Sound.cpp

 ::  Copyright © 2007-2008 Laurent Gomila, all rights reserved  ::  Documentation generated by doxygen 1.5.2  :: 

previous page start next page

Menu

• Homepage

Table of contents

• Main Page
• Class List
  • sf::AudioResource
  • sf::Clock
  • sf::Color
  • sf::Context
  • sf::Drawable
  • sf::Event
  • sf::Event::Event::JoyButtonEvent
  • sf::Event::Event::JoyMoveEvent
  • sf::Event::Event::KeyEvent
  • sf::Event::Event::MouseButtonEvent
  • sf::Event::Event::MouseMoveEvent
  • sf::Event::Event::MouseWheelEvent
  • sf::Event::Event::SizeEvent
  • sf::Event::Event::TextEvent
  • sf::Font
  • sf::Ftp
  • sf::Ftp::Ftp::DirectoryResponse
  • sf::Ftp::Ftp::ListingResponse
  • sf::Ftp::Ftp::Response
  • sf::Glyph
  • sf::Http
  • sf::Http::Http::Request
  • sf::Http::Http::Response
  • sf::Image
  • sf::Input
  • sf::IPAddress
  • sf::Listener
  • sf::Lock
  • sf::Matrix3
  • sf::Music
  • sf::Mutex
  • sf::NonCopyable
  • sf::Packet
  • sf::PostFX
  • sf::Randomizer
  • sf::Rect< T >
  • sf::RenderTarget
  • sf::RenderWindow
  • sf::Resource< T >
  • sf::ResourcePtr< T >
  • sf::Selector< Type >
  • sf::SelectorBase
  • sf::Shape
  • sf::SocketHelper
  • sf::SocketTCP
  • sf::SocketUDP
  • sf::Sound
  • sf::SoundBuffer
  • sf::SoundBufferRecorder
  • sf::SoundRecorder
  • sf::SoundStream
  • sf::SoundStream::SoundStream::Chunk
  • sf::Sprite
  • sf::String
  • sf::Thread
  • sf::Unicode
  • sf::Unicode::Unicode::Text
  • sf::Vector2< T >
  • sf::Vector3< T >
  • sf::VideoMode
  • sf::View
  • sf::Window
  • sf::WindowListener
  • sf::WindowSettings
• Class Hierarchy
  • sf::AudioResource
    • sf::Sound
      • sf::SoundStream
        • sf::Music
    • sf::SoundBuffer
  • sf::Clock
  • sf::Color
  • sf::Drawable
    • sf::PostFX
    • sf::Shape
    • sf::Sprite
    • sf::String
  • sf::Event
  • sf::Event::Event::JoyButtonEvent
  • sf::Event::Event::JoyMoveEvent
  • sf::Event::Event::KeyEvent
  • sf::Event::Event::MouseButtonEvent
  • sf::Event::Event::MouseMoveEvent
  • sf::Event::Event::MouseWheelEvent
  • sf::Event::Event::SizeEvent
  • sf::Event::Event::TextEvent
  • sf::Ftp::Ftp::Response
    • sf::Ftp::Ftp::DirectoryResponse
    • sf::Ftp::Ftp::ListingResponse
  • sf::Glyph
  • sf::Http::Http::Request
  • sf::Http::Http::Response
  • sf::IPAddress
  • sf::Listener
  • sf::Matrix3
  • sf::NonCopyable
    • sf::Context
    • sf::Ftp
    • sf::Http
    • sf::Input
    • sf::Lock
    • sf::Mutex
    • sf::Thread
      • sf::SoundRecorder
        • sf::SoundBufferRecorder
      • sf::SoundStream
    • sf::Window
      • sf::RenderWindow
  • sf::Packet
  • sf::Randomizer
  • sf::Rect< T >
  • sf::RenderTarget
    • sf::RenderWindow
  • sf::Resource< T >
  • sf::Resource< Font >
    • sf::Font
  • sf::Resource< Image >
    • sf::Image
  • sf::Resource< SoundBuffer >
    • sf::SoundBuffer
  • sf::ResourcePtr< T >
  • sf::SelectorBase
    • sf::Selector< Type >
  • sf::SocketHelper
  • sf::SocketTCP
  • sf::SocketUDP
  • sf::SoundStream::SoundStream::Chunk
  • sf::Unicode
  • sf::Unicode::Unicode::Text
  • sf::Vector2< T >
  • sf::Vector3< T >
  • sf::VideoMode
  • sf::View
  • sf::WindowListener
    • sf::Input
    • sf::Window
  • sf::WindowSettings
• Class Members
• Namespace List
  • sf::Blend
  • sf::Joy
  • sf::Key
  • sf::Mouse
  • sf::Style
• Namespace Members
• File List
  • Arial.hpp
  • Audio.hpp
  • AudioDevice.cpp
  • AudioDevice.hpp
  • AudioResource.cpp
  • AudioResource.hpp
  • Clock.cpp
  • Clock.hpp
  • Color.cpp
  • Color.hpp
  • Config.hpp
  • Context.cpp
  • Context.hpp
  • Doxygen.hpp
  • Drawable.cpp
  • Drawable.hpp
  • Event.hpp
  • Font.cpp
  • Font.hpp
  • FontLoader.cpp
  • FontLoader.hpp
  • Ftp.cpp
  • Ftp.hpp
  • Glyph.hpp
  • Graphics.hpp
  • GraphicsContext.cpp
  • GraphicsContext.hpp
  • Http.cpp
  • Http.hpp
  • Image.cpp
  • Image.hpp
  • ImageLoader.cpp
  • ImageLoader.hpp
  • Input.cpp
  • Input.hpp
  • IPAddress.cpp
  • IPAddress.hpp
  • Cocoa/Joystick.cpp
  • Template for new ports/Joystick.cpp
  • Win32/Joystick.cpp
  • Cocoa/Joystick.hpp
  • Joystick.hpp
  • Template for new ports/Joystick.hpp
  • Win32/Joystick.hpp
  • Listener.cpp
  • Listener.hpp
  • Lock.cpp
  • Lock.hpp
  • Matrix3.cpp
  • Matrix3.hpp
  • Matrix3.inl
  • Music.cpp
  • Music.hpp
  • Mutex.cpp
  • Mutex.hpp
  • Win32/Mutex.hpp
  • Network.hpp
  • NonCopyable.hpp
  • OpenAL.hpp
  • OpenGL.hpp
  • Packet.cpp
  • Packet.hpp
  • Platform.cpp
  • Platform.hpp
  • Win32/Platform.hpp
  • PostFX.cpp
  • PostFX.hpp
  • Randomizer.cpp
  • Randomizer.hpp
  • Rect.hpp
  • Rect.inl
  • RenderTarget.cpp
  • RenderTarget.hpp
  • RenderWindow.cpp
  • RenderWindow.hpp
  • Resource.hpp
  • Resource.inl
  • ResourcePtr.inl
  • Selector.hpp
  • Selector.inl
  • SelectorBase.cpp
  • SelectorBase.hpp
  • SFML_Main.cpp
  • Shape.cpp
  • Shape.hpp
  • Sleep.cpp
  • Sleep.hpp
  • SocketHelper.cpp
  • SocketHelper.hpp
  • Win32/SocketHelper.hpp
  • Sockets.hpp
  • SocketTCP.cpp
  • SocketTCP.hpp
  • SocketUDP.cpp
  • SocketUDP.hpp
  • Sound.cpp
  • Sound.hpp
  • SoundBuffer.cpp
  • SoundBuffer.hpp
  • SoundBufferRecorder.cpp
  • SoundBufferRecorder.hpp
  • SoundFile.cpp
  • SoundFile.hpp
  • SoundFileDefault.cpp
  • SoundFileDefault.hpp
  • SoundFileOgg.cpp
  • SoundFileOgg.hpp
  • SoundRecorder.cpp
  • SoundRecorder.hpp
  • SoundStream.cpp
  • SoundStream.hpp
  • Sprite.cpp
  • Sprite.hpp
  • String.cpp
  • String.hpp
  • System.hpp
  • Thread.cpp
  • Thread.hpp
  • Win32/Thread.hpp
  • Unicode.cpp
  • Unicode.hpp
  • Unicode.inl
  • Vector2.hpp
  • Vector2.inl
  • Vector3.hpp
  • Vector3.inl
  • VideoMode.cpp
  • VideoMode.hpp
  • Cocoa/VideoModeSupport.cpp
  • Template for new ports/VideoModeSupport.cpp
  • Win32/VideoModeSupport.cpp
  • Cocoa/VideoModeSupport.hpp
  • Template for new ports/VideoModeSupport.hpp
  • VideoModeSupport.hpp
  • Win32/VideoModeSupport.hpp
  • View.cpp
  • View.hpp
  • Window.cpp
  • Window/Window.hpp
  • Window.hpp
  • WindowHandle.hpp
  • WindowImpl.cpp
  • WindowImpl.hpp
  • WindowImplCocoa.hpp
  • WindowImplWin32.cpp
  • WindowImplWin32.hpp
  • WindowImplXXX.cpp
  • WindowImplXXX.hpp
  • WindowListener.hpp
  • WindowSettings.hpp
  • WindowStyle.hpp

Get in touch

Submit feedback about this site to:

• [email protected]

© documentation.help. Design: rehmann.co.