OODebugController.m

Go to the documentation of this file.

/*
 
OODebugController.m
 
 
Oolite Debug Bundle
 
Copyright (C) 2007-2010 Jens Ayton
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
 
*/
 
#import "OODebugController.h"
#import "OODebugMonitor.h"
#import "OOMacDebugger.h"
 
#import "ResourceManager.h"
 
#import "OOGraphicsResetManager.h"
#import "OOTexture.h"
#import "OOLoggingExtended.h"
#import "Universe.h"
#import "OOOpenGL.h"
#import "OOCacheManager.h"
#import "PlayerEntity.h"
#import "OOCollectionExtractors.h"
#import "OOLogOutputHandler.h"
#import "OOJavaScriptEngine.h"
#import "OODebugInspector.h"
#import "OOEntityInspectorExtensions.h"
#import "OOConstToString.h"
#import "OODebugFlags.h"
#import "OOOpenGLExtensionManager.h"
#import "OOConstToString.h"
 
 
static OODebugController *sSingleton = nil;
 
 
@interface OODebugController ()
 
- (void)insertDebugMenu;
- (void)setUpLogMessageClassMenu;
 
@end
 
 
@implementation OODebugController
 
- (id <OODebuggerInterface>) setUpDebugger
{
    return [[[OOMacDebugger alloc] initWithController:jsConsoleController] autorelease];
}
- (id <OODebuggerInterface>) setUpDebugger {…}
 
 
- (id)init
{
    NSString                    *nibPath = nil;
    
    self = [super init];
    if (self != nil)
    {
        _bundle = [[NSBundle bundleForClass:[self class]] retain];
        
        nibPath = [self pathForResource:@"OODebugController" ofType:@"nib"];
        if (nibPath == nil)
        {
            OOLog(@"debugSupport.load.failed", @"Could not find OODebugController.nib.");
            [self release];
            self = nil;
        }
        else
        {
            [NSBundle loadNibFile:nibPath externalNameTable:[NSDictionary dictionaryWithObject:self forKey:@"NSOwner"] withZone:NULL];
            
            [self insertDebugMenu];
            [self setUpLogMessageClassMenu];
            OOLog(@"debugSupport.load.success", @"Debug Bundle loaded successfully.");
        }
    }
    
    return self;
}
- (id)init {…}
 
 
- (void)dealloc
{
    if (sSingleton == self)  sSingleton = nil;
    
    [menu release];
    [logMessageClassPanel release];
    [logPrefsWindow release];
    [createShipPanel release];
    [jsConsoleController release];
    
    [_bundle release];
    
    [super dealloc];
}
- (void)dealloc {…}
 
 
+ (id)sharedDebugController
{
    // NOTE: assumes single-threaded first access. See header.
    if (sSingleton == nil)  sSingleton = [[self alloc] init];
    return sSingleton;
}
+ (id)sharedDebugController {…}
 
 
- (NSBundle *)bundle
{
    return _bundle;
}
- (NSBundle *)bundle {…}
 
 
- (NSString *)pathForResource:(NSString *)name ofType:(NSString *)type
{
    return [[self bundle] pathForResource:name ofType:type];
}
- (NSString *)pathForResource:(NSString *)name ofType:(NSString *)type {…}
 
 
- (void)awakeFromNib
{
    [logPrefsWindow center];
}
- (void)awakeFromNib {…}
 
 
#pragma mark -
 
- (IBAction)showLogAction:sender
{
    [[NSWorkspace sharedWorkspace] openFile:OOLogHandlerGetLogPath()];
}
- (IBAction)showLogAction:sender {…}
 
 
- (IBAction)graphicsResetAction:sender
{
    [[OOGraphicsResetManager sharedManager] resetGraphicsState];
}
- (IBAction)graphicsResetAction:sender {…}
 
 
- (IBAction)clearTextureCacheAction:sender
{
    [OOTexture clearCache];
}
- (IBAction)clearTextureCacheAction:sender {…}
 
 
- (IBAction)resetAndClearAction:sender
{
    [OOTexture clearCache];
    [[OOGraphicsResetManager sharedManager] resetGraphicsState];
}
- (IBAction)resetAndClearAction:sender {…}
 
 
- (IBAction)dumpEntityListAction:sender
{
    BOOL                        wasEnabled;
    
    wasEnabled = OOLogWillDisplayMessagesInClass(@"universe.objectDump");
    OOLogSetDisplayMessagesInClass(@"universe.objectDump", YES);
    
    [UNIVERSE debugDumpEntities];
    
    OOLogSetDisplayMessagesInClass(@"universe.objectDump", wasEnabled);
}
- (IBAction)dumpEntityListAction:sender {…}
 
 
- (IBAction)dumpPlayerStateAction:sender
{
    [[PlayerEntity sharedPlayer] dumpState];
}
- (IBAction)dumpPlayerStateAction:sender {…}
 
 
- (IBAction)createShipAction:sender
{
    NSString                    *role = nil;
    
    role = [[NSUserDefaults standardUserDefaults] stringForKey:@"debug-create-ship-panel-last-role"];
    if (role != nil)
    {
        [createShipPanelTextField setStringValue:role];
    }
    
    [NSApp runModalForWindow:createShipPanel];
    [createShipPanel orderOut:self];
}
- (IBAction)createShipAction:sender {…}
 
 
- (IBAction)clearAllCachesAction:sender
{
    [[OOCacheManager sharedCache] clearAllCaches];
}
- (IBAction)clearAllCachesAction:sender {…}
 
 
- (IBAction)toggleWireframeModeAction:sender
{
    [UNIVERSE setWireframeGraphics:![UNIVERSE wireframeGraphics]];
}
- (IBAction)toggleWireframeModeAction:sender {…}
 
 
- (IBAction) hideShowHUD:sender
{
    BOOL hidden = [[[PlayerEntity sharedPlayer] hud] isHidden];
    NSString *command = [NSString stringWithFormat:@"player.ship.hudHidden = %@", hidden ? @"false" : @"true"];
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:command];
}
- (IBAction) hideShowHUD:sender {…}
 
 
- (IBAction) inspectPlayer:sender
{
    //  [[PlayerEntity sharedPlayer] inspect];
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:@"player.ship.inspect()"];
}
- (IBAction) inspectPlayer:sender {…}
 
 
- (IBAction) inspectTarget:sender
{
    //  [[[PlayerEntity sharedPlayer] primaryTarget] inspect];
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:@"player.ship.target.inspect()"];
}
- (IBAction) inspectTarget:sender {…}
 
 
- (IBAction) cleanUpInspectors:sender
{
    [OODebugInspector cleanUpInspectors];
}
- (IBAction) cleanUpInspectors:sender {…}
 
 
static void SetDisplayLogMessagesInClassThroughJS(NSString *msgClass, BOOL display)
{
    NSString *command = [NSString stringWithFormat:@"console.setDisplayMessagesInClass(\"%@\", %@)", [msgClass escapedForJavaScriptLiteral], display ? @"true" : @"false"];
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:command];
}
static void SetDisplayLogMessagesInClassThroughJS(NSString *msgClass, BOOL display) {…}
 
 
- (IBAction)toggleThisLogMessageClassAction:sender
{
    NSString                    *msgClass = nil;
    
    if ([sender respondsToSelector:@selector(representedObject)])
    {
        msgClass = [sender representedObject];
        SetDisplayLogMessagesInClassThroughJS(msgClass, !OOLogWillDisplayMessagesInClass(msgClass));
    }
}
- (IBAction)toggleThisLogMessageClassAction:sender {…}
 
 
- (IBAction)otherLogMessageClassAction:sender
{
    [NSApp runModalForWindow:logMessageClassPanel];
    [logMessageClassPanel orderOut:self];
}
- (IBAction)otherLogMessageClassAction:sender {…}
 
 
- (IBAction)logMsgClassPanelEnableAction:sender
{
    NSString                    *msgClass = nil;
    
    msgClass = [logMsgClassPanelTextField stringValue];
    if ([msgClass length] != 0)  SetDisplayLogMessagesInClassThroughJS(msgClass, YES);
    
    [NSApp stopModal];
}
- (IBAction)logMsgClassPanelEnableAction:sender {…}
 
 
- (IBAction)logMsgClassPanelDisableAction:sender
{
    NSString                    *msgClass = nil;
    
    msgClass = [logMsgClassPanelTextField stringValue];
    if ([msgClass length] != 0)  SetDisplayLogMessagesInClassThroughJS(msgClass, NO);
    
    [NSApp stopModal];
}
- (IBAction)logMsgClassPanelDisableAction:sender {…}
 
 
- (IBAction)toggleThisDebugFlagAction:sender
{
    NSUInteger                  tag, bits;
    NSString                    *command = nil;
    
    tag = [sender tag];
    bits = gDebugFlags & tag;
    
    if (bits != tag)
    {
        // Flags are off or mixed.
        command = [NSString stringWithFormat:@"console.debugFlags |= 0x%lX", tag];
    }
    else
    {
        // Flags are all on.
        command = [NSString stringWithFormat:@"console.debugFlags &= ~0x%.lX", tag];
    }
    
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:command];
}
- (IBAction)toggleThisDebugFlagAction:sender {…}
 
 
- (IBAction) setShaderModeToTag:(NSMenuItem *)sender
{
    OOGraphicsDetail detail = (OOGraphicsDetail)sender.tag;
    NSString *detailString = [OOStringFromGraphicsDetail(detail) escapedForJavaScriptLiteral];
    NSString *command = [NSString stringWithFormat:@"console.detailLevel = \"%@\"", detailString];
    
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:command];
}
- (IBAction) setShaderModeToTag:(NSMenuItem *)sender {…}
 
 
- (IBAction)showLogPreferencesAction:sender
{
    [logShowFunctionCheckBox setState:OOLogShowFunction()];
    [logShowFileAndLineCheckBox setState:OOLogShowFileAndLine()];
    [logShowMessageClassCheckBox setState:OOLogShowMessageClass()];
    [logShowTimeStampCheckBox setState:OOLogShowTime()];
    
    [logPrefsWindow makeKeyAndOrderFront:self];
}
- (IBAction)showLogPreferencesAction:sender {…}
 
 
- (IBAction)logSetShowFunctionAction:sender
{
    OOLogSetShowFunction([sender state]);
}
- (IBAction)logSetShowFunctionAction:sender {…}
 
 
- (IBAction)logSetShowFileAndLineAction:sender
{
    OOLogSetShowFileAndLine([sender state]);
}
- (IBAction)logSetShowFileAndLineAction:sender {…}
 
 
- (IBAction)logSetShowMessageClassAction:sender
{
    OOLogSetShowMessageClass([sender state]);
}
- (IBAction)logSetShowMessageClassAction:sender {…}
 
 
- (IBAction) logSetShowTimeStampAction:sender
{
    OOLogSetShowTime([sender state]);
}
- (IBAction) logSetShowTimeStampAction:sender {…}
 
 
- (IBAction)insertLogSeparatorAction:sender
{
    [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:@"console.writeLogMarker()"];
}
- (IBAction)insertLogSeparatorAction:sender {…}
 
 
- (IBAction)createShipPanelOKAction:sender
{
    NSString                    *shipRole = nil;
    
    shipRole = [createShipPanelTextField stringValue];
    if ([shipRole length] != 0)
    {
        [self performSelector:@selector(spawnShip:) withObject:shipRole afterDelay:0.1];
        [[NSUserDefaults standardUserDefaults] setObject:shipRole forKey:@"debug-create-ship-panel-last-role"];
    }
    
    [NSApp stopModal]; 
}
- (IBAction)createShipPanelOKAction:sender {…}
 
 
- (void)spawnShip:(NSString *)shipRole
{
    NSString                    *command = nil;
    
    if (shipRole == nil)  return;
    
    if ([[OODebugMonitor sharedDebugMonitor] debuggerConnected])
    {
        command = [NSString stringWithFormat:@"this.T = system.addShips('%@', 1, player.ship.position, 10000); if (this.T) this.T = this.T[0]; else consoleMessage('command-error', 'Could not spawn \"%@\".');", [shipRole escapedForJavaScriptLiteral], [shipRole escapedForJavaScriptLiteral]];
        [[OODebugMonitor sharedDebugMonitor] performJSConsoleCommand:command];
    }
    else
    {
        [UNIVERSE addShipWithRole:shipRole nearRouteOneAt:1.0];
    }
}
- (void)spawnShip:(NSString *)shipRole {…}
 
 
- (IBAction)modalPanelCancelAction:sender
{
    [NSApp stopModal];
}
- (IBAction)modalPanelCancelAction:sender {…}
 
 
#pragma mark -
 
- (BOOL)validateMenuItem:(NSMenuItem *)menuItem
{
    SEL                         action = NULL;
    NSString                    *msgClass = nil;
    NSUInteger                  tag, bits;
    int                         state;
    
    action = [menuItem action];
    
    if (action == @selector(toggleThisLogMessageClassAction:))
    {
        msgClass = [menuItem representedObject];
        [menuItem setState:OOLogWillDisplayMessagesInClass(msgClass)];
        return YES;
    }
    if (action == @selector(toggleThisDebugFlagAction:))
    {
        tag = [menuItem tag];
        bits = gDebugFlags & tag;
        if (bits == 0)  state = NSOffState;
        else if (bits == tag)  state = NSOnState;
        else state = NSMixedState;
        
        [menuItem setState:state];
        return YES;
    }
    if (action == @selector(toggleWireframeModeAction:))
    {
        [menuItem setState:!![UNIVERSE wireframeGraphics]];     
        return YES;
    }
    if (action == @selector(inspectTarget:))
    {
        return [[PlayerEntity sharedPlayer] primaryTarget] != nil;
    }
    if (action == @selector(hideShowHUD:))
    {
        BOOL hidden = [[[PlayerEntity sharedPlayer] hud] isHidden];
        [menuItem setTitle:hidden ? @"Show HUD" : @"Hide HUD"];
        return YES;
    }
    if (action == @selector(setShaderModeToTag:))
    {
        OOGraphicsDetail itemLevel = (OOGraphicsDetail)menuItem.tag;
        
        menuItem.state = (UNIVERSE.detailLevel == itemLevel);
        return itemLevel <= OOOpenGLExtensionManager.sharedManager.maximumDetailLevel;
    }
    
    return [self respondsToSelector:action];
}
- (BOOL)validateMenuItem:(NSMenuItem *)menuItem {…}
 
 
- (void)insertDebugMenu
{
    NSMenuItem                  *item = nil;
    NSInteger                   index;
    
    [menu setTitle:@"Debug"];
    item = [[NSMenuItem alloc] initWithTitle:@"Debug" action:NULL keyEquivalent:@""];
    [item setSubmenu:menu];
    [[NSApp mainMenu] addItem:item];
    [item release];
    
    if (![[NSUserDefaults standardUserDefaults] boolForKey:@"debug-show-extra-menu-items"])
    {
        // Old school and not elegant, but it removes the compiler warning 
        // on possible misuse of comma operator [-Wcomma], 
        // produced by the following statement 
        // while (index = [menu indexOfItemWithTag:-42], index != -1)
        // Bracketing the operands with parenthesis, doesn't help either.
        index = [menu indexOfItemWithTag:-42];
        while (index != -1)
        {
            [menu removeItemAtIndex:index];
            index = [menu indexOfItemWithTag:-42];
        }
    }
}
- (void)insertDebugMenu {…}
 
 
- (void)setUpLogMessageClassMenu
{
    NSArray                     *definitions = nil;
    NSUInteger                  i, count, inserted = 0;
    NSString                    *title = nil, *key = nil;
    NSMenuItem                  *item = nil;
    
    definitions = [ResourceManager arrayFromFilesNamed:@"debugLogMessageClassesMenu.plist" inFolder:@"Config" andMerge:YES];
    count = [definitions count] / 2;
    
    for (i = 0; i != count; ++i)
    {
        title = [definitions oo_stringAtIndex:i * 2];
        key = [definitions oo_stringAtIndex:i * 2 + 1];
        if (title == nil || key == nil)  continue;
        
        item = [[NSMenuItem alloc] initWithTitle:title
                                          action:@selector(toggleThisLogMessageClassAction:)
                                   keyEquivalent:@""];
        [item setTarget:self];
        [item setRepresentedObject:key];
        
        [logMessageClassSubMenu insertItem:item atIndex:inserted++];
        [item release];
    }
}
- (void)setUpLogMessageClassMenu {…}
 
@end
 
 
@implementation OODebugController (Singleton)
 
/*  Canonical singleton boilerplate.
    See Cocoa Fundamentals Guide: Creating a Singleton Instance.
    See also +sharedDebugController above.
*/
 
+ (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