OOJoystickSplineAxisProfile Class Reference

#include <OOJoystickProfile.h>

Inheritance diagram for OOJoystickSplineAxisProfile:

Collaboration diagram for OOJoystickSplineAxisProfile:

Instance Methods
(id)	- init
(void)	- dealloc
(id)	- copyWithZone:
(int)	- addControl:
(NSPoint)	- pointAtIndex:
(int)	- countPoints
(void)	- removeControl:
(void)	- clearControlPoints
(void)	- moveControl:point:
(double)	- rawValue:
(double)	- gradient:
(NSArray *)	- controlPoints
(BOOL)	- makeSegments [implementation]
Instance Methods inherited from OOJoystickAxisProfile
(double)	- value:
(double)	- deadzone
(void)	- setDeadzone:

Private Attributes
NSMutableArray *	controlPoints
NSArray *	segments

Detailed Description

Definition at line 72 of file OOJoystickProfile.h.

Method Documentation

addControl:

- (int) addControl:

(NSPoint)

point

Definition at line 39 of file OOJoystickProfile.m.

{
    NSPoint left, right;
    NSUInteger i;
 
    if (point.x <= SPLINE_POINT_MIN_SPACING || point.x >= 1 - SPLINE_POINT_MIN_SPACING )
    {
        return -1;
    }
 
    left.x = 0.0;
    left.y = 0.0;
    for (i = 0; i <= [controlPoints count]; i++ )
    {
        if (i < [controlPoints count])
        {
            right = [[controlPoints objectAtIndex: i] pointValue];
        }
        else
        {
            right = NSMakePoint(1.0,1.0);
        }
        if ((point.x - left.x) < SPLINE_POINT_MIN_SPACING)
        {
            if (i == 0)
            {
                return -1;
            }
            [controlPoints replaceObjectAtIndex: i - 1 withObject: [NSValue valueWithPoint: point]];
            [self makeSegments];
            return i - 1;
        }
        if ((right.x - point.x) >= SPLINE_POINT_MIN_SPACING)
        {
            [controlPoints insertObject: [NSValue valueWithPoint: point] atIndex: i];
            [self makeSegments];
            return i;
        }
        left = right;
    }
    return -1;
}
 

clearControlPoints

- (void) clearControlPoints

Definition at line 39 of file OOJoystickProfile.m.

{
    [controlPoints removeAllObjects];
    [self makeSegments];
}
 

controlPoints

- (NSArray *) controlPoints

Definition at line 39 of file OOJoystickProfile.m.

{
    return [NSArray arrayWithArray: controlPoints];
}
 

copyWithZone:

- (id) copyWithZone:

(NSZone *)

zone

Reimplemented from OOJoystickAxisProfile.

Definition at line 39 of file OOJoystickProfile.m.

{
    OOJoystickSplineAxisProfile *copy = [[[self class] alloc] init];
    copy->controlPoints = [controlPoints copyWithZone: zone];
    copy->segments = [segments copyWithZone: zone];
    return copy;
}
 

countPoints

- (int) countPoints

Definition at line 39 of file OOJoystickProfile.m.

{
    return [controlPoints count];
}
 

dealloc

- (void) dealloc

Definition at line 39 of file OOJoystickProfile.m.

{
    [controlPoints release];
    [segments release];
    [super dealloc];
    return;
}
 

gradient:

- (double) gradient:

(double)

x

Definition at line 39 of file OOJoystickProfile.m.

{
    NSUInteger i;
    OOJoystickSplineSegment *segment;
    for (i = 0; i < [segments count]; i++)
    {
        segment = [segments objectAtIndex: i];
        if ([segment end] > x)
        {
            return [segment gradient:x];
        }
    }
    return 1.0;
}
 

init

- (id) init

Reimplemented from OOJoystickAxisProfile.

Definition at line 39 of file OOJoystickProfile.m.

{
    if ((self = [super init]))
    {
        controlPoints = [[NSMutableArray alloc] initWithCapacity: 2];
        segments = nil;
        [self makeSegments];
    }
    return self;
}
 

makeSegments

- (BOOL) makeSegments

implementation

Provided by category OOJoystickSplineAxisProfile(Private).

Definition at line 39 of file OOJoystickProfile.m.

{
    NSUInteger i;
    NSPoint left, right, next;
    double gradientleft, gradientright;
    OOJoystickSplineSegment* segment;
    BOOL first_segment = YES;
    NSMutableArray *new_segments = [NSMutableArray arrayWithCapacity: ([controlPoints count] + 1)];
 
    left.x = 0.0;
    left.y = 0.0;
    if ([controlPoints count] == 0)
    {
        right.x = 1.0;
        right.y = 1.0;
        segment = [OOJoystickSplineSegment segmentWithData: left right: right];
        [new_segments addObject:segment];
    }
    else
    {
        gradientleft = 1.0;
        right = [[controlPoints objectAtIndex: 0] pointValue];
        for (i = 0; i < [controlPoints count]; i++)
        {
            next = [self pointAtIndex: i + 1];
            if (next.x - left.x > 0.0)
            {
                // we make the gradient at right equal to the gradient of a straight line between the neighcouring points
                gradientright = (next.y - left.y)/(next.x - left.x);
                if (first_segment)
                {
                    segment = [OOJoystickSplineSegment segmentWithData: left right: right gradientright: gradientright];
                }
                else
                {
                    segment = [OOJoystickSplineSegment segmentWithData: left right: right gradientleft: gradientleft gradientright: gradientright];
                }
                if (segment == nil)
                {
                    return NO;
                }
                else
                {
                    [new_segments addObject: segment];
                    gradientleft = gradientright;
                    first_segment = NO;
                    left = right;
                }
            }
            right = next;
        }
        right.x = 1.0;
        right.y = 1.0;
        segment = [OOJoystickSplineSegment segmentWithData: left right: right gradientleft: gradientleft];
        if (segment == nil)
        {
            return NO;
        }
        [new_segments addObject: segment];
    }
    [segments release];
    segments = [[NSArray arrayWithArray: new_segments] retain];
    return YES;
}
 

moveControl:point:

- (void) moveControl:		(NSInteger)	index
point:		(NSPoint)	point

Definition at line 39 of file OOJoystickProfile.m.

{
    NSPoint left, right;
 
    point.x = OOClamp_0_1_d(point.x);
    point.y = OOClamp_0_1_d(point.y);
    if (index < 0 || index >= (NSInteger)[controlPoints count])
    {
        return;
    }
    if (index == 0)
    {
        left.x = 0.0;
        right.x = 0.0;
    }
    else
    {
        left = [[controlPoints objectAtIndex: (index-1)] pointValue];
    }
    if (index == (NSInteger)[controlPoints count] - 1)
    {
        right.x = 1.0;
        right.y = 1.0;
    }
    else
    {
        right = [[controlPoints objectAtIndex: (index+1)] pointValue];
    }
    // preserve order of control points - if we attempt to move this control point beyond
    // either of its neighbours, move it back inside.  Also keep neighbours a distance of at least SPLINE_POINT_MIN_SPACING apart
    if (point.x - left.x < SPLINE_POINT_MIN_SPACING)
    {
        point.x = left.x + SPLINE_POINT_MIN_SPACING;
        if (right.x - point.x < SPLINE_POINT_MIN_SPACING)
        {
            point.x = (left.x + right.x)/2;
        }
    }
    else if (right.x - point.x < SPLINE_POINT_MIN_SPACING)
    {
        point.x = right.x - SPLINE_POINT_MIN_SPACING;
        if (point.x - left.x < SPLINE_POINT_MIN_SPACING)
        {
            point.x = (left.x + right.x)/2;
        }
    }
    [controlPoints replaceObjectAtIndex: index withObject: [NSValue valueWithPoint: point]];
    [self makeSegments];
    return;
}
 

pointAtIndex:

- (NSPoint) pointAtIndex:

(NSInteger)

index

Definition at line 39 of file OOJoystickProfile.m.

{
    NSPoint point;
    if (index < 0)
    {
        point.x = 0.0;
        point.y = 0.0;
    }
    else if (index >= (NSInteger)[controlPoints count])
    {
        point.x = 1.0;
        point.y = 1.0;
    }
    else
    {
        point = [[controlPoints objectAtIndex: index] pointValue];
    }
    return point;
}
 

rawValue:

- (double) rawValue:

(double)

x

Reimplemented from OOJoystickAxisProfile.

Definition at line 39 of file OOJoystickProfile.m.

{
    NSUInteger i;
    OOJoystickSplineSegment *segment;
    double sign;
    
    if (x < 0)
    {
        sign = -1.0;
        x = -x;
    }
    else
    {
        sign = 1.0;
    }
    for (i = 0; i < [segments count]; i++)
    {
        segment = [segments objectAtIndex: i];
        if ([segment end] > x)
        {
            return sign * OOClamp_0_1_d([segment value:x]);
        }
    }
    return 1.0;
}
 

removeControl:

- (void) removeControl:

(NSInteger)

index

Definition at line 39 of file OOJoystickProfile.m.

{
    if (index >= 0 && index < (NSInteger)[controlPoints count])
    {
        [controlPoints removeObjectAtIndex: index];
        [self makeSegments];
    }
    return;
}
 

Member Data Documentation

controlPoints

- (NSMutableArray*) controlPoints

private

Definition at line 75 of file OOJoystickProfile.h.

segments

- (NSArray*) segments

private

Definition at line 76 of file OOJoystickProfile.h.

---

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

• src/Core/OOJoystickProfile.h
• src/Core/OOJoystickProfile.m