mirror of https://github.com/axmolengine/axmol.git
167 lines
6.3 KiB
C++
167 lines
6.3 KiB
C++
/****************************************************************************
|
|
Copyright (c) 2010 cocos2d-x.org
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
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.
|
|
****************************************************************************/
|
|
#ifndef __CC_FILEUTILS_PLATFORM_H__
|
|
#define __CC_FILEUTILS_PLATFORM_H__
|
|
|
|
#include <string>
|
|
#include "CCPlatformMacros.h"
|
|
#include "ccTypes.h"
|
|
|
|
NS_CC_BEGIN
|
|
|
|
//! @brief Helper class to handle file operations
|
|
class CC_DLL CCFileUtils
|
|
{
|
|
public:
|
|
static CCFileUtils* sharedFileUtils();
|
|
static void purgeFileUtils();
|
|
|
|
void purgeCachedEntries();
|
|
/**
|
|
@brief Get resource file data
|
|
@param[in] pszFileName The resource file name which contain the path
|
|
@param[in] pszMode The read mode of the file
|
|
@param[out] pSize If get the file data succeed the it will be the data size,or it will be 0
|
|
@return if success,the pointer of data will be returned,or NULL is returned
|
|
@warning If you get the file data succeed,you must delete it after used.
|
|
*/
|
|
unsigned char* getFileData(const char* pszFileName, const char* pszMode, unsigned long * pSize);
|
|
|
|
/**
|
|
@brief Get resource file data from zip file
|
|
@param[in] pszFileName The resource file name which contain the relative path of zip file
|
|
@param[out] pSize If get the file data succeed the it will be the data size,or it will be 0
|
|
@return if success,the pointer of data will be returned,or NULL is returned
|
|
@warning If you get the file data succeed,you must delete it after used.
|
|
*/
|
|
unsigned char* getFileDataFromZip(const char* pszZipFilePath, const char* pszFileName, unsigned long * pSize);
|
|
|
|
/** removes the suffix from a path
|
|
* On RetinaDisplay it will remove the -hd suffix
|
|
* On iPad it will remove the -ipad suffix
|
|
* On iPhone it will remove the (empty) suffix
|
|
Only valid on iOS. Not valid for OS X.
|
|
|
|
@since v0.99.5
|
|
*/
|
|
std::string& removeSuffixFromFile(std::string& path);
|
|
|
|
/**
|
|
@brief Generate the absolute path of the file.
|
|
@param pszRelativePath The relative path of the file.
|
|
@return The absolute path of the file.
|
|
@warning We only add the ResourcePath before the relative path of the file.
|
|
If you have not set the ResourcePath,the function add "/NEWPLUS/TDA_DATA/UserData/" as default.
|
|
You can set ResourcePath by function void setResourcePath(const char *pszResourcePath);
|
|
*/
|
|
const char* fullPathFromRelativePath(const char *pszRelativePath);
|
|
|
|
/** Returns the fullpath of an filename including the resolution of the image.
|
|
|
|
If in RetinaDisplay 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.
|
|
|
|
Examples:
|
|
|
|
* In iPad mode: "image.png" -> "/full/path/image-ipad.png" (in case the -ipad file exists)
|
|
* In RetinaDisplay mode: "image.png" -> "/full/path/image-hd.png" (in case the -hd file exists)
|
|
|
|
If an iPad file is found, it will set resolution type to kCCResolutioniPad
|
|
If a RetinaDisplay file is found, it will set resolution type to kCCResolutionRetinaDisplay
|
|
|
|
*/
|
|
const char* fullPathFromRelativePath(const char *pszRelativePath, ccResolutionType *pResolutionType);
|
|
|
|
/// @cond
|
|
const char* fullPathFromRelativeFile(const char *pszFilename, const char *pszRelativeFile);
|
|
/// @endcond
|
|
|
|
/** Sets the iPhone RetinaDisplay suffix to load resources.
|
|
By default it is "-hd".
|
|
Only valid on iOS. Not valid for OS X.
|
|
|
|
@since v1.1
|
|
*/
|
|
void setiPhoneRetinaDisplaySuffix(const char *suffix);
|
|
|
|
/** Sets the iPad suffix to load resources.
|
|
By default it is "".
|
|
Only valid on iOS. Not valid for OS X.
|
|
|
|
|
|
*/
|
|
void setiPadSuffix(const char *suffix);
|
|
|
|
/** Sets the iPad Retina Display suffix to load resources.
|
|
By default it is "-ipadhd".
|
|
Only valid on iOS. Not valid for OS X.
|
|
|
|
@since v1.1
|
|
*/
|
|
void setiPadRetinaDisplaySuffix(const char *suffix);
|
|
|
|
/** 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(const char *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(const char *filename);
|
|
|
|
/** 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(const char *filename);
|
|
|
|
/**
|
|
@brief Set the ResourcePath,we will find resource in this path
|
|
@param pszResourcePath The absolute resource path
|
|
@warning Don't call this function in android and iOS, it has not effect.
|
|
In android, if you want to read file other than apk, you shoud use invoke getFileData(), and pass the
|
|
absolute path.
|
|
*/
|
|
void setResourcePath(const char *pszResourcePath);
|
|
|
|
/**
|
|
@brief Get the writeable path
|
|
@return The path that can write/read file
|
|
*/
|
|
std::string getWriteablePath();
|
|
|
|
/**
|
|
@brief Set/Get whether pop-up a message box when the image load failed
|
|
*/
|
|
void setIsPopupNotify(bool bNotify);
|
|
bool getIsPopupNotify();
|
|
};
|
|
|
|
NS_CC_END
|
|
|
|
#endif // __CC_FILEUTILS_PLATFORM_H__
|