COCOS-Tiled地图类

一、TMXTiledMap类

cocos2dx提供了TMXTiledMap类来管理tiled瓦片地图，主要包括地图层、瓦片信息等，其主要方法、属性如下：

class CC_DLL TMXTiledMap : public Node{    // 使用.tmx格式的文件创建瓦片地图    static TMXTiledMap* create(const std::string& tmxFile);  /** * 获取瓦片地图的属性信息 **/    // 获取瓦片地图的指定名称的属性值    Value getProperty(const std::string& propertyName) const;    // 获取瓦片地图的所有属性（键-值对）    void setProperties(const ValueMap& properties); // 可以修改属性    ValueMap& getProperties();      // 获取瓦片地图（单位：瓦片数量）    void setMapSize(const Size& mapSize);    Size& getMapSize() const;    // 获取单个瓦片的尺寸（单位：像素）    void setTileSize(const Size& tileSize);    Size& getTileSize() const;      // 通过GID获取图块的属性，返回Value字典    // 其实返回的是：ValueMap，即（键-值对）    Value getPropertiesForGID(int GID) const;  /** * 获取地图层、对象层 **/    // 获取指定名称的地图层 TMXLayer    TMXLayer* getLayer(const std::string& layerName) const;      // 获取指定名称的对象层 TMXObjectGroup    TMXObjectGroup* getObjectGroup(const std::string& groupName) const;    // 获取瓦片地图的所有对象层，返回对象数组 Vector<TMXObjectGroup*>    void setObjectGroups(const Vector<TMXObjectGroup*>& groups);    Vector<TMXObjectGroup*>& getObjectGroups() const;    // 瓦片地图的尺寸，以瓦片数量为单位    Size _mapSize;    // 瓦片的尺寸，以瓦片像素为单位    Size _tileSize;};

二、TMXLayer类

TMXLayer类管理tiled的地图层，包含该地图层中的每个瓦片的信息，而每一个瓦片都被表示成精灵，其主要方法、属性如下：

class CC_DLL TMXLayer : public SpriteBatchNode {/** * 获取地图层的属性信息 **/      // 获取地图层的名字    void setLayerName(const std::string& layerName); // 可以重新设置地图层名字    std::string& getLayerName();      // 获取地图层的propertyName属性值    Value getProperty(const std::string& propertyName) const;    // 获取地图层的所有自定义属性字典（键-值对）    void setProperties(const ValueMap& properties);    ValueMap& getProperties();      // 获取地图层尺寸，一般等于瓦片地图的尺寸（单位：瓦片数量）    void setLayerSize(const Size& size);    Size& getLayerSize() const;    // 设置瓦片尺寸的大小，一般与瓦片地图的瓦片尺寸是一样的（单位：像素）    void setMapTileSize(const Size& size);    Size& getMapTileSize() const;  /** * 对地图层的瓦片进行操作 **/    // 获取指定tile坐标的瓦片(Sprite)    Sprite* getTileAt(const Vec2& tileCoordinate);      // 可通过调用如下方法对瓦片精灵进行删除：    void removeTileAt(const Vec2& tileCoordinate);    void removeChild(Node* child, bool cleanup) override;      // 获取指定tile坐标的瓦片对应的OpenGL坐标位置    Vec2 getPositionAt(const Vec2& tileCoordinate);      // 设置指定tile坐标的瓦片，将其图片变为GID的图块。    void setTileGID(uint32_t gid, const Vec2& tileCoordinate);      // 获取指定tile坐标的瓦片所使用的图块的GID。    uint32_t getTileGIDAt(const Vec2& tileCoordinate);    // 地图层的名字    std::string _layerName;    // 地图层的尺寸，以瓦片数量为单位    Size _layerSize;    // 地图层的瓦片的尺寸，以瓦片像素为单位    Size _mapTileSize;};

三、TMXObjectGroup类

TMXObjectGroup类用于管理tiled地图中特殊的地图层，即对象层，包括所有的对象及其所有的属性，而每一个对象的所有属性被存储为ValueMap键-值对映射，其主要方法、属性如下：

class CC_DLL TMXObjectGroup : public Ref{/** * 获取对象层的属性信息 **/      // 获取对象层的名称    void setGroupName(const std::string& groupName); // 可以重新设置对象层名称    std::string& getGroupName();      // 获取对象层的propertyName属性值    Value getProperty(const std::string& propertyName) const;        // 获取对象层所有属性（键-值对）    void setProperties(const ValueMap& properties);    ValueMap& getProperties();      // 获取对象层指定的objectName对象，其所有属性被存储为ValueMap（键-值对）    ValueMap getObject(const std::string& objectName) const;    // 获取对象层的所有对象    void setObjects(const ValueVector& objects);    ValueVector& getObjects();// 对象层的名称    std::string _groupName;// 所有的对象    ValueVector _objects;};