joybox 0.0.5 → 0.0.6

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/Platforms/Mac/CCGLView.h

@@ -0,0 +1,103 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2010 Ricardo Quesada
+ * Copyright (c) 2011 Zynga Inc.
+ *
+ * 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.
+ */
+
+// Only compile this code on Mac. These files should not be included on your iOS project.
+// But in case they are included, it won't be compiled.
+#import "../../ccMacros.h"
+#ifdef __CC_PLATFORM_MAC
+
+#import <Cocoa/Cocoa.h>
+
+#import "../../ccConfig.h"
+
+//PROTOCOLS:
+
+@protocol CCEventDelegate <NSObject>
+// Mouse
+- (void)mouseDown:(NSEvent *)theEvent;
+- (void)mouseUp:(NSEvent *)theEvent;
+- (void)mouseMoved:(NSEvent *)theEvent;
+- (void)mouseDragged:(NSEvent *)theEvent;
+- (void)rightMouseDown:(NSEvent*)event;
+- (void)rightMouseDragged:(NSEvent*)event;
+- (void)rightMouseUp:(NSEvent*)event;
+- (void)otherMouseDown:(NSEvent*)event;
+- (void)otherMouseDragged:(NSEvent*)event;
+- (void)otherMouseUp:(NSEvent*)event;
+- (void)scrollWheel:(NSEvent *)theEvent;
+- (void)mouseEntered:(NSEvent *)theEvent;
+- (void)mouseExited:(NSEvent *)theEvent;
+
+
+// Keyboard
+- (void)keyDown:(NSEvent *)theEvent;
+- (void)keyUp:(NSEvent *)theEvent;
+- (void)flagsChanged:(NSEvent *)theEvent;
+
+// Touches
+- (void)touchesBeganWithEvent:(NSEvent *)event;
+- (void)touchesMovedWithEvent:(NSEvent *)event;
+- (void)touchesEndedWithEvent:(NSEvent *)event;
+- (void)touchesCancelledWithEvent:(NSEvent *)event;
+
+// Gestures
+- (void)beginGestureWithEvent:(NSEvent *)event;
+- (void)magnifyWithEvent:(NSEvent *)event;
+- (void)smartMagnifyWithEvent:(NSEvent *)event;
+- (void)rotateWithEvent:(NSEvent *)event;
+- (void)swipeWithEvent:(NSEvent *)event;
+- (void)endGestureWithEvent:(NSEvent *)event;
+
+@end
+
+/** CCGLView
+
+ Only available for Mac OS X
+ */
+@interface CCGLView : NSOpenGLView {
+	id<CCEventDelegate> _eventDelegate;
+}
+
+/** Event delegate */
+@property (nonatomic, readwrite, assign) id<CCEventDelegate> eventDelegate;
+
+/** initializes the CCGLView with a frame rect and an OpenGL context */
+- (id) initWithFrame:(NSRect)frameRect shareContext:(NSOpenGLContext*)context;
+
+/** uses and locks the OpenGL context */
+-(void) lockOpenGLContext;
+
+/** unlocks the openGL context */
+-(void) unlockOpenGLContext;
+
+/** returns the depth format of the view in BPP */
+- (NSUInteger) depthFormat;
+
+// private
++(void) load_;
+@end
+
+#endif // __CC_PLATFORM_MAC
+

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/Platforms/Mac/CCWindow.h

@@ -0,0 +1,41 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2010 Ricardo Quesada
+ *
+ * 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.
+ */
+
+// Only compile this code on Mac. These files should not be included on your iOS project.
+// But in case they are included, it won't be compiled.
+#import "../../ccMacros.h"
+#ifdef __CC_PLATFORM_MAC
+
+#import <Cocoa/Cocoa.h>
+
+
+@interface CCWindow : NSWindow
+{
+}
+- (id) initWithFrame:(NSRect)frame fullscreen:(BOOL)fullscreen;
+
+@end
+
+
+#endif // __CC_PLATFORM_MAC

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/Support/CCArray.h

@@ -0,0 +1,119 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2010 ForzeField Studios S.L. http://forzefield.com
+ *
+ * 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 "ccCArray.h"
+
+
+/** A faster alternative of NSArray.
+ CCArray uses internally a c-array.
+ @since v0.99.4
+ */
+
+
+/** @def CCARRAY_FOREACH
+ A convenience macro to iterate over a CCArray using. It is faster than the "fast enumeration" interface.
+ @since v0.99.4
+ */
+
+#define CCARRAY_FOREACH(__array__, __object__)												\
+if (__array__ && __array__->data->num > 0)													\
+for(const CC_ARC_UNSAFE_RETAINED id *__arr__ = __array__->data->arr, *end = __array__->data->arr + __array__->data->num-1;	\
+	__arr__ <= end && ((__object__ = *__arr__) != nil || true);								\
+	__arr__++)
+
+@interface CCArray : NSObject <NSFastEnumeration, NSCoding, NSCopying>
+{
+	@public ccArray *data;
+}
+
++ (id) array;
++ (id) arrayWithCapacity:(NSUInteger)capacity;
++ (id) arrayWithArray:(CCArray*)otherArray;
++ (id) arrayWithNSArray:(NSArray*)otherArray;
+
+
+- (id) initWithCapacity:(NSUInteger)capacity;
+- (id) initWithArray:(CCArray*)otherArray;
+- (id) initWithNSArray:(NSArray*)otherArray;
+
+
+// Querying an Array
+
+- (NSUInteger) count;
+- (NSUInteger) capacity;
+- (NSUInteger) indexOfObject:(id)object;
+- (id) objectAtIndex:(NSUInteger)index;
+- (BOOL) containsObject:(id)object;
+- (id) randomObject;
+- (id) lastObject;
+- (NSArray*) getNSArray;
+/** @since 1.1 */
+- (BOOL) isEqualToArray:(CCArray*)otherArray;
+
+
+// Adding Objects
+
+- (void) addObject:(id)object;
+- (void) addObjectsFromArray:(CCArray*)otherArray;
+- (void) addObjectsFromNSArray:(NSArray*)otherArray;
+- (void) insertObject:(id)object atIndex:(NSUInteger)index;
+
+
+// Removing Objects
+
+- (void) removeLastObject;
+- (void) removeObject:(id)object;
+- (void) removeObjectAtIndex:(NSUInteger)index;
+- (void) removeObjectsInArray:(CCArray*)otherArray;
+- (void) removeAllObjects;
+- (void) fastRemoveObject:(id)object;
+- (void) fastRemoveObjectAtIndex:(NSUInteger)index;
+
+
+// Rearranging Content
+
+- (void) exchangeObject:(id)object1 withObject:(id)object2;
+- (void) exchangeObjectAtIndex:(NSUInteger)index1 withObjectAtIndex:(NSUInteger)index2;
+/** @since 1.1 */
+- (void) replaceObjectAtIndex:(NSUInteger)index withObject:(id)anObject;
+- (void) reverseObjects;
+- (void) reduceMemoryFootprint;
+
+// Sorting Array 
+/** all since @1.1 */
+- (void) qsortUsingCFuncComparator:(int(*)(const void *, const void *))comparator;	// c qsort is used for sorting
+- (void) insertionSortUsingCFuncComparator:(int(*)(const void *, const void *))comparator;  // insertion sort 
+- (void) mergesortLUsingCFuncComparator:(int(*)(const void *, const void *))comparator;	// mergesort
+- (void) insertionSort:(SEL)selector; // It sorts source array in ascending order
+- (void) sortUsingFunction:(NSInteger (*)(id, id, void *))compare context:(void *)context;
+
+// Sending Messages to Elements
+
+- (void) makeObjectsPerformSelector:(SEL)aSelector;
+- (void) makeObjectsPerformSelector:(SEL)aSelector withObject:(id)object;
+/** @since 1.1 */
+- (void) makeObjectPerformSelectorWithArrayObjects:(id)object selector:(SEL)aSelector; 
+
+@end

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/Support/CCFileUtils.h

@@ -0,0 +1,394 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2008-2010 Ricardo Quesada
+ * Copyright (c) 2011 Zynga Inc.
+ *
+ * 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 <Foundation/Foundation.h>
+#import "../ccTypes.h"
+
+// keys used for the suffix or directory dictionaries
+extern NSString const *kCCFileUtilsDefault;
+extern NSString const *kCCFileUtilsiPad;
+extern NSString const *kCCFileUtilsiPadHD;
+extern NSString const *kCCFileUtilsiPhone;
+extern NSString const *kCCFileUtilsiPhoneHD;
+extern NSString const *kCCFileUtilsiPhone5;
+extern NSString const *kCCFileUtilsiPhone5HD;
+extern NSString const *kCCFileUtilsMac;
+extern NSString const *kCCFileUtilsMacHD;
+
+extern NSString const *kCCFileUtilsDefaultSearchPath;
+
+enum {
+	kCCFileUtilsSearchSuffixMode,
+	kCCFileUtilsSearchDirectoryMode,
+};
+
+
+/** Helper class to handle file operations */
+@interface CCFileUtils : NSObject
+{
+	NSFileManager		*_fileManager;
+	NSBundle			*_bundle;
+
+	NSMutableDictionary *_fullPathCache;
+	NSMutableDictionary *_fullPathNoResolutionsCache;
+	NSMutableDictionary *_removeSuffixCache;
+	
+	NSMutableDictionary	*_directoriesDict;
+	NSMutableDictionary	*_suffixesDict;
+	
+	NSMutableDictionary	*_filenameLookup;
+	
+	NSMutableArray		*_searchResolutionsOrder;
+	NSMutableArray		*_searchPath;
+	
+	// it could be suffix (default) or directory
+	int					_searchMode;
+	
+	BOOL				_enableiPhoneResourcesOniPad;
+}
+
+/** NSBundle used by CCFileUtils. By default it uses [NSBundle mainBundle].
+ @since v2.0
+ */
+@property (nonatomic, readwrite, retain) NSBundle	*bundle;
+
+/** NSFileManager used by CCFileUtils. By default it uses its own instance.
+ @since v2.0
+ */
+@property (nonatomic, readwrite, retain) NSFileManager	*fileManager;
+
+/** Whether of not the fallback suffixes is enabled.
+ When enabled it will try to search for the following suffixes in the following order until one is found:
+ * On iPad HD  : iPad HD, iPad, iPhone HD, Resources without resolution
+ * On iPad     : iPad, iPhone HD, Resources without resolution
+ * On iPhone HD: iPhone HD, Resources without resolution
+ * On Mac HD   : Mac HD, Mac, Resources without resolution
+ * On Mac      : Mac, Resources without resolution
+ 
+ By default this functionality is off;
+ */
+@property (nonatomic, readwrite, getter = isEnablediPhoneResourcesOniPad) BOOL enableiPhoneResourcesOniPad;
+
+/** Dictionary that contians the search directories for the different devices. Default values:
+ - iPhone: "resources-iphone"
+ - iPhone HD: "resources-hd"
+ - iPhone5 : "resources-wide"
+ - iPhone5 HD: "resources-widehd"
+ - iPad: "resources-ipad"
+ - iPad HD: "resources-ipadhd"
+ - Mac: "resources-mac"
+ - Mac HD: "resources-machd"
+ 
+ If "search in directories" is enabled (disabled by default), it will try to get the resources from the directories according to the order of "searchResolutionsOrder" array.
+ @since v2.1
+ */
+@property (nonatomic, copy) NSMutableDictionary *directoriesDict;
+
+/** Dictionary that contians the suffix for the different devices. Default values:
+	- iPhone: ""
+	- iPhone HD: "-hd"
+	- iPhone5 : "-wide"
+	- iPhone5 HD: "-widehd"
+	- iPad: "-ipad"
+	- iPad HD: "-ipadhd"
+	- Mac: ""
+	- Mac HD: "-machd"
+
+  If "search with suffixes" is enabled (enabled by default), it will try to get the resources by appending the suffixes according to the order of "searchResolutionsOrder" array.
+ @since v2.1
+ */
+@property (nonatomic, copy) NSMutableDictionary *suffixesDict;
+
+/** Array that contains the search order of the resources based for the device.
+ By default it will try to load resources in the following order until one is found:
+   - On iPad HD: iPad HD resources, iPad resources, resources not associated with any device
+   - On iPad: iPad resources, resources not associated with any device
+   - On iPhone 5 HD: iPhone 5 HD resources, iPhone HD resouces, iPhone 5 resources, iPhone resources, resources not associated with any device
+   - On iPhone HD: iPhone HD resources, iPhone resouces, resources not associated with any device
+   - On iPhone: iPhone resources, resources not associated with any device
+
+   - On Mac HD: Mac HD resources, Mac resources, resources not associated with any device
+   - On Mac: Mac resources, resources not associated with any device
+ 
+ If the property "enableiPhoneResourcesOniPad" is enabled, it will also search for iPhone resources if you are in an iPad.
+ 
+ @since v2.1
+ */
+@property (nonatomic, copy) NSArray *searchResolutionsOrder;
+
+/** Array of search paths.
+ You can use this array to modify the search path of the resources.
+ If you want to use "themes" or search resources in the "cache", you can do it easily by adding new entries in this array.
+ 
+ By default it is an array with only the "" (empty string) element.
+ 
+ @since v2.1
+ */
+@property (nonatomic, copy) NSArray *searchPath;
+
+
+/**  It determines how the "resolution resources"  are to be searched.
+ Possible values:
+	- kCCFileUtilsSearchSuffix: It will search for resources by appending suffixes like "-hd", "-ipad", etc...
+	- kCCFileUtilsSearchDirectory: It will search the resoureces in subdirectories like "resources-hd", "resources-ipad", etc...
+ 
+ Default: kCCFileUtilsSearchSuffix
+ @since v2.1
+ */
+@property (nonatomic, readwrite) int searchMode;
+
+/** Dictionary used to lookup filenames based on a key.
+ It is used internally by the following methods:
+
+  *	-(NSString*) fullPathForFilename:(NSString*)key resolutionType:(ccResolutionType*)resolutionType;
+  *	-(NSString*) fullPathForFilenameIgnoringResolutions:(NSString*)key;
+
+ @since v2.1
+ */
+@property (nonatomic, readwrite, copy) NSMutableDictionary *filenameLookup;
+
+#ifdef __CC_PLATFORM_IOS
+/** The iPhone RetinaDisplay suffixes to load resources.
+ By default it is "-hd" and "" in that order.
+ Only valid on iOS. Not valid for OS X.
+ 
+ @since v1.1
+ */
+-(void) setiPhoneRetinaDisplaySuffix:(NSString*)iPhoneRetinaDisplaySuffix;
+
+/** The iPad suffixes to load resources.
+ By default it is "-ipad", "-hd", "", in that order.
+ Only valid on iOS. Not valid for OS X.
+ 
+ @since v1.1
+ */
+-(void) setiPadSuffix:(NSString*) iPadSuffix;
+
+
+/** Sets the iPad Retina Display suffixes to load resources.
+ By default it is "-ipadhd", "-ipad", "-hd", "", in that order.
+ Only valid on iOS. Not valid for OS X.
+ 
+ @since v2.0
+ */
+-(void)setiPadRetinaDisplaySuffix:(NSString*)iPadRetinaDisplaySuffix;
+
+#endif // __CC_PLATFORM_IOS
+
+
+/** returns the shared file utils instance */
++(CCFileUtils*) sharedFileUtils;
+
+
+/** Purge cached entries.
+ Will be called automatically by the Director when a memory warning is received
+ */
+-(void) purgeCachedEntries;
+
+/** Calling this method will populate the searchResolutionsOrder property depending on the current device.
+ 
+ @since v2.1
+ */
+- (void) buildSearchResolutionsOrder;
+
+/** Returns the fullpath of an filename.
+
+ If in iPhoneRetinaDisplay mode, and a RetinaDisplay file is found, it will return that path.
+ If in iPad mode, and an iPad file is found, it will return that path.
+ 
+ If the filename can't be found, it will return "relPath" instead of nil.
+
+ Examples:
+
+  * In iPad mode: "image.png" -> "/full/path/image-ipad.png" (in case the -ipad file exists)
+  * In iPhone RetinaDisplay mode: "image.png" -> "/full/path/image-hd.png" (in case the -hd file exists)
+  * In iPad RetinaDisplay mode: "image.png" -> "/full/path/image-ipadhd.png" (in case the -ipadhd file exists)
+
+ */
+-(NSString*) fullPathFromRelativePath:(NSString*) relPath;
+
+/** Returns the fullpath of an filename. It will try to get the correct file for the current screen resolution.
+ Useful for loading images and other assets that are related for the screen resolution.
+ 
+ If in iPad mode, and an iPad file is found, it will return that path.
+ If in iPhoneRetinaDisplay mode, and a RetinaDisplay file is found, it will return that path. But if it is not found, it will try load an iPhone Non-RetinaDisplay  file.
+
+ If the filename can't be found, it will return "relPath" instead of nil.
+
+ Examples:
+ 
+ * In iPad mode: "image.png" -> "/full/path/image-ipad.png" (in case the -ipad file exists)
+ * In iPhone RetinaDisplay mode: "image.png" -> "/full/path/image-hd.png" (in case the -hd file exists)
+ * In iPad RetinaDisplay mode: "image.png" -> "/full/path/image-ipadhd.png" (in case the -ipadhd file exists)
+ 
+ */
+-(NSString*) fullPathFromRelativePath:(NSString*)relPath resolutionType:(ccResolutionType*)resolutionType;
+
+/** Returns the fullpath of an filename without taking into account the screen resolution suffixes or directories.
+
+ It will use the "searchPath" though.
+ If the file can't be found, it will return nil.
+
+ Useful for loading music files, shaders, "data" and other files that are not related to the screen resolution of the device.
+ 
+ @since v2.1
+ */
+-(NSString*) fullPathFromRelativePathIgnoringResolutions:(NSString*)relPath;
+
+/** Returns the fullpath for a given filename.
+ 
+ First it will try to get a new filename from the "filenameLookup" dictionary. If a new filename can't be found on the dictionary, it will use the original filename.
+ Then it will try obtain the full path of the filename using the CCFileUtils search rules: resolutions, and search paths
+ 
+ If in iPad mode, and an iPad file is found, it will return that path.
+ If in iPhoneRetinaDisplay mode, and a RetinaDisplay file is found, it will return that path. But if it is not found, it will try load an iPhone Non-RetinaDisplay  file.
+ 
+ If the filename can't be found on the file system, it will return nil.
+ 
+ This method was added to simplify multiplatform support. Whether you are using cocos2d-js or any cross-compilation toolchain like StellaSDK or Apportable,
+ you might need to load differerent resources for a given file in the different platforms.
+ 
+ Examples:
+ 
+ * In iPad mode: "image.png" -> "image.pvr" -> "/full/path/image-ipad.pvr" (in case the -ipad file exists)
+ * In Android: "image.png" -> "image.png" -> "/full/path/image.png"
+ 
+ @since v2.1
+ */
+-(NSString*) fullPathForFilename:(NSString*)filename;
+
+/** Returns the fullpath for a given filename.
+ 
+ First it will try to get a new filename from the "filenameLookup" dictionary. If a new filename can't be found on the dictionary, it will use the original filename.
+ Then it will try obtain the full path of the filename using the CCFileUtils search rules: resolutions, and search paths
+ 
+ If in iPad mode, and an iPad file is found, it will return that path.
+ If in iPhoneRetinaDisplay mode, and a RetinaDisplay file is found, it will return that path. But if it is not found, it will try load an iPhone Non-RetinaDisplay  file.
+ 
+ If the filename can't be found on the file system, it will return nil.
+ 
+ This method was added to simplify multiplatform support. Whether you are using cocos2d-js or any cross-compilation toolchain like StellaSDK or Apportable,
+ you might need to load differerent resources for a given file in the different platforms.
+ 
+ Examples:
+ 
+ * In iPad mode: "image.png" -> "image.pvr" -> "/full/path/image-ipad.pvr" (in case the -ipad file exists)
+ * In Android: "image.png" -> "image.png" -> "/full/path/image.png"
+ 
+ @since v2.1
+ */
+-(NSString*) fullPathForFilename:(NSString*)filename resolutionType:(ccResolutionType*)resolutionType;
+
+/** Returns the fullpath for a given filename, without taking into account device resolution.
+ 
+ It will try to get a new filename from the "filenameLookup" dictionary. If a new filename can't be found on the dictionary, it will use the original filename.
+ 
+ Once it gets the filename, it will try to get the fullpath for the filename, using the "searchPath", but it won't use any resolution search rules.
+ If the file can't be found, it will return nil.
+ 
+ Useful for loading music files, shaders, "data" and other files that are not related to the screen resolution of the device.
+ 
+ This method was added to simplify multiplatform support. Whether you are using cocos2d-js or any cross-compilation toolchain like StellaSDK or Apportable,
+ you might need to load differerent resources for a given file in the different platforms.
+
+ Examples:
+ 
+ * On iOS: "sound.wav" -> "sound.caf" -> "/full/path/sound.caf" (in case the key dictionary says that "sound.wav" should be converted to "sound.caf")
+ * On Android: "sound.wav" -> "sound.wav" -> "/full/path/sound.caf" (in case the key dictionary says that "sound.wav" should be converted to "sound.caf")
+
+ 
+ @since v2.1
+ */
+-(NSString*) fullPathForFilenameIgnoringResolutions:(NSString*)key;
+
+/* Loads the filenameLookup dictionary from the contents of a filename.
+ 
+ @since v2.1
+ */
+-(void) loadFilenameLookupDictionaryFromFile:(NSString*)filename;
+
+/** removes the suffix from a path
+ * On iPhone RetinaDisplay it will remove the -hd suffix
+ * On iPad it will remove the -ipad suffix
+ * On iPad RetinaDisplay it will remove the -ipadhd suffix
+ 
+ @since v0.99.5
+ */
+-(NSString *)removeSuffixFromFile:(NSString*) path;
+
+/* Stadarize a path.
+ 
+ It calls [string stringByStandardizingPath], and if "suffix mode" is on, it will also call [self removeSuffixFromFile:path];
+ 
+ @since v2.1
+ */
+-(NSString*) standarizePath:(NSString*)path;
+
+#ifdef __CC_PLATFORM_IOS
+
+/** Returns whether or not a given path exists with the iPhone RetinaDisplay suffix.
+ Only available on iOS. Not supported on OS X.
+ @since v1.1
+ */
+-(BOOL) iPhoneRetinaDisplayFileExistsAtPath:(NSString*)filename;
+
+/** Returns whether or not a given filename exists with the iPad suffix.
+ Only available on iOS. Not supported on OS X.
+ @since v1.1
+ */
+-(BOOL) iPadFileExistsAtPath:(NSString*)filename;
+
+/** Returns whether or not a given filename exists with the iPad RetinaDisplay suffix.
+ Only available on iOS. Not supported on OS X.
+ @since v2.0
+ */
+-(BOOL) iPadRetinaDisplayFileExistsAtPath:(NSString*)filename;
+
+#endif // __CC_PLATFORM_MAC
+
+/**
+ @deprecated
+ */
+-(void) setEnableFallbackSuffixes:(BOOL)enableFallbackSuffixes;
+
+@end
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** loads a file into memory.
+ the caller should release the allocated buffer.
+
+ @returns the size of the allocated buffer
+ @since v0.99.5
+ */
+NSInteger ccLoadFileIntoMemory(const char *filename, unsigned char **out);
+	
+#ifdef __cplusplus
+}
+#endif