mirror of
https://github.com/SFML/SFML.git
synced 2024-11-25 04:41:05 +08:00
Finished the SFML::Sound class
git-svn-id: https://sfml.svn.sourceforge.net/svnroot/sfml/branches/sfml2@1707 4e206d99-4929-0410-ac5d-dfc041789085
This commit is contained in:
groogy
parent
748f572201
commit
ce1ffbc687
@ -30,27 +30,232 @@ VALUE globalSoundClass;
|
||||
/* External classes */
|
||||
extern VALUE globalVector3Class;
|
||||
extern VALUE globalSoundSourceClass;
|
||||
extern VALUE globalSoundBufferClass;
|
||||
|
||||
static VALUE Sound_New( int argc, VALUE *args, VALUE self )
|
||||
static void Sound_Free( sf::Sound *anObject )
|
||||
{
|
||||
delete anObject;
|
||||
}
|
||||
|
||||
static VALUE Sound_Initialize( int argc, VALUE *args, VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
switch( argc )
|
||||
{
|
||||
case 5:
|
||||
{
|
||||
VALUE temp = Vector3_ForceType( args[4] );
|
||||
sf::Vector3f position;
|
||||
position.x = NUM2DBL( Vector3_GetX( temp ) );
|
||||
position.y = NUM2DBL( Vector3_GetY( temp ) );
|
||||
position.z = NUM2DBL( Vector3_GetZ( temp ) );
|
||||
object->SetPosition( position );
|
||||
}
|
||||
case 4:
|
||||
object->SetVolume( NUM2DBL( args[3] ) );
|
||||
case 3:
|
||||
object->SetPitch( NUM2DBL( args[2] ) );
|
||||
case 2:
|
||||
if( args[1] == Qtrue )
|
||||
{
|
||||
object->SetLoop( true );
|
||||
}
|
||||
else if( args[1] == Qfalse )
|
||||
{
|
||||
object->SetLoop( false );
|
||||
}
|
||||
else
|
||||
{
|
||||
VALIDATE_CLASS( args[1], rb_cTrueClass, "loop" );
|
||||
}
|
||||
case 1:
|
||||
{
|
||||
VALIDATE_CLASS( args[0], globalSoundBufferClass, "buffer" );
|
||||
sf::SoundBuffer *buffer = NULL;
|
||||
Data_Get_Struct( args[0], sf::SoundBuffer, buffer );
|
||||
object->SetBuffer( *buffer );
|
||||
rb_iv_set( self, "@__buffer_ref", args[0] );
|
||||
}
|
||||
case 0:
|
||||
break;
|
||||
}
|
||||
|
||||
return self;
|
||||
}
|
||||
|
||||
static VALUE Sound_Play( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
object->Play();
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_Pause( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
object->Pause();
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_Stop( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
object->Stop();
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_SetBuffer( VALUE self, VALUE aBuffer )
|
||||
{
|
||||
VALIDATE_CLASS( aBuffer, globalSoundBufferClass, "buffer" );
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
sf::SoundBuffer *buffer = NULL;
|
||||
Data_Get_Struct( aBuffer, sf::SoundBuffer, buffer );
|
||||
object->SetBuffer( *buffer );
|
||||
rb_iv_set( self, "@__buffer_ref", aBuffer );
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_SetLoop( VALUE self, VALUE aLoop )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
if( aLoop == Qtrue )
|
||||
{
|
||||
object->SetLoop( true );
|
||||
}
|
||||
else if( aLoop == Qfalse )
|
||||
{
|
||||
object->SetLoop( false );
|
||||
}
|
||||
else
|
||||
{
|
||||
VALIDATE_CLASS( aLoop, rb_cTrueClass, "loop" );
|
||||
}
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_SetPlayingOffset( VALUE self, VALUE aOffset )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
object->SetPlayingOffset( NUM2DBL( aOffset ) );
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_GetBuffer( VALUE self )
|
||||
{
|
||||
return rb_iv_get( self, "@__buffer_ref" );
|
||||
}
|
||||
|
||||
static VALUE Sound_GetLoop( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
if( object->GetLoop() == true )
|
||||
{
|
||||
return Qtrue;
|
||||
}
|
||||
else
|
||||
{
|
||||
return Qfalse;
|
||||
}
|
||||
}
|
||||
|
||||
static VALUE Sound_GetPlayingOffset( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
return rb_float_new( object->GetPlayingOffset() );
|
||||
}
|
||||
|
||||
static VALUE Sound_GetStatus( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
return INT2FIX( static_cast< int >( object->GetStatus() ) );
|
||||
}
|
||||
|
||||
static VALUE Sound_ResetBuffer( VALUE self )
|
||||
{
|
||||
sf::Sound *object = NULL;
|
||||
Data_Get_Struct( self, sf::Sound, object );
|
||||
object->ResetBuffer();
|
||||
return Qnil;
|
||||
}
|
||||
|
||||
static VALUE Sound_New( int argc, VALUE *args, VALUE aKlass )
|
||||
{
|
||||
sf::Sound *object = new sf::Sound();
|
||||
VALUE rbData = Data_Wrap_Struct( aKlass, 0, Sound_Free, object );
|
||||
rb_obj_call_init( rbData, argc, args );
|
||||
return rbData;
|
||||
}
|
||||
|
||||
void Init_Sound( void )
|
||||
{
|
||||
/* SFML namespace which contains the classes of this module. */
|
||||
VALUE sfml = rb_define_module( "SFML" );
|
||||
/* Base class defining a sound's properties.
|
||||
/* Regular sound that can be played in the audio environment.
|
||||
*
|
||||
* SFML::SoundSource is not meant to be used directly, it only serves as a common base for all audio objects that can
|
||||
* live in the audio environment.
|
||||
* SFML::Sound is the class to use to play sounds.
|
||||
*
|
||||
* It defines several properties for the sound: pitch, volume, position, attenuation, etc. All of them can be changed
|
||||
* at any time with no impact on performances.
|
||||
* It provides:
|
||||
*
|
||||
* - Control (play, pause, stop)
|
||||
* - Ability to modify output parameters in real-time (pitch, volume, ...)
|
||||
* - 3D spatial features (position, attenuation, ...).
|
||||
*
|
||||
* SFML::Sound is perfect for playing short sounds that can fit in memory and require no latency, like foot steps or
|
||||
* gun shots. For longer sounds, like background musics or long speeches, rather see sf::Music
|
||||
* (which is based on streaming).
|
||||
*
|
||||
* In order to work, a sound must be given a buffer of audio data to play. Audio data (samples) is stored in
|
||||
* sf::SoundBuffer, and attached to a sound with the SetBuffer() function. The buffer object attached to a sound
|
||||
* must remain alive as long as the sound uses it. Note that multiple sounds can use the same sound buffer at the
|
||||
* same time.
|
||||
*
|
||||
* Usage example:
|
||||
*
|
||||
* buffer = SFML::SoundBuffer.new
|
||||
* buffer.loadFromFile( "sound.wav" )
|
||||
*
|
||||
* sound = SFML::Sound.new
|
||||
* sound.setBuffer( buffer )
|
||||
* sound.play()
|
||||
*/
|
||||
globalSoundClass = rb_define_class_under( sfml, "Sound", globalSoundSourceClass );
|
||||
|
||||
// Class methods
|
||||
rb_define_singleton_method( globalSoundClass, "new", Sound_New, -1 );
|
||||
|
||||
// Instance methods
|
||||
rb_define_method( globalSoundClass, "initialize", Sound_Initialize, 0 );
|
||||
rb_define_method( globalSoundClass, "play", Sound_Play, 0 );
|
||||
rb_define_method( globalSoundClass, "pause", Sound_Pause, 0 );
|
||||
rb_define_method( globalSoundClass, "stop", Sound_Stop, 0 );
|
||||
rb_define_method( globalSoundClass, "setBuffer", Sound_SetBuffer, 1 );
|
||||
rb_define_method( globalSoundClass, "getBuffer", Sound_GetBuffer, 0 );
|
||||
rb_define_method( globalSoundClass, "setLoop", Sound_SetLoop, 1 );
|
||||
rb_define_method( globalSoundClass, "getLoop", Sound_GetLoop, 0 );
|
||||
rb_define_method( globalSoundClass, "setPlayingOffset", Sound_SetPlayingOffset, 1 );
|
||||
rb_define_method( globalSoundClass, "getPlayingOffset", Sound_GetPlayingOffset, 0 );
|
||||
rb_define_method( globalSoundClass, "getStatus", Sound_GetStatus, 0 );
|
||||
rb_define_method( globalSoundClass, "resetBuffer", Sound_ResetBuffer, 0 );
|
||||
|
||||
// Aliases
|
||||
rb_define_alias( globalSoundClass, "buffer=", "setBuffer" );
|
||||
rb_define_alias( globalSoundClass, "buffer", "getBuffer" );
|
||||
rb_define_alias( globalSoundClass, "loop=", "setLoop" );
|
||||
rb_define_alias( globalSoundClass, "loop", "getLoop" );
|
||||
rb_define_alias( globalSoundClass, "playingOffset=", "setPlayingOffset" );
|
||||
rb_define_alias( globalSoundClass, "playing_offset=", "setPlayingOffset" );
|
||||
rb_define_alias( globalSoundClass, "playingOffset", "getPlayingOffset" );
|
||||
rb_define_alias( globalSoundClass, "playing_offset", "getPlayingOffset" );
|
||||
rb_define_alias( globalSoundClass, "status", "getStatus" );
|
||||
rb_define_alias( globalSoundClass, "reset_buffer", "resetBuffer" );
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user