OOSound Class Reference

#include <OOALSound.h>

Inheritance diagram for OOSound:

Collaboration diagram for OOSound:

Instance Methods
(id)	- initWithContentsOfFile:
(NSString *)	- name
(ALuint)	- soundBuffer
(BOOL)	- soundIncomplete
(void)	- rewind
(id)	- init [implementation]
(id)	- initWithDecoder: [implementation]
(id)	- initWithCustomSoundKey:
(jsval)	- oo_jsValueInContext: [implementation]
(NSString *)	- oo_jsDescription [implementation]
(NSString *)	- oo_jsClassName [implementation]

Class Methods
(BOOL)	+ setUp
(void)	+ update
(void)	+ setMasterVolume:
(float)	+ masterVolume
(BOOL)	+ isSoundOK
(id)	+ soundWithCustomSoundKey:

Detailed Description

Definition at line 30 of file OOALSound.h.

Method Documentation

init

- (id) init

implementation

Definition at line 90 of file OOALSound.m.

{
    if (!sIsSetUp)  [OOSound setUp];
    return [super init];
}

References init, setUp, and sIsSetUp.

Referenced by init, OOMusic::initWithContentsOfFile:, OOALBufferedSound::initWithDecoder:, and OOALStreamedSound::initWithDecoder:.

Here is the call graph for this function:

Here is the caller graph for this function:

initWithContentsOfFile:

- (id) initWithContentsOfFile:

(NSString *)

path

Reimplemented in OOMusic.

Definition at line 97 of file OOALSound.m.

                             :(NSString *)path
{
    if (!sIsSoundOK)  return nil;
    
    [self release];
    if (!sIsSetUp && ![OOSound setUp])  return nil;
 
    OOALSoundDecoder        *decoder;
 
    decoder = [[OOALSoundDecoder alloc] initWithPath:path];
    if (nil == decoder) return nil;
    
    if ([decoder sizeAsBuffer] <= kMaxBufferedSoundSize)
    {
        self = [[OOALBufferedSound alloc] initWithDecoder:decoder];
    }
    else
    {
        self = [[OOALStreamedSound alloc] initWithDecoder:decoder];
    }
    [decoder release];
    
    if (nil != self)
    {
        #ifndef NDEBUG
            OOLog(kOOLogSoundLoadingSuccess, @"Loaded sound %@", path);
        #endif
    }
    else
    {
        OOLog(kOOLogSoundLoadingError, @"Failed to load sound \"%@\"", path);
    }
    
    return self;
 
 
}

References kMaxBufferedSoundSize, kOOLogSoundLoadingError, kOOLogSoundLoadingSuccess, nil, OOLog, setUp, sIsSetUp, and sIsSoundOK.

Here is the call graph for this function:

initWithCustomSoundKey:

- (id) initWithCustomSoundKey:

(NSString *)

key

Provided by category OOSound(OOCustomSounds).

Definition at line 11063 of file Universe.m.

                             :(NSString *)key
{
    [self release];
    return [[OOSound soundWithCustomSoundKey:key] retain];
}

initWithDecoder:

- (id) initWithDecoder: (OOALSoundDecoder *) inDecoder

implementation

Reimplemented in OOALBufferedSound, and OOALStreamedSound.

Definition at line 135 of file OOALSound.m.

                     :(OOALSoundDecoder *)inDecoder
{
    [self release];
    return nil;
}

References nil.

isSoundOK

+ (BOOL) isSoundOK

Definition at line 156 of file OOALSound.m.

{
  return sIsSoundOK;
}

References isSoundOK, and sIsSoundOK.

Referenced by OOALBufferedSound::initWithDecoder:, OOALStreamedSound::initWithDecoder:, and isSoundOK.

Here is the call graph for this function:

Here is the caller graph for this function:

masterVolume

+ (float) masterVolume

Definition at line 80 of file OOALSound.m.

{
    if (!sIsSetUp && ![self setUp] )
        return 0.0;
 
    OOOpenALController *controller = [OOOpenALController sharedController];
    return [controller masterVolume];
}

References masterVolume, OOOpenALController::masterVolume, setUp, OOOpenALController::sharedController, and sIsSetUp.

Referenced by PlayerEntity(OOControlsPrivate)::handleGameOptionsScreenKeys, Universe::initWithGameView:, masterVolume, PlayerEntity::setGuiToGameOptionsScreen, setMasterVolume:, and Universe::startSpeakingString:.

Here is the call graph for this function:

Here is the caller graph for this function:

name

- (NSString *) name

Reimplemented in OOALBufferedSound, OOALStreamedSound, and OOMusic.

Definition at line 142 of file OOALSound.m.

{
    OOLogGenericSubclassResponsibility();
    return @"";
}

References name, and OOLogGenericSubclassResponsibility.

Referenced by OOMusic::name, name, and OOSound(OOJavaScriptExtentions)::oo_jsDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

oo_jsClassName

- (NSString *) oo_jsClassName

implementation

Provided by category OOSound(OOJavaScriptExtentions).

Definition at line 311 of file OOJSSound.m.

{
    return @"Sound";
}

oo_jsDescription

- (NSString *) oo_jsDescription

implementation

Provided by category OOSound(OOJavaScriptExtentions).

Definition at line 305 of file OOJSSound.m.

{
    return [NSString stringWithFormat:@"[Sound \"%@\"]", [self name]];
}

oo_jsValueInContext:

- (jsval) oo_jsValueInContext: (JSContext *) context

implementation

Provided by category OOSound(OOJavaScriptExtentions).

Definition at line 289 of file OOJSSound.m.

                             :(JSContext *)context
{
    JSObject                    *jsSelf = NULL;
    jsval                       result = JSVAL_NULL;
    
    jsSelf = JS_NewObject(context, &sSoundClass, sSoundPrototype, NULL);
    if (jsSelf != NULL)
    {
        if (!JS_SetPrivate(context, jsSelf, [self retain]))  jsSelf = NULL;
    }
    if (jsSelf != NULL)  result = OBJECT_TO_JSVAL(jsSelf);
    
    return result;
}

rewind

- (void) rewind

Reimplemented in OOALStreamedSound.

Definition at line 175 of file OOALSound.m.

{
    // doesn't need to do anything on seekable FDs
}

References rewind.

Referenced by OOSoundChannel::playSound:looped:, rewind, and OOSoundChannel::update.

Here is the call graph for this function:

Here is the caller graph for this function:

setMasterVolume:

+ (void) setMasterVolume:

(float)

fraction

Definition at line 64 of file OOALSound.m.

                        :(float) fraction
{
    if (!sIsSetUp && ![self setUp])
        return;
    
    fraction = OOClamp_0_1_f(fraction);
 
    OOOpenALController *controller = [OOOpenALController sharedController];
    if (fraction != [controller masterVolume])
    {
        [controller setMasterVolume:fraction];
        [[NSUserDefaults standardUserDefaults] setFloat:[controller masterVolume] forKey:KEY_VOLUME_CONTROL];
    }
}

References masterVolume, OOOpenALController::masterVolume, OOOpenALController::setMasterVolume:, setUp, OOOpenALController::sharedController, and sIsSetUp.

Referenced by PlayerEntity(OOControlsPrivate)::handleGameOptionsScreenKeys, and setUp.

Here is the call graph for this function:

Here is the caller graph for this function:

setUp

+ (BOOL) setUp

Definition at line 46 of file OOALSound.m.

{
    if (!sIsSetUp)
    {
        sIsSetUp = YES;
        OOOpenALController* controller = [OOOpenALController sharedController];
        if (controller != nil)
        {
            sIsSoundOK = YES;
            float volume = [[NSUserDefaults standardUserDefaults] oo_floatForKey:KEY_VOLUME_CONTROL defaultValue:0.5];
            [self setMasterVolume:volume];
        }
    }
    
    return sIsSoundOK;
}

References nil, setMasterVolume:, setUp, OOOpenALController::sharedController, sIsSetUp, and sIsSoundOK.

Referenced by MyOpenGLView::init, init, initWithContentsOfFile:, OOALBufferedSound::initWithDecoder:, OOALStreamedSound::initWithDecoder:, masterVolume, setMasterVolume:, and setUp.

Here is the call graph for this function:

Here is the caller graph for this function:

soundBuffer

- (ALuint) soundBuffer

Reimplemented in OOALBufferedSound, and OOALStreamedSound.

Definition at line 162 of file OOALSound.m.

{
    OOLogGenericSubclassResponsibility();
    return 0;
}

References OOLogGenericSubclassResponsibility, and soundBuffer.

Referenced by OOSoundChannel(Private)::enqueueBuffer:, and soundBuffer.

Here is the call graph for this function:

Here is the caller graph for this function:

soundIncomplete

- (BOOL) soundIncomplete

Reimplemented in OOALStreamedSound.

Definition at line 169 of file OOALSound.m.

{
    return NO;
}

References soundIncomplete.

Referenced by soundIncomplete.

Here is the call graph for this function:

Here is the caller graph for this function:

soundWithCustomSoundKey:

+ (id) soundWithCustomSoundKey:

(NSString *)

key

Provided by category OOSound(OOCustomSounds).

Definition at line 11055 of file Universe.m.

                              :(NSString *)key
{
    NSString *fileName = [UNIVERSE soundNameForCustomSoundKey:key];
    if (fileName == nil)  return nil;
    return [ResourceManager ooSoundNamed:fileName inFolder:@"Sounds"];
}

Referenced by GetNamedSound(), OOSound(OOCustomSounds)::initWithCustomSoundKey:, OOSoundSource(OOCustomSounds)::initWithCustomSoundKey:, OOSoundSource(OOCustomSounds)::playCustomSoundWithKey:, PlayerEntity(Sound)::playInterfaceBeep:, and OOSoundSourcePool::playSoundWithKey:priority:expiryTime:overlap:position:.

Here is the caller graph for this function:

update

+ (void) update

Definition at line 149 of file OOALSound.m.

{
    OOSoundMixer * mixer = [OOSoundMixer sharedMixer];
    if( sIsSoundOK && mixer)
        [mixer update];
}

References OOSoundMixer::sharedMixer, sIsSoundOK, update, and OOSoundMixer::update.

Referenced by GameController(OOPrivate)::doPerformGameTick, and update.

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• src/Core/OOALSound.h
• src/Core/OOALSound.m