OOMusicController.m

Go to the documentation of this file.

/*
 
OOMusicController.m
 
 
Oolite
Copyright (C) 2004-2013 Giles C Williams and contributors
 
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301, USA.
 
*/
 
#import "OOMusicController.h"
#import "OOSound.h"
#import "OOCollectionExtractors.h"
#import "ResourceManager.h"
 
 
static id sSingleton = nil;
 
 
@interface OOMusicController (Private)
 
- (void) playiTunesPlaylist:(NSString *)playlistName;
- (void) pauseiTunes;
 
@end
 
 
 
// Values for _special
enum
{
    kSpecialNone,
    kSpecialTheme,
    kSpecialDocking,
    kSpecialDocked,
    kSpecialMission
};
 
 
@implementation OOMusicController
 
+ (OOMusicController *) sharedController
{
    if (sSingleton == nil)
    {
        sSingleton = [[self alloc] init];
    }
    
    return sSingleton;
}
+ (OOMusicController *) sharedController {…}
 
 
- (id) init
{
    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;
}
- (id) init {…}
 
 
- (void) playMusicNamed:(NSString *)name loop:(BOOL)loop
{
    [self playMusicNamed:name loop:loop gain:OO_DEFAULT_SOUNDSOURCE_GAIN];
}
- (void) playMusicNamed:(NSString *)name loop:(BOOL)loop {…}
 
 
- (void) playMusicNamed:(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];
        }
    }
}
- (void) playMusicNamed:(NSString *)name loop:(BOOL)loop gain:(float)gain {…}
 
 
- (void) playThemeMusic
{
    _special = kSpecialTheme;
    [self playMusicNamed:@"OoliteTheme.ogg" loop:YES];
}
- (void) playThemeMusic {…}
 
 
- (void) playDockingMusic
{
    _special = kSpecialDocking;
    
    if (_mode == kOOMusicITunes)
    {
        [self playiTunesPlaylist:@"Oolite-Docking"];
    }
    else
    {
        [self playMusicNamed:@"BlueDanube.ogg" loop:YES];
    }
}
- (void) playDockingMusic {…}
 
 
- (void) playDockedMusic
{
    _special = kSpecialDocked;
    
    if (_mode == kOOMusicITunes)
    {
        [self playiTunesPlaylist:@"Oolite-Docked"];
    }
    else
    {
        [self playMusicNamed:@"OoliteDocked.ogg" loop:NO];
    }
}
- (void) playDockedMusic {…}
 
 
- (void) setMissionMusic:(NSString *)missionMusicName
{
    [_missionMusic autorelease];
    _missionMusic = [missionMusicName copy];
}
- (void) setMissionMusic:(NSString *)missionMusicName {…}
 
 
- (void) playMissionMusic
{
    if (_missionMusic != nil)
    {
        _special = kSpecialMission;
        [self playMusicNamed:_missionMusic loop:NO];
    }
}
- (void) playMissionMusic {…}
 
 
// Stop without switching iTunes to in-flight music.
- (void) justStop
{
    [_current stop];
    [_current release];
    _current = nil;
    _special = kSpecialNone;
}
- (void) justStop {…}
 
 
- (void) stop
{
    [self justStop];
    
    if (_mode == kOOMusicITunes)
    {
        [self playiTunesPlaylist:@"Oolite-Inflight"];
    }
}
- (void) stop {…}
 
 
- (void) stopMusicNamed:(NSString *)name
{
    if ([name isEqual:[self playingMusic]])  [self stop];
}
- (void) stopMusicNamed:(NSString *)name {…}
 
 
- (void) stopThemeMusic
{
    if (_special == kSpecialTheme)
    {
        [self justStop];
        [self playDockedMusic];
    }
}
- (void) stopThemeMusic {…}
 
 
- (void) stopDockingMusic
{
    if (_special == kSpecialDocking)  [self stop];
}
- (void) stopDockingMusic {…}
 
 
- (void) stopMissionMusic
{
    if (_special == kSpecialMission)  [self stop];
}
- (void) stopMissionMusic {…}
 
 
- (void) toggleDockingMusic
{
    if (_mode != kOOMusicOn)  return;
    
    if (![self isPlaying])  [self playDockingMusic];
    else if (_special == kSpecialDocking)  [self stop];
}
- (void) toggleDockingMusic {…}
 
 
- (OOSoundSource *) soundSource
{
    return [_current musicSoundSource];
}
- (OOSoundSource *) soundSource {…}
 
 
- (NSString *) playingMusic
{
    return [_current name];
}
- (NSString *) playingMusic {…}
 
 
- (BOOL) isPlaying
{
    return [_current isPlaying];
}
- (BOOL) isPlaying {…}
 
 
- (OOMusicMode) mode
{
    return _mode;
}
- (OOMusicMode) mode {…}
 
 
- (void) setMode:(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"];
    }
}
- (void) setMode:(OOMusicMode)mode {…}
 
@end
 
 
 
@implementation OOMusicController (Singleton)
 
/*  Canonical singleton boilerplate.
    See Cocoa Fundamentals Guide: Creating a Singleton Instance.
    See also +sharedController above.
    
    NOTE: assumes single-threaded access.
*/
 
+ (id) allocWithZone:(NSZone *)inZone
{
    if (sSingleton == nil)
    {
        sSingleton = [super allocWithZone:inZone];
        return sSingleton;
    }
    return nil;
}
+ (id) allocWithZone:(NSZone *)inZone {…}
 
 
- (id) copyWithZone:(NSZone *)inZone
{
    return self;
}
- (id) copyWithZone:(NSZone *)inZone {…}
 
 
- (id) retain
{
    return self;
}
- (id) retain {…}
 
 
- (NSUInteger) retainCount
{
    return UINT_MAX;
}
- (NSUInteger) retainCount {…}
 
 
- (void) release
{}
- (void) release {…}
 
 
- (id) autorelease
{
    return self;
}
- (id) autorelease {…}
 
@end
 
 
@implementation OOMusicController (Private)
 
#if OOLITE_MAC_OS_X
- (void) playiTunesPlaylist:(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);
}
- (void) playiTunesPlaylist:(NSString *)playlistName {…}
 
 
- (void) pauseiTunes
{
    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]; 
}
- (void) pauseiTunes {…}
#else
- (void) playiTunesPlaylist:(NSString *)playlistName {}
- (void) pauseiTunes {}
#endif
 
@end