CCLayer解析

来源:互联网 发布:喜剧动漫 知乎 编辑:程序博客网 时间:2024/06/08 17:09

代码:

//// Layer///** @class Layer * @brief Layer is a subclass of Node that implements the TouchEventsDelegate protocol.Layer是Node的一个子类实现了TouchEventsDelegate协议All features from Node are valid, plus the following new features:所有Node的特性都可以使用,同时还有如下特性:- It can receive iPhone Touches//可以接收iPhone的点击事件- 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 infomation.     * @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 infomation.    * @param unused_event Event information.    * @js NA    */// 点击移动的回调函数    virtual void onTouchMoved(Touch *touch, Event *unused_event);    /** Callback function for touch ended.    *    * @param touch Touch infomation.    * @param unused_event Event information.    * @js NA    */// 点击结束的回调函数    virtual void onTouchEnded(Touch *touch, Event *unused_event);    /** Callback function for touch cancelled.    *    * @param touch Touch infomation.    * @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 funtion 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 { return Layer::setOpacity(opacity); }// 更新显示的透明度    virtual void updateDisplayedOpacity(GLubyte parentOpacity) override { return Layer::updateDisplayedOpacity(parentOpacity); }// 串联透明度是否可用    virtual bool isCascadeOpacityEnabled() const override { return Layer::isCascadeOpacityEnabled(); }    // 设置串联透明度是否可用virtual void setCascadeOpacityEnabled(bool cascadeOpacityEnabled) override { return 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 { return Layer::setColor(color); }// 更新显示颜色    virtual void updateDisplayedColor(const Color3B& parentColor) override { return Layer::updateDisplayedColor(parentColor); }// 串联颜色是否可用    virtual bool isCascadeColorEnabled() const override { return Layer::isCascadeOpacityEnabled(); }// 设置串联颜色是否可用    virtual void setCascadeColorEnabled(bool cascadeColorEnabled) override { return Layer::setCascadeColorEnabled(cascadeColorEnabled); }// 设置透明度改变颜色    virtual void setOpacityModifyRGB(bool bValue) override { return 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.     */ // 创建一个LayerColor对象    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;// 设置contentsize    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 modeColor is interpolated between the startColor and endColor along the givenvector (starting at the origin, ending at the terminus).  If no vector issupplied, 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 fornon-cardinal vectors; a smooth gradient implying both end points will be stillbe 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.     */ // 创建一个LayerGradient对象    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_WP8) || (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT)    // WP8 in VS2012 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.     */ // 切换层,并且release当前层    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);};


0 0
原创粉丝点击