2010-08-31 15:11:13 +08:00
|
|
|
/****************************************************************************
|
|
|
|
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 __CCTMX_LAYER_H__
|
|
|
|
#define __CCTMX_LAYER_H__
|
|
|
|
#include "CCTMXObjectGroup.h"
|
|
|
|
#include "CCAtlasNode.h"
|
2010-12-31 09:36:53 +08:00
|
|
|
#include "CCSpriteBatchNode.h"
|
2010-08-31 15:11:13 +08:00
|
|
|
namespace cocos2d {
|
|
|
|
|
|
|
|
class CCTMXMapInfo;
|
|
|
|
class CCTMXLayerInfo;
|
|
|
|
class CCTMXTilesetInfo;
|
2010-09-02 15:48:47 +08:00
|
|
|
struct _ccCArray;
|
2010-08-31 15:11:13 +08:00
|
|
|
|
2010-09-29 09:44:57 +08:00
|
|
|
/** @brief CCTMXLayer represents the TMX layer.
|
2010-08-31 15:11:13 +08:00
|
|
|
|
2010-12-31 09:36:53 +08:00
|
|
|
It is a subclass of CCSpriteBatchNode. By default the tiles are rendered using a CCTextureAtlas.
|
2010-09-25 10:28:27 +08:00
|
|
|
If you modify a tile on runtime, then, that tile will become a CCSprite, otherwise no CCSprite objects are created.
|
2010-08-31 15:11:13 +08:00
|
|
|
The benefits of using CCSprite objects as tiles are:
|
|
|
|
- tiles (CCSprite) 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 drawin 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 differnt
|
|
|
|
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
|
|
|
|
*/
|
2010-12-31 09:36:53 +08:00
|
|
|
class CCX_DLL CCTMXLayer : public CCSpriteBatchNode
|
2010-08-31 15:11:13 +08:00
|
|
|
{
|
|
|
|
/** size of the layer in tiles */
|
|
|
|
CCX_SYNTHESIZE(CGSize, m_tLayerSize, LayerSize);
|
|
|
|
/** size of the map's tile (could be differnt from the tile's size) */
|
|
|
|
CCX_SYNTHESIZE(CGSize, m_tMapTileSize, MapTileSize);
|
|
|
|
/** pointer to the map of tiles */
|
|
|
|
CCX_SYNTHESIZE(unsigned int*, m_pTiles, Tiles);
|
|
|
|
/** Tilset information for the layer */
|
2010-09-04 18:06:26 +08:00
|
|
|
CCX_PROPERTY(CCTMXTilesetInfo*, m_pTileSet, TileSet);
|
2010-08-31 15:11:13 +08:00
|
|
|
/** Layer orientation, which is the same as the map orientation */
|
|
|
|
CCX_SYNTHESIZE(int, m_nLayerOrientation, LayerOrientation);
|
|
|
|
/** properties from the layer. They can be added using Tiled */
|
2010-09-07 11:26:28 +08:00
|
|
|
CCX_PROPERTY(CCXStringToStringDictionary*, m_pProperties, Properties);
|
2010-08-31 15:11:13 +08:00
|
|
|
public:
|
|
|
|
CCTMXLayer();
|
|
|
|
virtual ~CCTMXLayer();
|
|
|
|
/** creates a CCTMXLayer with an tileset info, a layer info and a map info */
|
|
|
|
static CCTMXLayer * layerWithTilesetInfo(CCTMXTilesetInfo *tilesetInfo, CCTMXLayerInfo *layerInfo, CCTMXMapInfo *mapInfo);
|
|
|
|
/** initializes a CCTMXLayer with a tileset info, a layer info and a map info */
|
|
|
|
bool initWithTilesetInfo(CCTMXTilesetInfo *tilesetInfo, CCTMXLayerInfo *layerInfo, CCTMXMapInfo *mapInfo);
|
|
|
|
|
|
|
|
/** 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.
|
2010-09-28 12:14:12 +08:00
|
|
|
If you are going to call layer->tileGIDAt() then, don't release the map
|
2010-08-31 15:11:13 +08:00
|
|
|
*/
|
|
|
|
void releaseMap();
|
|
|
|
|
|
|
|
/** returns the tile (CCSprite) at a given a tile coordinate.
|
|
|
|
The returned CCSprite will be already added to the CCTMXLayer. Don't add it again.
|
|
|
|
The CCSprite can be treated like any other CCSprite: rotated, scaled, translated, opacity, color, etc.
|
|
|
|
You can remove either by calling:
|
2010-09-28 12:14:12 +08:00
|
|
|
- layer->removeChild(sprite, cleanup);
|
|
|
|
- or layer->removeTileAt(ccp(x,y));
|
2010-08-31 15:11:13 +08:00
|
|
|
*/
|
|
|
|
CCSprite* tileAt(CGPoint tileCoordinate);
|
|
|
|
|
|
|
|
/** returns the tile gid at a given tile coordinate.
|
|
|
|
if it returns 0, it means that the tile is empty.
|
2010-09-28 12:14:12 +08:00
|
|
|
This method requires the the tile map has not been previously released (eg. don't call layer->releaseMap())
|
2010-08-31 15:11:13 +08:00
|
|
|
*/
|
|
|
|
unsigned int tileGIDAt(CGPoint 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.
|
|
|
|
*/
|
|
|
|
void setTileGID(unsigned int gid, CGPoint tileCoordinate);
|
|
|
|
|
|
|
|
/** removes a tile at given tile coordinate */
|
|
|
|
void removeTileAt(CGPoint tileCoordinate);
|
|
|
|
|
|
|
|
/** returns the position in pixels of a given tile coordinate */
|
|
|
|
CGPoint positionAt(CGPoint tileCoordinate);
|
|
|
|
|
|
|
|
/** return the value for the specific property name */
|
2010-09-06 20:26:19 +08:00
|
|
|
NSString *propertyNamed(const char *propertyName);
|
2010-08-31 15:11:13 +08:00
|
|
|
|
|
|
|
/** Creates the tiles */
|
|
|
|
void setupTiles();
|
|
|
|
|
|
|
|
/** CCTMXLayer doesn't support adding a CCSprite manually.
|
2010-09-28 12:14:12 +08:00
|
|
|
@warning addchild(z, tag); is not supported on CCTMXLayer. Instead of setTileGID.
|
2010-08-31 15:11:13 +08:00
|
|
|
*/
|
2010-12-28 15:17:59 +08:00
|
|
|
virtual void addChild(CCNode * child, int zOrder, int tag);
|
2010-08-31 15:11:13 +08:00
|
|
|
// super method
|
|
|
|
void removeChild(CCNode* child, bool cleanup);
|
|
|
|
void draw();
|
2010-09-06 20:26:19 +08:00
|
|
|
|
|
|
|
inline const char* getLayerName(){ return m_sLayerName.c_str(); }
|
|
|
|
inline void setLayerName(const char *layerName){ m_sLayerName = layerName; }
|
2010-08-31 15:11:13 +08:00
|
|
|
private:
|
|
|
|
CGPoint positionForIsoAt(CGPoint pos);
|
|
|
|
CGPoint positionForOrthoAt(CGPoint pos);
|
|
|
|
CGPoint positionForHexAt(CGPoint pos);
|
|
|
|
|
|
|
|
CGPoint calculateLayerOffset(CGPoint offset);
|
|
|
|
|
|
|
|
/* optimization methos */
|
|
|
|
CCSprite* appendTileForGID(unsigned int gid, CGPoint pos);
|
|
|
|
CCSprite* insertTileForGID(unsigned int gid, CGPoint pos);
|
|
|
|
CCSprite* updateTileForGID(unsigned int gid, CGPoint pos);
|
|
|
|
|
|
|
|
/* The layer recognizes some special properties, like cc_vertez */
|
|
|
|
void parseInternalProperties();
|
|
|
|
int vertexZForPos(CGPoint pos);
|
|
|
|
|
|
|
|
// index
|
|
|
|
unsigned int atlasIndexForExistantZ(unsigned int z);
|
|
|
|
unsigned int atlasIndexForNewZ(int z);
|
|
|
|
protected:
|
2010-09-29 12:03:21 +08:00
|
|
|
//! name of the layer
|
2010-09-06 20:26:19 +08:00
|
|
|
std::string m_sLayerName;
|
2010-09-29 12:03:21 +08:00
|
|
|
//! TMX Layer supports opacity
|
2010-09-28 12:14:12 +08:00
|
|
|
unsigned char m_cOpacity;
|
2010-08-31 15:11:13 +08:00
|
|
|
|
|
|
|
unsigned int m_uMinGID;
|
|
|
|
unsigned int m_uMaxGID;
|
|
|
|
|
2010-09-29 12:03:21 +08:00
|
|
|
//! Only used when vertexZ is used
|
2010-08-31 15:11:13 +08:00
|
|
|
int m_nVertexZvalue;
|
|
|
|
bool m_bUseAutomaticVertexZ;
|
|
|
|
float m_fAlphaFuncValue;
|
|
|
|
|
2010-09-29 12:03:21 +08:00
|
|
|
//! used for optimization
|
2010-08-31 15:11:13 +08:00
|
|
|
CCSprite *m_pReusedTile;
|
2010-09-02 15:48:47 +08:00
|
|
|
_ccCArray *m_pAtlasIndexArray;
|
2010-08-31 15:11:13 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
}// namespace cocos2d
|
|
|
|
#endif //__CCTMX_LAYER_H__
|
|
|
|
|