init
This commit is contained in:
690
cocos2d/cocos/2d/CCLayer.h
Normal file
690
cocos2d/cocos/2d/CCLayer.h
Normal file
@@ -0,0 +1,690 @@
|
||||
/****************************************************************************
|
||||
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 __CCLAYER_H__
|
||||
#define __CCLAYER_H__
|
||||
|
||||
#include "2d/CCNode.h"
|
||||
#include "base/CCProtocols.h"
|
||||
#include "renderer/CCCustomCommand.h"
|
||||
|
||||
|
||||
NS_CC_BEGIN
|
||||
|
||||
/**
|
||||
* @addtogroup _2d
|
||||
* @{
|
||||
*/
|
||||
|
||||
class __Set;
|
||||
class TouchScriptHandlerEntry;
|
||||
|
||||
class EventListenerTouch;
|
||||
class EventListenerKeyboard;
|
||||
class EventListenerAcceleration;
|
||||
|
||||
class Touch;
|
||||
|
||||
//
|
||||
// Layer
|
||||
//
|
||||
/** @class Layer
|
||||
* @brief Layer is a subclass of Node that implements the TouchEventsDelegate protocol.
|
||||
|
||||
All features from Node are valid, plus the following new features:
|
||||
- It can receive iPhone Touches
|
||||
- It can receive Accelerometer input
|
||||
*/
|
||||
class CC_DLL Layer : public Node
|
||||
{
|
||||
public:
|
||||
/** Creates a fullscreen black layer.
|
||||
*
|
||||
* @return An autoreleased Layer object.
|
||||
*/
|
||||
static Layer *create();
|
||||
|
||||
// Deprecated touch callbacks.
|
||||
CC_DEPRECATED_ATTRIBUTE virtual bool ccTouchBegan(Touch *pTouch, Event *pEvent) final {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent); return false;};
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchMoved(Touch *pTouch, Event *pEvent) final {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchEnded(Touch *pTouch, Event *pEvent) final {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchCancelled(Touch *pTouch, Event *pEvent) final {CC_UNUSED_PARAM(pTouch); CC_UNUSED_PARAM(pEvent);}
|
||||
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchesBegan(__Set *pTouches, Event *pEvent) final {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchesMoved(__Set *pTouches, Event *pEvent) final {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchesEnded(__Set *pTouches, Event *pEvent) final {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void ccTouchesCancelled(__Set *pTouches, Event *pEvent) final {CC_UNUSED_PARAM(pTouches); CC_UNUSED_PARAM(pEvent);}
|
||||
|
||||
/* Callback function should not be deprecated, it will generate lots of warnings.
|
||||
Since 'setTouchEnabled' was deprecated, it will make warnings if developer overrides onTouchXXX and invokes setTouchEnabled(true) instead of using EventDispatcher::addEventListenerWithXXX.
|
||||
*/
|
||||
/** Callback function for touch began.
|
||||
*
|
||||
* @param touch Touch information.
|
||||
* @param unused_event Event information.
|
||||
* @return if return false, onTouchMoved, onTouchEnded, onTouchCancelled will never called.
|
||||
* @js NA
|
||||
*/
|
||||
virtual bool onTouchBegan(Touch *touch, Event *unused_event);
|
||||
/** Callback function for touch moved.
|
||||
*
|
||||
* @param touch Touch information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchMoved(Touch *touch, Event *unused_event);
|
||||
/** Callback function for touch ended.
|
||||
*
|
||||
* @param touch Touch information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchEnded(Touch *touch, Event *unused_event);
|
||||
/** Callback function for touch cancelled.
|
||||
*
|
||||
* @param touch Touch information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchCancelled(Touch *touch, Event *unused_event);
|
||||
|
||||
/** Callback function for multiple touches began.
|
||||
*
|
||||
* @param touches Touches information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchesBegan(const std::vector<Touch*>& touches, Event *unused_event);
|
||||
/** Callback function for multiple touches moved.
|
||||
*
|
||||
* @param touches Touches information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchesMoved(const std::vector<Touch*>& touches, Event *unused_event);
|
||||
/** Callback function for multiple touches ended.
|
||||
*
|
||||
* @param touches Touches information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchesEnded(const std::vector<Touch*>& touches, Event *unused_event);
|
||||
/** Callback function for multiple touches cancelled.
|
||||
*
|
||||
* @param touches Touches information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onTouchesCancelled(const std::vector<Touch*>&touches, Event *unused_event);
|
||||
/**
|
||||
@deprecated Please override onAcceleration
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void didAccelerate(Acceleration* accelerationValue) final {};
|
||||
|
||||
/* Callback function should not be deprecated, it will generate lots of warnings.
|
||||
Since 'setAccelerometerEnabled' was deprecated, it will make warnings if developer overrides onAcceleration and invokes setAccelerometerEnabled(true) instead of using EventDispatcher::addEventListenerWithXXX.
|
||||
*/
|
||||
/** Callback function for acceleration.
|
||||
* @param acc Acceleration information.
|
||||
* @param unused_event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onAcceleration(Acceleration* acc, Event* unused_event);
|
||||
|
||||
/** If isTouchEnabled, this method is called onEnter. Override it to change the
|
||||
way Layer receives touch events.
|
||||
( Default: TouchDispatcher::sharedDispatcher()->addStandardDelegate(this,0); )
|
||||
Example:
|
||||
void Layer::registerWithTouchDispatcher()
|
||||
{
|
||||
TouchDispatcher::sharedDispatcher()->addTargetedDelegate(this,INT_MIN+1,true);
|
||||
}
|
||||
@since v0.8.0
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void registerWithTouchDispatcher() final {};
|
||||
|
||||
/** whether or not it will receive Touch events.
|
||||
You can enable / disable touch events with this property.
|
||||
Only the touches of this node will be affected. This "method" is not propagated to it's children.
|
||||
@since v0.8.1
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE bool isTouchEnabled() const;
|
||||
CC_DEPRECATED_ATTRIBUTE void setTouchEnabled(bool value);
|
||||
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void setTouchMode(Touch::DispatchMode mode);
|
||||
CC_DEPRECATED_ATTRIBUTE virtual Touch::DispatchMode getTouchMode() const;
|
||||
|
||||
/**
|
||||
swallowsTouches of the touch events. Default is true
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void setSwallowsTouches(bool swallowsTouches);
|
||||
CC_DEPRECATED_ATTRIBUTE virtual bool isSwallowsTouches() const;
|
||||
|
||||
/** whether or not it will receive Accelerometer events
|
||||
You can enable / disable accelerometer events with this property.
|
||||
@since v0.8.1
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual bool isAccelerometerEnabled() const;
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void setAccelerometerEnabled(bool value);
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void setAccelerometerInterval(double interval);
|
||||
|
||||
/** whether or not it will receive keyboard or keypad events
|
||||
You can enable / disable accelerometer events with this property.
|
||||
it's new in cocos2d-x
|
||||
@js NA
|
||||
*/
|
||||
|
||||
CC_DEPRECATED_ATTRIBUTE virtual bool isKeyboardEnabled() const;
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void setKeyboardEnabled(bool value);
|
||||
|
||||
/**
|
||||
Please use onKeyPressed instead.
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void keyPressed(int keyCode) final {};
|
||||
|
||||
/**
|
||||
Please use onKeyReleased instead.
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void keyReleased(int keyCode) final {};
|
||||
|
||||
/* Callback function should not be deprecated, it will generate lots of warnings.
|
||||
Since 'setKeyboardEnabled' was deprecated, it will make warnings if developer overrides onKeyXXX and invokes setKeyboardEnabled(true) instead of using EventDispatcher::addEventListenerWithXXX.
|
||||
*/
|
||||
/** Callback function for key pressed.
|
||||
* @param keyCode KeyCode information.
|
||||
* @param event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onKeyPressed(EventKeyboard::KeyCode keyCode, Event* event);
|
||||
/** Callback function for key released.
|
||||
* @param keyCode KeyCode information.
|
||||
* @param event Event information.
|
||||
* @js NA
|
||||
*/
|
||||
virtual void onKeyReleased(EventKeyboard::KeyCode keyCode, Event* event);
|
||||
|
||||
CC_DEPRECATED_ATTRIBUTE virtual bool isKeypadEnabled() const final { return _keyboardEnabled; }
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void setKeypadEnabled(bool value);
|
||||
|
||||
/**
|
||||
@deprecated Please override onKeyReleased and check the keycode of KeyboardEvent::KeyCode::Menu(KEY_BACKSPACE) instead.
|
||||
@js NA
|
||||
*/
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void keyBackClicked() final {};
|
||||
CC_DEPRECATED_ATTRIBUTE virtual void keyMenuClicked() final {};
|
||||
|
||||
// Overrides
|
||||
virtual std::string getDescription() const override;
|
||||
|
||||
CC_CONSTRUCTOR_ACCESS:
|
||||
Layer();
|
||||
virtual ~Layer();
|
||||
|
||||
virtual bool init() override;
|
||||
|
||||
protected:
|
||||
//add the api for avoid use deprecated api
|
||||
CC_DEPRECATED_ATTRIBUTE void _addTouchListener() {}
|
||||
|
||||
CC_DEPRECATED_ATTRIBUTE void addTouchListener() {}
|
||||
CC_DEPRECATED_ATTRIBUTE int executeScriptTouchHandler(EventTouch::EventCode eventType, Touch* touch, Event* event);
|
||||
CC_DEPRECATED_ATTRIBUTE int executeScriptTouchesHandler(EventTouch::EventCode eventType, const std::vector<Touch*>& touches, Event* event);
|
||||
|
||||
bool _touchEnabled;
|
||||
bool _accelerometerEnabled;
|
||||
bool _keyboardEnabled;
|
||||
EventListener* _touchListener;
|
||||
EventListenerKeyboard* _keyboardListener;
|
||||
EventListenerAcceleration* _accelerationListener;
|
||||
|
||||
Touch::DispatchMode _touchMode;
|
||||
bool _swallowsTouches;
|
||||
|
||||
private:
|
||||
CC_DISALLOW_COPY_AND_ASSIGN(Layer);
|
||||
|
||||
};
|
||||
|
||||
|
||||
/** @class __LayerRGBA
|
||||
* @brief LayerRGBA is a subclass of Layer that implements the RGBAProtocol protocol using a solid color as the background.
|
||||
|
||||
All features from Layer are valid, plus the following new features that propagate into children that conform to the RGBAProtocol:
|
||||
- opacity
|
||||
- RGB colors
|
||||
@since 2.1
|
||||
@js NA
|
||||
*/
|
||||
class CC_DLL __LayerRGBA : public Layer, public __RGBAProtocol
|
||||
{
|
||||
public:
|
||||
CREATE_FUNC(__LayerRGBA);
|
||||
|
||||
|
||||
//
|
||||
// Overrides
|
||||
//
|
||||
virtual GLubyte getOpacity() const override { return Layer::getOpacity(); }
|
||||
virtual GLubyte getDisplayedOpacity() const override { return Layer::getDisplayedOpacity(); }
|
||||
virtual void setOpacity(GLubyte opacity) override { Layer::setOpacity(opacity); }
|
||||
virtual void updateDisplayedOpacity(GLubyte parentOpacity) override { Layer::updateDisplayedOpacity(parentOpacity); }
|
||||
virtual bool isCascadeOpacityEnabled() const override { return Layer::isCascadeOpacityEnabled(); }
|
||||
virtual void setCascadeOpacityEnabled(bool cascadeOpacityEnabled) override { Layer::setCascadeOpacityEnabled(cascadeOpacityEnabled); }
|
||||
|
||||
virtual const Color3B& getColor() const override { return Layer::getColor(); }
|
||||
virtual const Color3B& getDisplayedColor() const override { return Layer::getDisplayedColor(); }
|
||||
virtual void setColor(const Color3B& color) override { Layer::setColor(color); }
|
||||
virtual void updateDisplayedColor(const Color3B& parentColor) override { Layer::updateDisplayedColor(parentColor); }
|
||||
virtual bool isCascadeColorEnabled() const override { return Layer::isCascadeOpacityEnabled(); }
|
||||
virtual void setCascadeColorEnabled(bool cascadeColorEnabled) override { Layer::setCascadeColorEnabled(cascadeColorEnabled); }
|
||||
|
||||
virtual void setOpacityModifyRGB(bool bValue) override { Layer::setOpacityModifyRGB(bValue); }
|
||||
virtual bool isOpacityModifyRGB() const override { return Layer::isOpacityModifyRGB(); }
|
||||
|
||||
CC_CONSTRUCTOR_ACCESS:
|
||||
__LayerRGBA();
|
||||
virtual ~__LayerRGBA() {}
|
||||
|
||||
private:
|
||||
CC_DISALLOW_COPY_AND_ASSIGN(__LayerRGBA);
|
||||
};
|
||||
|
||||
//
|
||||
// LayerColor
|
||||
//
|
||||
/** @class LayerColor
|
||||
* @brief LayerColor is a subclass of Layer that implements the RGBAProtocol protocol.
|
||||
|
||||
All features from Layer are valid, plus the following new features:
|
||||
- opacity
|
||||
- RGB colors
|
||||
*/
|
||||
class CC_DLL LayerColor : public Layer, public BlendProtocol
|
||||
{
|
||||
public:
|
||||
/** Creates a fullscreen black layer.
|
||||
*
|
||||
* @return An autoreleased LayerColor object.
|
||||
*/
|
||||
static LayerColor* create();
|
||||
/** Creates a Layer with color, width and height in Points.
|
||||
*
|
||||
* @param color The color of layer.
|
||||
* @param width The width of layer.
|
||||
* @param height The height of layer.
|
||||
* @return An autoreleased LayerColor object.
|
||||
*/
|
||||
static LayerColor * create(const Color4B& color, GLfloat width, GLfloat height);
|
||||
/** Creates a Layer with color. Width and height are the window size.
|
||||
*
|
||||
* @param color The color of layer.
|
||||
* @return An autoreleased LayerColor object.
|
||||
*/
|
||||
static LayerColor * create(const Color4B& color);
|
||||
|
||||
/** Change width in Points.
|
||||
*
|
||||
* @param w The width of layer.
|
||||
*/
|
||||
void changeWidth(GLfloat w);
|
||||
/** Change height in Points.
|
||||
*
|
||||
* @param h The height of layer.
|
||||
*/
|
||||
void changeHeight(GLfloat h);
|
||||
/** Change width and height in Points.
|
||||
*
|
||||
* @param w The width of layer.
|
||||
* @param h The Height of layer.
|
||||
@since v0.8
|
||||
*/
|
||||
void changeWidthAndHeight(GLfloat w ,GLfloat h);
|
||||
|
||||
//
|
||||
// Overrides
|
||||
//
|
||||
virtual void draw(Renderer *renderer, const Mat4 &transform, uint32_t flags) override;
|
||||
|
||||
virtual void setContentSize(const Size & var) override;
|
||||
/** BlendFunction. Conforms to BlendProtocol protocol */
|
||||
/**
|
||||
* @lua NA
|
||||
*/
|
||||
virtual const BlendFunc& getBlendFunc() const override;
|
||||
/**
|
||||
*@code
|
||||
*When this function bound into js or lua,the parameter will be changed
|
||||
*In js: var setBlendFunc(var src, var dst)
|
||||
*In lua: local setBlendFunc(local src, local dst)
|
||||
*@endcode
|
||||
*/
|
||||
virtual void setBlendFunc(const BlendFunc& blendFunc) override;
|
||||
|
||||
virtual std::string getDescription() const override;
|
||||
|
||||
CC_CONSTRUCTOR_ACCESS:
|
||||
LayerColor();
|
||||
virtual ~LayerColor();
|
||||
|
||||
bool init() override;
|
||||
bool initWithColor(const Color4B& color, GLfloat width, GLfloat height);
|
||||
bool initWithColor(const Color4B& color);
|
||||
|
||||
protected:
|
||||
void onDraw(const Mat4& transform, uint32_t flags);
|
||||
|
||||
virtual void updateColor() override;
|
||||
|
||||
BlendFunc _blendFunc;
|
||||
Vec2 _squareVertices[4];
|
||||
Color4F _squareColors[4];
|
||||
CustomCommand _customCommand;
|
||||
Vec3 _noMVPVertices[4];
|
||||
private:
|
||||
CC_DISALLOW_COPY_AND_ASSIGN(LayerColor);
|
||||
|
||||
};
|
||||
|
||||
//
|
||||
// LayerGradient
|
||||
//
|
||||
/** @class LayerGradient
|
||||
* @brief LayerGradient is a subclass of LayerColor that draws gradients across the background.
|
||||
|
||||
All features from LayerColor are valid, plus the following new features:
|
||||
- direction
|
||||
- final color
|
||||
- interpolation mode
|
||||
|
||||
Color is interpolated between the startColor and endColor along the given
|
||||
vector (starting at the origin, ending at the terminus). If no vector is
|
||||
supplied, it defaults to (0, -1) -- a fade from top to bottom.
|
||||
|
||||
If 'compressedInterpolation' is disabled, you will not see either the start or end color for
|
||||
non-cardinal vectors; a smooth gradient implying both end points will be still
|
||||
be drawn, however.
|
||||
|
||||
If ' compressedInterpolation' is enabled (default mode) you will see both the start and end colors of the gradient.
|
||||
|
||||
@since v0.99.5
|
||||
*/
|
||||
class CC_DLL LayerGradient : public LayerColor
|
||||
{
|
||||
public:
|
||||
/** Creates a fullscreen black layer.
|
||||
*
|
||||
* @return An autoreleased LayerGradient object.
|
||||
*/
|
||||
static LayerGradient* create();
|
||||
|
||||
/** Creates a full-screen Layer with a gradient between start and end.
|
||||
*
|
||||
* @param start The start color.
|
||||
* @param end The end color.
|
||||
* @return An autoreleased LayerGradient object.
|
||||
*/
|
||||
static LayerGradient* create(const Color4B& start, const Color4B& end);
|
||||
|
||||
/** Creates a full-screen Layer with a gradient between start and end in the direction of v.
|
||||
*
|
||||
* @param start The start color.
|
||||
* @param end The end color.
|
||||
* @param v The direction of gradient color.
|
||||
* @return An autoreleased LayerGradient object.
|
||||
*/
|
||||
static LayerGradient* create(const Color4B& start, const Color4B& end, const Vec2& v);
|
||||
|
||||
/** Whether or not the interpolation will be compressed in order to display all the colors of the gradient both in canonical and non canonical vectors.
|
||||
Default: true.
|
||||
*
|
||||
* @param compressedInterpolation The interpolation will be compressed if true.
|
||||
*/
|
||||
void setCompressedInterpolation(bool compressedInterpolation);
|
||||
/** Get the compressedInterpolation
|
||||
*
|
||||
* @return The interpolation will be compressed if true.
|
||||
*/
|
||||
bool isCompressedInterpolation() const;
|
||||
|
||||
/** Sets the start color of the gradient.
|
||||
*
|
||||
* @param startColor The start color.
|
||||
*/
|
||||
void setStartColor( const Color3B& startColor );
|
||||
/** Returns the start color of the gradient.
|
||||
*
|
||||
* @return The start color.
|
||||
*/
|
||||
const Color3B& getStartColor() const;
|
||||
|
||||
/** Sets the end color of the gradient.
|
||||
*
|
||||
* @param endColor The end color.
|
||||
*/
|
||||
void setEndColor( const Color3B& endColor );
|
||||
/** Returns the end color of the gradient.
|
||||
*
|
||||
* @return The end color.
|
||||
*/
|
||||
const Color3B& getEndColor() const;
|
||||
|
||||
/** Returns the start opacity of the gradient.
|
||||
*
|
||||
* @param startOpacity The start opacity, from 0 to 255.
|
||||
*/
|
||||
void setStartOpacity( GLubyte startOpacity );
|
||||
/** Returns the start opacity of the gradient.
|
||||
*
|
||||
* @return The start opacity.
|
||||
*/
|
||||
GLubyte getStartOpacity() const;
|
||||
|
||||
/** Returns the end opacity of the gradient.
|
||||
*
|
||||
* @param endOpacity The end opacity, from 0 to 255.
|
||||
*/
|
||||
void setEndOpacity( GLubyte endOpacity );
|
||||
/** Returns the end opacity of the gradient.
|
||||
*
|
||||
* @return The end opacity.
|
||||
*/
|
||||
GLubyte getEndOpacity() const;
|
||||
|
||||
/** Sets the directional vector that will be used for the gradient.
|
||||
The default value is vertical direction (0,-1).
|
||||
*
|
||||
* @param alongVector The direction of gradient.
|
||||
*/
|
||||
void setVector(const Vec2& alongVector);
|
||||
/** Returns the directional vector used for the gradient.
|
||||
*
|
||||
* @return The direction of gradient.
|
||||
*/
|
||||
const Vec2& getVector() const;
|
||||
|
||||
virtual std::string getDescription() const override;
|
||||
|
||||
CC_CONSTRUCTOR_ACCESS:
|
||||
LayerGradient();
|
||||
virtual ~LayerGradient();
|
||||
|
||||
virtual bool init() override;
|
||||
/** Initializes the Layer with a gradient between start and end.
|
||||
* @js init
|
||||
* @lua init
|
||||
*/
|
||||
bool initWithColor(const Color4B& start, const Color4B& end);
|
||||
|
||||
/** Initializes the Layer with a gradient between start and end in the direction of v.
|
||||
* @js init
|
||||
* @lua init
|
||||
*/
|
||||
bool initWithColor(const Color4B& start, const Color4B& end, const Vec2& v);
|
||||
|
||||
protected:
|
||||
virtual void updateColor() override;
|
||||
|
||||
Color3B _startColor;
|
||||
Color3B _endColor;
|
||||
GLubyte _startOpacity;
|
||||
GLubyte _endOpacity;
|
||||
Vec2 _alongVector;
|
||||
bool _compressedInterpolation;
|
||||
};
|
||||
|
||||
|
||||
/** @class LayerMultiplex
|
||||
* @brief MultipleLayer is a Layer with the ability to multiplex it's children.
|
||||
Features:
|
||||
- It supports one or more children
|
||||
- Only one children will be active a time
|
||||
*/
|
||||
class CC_DLL LayerMultiplex : public Layer
|
||||
{
|
||||
public:
|
||||
/** Creates and initializes a LayerMultiplex object.
|
||||
* @lua NA
|
||||
*
|
||||
* @return An autoreleased LayerMultiplex object.
|
||||
*/
|
||||
static LayerMultiplex* create();
|
||||
|
||||
/** Creates a LayerMultiplex with an array of layers.
|
||||
@since v2.1
|
||||
* @js NA
|
||||
*
|
||||
* @param arrayOfLayers An array of layers.
|
||||
* @return An autoreleased LayerMultiplex object.
|
||||
*/
|
||||
static LayerMultiplex* createWithArray(const Vector<Layer*>& arrayOfLayers);
|
||||
|
||||
/** Creates a LayerMultiplex with one or more layers using a variable argument list.
|
||||
* @code
|
||||
* When this function bound to lua or js,the input params are changed.
|
||||
* In js:var create(...)
|
||||
* In lua:local create(...)
|
||||
* @endcode
|
||||
*/
|
||||
#if (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT)
|
||||
// VS2013 does not support nullptr in variable args lists and variadic templates are also not supported
|
||||
typedef Layer* M;
|
||||
static LayerMultiplex* create(M m1, std::nullptr_t listEnd) { return createVariadic(m1, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, std::nullptr_t listEnd) { return createVariadic(m1, m2, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, M m5, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, m5, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, M m5, M m6, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, m5, m6, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, M m5, M m6, M m7, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, m5, m6, m7, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, M m5, M m6, M m7, M m8, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, m5, m6, m7, m8, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, M m5, M m6, M m7, M m8, M m9, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, m5, m6, m7, m8, m9, NULL); }
|
||||
static LayerMultiplex* create(M m1, M m2, M m3, M m4, M m5, M m6, M m7, M m8, M m9, M m10, std::nullptr_t listEnd) { return createVariadic(m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, NULL); }
|
||||
|
||||
// On WP8 for variable argument lists longer than 10 items, use createWithArray or createVariadic with NULL as the last argument
|
||||
static LayerMultiplex* createVariadic(Layer* item, ...) CC_REQUIRES_NULL_TERMINATION;
|
||||
#else
|
||||
static LayerMultiplex * create(Layer* layer, ... );
|
||||
#endif
|
||||
|
||||
/** Creates a LayerMultiplex with one layer.
|
||||
* Lua script can not init with undetermined number of variables
|
||||
* so add these functions to be used with lua.
|
||||
* @js NA
|
||||
* @lua NA
|
||||
*
|
||||
* @param layer A certain layer.
|
||||
* @return An autoreleased LayerMultiplex object.
|
||||
*/
|
||||
static LayerMultiplex * createWithLayer(Layer* layer);
|
||||
|
||||
|
||||
/** Add a certain layer to LayerMultiplex.
|
||||
*
|
||||
* @param layer A layer need to be added to the LayerMultiplex.
|
||||
*/
|
||||
void addLayer(Layer* layer);
|
||||
|
||||
/** Switches to a certain layer indexed by n.
|
||||
The current (old) layer will be removed from it's parent with 'cleanup=true'.
|
||||
*
|
||||
* @param n The layer indexed by n will display.
|
||||
*/
|
||||
void switchTo(int n);
|
||||
/** release the current layer and switches to another layer indexed by n.
|
||||
The current (old) layer will be removed from it's parent with 'cleanup=true'.
|
||||
*
|
||||
* @param n The layer indexed by n will display.
|
||||
*/
|
||||
void switchToAndReleaseMe(int n);
|
||||
|
||||
virtual std::string getDescription() const override;
|
||||
|
||||
CC_CONSTRUCTOR_ACCESS:
|
||||
/**
|
||||
* @js ctor
|
||||
*/
|
||||
LayerMultiplex();
|
||||
/**
|
||||
* @js NA
|
||||
* @lua NA
|
||||
*/
|
||||
virtual ~LayerMultiplex();
|
||||
|
||||
virtual bool init() override;
|
||||
/** initializes a MultiplexLayer with one or more layers using a variable argument list.
|
||||
* @js NA
|
||||
* @lua NA
|
||||
*/
|
||||
bool initWithLayers(Layer* layer, va_list params);
|
||||
|
||||
/** initializes a MultiplexLayer with an array of layers
|
||||
@since v2.1
|
||||
*/
|
||||
bool initWithArray(const Vector<Layer*>& arrayOfLayers);
|
||||
|
||||
protected:
|
||||
unsigned int _enabledLayer;
|
||||
Vector<Layer*> _layers;
|
||||
|
||||
private:
|
||||
CC_DISALLOW_COPY_AND_ASSIGN(LayerMultiplex);
|
||||
};
|
||||
|
||||
|
||||
// end of _2d group
|
||||
/// @}
|
||||
|
||||
NS_CC_END
|
||||
|
||||
#endif // __CCLAYER_H__
|
||||
|
||||
Reference in New Issue
Block a user