OOJoystickManager Class Reference

#include <OOJoystickManager.h>

Inheritance diagram for OOJoystickManager:

Collaboration diagram for OOJoystickManager:

Instance Methods
(id)	- init
(NSPoint)	- rollPitchAxis
(NSPoint)	- viewAxis
(void)	- setFunction:withDict:
(void)	- unsetAxisFunction:
(void)	- unsetButtonFunction:
(NSUInteger)	- joystickCount
(BOOL)	- isButtonDown:stick:
(BOOL)	- getButtonState:
(double)	- getAxisState:
(double)	- getSensitivity
(void)	- setProfile:forAxis:
(OOJoystickAxisProfile *)	- getProfileForAxis:
(void)	- saveProfileForAxis:
(void)	- loadProfileForAxis:
(const BOOL *)	- getAllButtonStates
(NSArray *)	- listSticks
(NSDictionary *)	- axisFunctions
(NSDictionary *)	- buttonFunctions
(void)	- setCallback:object:hardware:
(void)	- clearCallback
(void)	- setDefaultMapping
(void)	- clearMappings
(void)	- clearStickStates
(void)	- clearStickButtonState:
(void)	- decodeAxisEvent:
(void)	- decodeButtonEvent:
(void)	- decodeHatEvent:
(void)	- saveStickSettings
(void)	- loadStickSettings
(NSString *)	- nameOfJoystick:
(int16_t)	- getAxisWithStick:axis:
(void)	- setFunctionForAxis:function:stick: [implementation]
(void)	- setFunctionForButton:function:stick: [implementation]

Class Methods
(id)	+ sharedStickHandler
(BOOL)	+ setStickHandlerClass:

Private Attributes
int8_t	axismap [MAX_STICKS][MAX_AXES]
int8_t	buttonmap [MAX_STICKS][MAX_BUTTONS]
BOOL	true_butstate [MAX_STICKS][MAX_BUTTONS]
double	axstate [AXIS_end]
BOOL	butstate [BUTTON_end]
uint8_t	hatstate [MAX_STICKS][MAX_HATS]
BOOL	precisionMode
OOJoystickAxisProfile *	roll_profile
OOJoystickAxisProfile *	pitch_profile
OOJoystickAxisProfile *	yaw_profile
id	cbObject
SEL	cbSelector
char	cbHardware
BOOL	invertPitch

Detailed Description

Definition at line 247 of file OOJoystickManager.h.

Method Documentation

axisFunctions

- (NSDictionary *) axisFunctions

Definition at line 338 of file OOJoystickManager.m.

{
    int i,j;
    NSMutableDictionary *fnList = [NSMutableDictionary dictionary];
    
    // Add axes
    for (i = 0; i < MAX_AXES; i++)
    {
        for (j = 0; j < MAX_STICKS; j++)
        {
            if(axismap[j][i] >= 0)
            {
                NSDictionary *fnDict=[NSDictionary dictionaryWithObjectsAndKeys:
                                      [NSNumber numberWithBool:YES], STICK_ISAXIS,
                                      [NSNumber numberWithInt:j], STICK_NUMBER, 
                                      [NSNumber numberWithInt:i], STICK_AXBUT,
                                      nil];
                [fnList setValue: fnDict
                          forKey: ENUMKEY(axismap[j][i])];
            }
        }
    }
    return fnList;
}

References axisFunctions, axismap, MAX_AXES, and MAX_STICKS.

Referenced by axisFunctions, PlayerEntity(StickMapperInternal)::displayFunctionList:skip:, PlayerEntity(OOControlsPrivate)::pollFlightControls:, and saveStickSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

buttonFunctions

- (NSDictionary *) buttonFunctions

Definition at line 364 of file OOJoystickManager.m.

{
    int i, j;
    NSMutableDictionary *fnList = [NSMutableDictionary dictionary];
    
    // Add buttons
    for (i = 0; i < MAX_BUTTONS; i++)
    {
        for (j = 0; j < MAX_STICKS; j++)
        {
            if(buttonmap[j][i] >= 0)
            {
                NSDictionary *fnDict = [NSDictionary dictionaryWithObjectsAndKeys:
                                        [NSNumber numberWithBool:NO], STICK_ISAXIS, 
                                        [NSNumber numberWithInt:j], STICK_NUMBER, 
                                        [NSNumber numberWithInt:i], STICK_AXBUT, 
                                        nil];
                [fnList setValue:fnDict
                          forKey:ENUMKEY(buttonmap[j][i])];
            }
        }
    }
    return fnList;
}

References buttonFunctions, buttonmap, MAX_BUTTONS, and MAX_STICKS.

Referenced by buttonFunctions, PlayerEntity(StickMapperInternal)::displayFunctionList:skip:, and saveStickSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

clearCallback

- (void) clearCallback

Definition at line 551 of file OOJoystickManager.m.

{
    cbObject = nil;
    cbHardware = 0;
}

References cbHardware, cbObject, clearCallback, and nil.

Referenced by clearCallback, and PlayerEntity(StickMapper)::stickMapperInputHandler:view:.

Here is the call graph for this function:

Here is the caller graph for this function:

clearMappings

- (void) clearMappings

Definition at line 504 of file OOJoystickManager.m.

{
    memset(axismap, STICK_NOFUNCTION, sizeof axismap);
    memset(buttonmap, STICK_NOFUNCTION, sizeof buttonmap);
}

References axismap, buttonmap, clearMappings, and STICK_NOFUNCTION.

Referenced by clearMappings, and loadStickSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

clearStickButtonState:

- (void) clearStickButtonState:

(int)

stickButton

Definition at line 532 of file OOJoystickManager.m.

                              :(int)stickButton
{
    if (stickButton >= 0 && stickButton < BUTTON_end)
    {
        butstate[stickButton] = 0;
    }
}

References butstate, and BUTTON_end.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightControls:.

Here is the caller graph for this function:

clearStickStates

- (void) clearStickStates

Definition at line 511 of file OOJoystickManager.m.

{
    int i, j;
    for (i = 0; i < AXIS_end; i++)
    {
        axstate[i] = STICK_AXISUNASSIGNED;
    }
    for (i = 0; i < BUTTON_end; i++)
    {
        butstate[i] = 0;
    }
    for (i = 0; i < MAX_BUTTONS; i++)
    {
        for (j = 0; j < MAX_STICKS; j++)
        {
            true_butstate[j][i] = NO;
        }
    }
}

References AXIS_end, axstate, butstate, BUTTON_end, clearStickStates, MAX_BUTTONS, MAX_STICKS, STICK_AXISUNASSIGNED, and true_butstate.

Referenced by clearStickStates, and init.

Here is the call graph for this function:

Here is the caller graph for this function:

decodeAxisEvent:

- (void) decodeAxisEvent:

(JoyAxisEvent *)

evt

Definition at line 558 of file OOJoystickManager.m.

                       : (JoyAxisEvent *)evt
{
    // Which axis moved? Does the value need to be made to fit a
    // certain function? Convert axis value to a double.
    double axisvalue = (double)evt->value;
    
    // First check if there is a callback and...
    if(cbObject && (cbHardware & HW_AXIS)) 
    {
        // ...then check if axis moved more than AXCBTHRESH - (fix for BUG #17482)
        if(axisvalue > AXCBTHRESH)
        {
            NSDictionary *fnDict = [NSDictionary dictionaryWithObjectsAndKeys:
                                    [NSNumber numberWithBool: YES], STICK_ISAXIS,
                                    [NSNumber numberWithInt: evt->which], STICK_NUMBER, 
                                    [NSNumber numberWithInt: evt->axis], STICK_AXBUT,
                                    nil];
            cbHardware = 0;
            [cbObject performSelector:cbSelector withObject:fnDict];
            cbObject = nil;
        }
        
        // we are done.
        return;
    }
    
    // SDL seems to have some bizarre (perhaps a bug) behaviour when
    // events get queued up because the game isn't ready to handle
    // them (perhaps it's loading a commander and initializing the
    // universe, and the main event loop is blocked).
    // What happens is SDL lies about the axis that was triggered. For
    // each queued event it adds 1 to the axis number!! This does
    // not seem to happen with buttons.
    int function;
    if (evt->axis < MAX_AXES)
    {
        function = axismap[evt->which][evt->axis];
    }
    else
    {
        OOLog(@"decodeAxisEvent", @"Stick axis out of range - axis was %d", evt->axis);
        return;
    }
    switch (function)
    {
        case STICK_NOFUNCTION:
            // do nothing
            break;
        case AXIS_THRUST:
            // Normalize the thrust setting.
            axstate[function] = (float)(65536 - (axisvalue + 32768)) / 65536;
            break;
        case AXIS_ROLL:
        case AXIS_PITCH:
        case AXIS_YAW:
        case AXIS_VIEWX:
        case AXIS_VIEWY:
            axstate[function] = axisvalue / STICK_NORMALDIV;
            break;
        // TODO AXIS_FIELD_OF_VIEW
        default:
            // set the state with no modification.
            axstate[function] = axisvalue / 32768;         
    }
    if ((function == AXIS_PITCH) && invertPitch) axstate[function] = -1.0*axstate[function];
}

References AXCBTHRESH, JoyAxisEvent::axis, AXIS_PITCH, AXIS_ROLL, AXIS_THRUST, AXIS_VIEWX, AXIS_VIEWY, AXIS_YAW, axismap, axstate, cbHardware, cbObject, HW_AXIS, invertPitch, MAX_AXES, nil, OOLog, STICK_NOFUNCTION, STICK_NORMALDIV, JoyAxisEvent::value, and JoyAxisEvent::which.

Referenced by OOMacJoystickManager::handleInputEvent:, and OOSDLJoystickManager::handleSDLEvent:.

Here is the caller graph for this function:

decodeButtonEvent:

- (void) decodeButtonEvent:

(JoyButtonEvent *)

evt

Definition at line 626 of file OOJoystickManager.m.

                          :(JoyButtonEvent *)evt
{
    BOOL bs = NO;
    
    // Is there a callback we need to make?
    if(cbObject && (cbHardware & HW_BUTTON))
    {
        NSDictionary *fnDict = [NSDictionary dictionaryWithObjectsAndKeys:
                                [NSNumber numberWithBool: NO], STICK_ISAXIS,
                                [NSNumber numberWithInt: evt->which], STICK_NUMBER, 
                                [NSNumber numberWithInt: evt->button], STICK_AXBUT,
                                nil];
        cbHardware = 0;
        [cbObject performSelector:cbSelector withObject:fnDict];
        cbObject = nil;
        
        // we are done.
        return;
    }
    
    // Defensive measure - see comments in the axis handler for why.
    int function;
    if (evt->button < MAX_BUTTONS)
    {
        function = buttonmap[evt->which][evt->button];
    }
    else
    {
        OOLog(@"decodeButtonEvent", @"Joystick button out of range: %d", evt->button);
        return;
    }
    if (evt->type == JOYBUTTONDOWN)
    {
        bs = YES;
        if(function == BUTTON_PRECISION)
            precisionMode = !precisionMode;
    }
    true_butstate[evt->which][evt->button] = bs;
    if (function >= 0)
    {
        butstate[function]=bs;
    }
    
}

References butstate, BUTTON_PRECISION, buttonmap, cbHardware, cbObject, HW_BUTTON, JOYBUTTONDOWN, MAX_BUTTONS, nil, OOLog, precisionMode, true_butstate, JoyAxisEvent::type, and JoyAxisEvent::which.

Referenced by decodeHatEvent:, OOMacJoystickManager::handleInputEvent:, and OOSDLJoystickManager::handleSDLEvent:.

Here is the caller graph for this function:

decodeHatEvent:

- (void) decodeHatEvent:

(JoyHatEvent *)

evt

Definition at line 672 of file OOJoystickManager.m.

                       :(JoyHatEvent *)evt
{
    // HACK: handle this as a set of buttons
    int i;
    JoyButtonEvent btn;
 
    btn.which = evt->which;
    
    for (i = 0; i < 4; ++i)
    {
        if ((evt->value ^ hatstate[evt->which][evt->hat]) & (1 << i))
        {
            btn.type = (evt->value & (1 << i)) ? JOYBUTTONDOWN : JOYBUTTONUP;
            btn.button = MAX_REAL_BUTTONS + i + evt->which * 4;
            btn.state = (evt->value & (1 << i)) ? JOYBUTTON_PRESSED : JOYBUTTON_RELEASED;
            [self decodeButtonEvent:&btn];
        }
    }
    
    hatstate[evt->which][evt->hat] = evt->value;
}

References JoyButtonEvent::button, decodeButtonEvent:, hatstate, JOYBUTTON_PRESSED, JOYBUTTON_RELEASED, JOYBUTTONDOWN, JOYBUTTONUP, MAX_REAL_BUTTONS, JoyButtonEvent::state, JoyButtonEvent::type, JoyAxisEvent::value, JoyAxisEvent::which, and JoyButtonEvent::which.

Referenced by OOMacJoystickManager::handleInputEvent:, and OOSDLJoystickManager::handleSDLEvent:.

Here is the call graph for this function:

Here is the caller graph for this function:

getAllButtonStates

- (const BOOL *) getAllButtonStates

Definition at line 115 of file OOJoystickManager.m.

{
    return butstate;
}

References butstate, and getAllButtonStates.

Referenced by getAllButtonStates, PlayerEntity(OOControlsPrivate)::pollApplicationControls, PlayerEntity(OOControlsPrivate)::pollAutopilotControls:, PlayerEntity(OOControlsPrivate)::pollCustomViewControls, PlayerEntity(OOControlsPrivate)::pollDockedControls:, PlayerEntity(OOControlsPrivate)::pollFlightControls:, and PlayerEntity(OOControlsPrivate)::pollViewControls.

Here is the call graph for this function:

Here is the caller graph for this function:

getAxisState:

- (double) getAxisState:

(int)

function

Definition at line 125 of file OOJoystickManager.m.

                       : (int)function
{
    if (axstate[function] == STICK_AXISUNASSIGNED)
    {
        return STICK_AXISUNASSIGNED;
    }
    switch (function)
    {
    case AXIS_ROLL:
        if (precisionMode)
        {
            return [roll_profile value:axstate[function]] / STICK_PRECISIONFAC;
        }
        else
        {
            return [roll_profile value:axstate[function]];
        }
    case AXIS_PITCH:
        if (precisionMode)
        {
            return [pitch_profile value:axstate[function]] / STICK_PRECISIONFAC;
        }
        else
        {
            return [pitch_profile value:axstate[function]];
        }
    case AXIS_YAW:
        if (precisionMode)
        {
            return [yaw_profile value:axstate[function]] / STICK_PRECISIONFAC;
        }
        else
        {
            return [yaw_profile value:axstate[function]];
        }
    default:
        return axstate[function];
    }
}

References AXIS_PITCH, AXIS_ROLL, AXIS_YAW, axstate, precisionMode, STICK_AXISUNASSIGNED, STICK_PRECISIONFAC, and OOJoystickAxisProfile::value:.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and PlayerEntity(OOControlsPrivate)::pollFlightControls:.

Here is the call graph for this function:

Here is the caller graph for this function:

getAxisWithStick:axis:

- (int16_t) getAxisWithStick:		(NSUInteger)	stickNum
axis:		(NSUInteger)	axisNum

Reimplemented in OOMacJoystickManager, and OOSDLJoystickManager.

Definition at line 760 of file OOJoystickManager.m.

                            :(NSUInteger)stickNum axis:(NSUInteger)axisNum
{
    return 0;
}

Referenced by OOJoystickManager(Private)::setFunctionForAxis:function:stick:.

Here is the caller graph for this function:

getButtonState:

- (BOOL) getButtonState:

(int)

function

Definition at line 109 of file OOJoystickManager.m.

                       : (int)function
{
    return butstate[function];
}

References butstate.

getProfileForAxis:

- (OOJoystickAxisProfile *) getProfileForAxis:

(int)

axis

Definition at line 193 of file OOJoystickManager.m.

                                             : (int) axis
{
    switch (axis)
    {
    case AXIS_ROLL:
        return roll_profile;
    case AXIS_PITCH:
        return pitch_profile;
    case AXIS_YAW:
        return yaw_profile;
    }
    return nil;
}

References AXIS_PITCH, AXIS_ROLL, AXIS_YAW, nil, pitch_profile, roll_profile, and yaw_profile.

Referenced by StickProfileScreen::deleteSelected, StickProfileScreen::mouseDown:, and saveProfileForAxis:.

Here is the caller graph for this function:

getSensitivity

- (double) getSensitivity

Definition at line 166 of file OOJoystickManager.m.

{
    return precisionMode ? STICK_PRECISIONFAC : 1.0;
}

References getSensitivity, precisionMode, and STICK_PRECISIONFAC.

Referenced by HeadUpDisplay(Private)::drawStickSensitivityIndicator:, and getSensitivity.

Here is the call graph for this function:

Here is the caller graph for this function:

init

- (id) init

Reimplemented in OOMacJoystickManager, and OOSDLJoystickManager.

Definition at line 74 of file OOJoystickManager.m.

{
    if ((self = [super init]))
    {
        // set initial values for stick buttons/axes (NO for buttons,
        // STICK_AXISUNASSIGNED for axes). Caution: calling this again
        // after axes have been assigned will set all the axes to
        // STICK_AXISUNASSIGNED so if there is a need to do something
        // like this, then do it some other way, or change this method
        // so it doesn't do that.
        [self clearStickStates];
        
        // Make some sensible mappings. This also ensures unassigned
        // axes and buttons are set to unassigned (STICK_NOFUNCTION).
        [self loadStickSettings];
        invertPitch = NO;
        precisionMode = NO;
    }
    return self;
}

References clearStickStates, init, invertPitch, loadStickSettings, and precisionMode.

Referenced by init, and OOSDLJoystickManager::init.

Here is the call graph for this function:

Here is the caller graph for this function:

isButtonDown:stick:

- (BOOL) isButtonDown:		(int)	button
stick:		(int)	stickNum

Definition at line 120 of file OOJoystickManager.m.

                     :(int)button stick:(int)stickNum
{
    return true_butstate[stickNum][button];
}

References true_butstate.

joystickCount

- (NSUInteger) joystickCount

Reimplemented in OOMacJoystickManager, and OOSDLJoystickManager.

Definition at line 695 of file OOJoystickManager.m.

{
    return 0;
}

References joystickCount.

Referenced by joystickCount, listSticks, and PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:.

Here is the call graph for this function:

Here is the caller graph for this function:

listSticks

- (NSArray *) listSticks

Definition at line 325 of file OOJoystickManager.m.

{
    NSUInteger i, stickCount = [self joystickCount];
    
    NSMutableArray *stickList = [NSMutableArray array];
    for (i = 0; i < stickCount; i++)
    {
        [stickList addObject:[self nameOfJoystick:i]];
    }
    return stickList;
}

References joystickCount, listSticks, and nameOfJoystick:.

Referenced by listSticks, and PlayerEntity(StickMapper)::setGuiToStickMapperScreen:resetCurrentRow:.

Here is the call graph for this function:

Here is the caller graph for this function:

loadProfileForAxis:

- (void) loadProfileForAxis:

(int)

axis

Definition at line 267 of file OOJoystickManager.m.

                           : (int) axis
{
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    NSDictionary *dict;
    OOJoystickStandardAxisProfile *standard_profile;
    OOJoystickSplineAxisProfile *spline_profile;
    
    if (axis == AXIS_ROLL)
    {
        dict = [defaults objectForKey: STICK_ROLL_AXIS_PROFILE_SETTING];
    }
    else if (axis == AXIS_PITCH)
    {
        dict = [defaults objectForKey: STICK_PITCH_AXIS_PROFILE_SETTING];
    }
    else if (axis == AXIS_YAW)
    {
        dict = [defaults objectForKey: STICK_YAW_AXIS_PROFILE_SETTING];
    }
    else
    {
        return;
    }
 
    NSString *type = [dict objectForKey: @"Type"];
    if ([type isEqualToString: @"Standard"])
    {
        standard_profile = [[OOJoystickStandardAxisProfile alloc] init];
        [standard_profile setDeadzone: [[dict objectForKey: @"Deadzone"] doubleValue]];
        [standard_profile setPower: [[dict objectForKey: @"Power"] doubleValue]];
        [standard_profile setParameter: [[dict objectForKey: @"Parameter"] doubleValue]];
        [self setProfile: [standard_profile autorelease] forAxis: axis];
    }
    else if([type isEqualToString: @"Spline"])
    {
        spline_profile = [[OOJoystickSplineAxisProfile alloc] init];
        [spline_profile setDeadzone: [[dict objectForKey: @"Deadzone"] doubleValue]];
        NSArray *points = [dict objectForKey: @"ControlPoints"], *pointArray;
        NSPoint point;
        NSUInteger i;
 
        for (i = 0; i < [points count]; i++)
        {
            pointArray = [points objectAtIndex: i];
            if ([pointArray count] >= 2)
            {
                point = NSMakePoint([[pointArray objectAtIndex: 0] floatValue], [[pointArray objectAtIndex: 1] floatValue]);
                [spline_profile addControl: point];
            }
        }
        [self setProfile: [spline_profile autorelease] forAxis: axis];
    }
    else
    {
        [self setProfile: [[[OOJoystickStandardAxisProfile alloc] init] autorelease] forAxis: axis];
    }
}

References OOJoystickSplineAxisProfile::addControl:, AXIS_PITCH, AXIS_ROLL, AXIS_YAW, count, OOJoystickAxisProfile::setDeadzone:, OOJoystickStandardAxisProfile::setParameter:, OOJoystickStandardAxisProfile::setPower:, and setProfile:forAxis:.

Referenced by loadStickSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

loadStickSettings

- (void) loadStickSettings

Definition at line 716 of file OOJoystickManager.m.

{
    unsigned i;
    [self clearMappings];
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    NSDictionary *axisSettings = [defaults objectForKey: AXIS_SETTINGS];
    NSDictionary *buttonSettings = [defaults objectForKey: BUTTON_SETTINGS];
    if(axisSettings)
    {
        NSArray *keys = [axisSettings allKeys];
        for (i = 0; i < [keys count]; i++)
        {
            NSString *key = [keys objectAtIndex: i];
            [self setFunction: [key intValue]
                     withDict: [axisSettings objectForKey: key]];
        }
    }
    if(buttonSettings)
    {
        NSArray *keys = [buttonSettings allKeys];
        for (i = 0; i < [keys count]; i++)
        {
            NSString *key = [keys objectAtIndex: i];
            [self setFunction:[key intValue]
                     withDict:[buttonSettings objectForKey: key]];
        }
    }
    else
    {
        // Nothing to load - set useful defaults
        [self setDefaultMapping];
    }
    [self loadProfileForAxis: AXIS_ROLL];
    [self loadProfileForAxis: AXIS_PITCH];
    [self loadProfileForAxis: AXIS_YAW];
}

References clearMappings, loadProfileForAxis:, loadStickSettings, setDefaultMapping, and setFunction:withDict:.

Referenced by init, and loadStickSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

nameOfJoystick:

- (NSString *) nameOfJoystick:

(NSUInteger)

stickNumber

Reimplemented in OOMacJoystickManager, and OOSDLJoystickManager.

Definition at line 755 of file OOJoystickManager.m.

                             :(NSUInteger)stickNumber
{
    return @"Dummy joystick";
}

Referenced by listSticks.

Here is the caller graph for this function:

rollPitchAxis

- (NSPoint) rollPitchAxis

Definition at line 97 of file OOJoystickManager.m.

{
    return NSMakePoint([self getAxisState:AXIS_ROLL], [self getAxisState:AXIS_PITCH]);
}

References AXIS_PITCH, AXIS_ROLL, and rollPitchAxis.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, and rollPitchAxis.

Here is the call graph for this function:

Here is the caller graph for this function:

saveProfileForAxis:

- (void) saveProfileForAxis:

(int)

axis

Definition at line 208 of file OOJoystickManager.m.

                           : (int) axis
{
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    NSMutableDictionary *dict = [[NSMutableDictionary alloc] init];
    OOJoystickAxisProfile *profile;
    OOJoystickStandardAxisProfile *standard_profile;
    OOJoystickSplineAxisProfile *spline_profile;
    NSArray *controlPoints;
    NSMutableArray *points;
    NSPoint point;
    NSUInteger i;
    
    profile = [self getProfileForAxis: axis];
    if (!profile) return;
    [dict setObject: [NSNumber numberWithDouble: [profile deadzone]] forKey: @"Deadzone"];
    if ([profile isKindOfClass: [OOJoystickStandardAxisProfile class]])
    {
        standard_profile = (OOJoystickStandardAxisProfile *) profile;
        [dict setObject: @"Standard" forKey: @"Type"];
        [dict setObject: [NSNumber numberWithDouble: [standard_profile power]] forKey: @"Power"];
        [dict setObject: [NSNumber numberWithDouble: [standard_profile parameter]] forKey: @"Parameter"];
    }
    else if ([profile isKindOfClass: [OOJoystickSplineAxisProfile class]])
    {
        spline_profile = (OOJoystickSplineAxisProfile *) profile;
        [dict setObject: @"Spline" forKey: @"Type"];
        controlPoints = [NSArray arrayWithArray: [spline_profile controlPoints]];
        points = [[NSMutableArray alloc] initWithCapacity: [controlPoints count]];
        for (i = 0; i < [controlPoints count]; i++)
        {
            point = [[controlPoints objectAtIndex: i] pointValue];
            [points addObject: [NSArray arrayWithObjects:
                [NSNumber numberWithFloat: point.x],
                [NSNumber numberWithFloat: point.y],
                nil ]];
        }
        [dict setObject: points forKey: @"ControlPoints"];
    }
    else
    {
        [dict setObject: @"Standard" forKey: @"Type"];
    }
    if (axis == AXIS_ROLL)
    {
        [defaults setObject: dict forKey: STICK_ROLL_AXIS_PROFILE_SETTING];
    }
    else if (axis == AXIS_PITCH)
    {
        [defaults setObject: dict forKey: STICK_PITCH_AXIS_PROFILE_SETTING];
    }
    else if (axis == AXIS_YAW)
    {
        [defaults setObject: dict forKey: STICK_YAW_AXIS_PROFILE_SETTING];
    }
    return;
}

References AXIS_PITCH, AXIS_ROLL, AXIS_YAW, OOJoystickSplineAxisProfile::controlPoints, OOJoystickAxisProfile::deadzone, getProfileForAxis:, OOJoystickStandardAxisProfile::parameter, and OOJoystickStandardAxisProfile::power.

Referenced by saveStickSettings.

Here is the call graph for this function:

Here is the caller graph for this function:

saveStickSettings

- (void) saveStickSettings

Definition at line 701 of file OOJoystickManager.m.

{
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    
    [defaults setObject:[self axisFunctions]
                 forKey:AXIS_SETTINGS];
    [defaults setObject:[self buttonFunctions]
                 forKey:BUTTON_SETTINGS];
    [self saveProfileForAxis: AXIS_ROLL];
    [self saveProfileForAxis: AXIS_PITCH];
    [self saveProfileForAxis: AXIS_YAW];
    [defaults synchronize];
}

References axisFunctions, buttonFunctions, saveProfileForAxis:, and saveStickSettings.

Referenced by StickProfileScreen::deleteSelected, StickProfileScreen::mouseDown:, PlayerEntity(StickMapperInternal)::removeFunction:, saveStickSettings, and PlayerEntity(StickMapper)::updateFunction:.

Here is the call graph for this function:

Here is the caller graph for this function:

setCallback:object:hardware:

- (void) setCallback:		(SEL)	selector
object:		(id)	obj
hardware:		(char)	hwflags

Definition at line 541 of file OOJoystickManager.m.

                   :(SEL) selector
             object:(id) obj
           hardware:(char)hwflags
{
    cbObject = obj;
    cbSelector = selector;
    cbHardware = hwflags;
}

References cbHardware, cbObject, and cbSelector.

Referenced by PlayerEntity(StickMapper)::stickMapperInputHandler:view:.

Here is the caller graph for this function:

setDefaultMapping

- (void) setDefaultMapping

Definition at line 492 of file OOJoystickManager.m.

{
    // assign the simplest mapping: stick 0 having
    // axis 0/1 being roll/pitch and button 0 being fire, 1 being missile
    // All joysticks should at least have two axes and two buttons.
    axismap[0][0] = AXIS_ROLL;
    axismap[0][1] = AXIS_PITCH;
    buttonmap[0][0] = BUTTON_FIRE;
    buttonmap[0][1] = BUTTON_LAUNCHMISSILE;
}

References AXIS_PITCH, AXIS_ROLL, axismap, BUTTON_FIRE, BUTTON_LAUNCHMISSILE, buttonmap, and setDefaultMapping.

Referenced by loadStickSettings, and setDefaultMapping.

Here is the call graph for this function:

Here is the caller graph for this function:

setFunction:withDict:

- (void) setFunction:		(int)	function
withDict:		(NSDictionary *)	stickFn

Definition at line 390 of file OOJoystickManager.m.

                    :(int)function withDict:(NSDictionary *)stickFn
{
    BOOL isAxis = [stickFn oo_boolForKey:STICK_ISAXIS];
    int stickNum = [stickFn oo_intForKey:STICK_NUMBER];
    int stickAxBt = [stickFn oo_intForKey:STICK_AXBUT];
    
    if (isAxis)
    {
        [self setFunctionForAxis:stickAxBt 
                        function:function
                           stick:stickNum];
    }
    else
    {
        [self setFunctionForButton:stickAxBt
                          function:function
                             stick:stickNum];
    }
}

References setFunctionForAxis:function:stick:, and setFunctionForButton:function:stick:.

Referenced by loadStickSettings, and PlayerEntity(StickMapper)::updateFunction:.

Here is the call graph for this function:

Here is the caller graph for this function:

setFunctionForAxis:function:stick:

- (void) setFunctionForAxis: (int) axis function: (int) function stick: (int) stickNum

implementation

Provided by category OOJoystickManager(Private).

Definition at line 411 of file OOJoystickManager.m.

                           :(int)axis 
                   function:(int)function
                      stick:(int)stickNum
{
    NSParameterAssert(axis < MAX_AXES && stickNum < MAX_STICKS);
    
    int16_t axisvalue = [self getAxisWithStick:stickNum axis:axis];
    [self unsetAxisFunction:function];
    axismap[stickNum][axis] = function;
    
    // initialize the throttle to what it's set to now (or else the
    // commander has to waggle the throttle to wake it up). Other axes
    // set as default.
    if(function == AXIS_THRUST)
    {
        axstate[function] = (float)(65536 - (axisvalue + 32768)) / 65536;
    }
    else
    {
        axstate[function] = (float)axisvalue / STICK_NORMALDIV;
    }
}

References AXIS_THRUST, getAxisWithStick:axis:, MAX_AXES, MAX_STICKS, STICK_NORMALDIV, and unsetAxisFunction:.

Referenced by setFunction:withDict:.

Here is the call graph for this function:

Here is the caller graph for this function:

setFunctionForButton:function:stick:

- (void) setFunctionForButton: (int) button function: (int) function stick: (int) stickNum

implementation

Provided by category OOJoystickManager(Private).

Definition at line 435 of file OOJoystickManager.m.

                             :(int)button 
                     function:(int)function 
                        stick:(int)stickNum
{
    NSParameterAssert(button < MAX_BUTTONS && stickNum < MAX_STICKS);
    
    int i, j;
    for (i = 0; i < MAX_BUTTONS; i++)
    {
        for (j = 0; j < MAX_STICKS; j++)
        {
            if (buttonmap[j][i] == function)
            {
                buttonmap[j][i] = STICK_NOFUNCTION;
                break;
            }
        }
    }
    buttonmap[stickNum][button] = function;
}

References MAX_BUTTONS, MAX_STICKS, and STICK_NOFUNCTION.

Referenced by setFunction:withDict:.

Here is the caller graph for this function:

setProfile:forAxis:

- (void) setProfile:		(OOJoystickAxisProfile *)	profile
forAxis:		(int)	axis

Definition at line 171 of file OOJoystickManager.m.

                   : (OOJoystickAxisProfile *) profile forAxis: (int) axis
{
    switch (axis)
    {
    case AXIS_ROLL:
        [roll_profile release];
        roll_profile = [profile retain];
        break;
 
    case AXIS_PITCH:
        [pitch_profile release];
        pitch_profile = [profile retain];
        break;
 
    case AXIS_YAW:
        [yaw_profile release];
        yaw_profile = [profile retain];
        break;
    }
    return;
}

References AXIS_PITCH, AXIS_ROLL, AXIS_YAW, pitch_profile, roll_profile, and yaw_profile.

Referenced by loadProfileForAxis:.

Here is the caller graph for this function:

setStickHandlerClass:

+ (BOOL) setStickHandlerClass:

(Class)

aClass

Definition at line 64 of file OOJoystickManager.m.

                             :(Class)aClass
{
    NSAssert(sStickHandlerClass == nil, @"Can't set joystick handler class after joystick handler is initialized.");
    NSParameterAssert(aClass == Nil || [aClass isSubclassOfClass:[OOJoystickManager class]]);
    
    sStickHandlerClass = aClass;
    return YES;
}

References nil, and sStickHandlerClass.

Referenced by GameController::applicationDidFinishLaunching:, and MyOpenGLView::init.

Here is the caller graph for this function:

sharedStickHandler

+ (id) sharedStickHandler

Definition at line 53 of file OOJoystickManager.m.

{
    if (sSharedStickHandler == nil)
    {
        if (sStickHandlerClass == Nil)  sStickHandlerClass = [OOJoystickManager class];
        sSharedStickHandler = [[sStickHandlerClass alloc] init];
    }
    return sSharedStickHandler;
}

References nil, sharedStickHandler, sSharedStickHandler, and sStickHandlerClass.

Referenced by PlayerEntity(StickMapperInternal)::displayFunctionList:skip:, HeadUpDisplay(Private)::drawStickSensitivityIndicator:, StickProfileScreen::init, Universe::initWithGameView:, PlayerEntity(OOControlsPrivate)::pollApplicationControls, PlayerEntity(OOControlsPrivate)::pollAutopilotControls:, MyOpenGLView::pollControls, PlayerEntity(OOControlsPrivate)::pollCustomViewControls, PlayerEntity(OOControlsPrivate)::pollDockedControls:, PlayerEntity(OOControlsPrivate)::pollFlightArrowKeyControls:, PlayerEntity(OOControlsPrivate)::pollFlightControls:, PlayerEntity(OOControlsPrivate)::pollViewControls, PlayerEntity(StickMapperInternal)::removeFunction:, PlayerEntity(StickMapper)::setGuiToStickMapperScreen:resetCurrentRow:, sharedStickHandler, PlayerEntity(StickMapper)::stickMapperInputHandler:view:, and PlayerEntity(StickMapper)::updateFunction:.

Here is the call graph for this function:

Here is the caller graph for this function:

unsetAxisFunction:

- (void) unsetAxisFunction:

(int)

function

Definition at line 457 of file OOJoystickManager.m.

                          :(int)function
{
    int i, j;
    for (i = 0; i < MAX_AXES; i++)
    {
        for (j = 0; j < MAX_STICKS; j++)
        {
            if (axismap[j][i] == function)
            {
                axismap[j][i] = STICK_NOFUNCTION;
                axstate[function] = STICK_AXISUNASSIGNED;
                break;
            }
        }
    }
}

References axismap, axstate, MAX_AXES, MAX_STICKS, STICK_AXISUNASSIGNED, and STICK_NOFUNCTION.

Referenced by PlayerEntity(StickMapperInternal)::removeFunction:, OOJoystickManager(Private)::setFunctionForAxis:function:stick:, and PlayerEntity(StickMapper)::updateFunction:.

Here is the caller graph for this function:

unsetButtonFunction:

- (void) unsetButtonFunction:

(int)

function

Definition at line 475 of file OOJoystickManager.m.

                            :(int)function
{
    int i,j;
    for (i = 0; i < MAX_BUTTONS; i++)
    {
        for (j = 0; j < MAX_STICKS; j++)
        {
            if(buttonmap[j][i] == function)
            {
                buttonmap[j][i] = STICK_NOFUNCTION;
                break;
            }
        }
    }
}

References buttonmap, MAX_BUTTONS, MAX_STICKS, and STICK_NOFUNCTION.

Referenced by PlayerEntity(StickMapperInternal)::removeFunction:, and PlayerEntity(StickMapper)::updateFunction:.

Here is the caller graph for this function:

viewAxis

- (NSPoint) viewAxis

Definition at line 103 of file OOJoystickManager.m.

{
    return NSMakePoint(axstate[AXIS_VIEWX], axstate[AXIS_VIEWY]);
}

References AXIS_VIEWX, AXIS_VIEWY, axstate, and viewAxis.

Referenced by PlayerEntity(OOControlsPrivate)::pollFlightControls:, PlayerEntity(OOControlsPrivate)::pollViewControls, and viewAxis.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

axismap

- (int8_t axismap[MAX_STICKS][MAX_AXES])

private

Definition at line 251 of file OOJoystickManager.h.

Referenced by axisFunctions, clearMappings, decodeAxisEvent:, setDefaultMapping, and unsetAxisFunction:.

axstate

- (double axstate[AXIS_end])

private

Definition at line 254 of file OOJoystickManager.h.

Referenced by clearStickStates, decodeAxisEvent:, getAxisState:, unsetAxisFunction:, and viewAxis.

butstate

- (BOOL butstate[BUTTON_end])

private

Definition at line 255 of file OOJoystickManager.h.

Referenced by clearStickButtonState:, clearStickStates, decodeButtonEvent:, getAllButtonStates, and getButtonState:.

buttonmap

- (int8_t buttonmap[MAX_STICKS][MAX_BUTTONS])

private

Definition at line 252 of file OOJoystickManager.h.

Referenced by buttonFunctions, clearMappings, decodeButtonEvent:, setDefaultMapping, and unsetButtonFunction:.

cbHardware

- (char) cbHardware

private

Definition at line 266 of file OOJoystickManager.h.

Referenced by clearCallback, decodeAxisEvent:, decodeButtonEvent:, and setCallback:object:hardware:.

cbObject

- (id) cbObject

private

Definition at line 264 of file OOJoystickManager.h.

Referenced by clearCallback, decodeAxisEvent:, decodeButtonEvent:, and setCallback:object:hardware:.

cbSelector

- (SEL) cbSelector

private

Definition at line 265 of file OOJoystickManager.h.

Referenced by setCallback:object:hardware:.

hatstate

- (uint8_t hatstate[MAX_STICKS][MAX_HATS])

private

Definition at line 256 of file OOJoystickManager.h.

Referenced by decodeHatEvent:.

invertPitch

- (BOOL) invertPitch

private

Definition at line 267 of file OOJoystickManager.h.

Referenced by decodeAxisEvent:, and init.

pitch_profile

- (OOJoystickAxisProfile*) pitch_profile

private

Definition at line 259 of file OOJoystickManager.h.

Referenced by getProfileForAxis:, and setProfile:forAxis:.

precisionMode

- (BOOL) precisionMode

private

Definition at line 257 of file OOJoystickManager.h.

Referenced by decodeButtonEvent:, getAxisState:, getSensitivity, and init.

roll_profile

- (OOJoystickAxisProfile*) roll_profile

private

Definition at line 258 of file OOJoystickManager.h.

Referenced by getProfileForAxis:, and setProfile:forAxis:.

true_butstate

- (BOOL true_butstate[MAX_STICKS][MAX_BUTTONS])

private

Definition at line 253 of file OOJoystickManager.h.

Referenced by clearStickStates, decodeButtonEvent:, and isButtonDown:stick:.

yaw_profile

- (OOJoystickAxisProfile*) yaw_profile

private

Definition at line 260 of file OOJoystickManager.h.

Referenced by getProfileForAxis:, and setProfile:forAxis:.

---

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

• src/Core/OOJoystickManager.h
• src/Core/OOJoystickManager.m