Cocos2dx3.2编写常用UI组件（一）新手指导框GuideLayer

前言：

在很多的游戏里（特别是RPG游戏），一开始都会有一个关于操作的介绍，几乎都像下图那样子的。

除了系统希望你所点击的区域外，其余区域都会变暗，而且你点暗的区域是不会有任何反应的。

正文：

下面我们来讲怎么实现的：

一、实现思路：

我们可以用Cocos2dx提供给我们的LayerColor，在你想要被点击的区域周围添加4块LayerColor，如下图所示

二、代码实现

GuideLayer.h

class  GuideLayer : public Node{
private:
	GuideLayer();
public:
	//用于创建一个指导层,参数：可触控区域
	static GuideLayer* create(const Rect& rect);

	//用于创建一个指导层,参数：可触控区域，不可触控区域的颜色
	static GuideLayer* create(const Rect& rect,const Color4B& color);

private:
	bool init(const Rect& rect);
	bool init(const Rect& rect,const Color4B& color);
	bool onTouchBegan(Touch* touch,Event* event);
private:
	LayerColor* area1;
	LayerColor* area2;
	LayerColor* area3;
	LayerColor* area4;

	Color4B defaultColor;

	Rect m_rect;
	EventListenerTouchOneByOne* m_listener;
};

GuideLayer::GuideLayer():
	defaultColor(0x00, 0x00, 0x00, 0xC0)
{}

先看使用默认颜色的create和init方法

bool GuideLayer::init(const Rect& rect){
	if(!Node::init())	return false;
	m_rect = rect;
	Size visibleSize = Director::getInstance()->getVisibleSize();
	area1 = LayerColor::create(
		defaultColor,
		visibleSize.width,
		visibleSize.height - rect.getMaxY()
		);
	area1->setAnchorPoint(Point(0,0));
	area1->setPosition(Point(0,rect.getMaxY()));

	area2 = LayerColor::create(
		defaultColor,
		visibleSize.width,
		rect.getMinY()
		);
	area2->setAnchorPoint(Point(0,0));
	area2->setPosition(Point(0,0));

	area3 = LayerColor::create(
		defaultColor,
		rect.getMinX(),
		rect.getMaxY()-rect.getMinY()
		);
	area3->setAnchorPoint(Point(0,0));
	area3->setPosition(Point(0,rect.getMinY()));
	
	area4 = LayerColor::create(
		defaultColor,
		visibleSize.width - rect.getMaxX(),
		rect.getMaxY() - rect.getMinY()
		);
	area4->setAnchorPoint(Point(0,0));
	area4->setPosition(Point(rect.getMaxX(),rect.getMinY()));

	this->addChild(area1);
	this->addChild(area2);
	this->addChild(area3);
	this->addChild(area4);

	//设置监听器，截断非rect外区域的触摸事件
	m_listener = EventListenerTouchOneByOne::create();
	m_listener->onTouchBegan = CC_CALLBACK_2(GuideLayer::onTouchBegan,this);
	Director::getInstance()->getEventDispatcher()->addEventListenerWithSceneGraphPriority(m_listener,this);

	return true;
}