OOMusicController Class Reference

#include <OOMusicController.h>

Inheritance diagram for OOMusicController:

Collaboration diagram for OOMusicController:

Instance Methods
(void)	- playMusicNamed:loop:
(void)	- playMusicNamed:loop:gain:
(void)	- playThemeMusic
(void)	- playDockingMusic
(void)	- playDockedMusic
(void)	- setMissionMusic:
(void)	- playMissionMusic
(void)	- justStop
(void)	- stop
(void)	- stopMusicNamed:
(void)	- stopThemeMusic
(void)	- stopDockingMusic
(void)	- stopMissionMusic
(void)	- toggleDockingMusic
(OOSoundSource *)	- soundSource
(NSString *)	- playingMusic
(BOOL)	- isPlaying
(OOMusicMode)	- mode
(void)	- setMode:
(id)	- init [implementation]
(void)	- playiTunesPlaylist: [implementation]
(void)	- pauseiTunes [implementation]
(id)	- copyWithZone: [implementation]
(id)	- retain [implementation]
(NSUInteger)	- retainCount [implementation]
(void)	- release [implementation]
(id)	- autorelease [implementation]

Class Methods
(OOMusicController *)	+ sharedController
(id)	+ allocWithZone: [implementation]

Private Attributes
OOMusicMode	_mode
NSString *	_missionMusic
OOMusic *	_current
uint8_t	_special

Detailed Description

Definition at line 51 of file OOMusicController.h.

Method Documentation

allocWithZone:

+ (id) allocWithZone: (NSZone *)  inZone

implementation

Provided by category OOMusicController(Singleton).

Definition at line 32 of file OOMusicController.m.

                    :(NSZone *)inZone
{
    if (sSingleton == nil)
    {
        sSingleton = [super allocWithZone:inZone];
        return sSingleton;
    }
    return nil;
}

autorelease

- (id) autorelease

implementation

Provided by category OOMusicController(Singleton).

Definition at line 32 of file OOMusicController.m.

{
    return self;
}

copyWithZone:

- (id) copyWithZone: (NSZone *)  inZone

implementation

Provided by category OOMusicController(Singleton).

Definition at line 32 of file OOMusicController.m.

                   :(NSZone *)inZone
{
    return self;
}

init

- (id) init

implementation

Definition at line 32 of file OOMusicController.m.

{
    self = [super init];
    if (self != nil)
    {
        NSString *modeString = [[NSUserDefaults standardUserDefaults] stringForKey:@"music mode"];
        if ([modeString isEqualToString:@"off"])  _mode = kOOMusicOff;
        else if ([modeString isEqualToString:@"iTunes"])  _mode = kOOMusicITunes;
        else  _mode = kOOMusicOn;
        
        // Handle unlikely case of taking prefs from iTunes-enabled system to other.
        if (_mode > kOOMusicModeMax)  _mode = kOOMusicModeMax;
        
        [self setMissionMusic:@"OoliteTheme.ogg"];
    }
    
    return self;
}

isPlaying

- (BOOL) isPlaying

Definition at line 32 of file OOMusicController.m.

{
    return [_current isPlaying];
}

Referenced by PlayerEntity(OOControlsPrivate)::handleAutopilotOn:.

Here is the caller graph for this function:

justStop

- (void) justStop

Definition at line 32 of file OOMusicController.m.

{
    [_current stop];
    [_current release];
    _current = nil;
    _special = kSpecialNone;
}

mode

- (OOMusicMode) mode

Definition at line 32 of file OOMusicController.m.

{
    return _mode;
}

pauseiTunes

- (void) pauseiTunes

implementation

Provided by category OOMusicController(Private).

Definition at line 32 of file OOMusicController.m.

{
    NSString *ootunesScriptString = [NSString stringWithFormat:@"try\nignoring application responses\ntell application \"iTunes\" to pause\nend ignoring\nend try"];
    NSAppleScript *ootunesScript = [[NSAppleScript alloc] initWithSource:ootunesScriptString];
    NSDictionary *errDict = nil;
    [ootunesScript executeAndReturnError:&errDict];
    if (errDict)
        OOLog(@"sound.music.iTunesIntegration.failed", @"ootunes returned :%@", errDict);
    [ootunesScript release]; 
}

playDockedMusic

- (void) playDockedMusic

Definition at line 32 of file OOMusicController.m.

{
    _special = kSpecialDocked;
    
    if (_mode == kOOMusicITunes)
    {
        [self playiTunesPlaylist:@"Oolite-Docked"];
    }
    else
    {
        [self playMusicNamed:@"OoliteDocked.ogg" loop:NO];
    }
}

playDockingMusic

- (void) playDockingMusic

Definition at line 32 of file OOMusicController.m.

{
    _special = kSpecialDocking;
    
    if (_mode == kOOMusicITunes)
    {
        [self playiTunesPlaylist:@"Oolite-Docking"];
    }
    else
    {
        [self playMusicNamed:@"BlueDanube.ogg" loop:YES];
    }
}

playingMusic

- (NSString *) playingMusic

Definition at line 32 of file OOMusicController.m.

{
    return [_current name];
}

Referenced by OOSound(OOJavaScriptExtentions)::oo_jsClassName.

Here is the caller graph for this function:

playiTunesPlaylist:

- (void) playiTunesPlaylist: (NSString *)  playlistName

implementation

Provided by category OOMusicController(Private).

Definition at line 32 of file OOMusicController.m.

                           :(NSString *)playlistName
{
    NSString *ootunesScriptString =
        [NSString stringWithFormat:
        @"with timeout of 1 second\n"
         "    tell application \"iTunes\"\n"
         "        copy playlist \"%@\" to thePlaylist\n"
         "        if thePlaylist exists then\n"
         "            play some track of thePlaylist\n"
         "        end if\n"
         "    end tell\n"
         "end timeout",
         playlistName];
    
    NSAppleScript *ootunesScript = [[[NSAppleScript alloc] initWithSource:ootunesScriptString] autorelease];
    NSDictionary *errDict = nil;
    
    [ootunesScript executeAndReturnError:&errDict];
    if (errDict)
        OOLog(@"sound.music.iTunesIntegration.failed", @"ootunes returned :%@", errDict);
}

playMissionMusic

- (void) playMissionMusic

Definition at line 32 of file OOMusicController.m.

{
    if (_missionMusic != nil)
    {
        _special = kSpecialMission;
        [self playMusicNamed:_missionMusic loop:NO];
    }
}

playMusicNamed:loop:

- (void) playMusicNamed:		(NSString *)	name
loop:		(BOOL)	loop

Definition at line 32 of file OOMusicController.m.

                       :(NSString *)name loop:(BOOL)loop
{
    [self playMusicNamed:name loop:loop gain:OO_DEFAULT_SOUNDSOURCE_GAIN];
}

playMusicNamed:loop:gain:

- (void) playMusicNamed:		(NSString *)	name
loop:		(BOOL)	loop
gain:		(float)	gain

Definition at line 32 of file OOMusicController.m.

                       :(NSString *)name loop:(BOOL)loop gain:(float)gain
{
    if ([self isPlaying] && [name isEqual:[self playingMusic]])  return;
    
    if (_mode == kOOMusicOn || (_mode == kOOMusicITunes && [name isEqualToString:@"OoliteTheme.ogg"]))
    {
        OOMusic *music = [ResourceManager ooMusicNamed:name inFolder:@"Music"];
        if (music != nil)
        {
            [_current stop];
            
            [music setMusicGain:OOClamp_0_1_f(gain)];
            [music playLooped:loop];
            
            [_current release];
            _current = [music retain];
        }
    }
}

Referenced by SoundStaticPlayMusic().

Here is the caller graph for this function:

playThemeMusic

- (void) playThemeMusic

Definition at line 32 of file OOMusicController.m.

{
    _special = kSpecialTheme;
    [self playMusicNamed:@"OoliteTheme.ogg" loop:YES];
}

release

- (void) release

implementation

Provided by category OOMusicController(Singleton).

Definition at line 32 of file OOMusicController.m.

{}

retain

- (id) retain

implementation

Provided by category OOMusicController(Singleton).

Definition at line 32 of file OOMusicController.m.

{
    return self;
}

retainCount

- (NSUInteger) retainCount

implementation

Provided by category OOMusicController(Singleton).

Definition at line 32 of file OOMusicController.m.

{
    return UINT_MAX;
}

setMissionMusic:

- (void) setMissionMusic:

(NSString *)

missionMusicName

Definition at line 32 of file OOMusicController.m.

                        :(NSString *)missionMusicName
{
    [_missionMusic autorelease];
    _missionMusic = [missionMusicName copy];
}

Referenced by MissionRunScreen().

Here is the caller graph for this function:

setMode:

- (void) setMode:

(OOMusicMode)

mode

Definition at line 32 of file OOMusicController.m.

                :(OOMusicMode)mode
{
    if (mode <= kOOMusicModeMax && _mode != mode)
    {
        if (_mode == kOOMusicITunes) [self pauseiTunes];
        _mode = mode;
        
        if (_mode == kOOMusicOff)  [self stop];
        else switch (_special)
        {
            case kSpecialNone:
                [self stop];
                break;
                
            case kSpecialTheme:
                [self playThemeMusic];
                break;
                
            case kSpecialDocked:
                [self playDockedMusic];
                break;
                
            case kSpecialDocking:
                [self playDockingMusic];
                break;
                
            case kSpecialMission:
                [self playMissionMusic];
                break;
        }
        
        NSString *modeString = nil;
        switch (_mode)
        {
            case kOOMusicOff:       modeString = @"off"; break;
            case kOOMusicOn:        modeString = @"on"; break;
            case kOOMusicITunes:    modeString = @"iTunes"; break;
        }
        [[NSUserDefaults standardUserDefaults] setObject:modeString forKey:@"music mode"];
    }
}

sharedController

+ (OOMusicController *) sharedController

Definition at line 32 of file OOMusicController.m.

{
    if (sSingleton == nil)
    {
        sSingleton = [[self alloc] init];
    }
    
    return sSingleton;
}

Referenced by PlayerEntity(OOControlsPrivate)::handleAutopilotOn:, MissionRunScreen(), OOSound(OOJavaScriptExtentions)::oo_jsClassName, SoundStaticMusicSoundSource(), and SoundStaticPlayMusic().

Here is the caller graph for this function:

soundSource

- (OOSoundSource *) soundSource

Definition at line 32 of file OOMusicController.m.

{
    return [_current musicSoundSource];
}

Referenced by SoundStaticMusicSoundSource().

Here is the caller graph for this function:

stop

- (void) stop

Definition at line 32 of file OOMusicController.m.

{
    [self justStop];
    
    if (_mode == kOOMusicITunes)
    {
        [self playiTunesPlaylist:@"Oolite-Inflight"];
    }
}

Referenced by OOSound(OOJavaScriptExtentions)::oo_jsClassName.

Here is the caller graph for this function:

stopDockingMusic

- (void) stopDockingMusic

Definition at line 32 of file OOMusicController.m.

{
    if (_special == kSpecialDocking)  [self stop];
}

stopMissionMusic

- (void) stopMissionMusic

Definition at line 32 of file OOMusicController.m.

{
    if (_special == kSpecialMission)  [self stop];
}

stopMusicNamed:

- (void) stopMusicNamed:

(NSString *)

name

Definition at line 32 of file OOMusicController.m.

                       :(NSString *)name
{
    if ([name isEqual:[self playingMusic]])  [self stop];
}

stopThemeMusic

- (void) stopThemeMusic

Definition at line 32 of file OOMusicController.m.

{
    if (_special == kSpecialTheme)
    {
        [self justStop];
        [self playDockedMusic];
    }
}

toggleDockingMusic

- (void) toggleDockingMusic

Definition at line 32 of file OOMusicController.m.

{
    if (_mode != kOOMusicOn)  return;
    
    if (![self isPlaying])  [self playDockingMusic];
    else if (_special == kSpecialDocking)  [self stop];
}

Referenced by PlayerEntity(OOControlsPrivate)::handleAutopilotOn:.

Here is the caller graph for this function:

Member Data Documentation

_current

- (OOMusic*) _current

private

Definition at line 56 of file OOMusicController.h.

_missionMusic

- (NSString*) _missionMusic

private

Definition at line 55 of file OOMusicController.h.

_mode

- (OOMusicMode) _mode

private

Definition at line 54 of file OOMusicController.h.

_special

- (uint8_t) _special

private

Definition at line 57 of file OOMusicController.h.

---

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

• src/Core/OOMusicController.h
• src/Core/OOMusicController.m