我的Cocos2d-x学习笔记十一触摸、触摸优先级

Cocos2d-x认只有cclayer及其派生类才有触摸的功能

cclayer中关于触摸的部分代码如下:

class CC_DLL cclayer : public CCNode,public CCTouchDelegate,public CCAccelerometerDelegate,public CCKeypadDelegate
{
public:
	virtual void setTouchEnabled(bool value);
	virtual void setTouchMode(cctouchesMode mode);

	// default implements are used to call script callback if exist
	virtual bool ccTouchBegan(CCTouch *pTouch,CCEvent *pEvent);
	virtual void ccTouchMoved(CCTouch *pTouch,CCEvent *pEvent);
	virtual void ccTouchEnded(CCTouch *pTouch,CCEvent *pEvent);
	virtual void ccTouchCancelled(CCTouch *pTouch,CCEvent *pEvent);

	// default implements are used to call script callback if exist
	virtual void cctouchesBegan(CCSet *ptouches,CCEvent *pEvent);
	virtual void cctouchesMoved(CCSet *ptouches,CCEvent *pEvent);
	virtual void cctouchesEnded(CCSet *ptouches,CCEvent *pEvent);
	virtual void cctouchesCancelled(CCSet *ptouches,CCEvent *pEvent);

	virtual void setTouchPriority(int priority);
	virtual int getTouchPriority();
}


一、触摸开启:
在使用触摸功能时候,首先要开启触摸,并设置触摸模式。这时候要用到以下两个函数
	virtual void setTouchEnabled(bool value);
	virtual void setTouchMode(cctouchesMode mode);
setTouchEnabled:用来设置是否开启触摸,认是false,当setTouchEnabled(true)时候打开触摸开关。

setTouchMode:用来设置触摸的方式,有单点触摸与多点触摸。

cctouchesMode参数kCCtouchesOneByOne表示开启单点触摸。

cctouchesMode参数kCCtouchesAllAtOnce表示开启多点触摸。


二、多点触摸
当开启触摸后,设置模式为kCCtouchesAllAtOnce,此时为多点触摸。

	setTouchEnabled(true); 
	setTouchMode(kCCtouchesAllAtOnce);
上述代码开启多点触摸,此时需要覆写cclayer中的关于多点触摸的函数来进行使用触摸功能函数如下:
	virtual void cctouchesBegan(CCSet *ptouches,CCEvent *pEvent);
cctouchesBegan:手指触摸到屏幕,触发cctouchesBegan函数

cctouchesMoved:手指在屏幕上滑动,触发cctouchesMoved函数。每隔一帧都会触发。

cctouchesEnded:手指离开屏幕,触发cctouchesEnded函数

cctouchesCancelled:手指触摸还是移动过程中被打断,触发cctouchesCancelled函数


三、单点触摸

当开启触摸后,设置模式为kCCtouchesOneByOne,此时为单点触摸。

	setTouchEnabled(true); 
	setTouchMode(kCCtouchesOneByOne);

上述代码开启单点触摸,此时需要覆写cclayer中的关于单点触摸的函数来进行使用触摸功能函数如下:
	virtual bool ccTouchBegan(CCTouch *pTouch,CCEvent *pEvent);

ccTouchBegan:手指触摸到屏幕,触发cctouchesBegan函数。此函数返回true,把触摸事件传递给下面的函数进行处理;此函数返回false,触摸事件到此为止,cctouchesMoved、cctouchesEnded不再接受触摸。

ccTouchMoved:手指在屏幕上滑动,触发cctouchesMoved函数。每隔一帧都会触发。

ccTouchEnded:手指离开屏幕,触发cctouchesEnded函数

ccTouchCancelled:手指触摸还是移动过程中被打断,触发cctouchesCancelled函数


四、CCTouch

CCEvent在苹果系统中才有,暂时不讨论。

CCTouch是触摸事件处理函数的参数CCTouch *pTouch,由Cocos2d-x负责维护赋值,我们可以直接使用这个参数值,部分代码如下:

class CC_DLL CCTouch : public CCObject
{
public:
	/** returns the current touch location in OpenGL coordinates */
	CCPoint getLocation() const;
	/** returns the prevIoUs touch location in OpenGL coordinates */
	CCPoint getPrevIoUsLocation() const;
	/** returns the start touch location in OpenGL coordinates */
	CCPoint getStartLocation() const;
	/** returns the delta of 2 current touches locations in screen coordinates */
	CCPoint getDelta() const;
	/** returns the current touch location in screen coordinates */
	CCPoint getLocationInView() const;
	/** returns the prevIoUs touch location in screen coordinates */
	CCPoint getPrevIoUsLocationInView() const;
	/** returns the start touch location in screen coordinates */
	CCPoint getStartLocationInView() const;
};
上面代码包含注释,很好理解。

getLocation:获取触摸点的OpenGL坐标。

getLocationInView:获取触摸点的屏幕(UI)坐标。

getStartLocation:获取刚触摸时候的点坐标,基于OpenGL。

getDelta:是第一次触摸屏幕的坐标点与现在滑动后坐标的差值。
五、单点触摸实例

bool HelloWorld::init()
{
	cclayer::init();
	CCSprite* sprite = CCSprite::create("Closenormal.png");
	sprite->setTag(50);
	addChild(sprite);
	setTouchEnabled(true); 
	setTouchMode(kCCtouchesOneByOne);
    return true;
}
bool HelloWorld::ccTouchBegan(CCTouch *pTouch,CCEvent *pEvent)
{
	cclog("ccTouchBegan");
	CCSprite* sprite = (CCSprite*)getChildByTag(50);
	if (sprite->boundingBox().containsPoint(pTouch->getLocation()))
		return true;
	sprite->getContentSize();
	return false;
}
void HelloWorld::ccTouchMoved(CCTouch *pTouch,CCEvent *pEvent)
{
	cclog("ccTouchMoved");
	CCSprite* sprite = (CCSprite*)getChildByTag(50);
	CCPoint pt = pTouch->getLocation();
	CCPoint point = sprite->getPosition();
	sprite->setPosition(point+pTouch->getDelta());

}
void HelloWorld::ccTouchEnded(CCTouch *pTouch,CCEvent *pEvent)
{
	cclog("ccTouchEnded");
}

首先介绍一下boundingBox,与boundingBox类似的还有getContentSize,这两个函数都是从CCNode中继承而来,声明如下:

class CC_DLL CCNode : public CCObject
{
public:

	/**
	* Returns a "local" axis aligned bounding Box of the node.
	* The returned Box is relative only to its parent.
	*/
	virtual CCRect boundingBox(void);
	/**
	* Returns the untransformed size of the node.
	*/
	virtual const CCSize& getContentSize() const;
	/**
	* Gets a child from the container with its tag
	*/
	virtual CCNode * getChildByTag(int tag);
}

boundingBox获取节点缩放等操作后的轮廓。
getContentSize:获取节点本身大小。

如果节点没有进行缩放操作,boundingBox与getContentSize获取的值相同。

getChildByTag:通过Tag来获取加到渲染树中的游戏元素。例如把A利用addChild添加到B中,B->addChild(A),之后可以通过B->getChildByTag来获取A。

知道了上面几个函数之后就知道,单点触摸实例中首先创建了一个精灵,并设置Tag为50;

之后开启了触摸,设置为单点触摸;

在ccTouchBegan中利用getChildByTag获取之前创建的精灵,通过boundingBox来判断触摸点是否落在精灵上,如果点中精灵触摸事件向下传递;

在ccTouchMoved中再次利用getChildByTag获取之前创建的精灵,此时通过getDelta获取触摸点的位移来重新设置精灵的位置,实现精灵的移动。


六、触摸优先级

消息泵:手机有操作系统,有消息分发机制,人触摸屏幕,点击消息加入队列中,分发到相应进程分管的队列中,我们写的程序就是为了获得各种消息加入消息队列中。

首先看看setTouchEnabled中的内容代码如下:

void cclayer::setTouchEnabled(bool enabled)
{
	if (m_bTouchEnabled != enabled)
	{
		m_bTouchEnabled = enabled;
		if (m_bRunning)
		{
			if (enabled)
			{
				this->registerWithTouchdispatcher();
			}
			else
			{
				// have problems?
				CCDirector::sharedDirector()->getTouchdispatcher()->removeDelegate(this);
			}
		}
	}
}
如果开启触摸,也就是setTouchEnabled传入true,则执行this->registerWithTouchdispatcher(),此段代码意思是把当前Layer注册到分发器上;

而setTouchEnabled传入false,则把当前Layer从分发器中移除。


下面再仔细看一下registerWithTouchdispatcher中内容,部分代码如下:

void cclayer::registerWithTouchdispatcher()
{
	CCTouchdispatcher* pdispatcher = CCDirector::sharedDirector()->getTouchdispatcher();
	if (m_pScriptTouchHandlerEntry)
	{....}
	else
	{
		if (m_etouchMode == kCCtouchesAllAtOnce) {
			pdispatcher->addStandardDelegate(this,0);
		}
		else {
			pdispatcher->addTargetedDelegate(this,m_nTouchPriority,true);
		}
	}
}
由上面可知,m_etouchMode设置为kCCtouchesAllAtOnce,也就是开启多点触摸,执行pdispatcher->addStandardDelegate(this,0);

m_etouchMode设置为kCCtouchesOneByOne,开启单点触摸,执行pdispatcher->addTargetedDelegate(this,true);
由此可知单点触摸与多点触摸使用不同的代理。

再来看看使用到的两种代理,部分代码如下:

class CC_DLL CCTouchdispatcher : public CCObject,public EGLTouchDelegate
{
public:
	/** Adds a standard touch delegate to the dispatcher's list.
	*/
	void addStandardDelegate(CCTouchDelegate *pDelegate,int nPriority);

	/** Adds a targeted touch delegate to the dispatcher's list.
	*/
	void addTargetedDelegate(CCTouchDelegate *pDelegate,int nPriority,bool bSwallowstouches);
}

单点触摸的代理:

void addTargetedDelegate(CCTouchDelegate *pDelegate,bool bSwallowstouches);

一个参数CCTouchDelegate *pDelegate指明此单点触摸代理添加到哪个Layer中;

第二个参数int nPriority设置触摸优先级的参数,优先级越高,优先处理此触摸;nPriority参数值越小,触摸优先级越高,例如menu的优先级为-128,Layer优先级为0。

第三个参数bool bSwallowstouches设置是否吞噬触摸,true表示吞噬触摸,设置true吞噬后,高优先级接收到触摸后不向低优先级Layer继续传递此触摸。

多点触摸的代理:

void addStandardDelegate(CCTouchDelegate *pDelegate,int nPriority);

一个参数CCTouchDelegate *pDelegate指明此单点触摸代理添加到哪个Layer中;

第二个参数int nPriority设置触摸优先级的参数,优先级越高,优先处理此触摸;nPriority参数值越小,触摸优先级越高。

注意:

触摸事件的触发是根据添加的顺序依次触发的,后添加的层先捕获触摸事件,当然,这是没有设置事件优先级的情况下,若要是定义了事件的优先级,则先按照事件的优先级依次被触发,然后根据添加的顺序依次被触发。同一优先级,先处理哪一层,系统无定义。


七、单点触摸优先级实例:重点关注NoTouch

class NoTouch :public cclayerColor
{
public:
	CREATE_FUNC(NoTouch);
	bool init()
	{
		cclayerColor::initWithColor(ccc4(150,150,10));
		CCTouchdispatcher* pdispatcher = CCDirector::sharedDirector()->getTouchdispatcher();
		pdispatcher->addTargetedDelegate(this,-10,true);
		return true;
	}
	bool ccTouchBegan(CCTouch *pTouch,CCEvent *pEvent)
	{
		return true;
	}
};
CCScene* HelloWorld::scene()
{
    CCScene *scene = CCScene::create();

	NoTouch *noLayer = NoTouch::create();
    HelloWorld *layer = HelloWorld::create();

	scene->addChild(noLayer);
    scene->addChild(layer);
    return scene;
}

bool HelloWorld::init()
{
	cclayer::init();
	CCSprite* sprite = CCSprite::create("Closenormal.png");
	sprite->setTag(50);
	addChild(sprite);
	setTouchEnabled(true); 
	setTouchMode(kCCtouchesOneByOne);
    return true;
}
bool HelloWorld::ccTouchBegan(CCTouch *pTouch,CCEvent *pEvent)
{
	cclog("ccTouchEnded");
}
上述代码,在类NoTouch中的init函数中,直接通过CCDirector获取CCTouchdispatcher对象;

通过CCTouchdispatcher对象直接把NoTouch这个Layer设置为单点触摸添加到代理中,优先级设为-10,并且吞噬触摸。

在HelloWorld中的scene中添加NoTouch后,之后可以移动的图标不再可移动。因为NoTouch这个Layer优先级高,并且吞噬了触摸事件。


cclayer中也提供了管理触摸优先级的函数,如下:

	virtual void setTouchPriority(int priority);
	virtual int getTouchPriority();
通过setTouchPriority可以设置层的触摸优先级;

通过getTouchPriority可以获取层的触摸优先级。

相关文章

    本文实践自 RayWenderlich、Ali Hafizji 的文章《...
Cocos-code-ide使用入门学习地点:杭州滨江邮箱:appdevzw@1...
第一次開始用手游引擎挺激动!!!进入正题。下载资源1:从C...
    Cocos2d-x是一款强大的基于OpenGLES的跨平台游戏开发...
1.  来源 QuickV3sample项目中的2048样例游戏,以及最近《...
   Cocos2d-x3.x已经支持使用CMake来进行构建了,这里尝试...