mirror of https://github.com/axmolengine/axmol.git
264 lines
9.2 KiB
C++
264 lines
9.2 KiB
C++
/****************************************************************************
|
|
Copyright (c) 2008-2010 Ricardo Quesada
|
|
Copyright (c) 2010-2012 cocos2d-x.org
|
|
Copyright (c) 2011 Zynga Inc.
|
|
Copyright (c) 2013-2014 Chukong Technologies Inc.
|
|
|
|
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 __CCTMX_LAYER2_H__
|
|
#define __CCTMX_LAYER2_H__
|
|
|
|
#include "CCTMXObjectGroup.h"
|
|
#include "CCTMXXMLParser.h"
|
|
#include "CCNode.h"
|
|
#include "renderer/CCCustomCommand.h"
|
|
|
|
#include "ccCArray.h"
|
|
|
|
NS_CC_BEGIN
|
|
|
|
class TMXMapInfo;
|
|
class TMXLayerInfo;
|
|
class TMXTilesetInfo;
|
|
class Texture2D;
|
|
class Sprite;
|
|
struct _ccCArray;
|
|
|
|
|
|
//! a Point with a vertex point, a tex coord point and a color 4F
|
|
struct V2F_T2F
|
|
{
|
|
//! vertices (2F)
|
|
Vertex2F vertices;
|
|
//! tex coords (2F)
|
|
Tex2F texCoords;
|
|
};
|
|
|
|
//! a Point with a vertex point, a tex coord point and a color 4F
|
|
struct V2F_T2F_Quad
|
|
{
|
|
//! top left
|
|
struct V2F_T2F tl;
|
|
//! bottom left
|
|
struct V2F_T2F bl;
|
|
//! top right
|
|
struct V2F_T2F tr;
|
|
//! bottom right
|
|
struct V2F_T2F br;
|
|
};
|
|
|
|
|
|
/**
|
|
* @addtogroup tilemap_parallax_nodes
|
|
* @{
|
|
*/
|
|
|
|
/** @brief TMXLayer2 represents the TMX layer.
|
|
|
|
It is a subclass of SpriteBatchNode. By default the tiles are rendered using a TextureAtlas.
|
|
If you modify a tile on runtime, then, that tile will become a Sprite, otherwise no Sprite objects are created.
|
|
The benefits of using Sprite objects as tiles are:
|
|
- tiles (Sprite) can be rotated/scaled/moved with a nice API
|
|
|
|
If the layer contains a property named "cc_vertexz" with an integer (in can be positive or negative),
|
|
then all the tiles belonging to the layer will use that value as their OpenGL vertex Z for depth.
|
|
|
|
On the other hand, if the "cc_vertexz" property has the "automatic" value, then the tiles will use an automatic vertex Z value.
|
|
Also before drawing the tiles, GL_ALPHA_TEST will be enabled, and disabled after drawing them. The used alpha func will be:
|
|
|
|
glAlphaFunc( GL_GREATER, value )
|
|
|
|
"value" by default is 0, but you can change it from Tiled by adding the "cc_alpha_func" property to the layer.
|
|
The value 0 should work for most cases, but if you have tiles that are semi-transparent, then you might want to use a different
|
|
value, like 0.5.
|
|
|
|
For further information, please see the programming guide:
|
|
|
|
http://www.cocos2d-iphone.org/wiki/doku.php/prog_guide:tiled_maps
|
|
|
|
@since v0.8.1
|
|
Tiles can have tile flags for additional properties. At the moment only flip horizontal and flip vertical are used. These bit flags are defined in TMXXMLParser.h.
|
|
|
|
@since 1.1
|
|
*/
|
|
|
|
class CC_DLL TMXLayer2 : public Node
|
|
{
|
|
public:
|
|
/** creates a TMXLayer2 with an tileset info, a layer info and a map info */
|
|
static TMXLayer2 * create(TMXTilesetInfo *tilesetInfo, TMXLayerInfo *layerInfo, TMXMapInfo *mapInfo);
|
|
/**
|
|
* @js ctor
|
|
*/
|
|
TMXLayer2();
|
|
/**
|
|
* @js NA
|
|
* @lua NA
|
|
*/
|
|
virtual ~TMXLayer2();
|
|
|
|
/** dealloc the map that contains the tile position from memory.
|
|
Unless you want to know at runtime the tiles positions, you can safely call this method.
|
|
If you are going to call layer->tileGIDAt() then, don't release the map
|
|
*/
|
|
void releaseMap();
|
|
|
|
/** returns the tile gid at a given tile coordinate. It also returns the tile flags.
|
|
This method requires the the tile map has not been previously released (eg. don't call [layer releaseMap])
|
|
*/
|
|
int getTileGIDAt(const Point& tileCoordinate, ccTMXTileFlags* flags = nullptr);
|
|
CC_DEPRECATED_ATTRIBUTE int tileGIDAt(const Point& tileCoordinate, ccTMXTileFlags* flags = nullptr){
|
|
return getTileGIDAt(tileCoordinate, flags);
|
|
};
|
|
|
|
/** sets the tile gid (gid = tile global id) at a given tile coordinate.
|
|
The Tile GID can be obtained by using the method "tileGIDAt" or by using the TMX editor -> Tileset Mgr +1.
|
|
If a tile is already placed at that position, then it will be removed.
|
|
*/
|
|
void setTileGID(int gid, const Point& tileCoordinate);
|
|
|
|
/** sets the tile gid (gid = tile global id) at a given tile coordinate.
|
|
The Tile GID can be obtained by using the method "tileGIDAt" or by using the TMX editor -> Tileset Mgr +1.
|
|
If a tile is already placed at that position, then it will be removed.
|
|
|
|
Use withFlags if the tile flags need to be changed as well
|
|
*/
|
|
|
|
void setTileGID(int gid, const Point& tileCoordinate, ccTMXTileFlags flags);
|
|
|
|
/** removes a tile at given tile coordinate */
|
|
void removeTileAt(const Point& tileCoordinate);
|
|
|
|
/** returns the position in points of a given tile coordinate */
|
|
Point getPositionAt(const Point& tileCoordinate);
|
|
CC_DEPRECATED_ATTRIBUTE Point positionAt(const Point& tileCoordinate) { return getPositionAt(tileCoordinate); };
|
|
|
|
/** return the value for the specific property name */
|
|
Value getProperty(const std::string& propertyName) const;
|
|
CC_DEPRECATED_ATTRIBUTE Value propertyNamed(const std::string& propertyName) const { return getProperty(propertyName); };
|
|
|
|
/** Creates the tiles */
|
|
void setupTiles();
|
|
|
|
inline const std::string& getLayerName(){ return _layerName; }
|
|
inline void setLayerName(const std::string& layerName){ _layerName = layerName; }
|
|
|
|
/** size of the layer in tiles */
|
|
inline const Size& getLayerSize() const { return _layerSize; };
|
|
inline void setLayerSize(const Size& size) { _layerSize = size; };
|
|
|
|
/** size of the map's tile (could be different from the tile's size) */
|
|
inline const Size& getMapTileSize() const { return _mapTileSize; };
|
|
inline void setMapTileSize(const Size& size) { _mapTileSize = size; };
|
|
|
|
/** pointer to the map of tiles
|
|
* @js NA
|
|
* @lua NA
|
|
*/
|
|
inline int* getTiles() const { return _tiles; };
|
|
inline void setTiles(int* tiles) { _tiles = tiles; };
|
|
|
|
/** Tileset information for the layer */
|
|
inline TMXTilesetInfo* getTileSet() const { return _tileSet; };
|
|
inline void setTileSet(TMXTilesetInfo* info) {
|
|
CC_SAFE_RETAIN(info);
|
|
CC_SAFE_RELEASE(_tileSet);
|
|
_tileSet = info;
|
|
};
|
|
|
|
/** Layer orientation, which is the same as the map orientation */
|
|
inline int getLayerOrientation() const { return _layerOrientation; };
|
|
inline void setLayerOrientation(int orientation) { _layerOrientation = orientation; };
|
|
|
|
/** properties from the layer. They can be added using Tiled */
|
|
inline const ValueMap& getProperties() const { return _properties; };
|
|
inline ValueMap& getProperties() { return _properties; };
|
|
inline void setProperties(const ValueMap& properties) {
|
|
_properties = properties;
|
|
};
|
|
|
|
//
|
|
// Override
|
|
//
|
|
virtual std::string getDescription() const override;
|
|
virtual void draw() override;
|
|
|
|
protected:
|
|
|
|
bool initWithTilesetInfo(TMXTilesetInfo *tilesetInfo, TMXLayerInfo *layerInfo, TMXMapInfo *mapInfo);
|
|
void appendTileForGID(int gid, const Point& pos);
|
|
void setupTileSprite(Sprite* sprite, Point pos, int gid);
|
|
void setupIndices();
|
|
void setupVertices();
|
|
void setupVBO();
|
|
void setVerticesForPos(int x, int y, GLfloat *xpos0, GLfloat *xpos1, GLfloat *ypos0, GLfloat *ypos1);
|
|
int getTileIndex(int x, int y, Point base);
|
|
void updateTexCoords(const Point& baseTile);
|
|
|
|
Point calculateLayerOffset(const Point& offset);
|
|
|
|
/* The layer recognizes some special properties, like cc_vertez */
|
|
void parseInternalProperties();
|
|
|
|
void onDraw();
|
|
|
|
// index
|
|
ssize_t atlasIndexForExistantZ(int z);
|
|
ssize_t atlasIndexForNewZ(int z);
|
|
|
|
|
|
CustomCommand _customCommand;
|
|
|
|
//! name of the layer
|
|
std::string _layerName;
|
|
|
|
/** size of the layer in tiles */
|
|
Size _layerSize;
|
|
/** size of the map's tile (could be different from the tile's size) */
|
|
Size _mapTileSize;
|
|
/** pointer to the map of tiles */
|
|
int* _tiles;
|
|
/** Tileset information for the layer */
|
|
TMXTilesetInfo* _tileSet;
|
|
/** Layer orientation, which is the same as the map orientation */
|
|
int _layerOrientation;
|
|
/** properties from the layer. They can be added using Tiled */
|
|
ValueMap _properties;
|
|
|
|
//
|
|
Texture2D *_texture;
|
|
|
|
GLuint _buffersVBO[3]; //0: vertex, 1: tex coords, 2: indices
|
|
|
|
Size _screenGridSize;
|
|
int _screenTileCount;
|
|
Point _lastPosition;
|
|
};
|
|
|
|
// end of tilemap_parallax_nodes group
|
|
/// @}
|
|
|
|
NS_CC_END
|
|
|
|
#endif //__CCTMX_LAYER2_H__
|
|
|