https://github.com/krzysztofzablocki/CCNode-SFGestureRecognizers

Adding UIGestureRecognizers to cocos2d, painless.
https://github.com/krzysztofzablocki/CCNode-SFGestureRecognizers

Last synced: about 1 month ago
JSON representation

Adding UIGestureRecognizers to cocos2d, painless.

• Host: GitHub
• URL: https://github.com/krzysztofzablocki/CCNode-SFGestureRecognizers
• Owner: krzysztofzablocki
• License: other
• Created: 2012-03-15T08:23:03.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2014-07-18T07:24:07.000Z (over 10 years ago)
• Last Synced: 2024-04-14T07:11:35.965Z (8 months ago)
• Language: Objective-C
• Homepage: http://twitter.com/merowing_
• Size: 2.39 MB
• Stars: 202
• Watchers: 20
• Forks: 34
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome - CCNode-SFGestureRecognizers - Adding UIGestureRecognizers to cocos2d, painless. (etc)
• awesome - CCNode-SFGestureRecognizers - Adding UIGestureRecognizers to cocos2d, painless. (etc)

README

        
Purpose

--------------

CCNode+SFGestureRecognizers is a category designed to simplify adding UIGestureRecognizers support in cocos2d. 

It removes the need to change cocos2d source code so that you can update your cocos2d anytime new versions are released.

[Follow me on twitter][1]

Supported OS & SDK Versions

-----------------------------

* iOS 4.0 (Xcode 4.3, Apple LLVM compiler 3.1)

* cocos2d version 1.x or 2.x works fine.

ARC Compatibility

------------------

CCNode+SFGestureRecognizers automatically works with both ARC and non-ARC projects through conditional compilation. There is no need to exclude CCNode+SFGestureRecognizers files from the ARC validation process, or to convert CCNode+SFGestureRecognizers using the ARC conversion tool.

Installation

--------------

If you are using CocoaPods, you can just add CCNode+SFGestureRecognizers to your Podfile. If you didn't use it before I'm recommending you check it out: http://cocoapods.org/

### Manual Install

To use the CCNode+SFGestureRecognizers category in an app, just drag the category files (demo files and assets are not needed) into your project.

Include the CCNode+SFGestureRecognizers.h in your Prefix.pch file so that you can use it everywhere.

Properties

--------------

CCNode+SFGestureRecognizers adds following properties / methods to CCNode:

    @property (nonatomic, assign) BOOL isTouchEnabled;

Defines if touches are enabled, if you disable it no gesture will be working.    

    

    @property (nonatomic, assign) CGRect touchRect;

Defines touchable rectangle in node local coordinate space.

    - (void)addGestureRecognizer:(UIGestureRecognizer*)aGestureRecognizer;

Adds gesture recognizer to node.

    

    - (void)removeGestureRecognizer:(UIGestureRecognizer*)aGestureRecognizer;

Removes gesture recognizer from node.

    

    - (NSArray*)gestureRecognizers;

Returns all gesture recognizers that are bound to this node.

 	- (BOOL)isPointTouchableInArea:(CGPoint)pt;

Tests if point is touchable in selected area without testing children nodes (node must be visible and running to pass this check, isTouchEnabled also has to be set to YES )  

    - (BOOL)isNodeInTreeTouched:(CGPoint)pt;

Tests if points is touchable in a node or any of its children nodes.

    

    - (BOOL)isPointInArea:(CGPoint)pt;

Tests if point is inside in selected area without testing children nodes (node must be visible and running to pass this check, ignores isTouchEnabled ).

CCNode+SFGestureRecognizers also adds this property in UIGestureRecognizer class:

    @property (nonatomic, readonly) CCNode *node;

Node that this gesture is added to.

  [1]: http://twitter.com/merowing_