首页 > 代码库 > cocod2d-x 之 CCTMXTiledMap & CCTMXLayer

cocod2d-x 之 CCTMXTiledMap & CCTMXLayer

  cocos2dx框架自带的地图CCTMXTiledMap,继承自CCNode。CCTMXTiledMap的坐标系的原点位于左上角,以一个瓦片为单位,换句话说,左上角第一块瓦片的坐标为(0,0),而紧挨着它的右边的瓦片坐标就是(1,0)。TileMap中的每一个瓦片拥有一个唯一的编号GID,用于在地图中查找某个瓦片。Cocos2d-x提供了一系列方法,可以从瓦片地图坐标获取对应瓦片的GID,同时还可以利用这些方法来判断某个坐标下是否存在瓦片。

属性:

CCSize  m_tMapSize,地图大小(以瓦片为单位)

CCSize  m_tTileSize,瓦片大小(以像素为单位)

int  m_nMapOrientation,地图类型(enum{CCTMXOrientationOrtho,CCTMXOrientationHex,CCTMXOrientationIso,};

CCArray*  m_pObjectGroups,对象集合

CCDictionary* m_pProperties,属性字典

CCDictionary* m_pTileProperties,瓦片属性

方法:

创建地图

static CCTMXTiledMap* create(const char *tmxFile)

static CCTMXTiledMap* createWithXML(const char* tmxString, const char* resourcePath)

地图初始化

bool initWithTMXFile(const char *tmxFile)

bool initWithXML(const char* tmxString, const char* resourcePath)

获取地图层

CCTMXLayer* layerNamed(const char *layerName)

获取根据名称对象组

CCTMXObjectGroup* objectGroupNamed(const char *groupName)

获取属性值

CCString *propertyNamed(const char *propertyName)

根据瓦片GID获取属性字典

CCDictionary* propertiesForGID(int GID)

 

  CCTMXLayer继承自CCSpriteBatchNode,代表一个瓦片地图中的图层,可以从图层对象获取图层信息,如某一点是否存在对象组或属性。

属性:

std::string m_sLayerName,图层名称

unsigned char m_cOpacity,透明度

unsigned int m_uMinGID
unsigned int m_uMaxGID

int m_nVertexZvalue,Z轴
bool m_bUseAutomaticVertexZ,由框架自动管理Z轴值

float m_fContentScaleFactor,缩放

CCSize  m_tLayerSize,图层大小(以瓦片为单位)

CCSize  m_tMapTileSize,瓦片大小(可能与tileMap不同)

unsigned int*  m_pTiles,指向瓦片的指针

CCTMXTilesetInfo*  m_pTileSet,图层瓦片信息

unsigned int  m_uLayerOrientation,和tileMap一样

CCDictionary*  m_pProperties图层属性

方法

CCSprite* tileAt(const CCPoint& tileCoordinate),根据瓦片坐标返回瓦片精灵

unsigned int  tileGIDAt(const CCPoint& tileCoordinate),根据瓦片坐标返回GID,如为空则返回0

unsigned int tileGIDAt(const CCPoint& tileCoordinate, ccTMXTileFlags* flags),同上且返回flags

void setTileGID(unsigned int gid, const CCPoint& tileCoordinate),设置GID

void setTileGID(unsigned int gid, const CCPoint& tileCoordinate, ccTMXTileFlags flags)

void removeTileAt(const CCPoint& tileCoordinate),删除瓦片

CCPoint positionAt(const CCPoint& tileCoordinate),返回像素坐标

CCString *propertyNamed(const char *propertyName),获取属性

virtual void addChild(CCNode * child, int zOrder, int tag),添加对象

void removeChild(CCNode* child, bool cleanup),删除对象

const char* getLayerName()

void setLayerName(const char *layerName)

 

 1 #ifndef __CCTMX_TILE_MAP_H__ 2 #define __CCTMX_TILE_MAP_H__ 3  4 #include "base_nodes/CCNode.h" 5 #include "CCTMXObjectGroup.h" 6  7 NS_CC_BEGIN 8  9 class CCTMXObjectGroup;10 class CCTMXLayer;11 class CCTMXLayerInfo;12 class CCTMXTilesetInfo;13 class CCTMXMapInfo;14 15 /** TMX地图类型 */16 enum17 {18     /** 平面地图 */19     CCTMXOrientationOrtho,20 21     /** 六角地图 */22     CCTMXOrientationHex,23 24     /** 三维地图(45度斜视) */25     CCTMXOrientationIso,26 };27 28 class CC_DLL CCTMXTiledMap : public CCNode29 {30     /** 地图尺寸(以瓦片为单位) */31     CC_SYNTHESIZE_PASS_BY_REF(CCSize, m_tMapSize, MapSize);32  33     /** 地图尺寸(以像素为单位) */34     CC_SYNTHESIZE_PASS_BY_REF(CCSize, m_tTileSize, TileSize);35  36     /** 地图类型(朝向) */37     CC_SYNTHESIZE(int, m_nMapOrientation, MapOrientation);38  39     /** 地图内对象集合 */40     CC_PROPERTY(CCArray*, m_pObjectGroups, ObjectGroups);41  42     /** 地图内对象字典 */43     CC_PROPERTY(CCDictionary*, m_pProperties, Properties);44 public:45     46     CCTMXTiledMap();47     48     virtual ~CCTMXTiledMap();49 50  51     /** 根据tmx文件创建地图 */52     static CCTMXTiledMap* create(const char *tmxFile);53 54      /** 根据xml字符串和资源路径创建地图 */55     static CCTMXTiledMap* createWithXML(const char* tmxString, const char* resourcePath);56 57  58     /** 根据tmx文件初始化地图 */59     bool initWithTMXFile(const char *tmxFile);60 61      /** 根据xml字符串和资源路径初始化地图 */62     bool initWithXML(const char* tmxString, const char* resourcePath);63 64  65     /** 获取地图中的层 */66     CCTMXLayer* layerNamed(const char *layerName);67 68  69     /** 获取对象集合 */70     CCTMXObjectGroup* objectGroupNamed(const char *groupName);71 72  73     /** 获取属性值 */74     CCString *propertyNamed(const char *propertyName);75 76  77     /** 根据GID返回属性字典 */78     CCDictionary* propertiesForGID(int GID);79 80 private:81     CCTMXLayer * parseLayer(CCTMXLayerInfo *layerInfo, CCTMXMapInfo *mapInfo);82     CCTMXTilesetInfo * tilesetForLayer(CCTMXLayerInfo *layerInfo, CCTMXMapInfo *mapInfo);83     void buildWithMapInfo(CCTMXMapInfo* mapInfo);84 protected:85     //地图属性字典86     CCDictionary* m_pTileProperties;87 88 };89 90 NS_CC_END
CCTMXTiledMap.h
  1 #ifndef __CCTMX_LAYER_H__  2 #define __CCTMX_LAYER_H__  3   4 #include "CCTMXObjectGroup.h"  5 #include "base_nodes/CCAtlasNode.h"  6 #include "sprite_nodes/CCSpriteBatchNode.h"  7 #include "CCTMXXMLParser.h"  8 NS_CC_BEGIN  9  10 class CCTMXMapInfo; 11 class CCTMXLayerInfo; 12 class CCTMXTilesetInfo; 13 struct _ccCArray; 14  15 class CC_DLL CCTMXLayer : public CCSpriteBatchNode 16 { 17     /** layer尺寸( 以tile为单位) */ 18     CC_SYNTHESIZE_PASS_BY_REF(CCSize, m_tLayerSize, LayerSize); 19     /** size of the map‘s tile (could be different from the tile‘s size) */ 20     /** layer尺寸( 以tile为单位,可能与tile不同) */ 21     CC_SYNTHESIZE_PASS_BY_REF(CCSize, m_tMapTileSize, MapTileSize); 22     /** pointer to the map of tiles */ 23     CC_SYNTHESIZE(unsigned int*, m_pTiles, Tiles); 24     /** Tileset information for the layer */ 25     CC_PROPERTY(CCTMXTilesetInfo*, m_pTileSet, TileSet); 26     /** Layer orientation, which is the same as the map orientation */ 27     CC_SYNTHESIZE(unsigned int, m_uLayerOrientation, LayerOrientation); 28     /** properties from the layer. They can be added using Tiled */ 29     CC_PROPERTY(CCDictionary*, m_pProperties, Properties); 30 public: 31     /** 32      * @js ctor 33      * @lua NA 34      */ 35     CCTMXLayer(); 36     /** 37      * @js NA 38      * @lua NA 39      */ 40     virtual ~CCTMXLayer(); 41    42     /** creates a CCTMXLayer with an tileset info, a layer info and a map info */ 43     static CCTMXLayer * create(CCTMXTilesetInfo *tilesetInfo, CCTMXLayerInfo *layerInfo, CCTMXMapInfo *mapInfo); 44  45     /** initializes a CCTMXLayer with a tileset info, a layer info and a map info  46      * @lua NA 47      */ 48     bool initWithTilesetInfo(CCTMXTilesetInfo *tilesetInfo, CCTMXLayerInfo *layerInfo, CCTMXMapInfo *mapInfo); 49  50     /** dealloc the map that contains the tile position from memory. 51     Unless you want to know at runtime the tiles positions, you can safely call this method. 52     If you are going to call layer->tileGIDAt() then, don‘t release the map 53     */ 54     void releaseMap(); 55  56     /** returns the tile (CCSprite) at a given a tile coordinate. 57     The returned CCSprite will be already added to the CCTMXLayer. Don‘t add it again. 58     The CCSprite can be treated like any other CCSprite: rotated, scaled, translated, opacity, color, etc. 59     You can remove either by calling: 60     - layer->removeChild(sprite, cleanup); 61     - or layer->removeTileAt(ccp(x,y)); 62     @js getTileGIDAt 63     */ 64     CCSprite* tileAt(const CCPoint& tileCoordinate); 65  66     /** returns the tile gid at a given tile coordinate. 67     if it returns 0, it means that the tile is empty. 68     This method requires the the tile map has not been previously released (eg. don‘t call layer->releaseMap()) 69     @js tileGIDAt 70     */ 71     unsigned int  tileGIDAt(const CCPoint& tileCoordinate); 72  73     /** returns the tile gid at a given tile coordinate. It also returns the tile flags. 74      This method requires the the tile map has not been previously released (eg. don‘t call [layer releaseMap]) 75      @js tileGIDAt 76      @lua NA 77      */ 78     unsigned int tileGIDAt(const CCPoint& tileCoordinate, ccTMXTileFlags* flags); 79  80     /** sets the tile gid (gid = tile global id) at a given tile coordinate. 81     The Tile GID can be obtained by using the method "tileGIDAt" or by using the TMX editor -> Tileset Mgr +1. 82     If a tile is already placed at that position, then it will be removed. 83     */ 84     void setTileGID(unsigned int gid, const CCPoint& tileCoordinate); 85  86     /** sets the tile gid (gid = tile global id) at a given tile coordinate. 87      The Tile GID can be obtained by using the method "tileGIDAt" or by using the TMX editor -> Tileset Mgr +1. 88      If a tile is already placed at that position, then it will be removed. 89       90      Use withFlags if the tile flags need to be changed as well 91      */ 92  93     void setTileGID(unsigned int gid, const CCPoint& tileCoordinate, ccTMXTileFlags flags); 94  95     /** removes a tile at given tile coordinate */ 96     void removeTileAt(const CCPoint& tileCoordinate); 97  98     /** returns the position in points of a given tile coordinate  99      * @js getPositionAt100      */101     CCPoint positionAt(const CCPoint& tileCoordinate);102 103     /** return the value for the specific property name 104      *  @js getProperty105      */106     CCString *propertyNamed(const char *propertyName);107 108     /** Creates the tiles */109     void setupTiles();110 111     /** CCTMXLayer doesn‘t support adding a CCSprite manually.112      *  @warning addchild(z, tag); is not supported on CCTMXLayer. Instead of setTileGID.113      *  @lua NA114      */115     virtual void addChild(CCNode * child, int zOrder, int tag);116     /** super method117      *  @lua NA118      */119     void removeChild(CCNode* child, bool cleanup);120 121     inline const char* getLayerName(){ return m_sLayerName.c_str(); }122     inline void setLayerName(const char *layerName){ m_sLayerName = layerName; }123 private:124     CCPoint positionForIsoAt(const CCPoint& pos);125     CCPoint positionForOrthoAt(const CCPoint& pos);126     CCPoint positionForHexAt(const CCPoint& pos);127 128     CCPoint calculateLayerOffset(const CCPoint& offset);129 130     /* optimization methods */131     CCSprite* appendTileForGID(unsigned int gid, const CCPoint& pos);132     CCSprite* insertTileForGID(unsigned int gid, const CCPoint& pos);133     CCSprite* updateTileForGID(unsigned int gid, const CCPoint& pos);134 135     /* The layer recognizes some special properties, like cc_vertez */136     void parseInternalProperties();137     void setupTileSprite(CCSprite* sprite, CCPoint pos, unsigned int gid);138     CCSprite* reusedTileWithRect(CCRect rect);139     int vertexZForPos(const CCPoint& pos);140 141     // index142     unsigned int atlasIndexForExistantZ(unsigned int z);143     unsigned int atlasIndexForNewZ(int z);144 protected:145     // layer的名称146     std::string m_sLayerName;147     //TMX Layer 的透明度148     unsigned char        m_cOpacity;149 150     unsigned int        m_uMinGID;151     unsigned int        m_uMaxGID;152 153     //vertexZ 启用后该参数才有效154     int                    m_nVertexZvalue;155     bool                m_bUseAutomaticVertexZ;156 157     // 用于优化158     CCSprite            *m_pReusedTile;159     ccCArray            *m_pAtlasIndexArray;160     161     // 用于视网膜显示屏162     float               m_fContentScaleFactor;            163 };164 165 166 NS_CC_END167 168 #endif //__CCTMX_LAYER_H__
CCTMXLayer.h