2012-09-25 17:26:09 +08:00
|
|
|
|
/****************************************************************************
|
|
|
|
|
Copyright (c) 2012 cocos2d-x.org
|
|
|
|
|
|
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
|
|
|
|
|
|
Created by Jung Sang-Taik on 12. 3. 16..
|
|
|
|
|
Copyright (c) 2012 Neofect. All rights reserved.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
****************************************************************************/
|
2012-04-16 18:58:43 +08:00
|
|
|
|
|
|
|
|
|
#ifndef __CCScale9Sprite_H__
|
|
|
|
|
#define __CCScale9Sprite_H__
|
|
|
|
|
|
2014-01-17 13:35:58 +08:00
|
|
|
|
#include "CCNode.h"
|
|
|
|
|
#include "CCSpriteFrame.h"
|
|
|
|
|
#include "CCSpriteBatchNode.h"
|
|
|
|
|
|
2013-05-24 11:42:27 +08:00
|
|
|
|
#include "../../ExtensionMacros.h"
|
2012-04-16 18:58:43 +08:00
|
|
|
|
|
2012-04-27 18:47:49 +08:00
|
|
|
|
NS_CC_EXT_BEGIN
|
2012-04-16 18:58:43 +08:00
|
|
|
|
|
2012-06-20 18:09:11 +08:00
|
|
|
|
/**
|
|
|
|
|
* @addtogroup GUI
|
|
|
|
|
* @{
|
|
|
|
|
* @addtogroup control_extension
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
2013-04-15 16:37:35 +08:00
|
|
|
|
/**
|
|
|
|
|
* A 9-slice sprite for cocos2d.
|
|
|
|
|
*
|
|
|
|
|
* 9-slice scaling allows you to specify how scaling is applied
|
|
|
|
|
* to specific areas of a sprite. With 9-slice scaling (3x3 grid),
|
|
|
|
|
* you can ensure that the sprite does not become distorted when
|
|
|
|
|
* scaled.
|
|
|
|
|
*
|
|
|
|
|
* @see http://yannickloriot.com/library/ios/cccontrolextension/Classes/CCScale9Sprite.html
|
|
|
|
|
*/
|
2013-12-06 18:07:16 +08:00
|
|
|
|
class Scale9Sprite : public Node
|
2012-04-16 18:58:43 +08:00
|
|
|
|
{
|
|
|
|
|
public:
|
2013-09-13 16:46:31 +08:00
|
|
|
|
/**
|
|
|
|
|
* @js ctor
|
|
|
|
|
*/
|
2013-06-20 14:15:53 +08:00
|
|
|
|
Scale9Sprite();
|
2013-09-13 11:41:20 +08:00
|
|
|
|
/**
|
|
|
|
|
* @js NA
|
|
|
|
|
* @lua NA
|
|
|
|
|
*/
|
2013-06-20 14:15:53 +08:00
|
|
|
|
virtual ~Scale9Sprite();
|
2012-04-16 18:58:43 +08:00
|
|
|
|
|
|
|
|
|
public:
|
2013-07-19 07:30:19 +08:00
|
|
|
|
static Scale9Sprite* create();
|
2012-04-16 18:58:43 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with a texture file, a delimitation zone and
|
|
|
|
|
* with the specified cap insets.
|
|
|
|
|
*
|
2013-10-08 11:53:38 +08:00
|
|
|
|
* @see initWithFile(const char *file, const Rect& rect, const Rect& capInsets)
|
2012-04-19 14:35:52 +08:00
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
static Scale9Sprite* create(const std::string& file, const Rect& rect, const Rect& capInsets);
|
2012-09-25 16:57:51 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with a texture file. The whole texture will be
|
|
|
|
|
* broken down into a 3×3 grid of equal blocks.
|
|
|
|
|
*
|
2013-10-08 11:53:38 +08:00
|
|
|
|
* @see initWithFile(const Rect& capInsets, const char *file)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
static Scale9Sprite* create(const Rect& capInsets, const std::string& file);
|
2013-04-15 16:37:35 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with a texture file and a delimitation zone. The
|
|
|
|
|
* texture will be broken down into a 3×3 grid of equal blocks.
|
|
|
|
|
*
|
2013-10-08 11:53:38 +08:00
|
|
|
|
* @see initWithFile(const char *file, const Rect& rect)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
static Scale9Sprite* create(const std::string& file, const Rect& rect);
|
2012-06-01 02:47:16 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with a texture file. The whole texture will be
|
|
|
|
|
* broken down into a 3×3 grid of equal blocks.
|
|
|
|
|
*
|
2013-08-05 20:46:57 +08:00
|
|
|
|
* @see initWithFile(const char *file)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
static Scale9Sprite* create(const std::string& file);
|
2013-07-19 07:30:19 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with an sprite frame.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
2013-08-05 20:46:57 +08:00
|
|
|
|
* @see initWithSpriteFrame(SpriteFrame *spriteFrame)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
|
|
|
|
static Scale9Sprite* createWithSpriteFrame(SpriteFrame* spriteFrame);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with an sprite frame and the centre of its zone.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
2013-10-08 11:53:38 +08:00
|
|
|
|
* @see initWithSpriteFrame(SpriteFrame *spriteFrame, const Rect& capInsets)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
2013-10-08 11:53:38 +08:00
|
|
|
|
static Scale9Sprite* createWithSpriteFrame(SpriteFrame* spriteFrame, const Rect& capInsets);
|
2013-07-19 07:30:19 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with an sprite frame name.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
2013-08-05 20:46:57 +08:00
|
|
|
|
* @see initWithSpriteFrameName(const char *spriteFrameName)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
static Scale9Sprite* createWithSpriteFrameName(const std::string& spriteFrameName);
|
2013-07-19 07:30:19 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Creates a 9-slice sprite with an sprite frame name and the centre of its
|
|
|
|
|
* zone.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
2013-10-08 11:53:38 +08:00
|
|
|
|
* @see initWithSpriteFrameName(const char *spriteFrameName, const Rect& capInsets)
|
2013-07-19 07:30:19 +08:00
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
static Scale9Sprite* createWithSpriteFrameName(const std::string& spriteFrameName, const Rect& capInsets);
|
2012-06-01 02:47:16 +08:00
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with a texture file, a delimitation zone and
|
|
|
|
|
* with the specified cap insets.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param file The name of the texture file.
|
|
|
|
|
* @param rect The rectangle that describes the sub-part of the texture that
|
|
|
|
|
* is the whole image. If the shape is the whole texture, set this to the
|
|
|
|
|
* texture's full rect.
|
|
|
|
|
* @param capInsets The values to use for the cap insets.
|
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
virtual bool initWithFile(const std::string& file, const Rect& rect, const Rect& capInsets);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with a texture file and a delimitation zone. The
|
|
|
|
|
* texture will be broken down into a 3×3 grid of equal blocks.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param file The name of the texture file.
|
|
|
|
|
* @param rect The rectangle that describes the sub-part of the texture that
|
|
|
|
|
* is the whole image. If the shape is the whole texture, set this to the
|
|
|
|
|
* texture's full rect.
|
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
virtual bool initWithFile(const std::string& file, const Rect& rect);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with a texture file and with the specified cap
|
|
|
|
|
* insets.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param file The name of the texture file.
|
|
|
|
|
* @param capInsets The values to use for the cap insets.
|
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
virtual bool initWithFile(const Rect& capInsets, const std::string& file);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with a texture file. The whole texture will be
|
|
|
|
|
* broken down into a 3×3 grid of equal blocks.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param file The name of the texture file.
|
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
virtual bool initWithFile(const std::string& file);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with an sprite frame and with the specified
|
|
|
|
|
* cap insets.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param spriteFrame The sprite frame object.
|
|
|
|
|
* @param capInsets The values to use for the cap insets.
|
|
|
|
|
*/
|
2013-10-08 11:53:38 +08:00
|
|
|
|
virtual bool initWithSpriteFrame(SpriteFrame* spriteFrame, const Rect& capInsets);
|
2012-06-14 15:13:16 +08:00
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with an sprite frame.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param spriteFrame The sprite frame object.
|
|
|
|
|
*/
|
2013-06-20 14:15:53 +08:00
|
|
|
|
virtual bool initWithSpriteFrame(SpriteFrame* spriteFrame);
|
2012-06-14 15:13:16 +08:00
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with an sprite frame name and with the specified
|
|
|
|
|
* cap insets.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param spriteFrameName The sprite frame name.
|
|
|
|
|
* @param capInsets The values to use for the cap insets.
|
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
virtual bool initWithSpriteFrameName(const std::string& spriteFrameName, const Rect& capInsets);
|
2012-06-14 15:13:16 +08:00
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
|
/**
|
|
|
|
|
* Initializes a 9-slice sprite with an sprite frame name.
|
|
|
|
|
* Once the sprite is created, you can then call its "setContentSize:" method
|
|
|
|
|
* to resize the sprite will all it's 9-slice goodness intract.
|
|
|
|
|
* It respects the anchorPoint too.
|
|
|
|
|
*
|
|
|
|
|
* @param spriteFrameName The sprite frame name.
|
|
|
|
|
*/
|
2014-04-02 18:35:08 +08:00
|
|
|
|
virtual bool initWithSpriteFrameName(const std::string& spriteFrameName);
|
2012-06-14 15:13:16 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
virtual bool init();
|
2013-10-08 11:53:38 +08:00
|
|
|
|
virtual bool initWithBatchNode(SpriteBatchNode* batchnode, const Rect& rect, bool rotated, const Rect& capInsets);
|
|
|
|
|
virtual bool initWithBatchNode(SpriteBatchNode* batchnode, const Rect& rect, const Rect& capInsets);
|
2013-07-19 07:30:19 +08:00
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
|
/**
|
|
|
|
|
* Creates and returns a new sprite object with the specified cap insets.
|
|
|
|
|
* You use this method to add cap insets to a sprite or to change the existing
|
|
|
|
|
* cap insets of a sprite. In both cases, you get back a new image and the
|
|
|
|
|
* original sprite remains untouched.
|
|
|
|
|
*
|
|
|
|
|
* @param capInsets The values to use for the cap insets.
|
|
|
|
|
*/
|
2013-10-08 11:53:38 +08:00
|
|
|
|
Scale9Sprite* resizableSpriteWithCapInsets(const Rect& capInsets);
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
2013-10-08 11:53:38 +08:00
|
|
|
|
virtual bool updateWithBatchNode(SpriteBatchNode* batchnode, const Rect& rect, bool rotated, const Rect& capInsets);
|
2013-07-19 07:30:19 +08:00
|
|
|
|
virtual void setSpriteFrame(SpriteFrame * spriteFrame);
|
2012-06-14 15:13:16 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
// overrides
|
|
|
|
|
virtual void setContentSize(const Size & size) override;
|
2013-09-13 11:41:20 +08:00
|
|
|
|
/**
|
|
|
|
|
* @js NA
|
|
|
|
|
* @lua NA
|
|
|
|
|
*/
|
2014-03-01 08:10:48 +08:00
|
|
|
|
virtual void visit(Renderer *renderer, const kmMat4 &parentTransform, bool parentTransformUpdated) override;
|
2013-07-19 07:30:19 +08:00
|
|
|
|
virtual void setOpacityModifyRGB(bool bValue) override;
|
|
|
|
|
virtual bool isOpacityModifyRGB(void) const override;
|
|
|
|
|
virtual void setOpacity(GLubyte opacity) override;
|
|
|
|
|
virtual void setColor(const Color3B& color) override;
|
|
|
|
|
virtual void updateDisplayedOpacity(GLubyte parentOpacity) override;
|
|
|
|
|
virtual void updateDisplayedColor(const Color3B& parentColor) override;
|
2013-07-05 17:32:50 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
protected:
|
|
|
|
|
void updateCapInset();
|
|
|
|
|
void updatePositions();
|
2012-06-01 02:47:16 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
bool _spritesGenerated;
|
|
|
|
|
Rect _spriteRect;
|
|
|
|
|
bool _spriteFrameRotated;
|
|
|
|
|
Rect _capInsetsInternal;
|
|
|
|
|
bool _positionsAreDirty;
|
2012-06-01 02:47:16 +08:00
|
|
|
|
|
2013-07-19 07:30:19 +08:00
|
|
|
|
SpriteBatchNode* _scale9Image;
|
|
|
|
|
Sprite* _topLeft;
|
|
|
|
|
Sprite* _top;
|
|
|
|
|
Sprite* _topRight;
|
|
|
|
|
Sprite* _left;
|
|
|
|
|
Sprite* _centre;
|
|
|
|
|
Sprite* _right;
|
|
|
|
|
Sprite* _bottomLeft;
|
|
|
|
|
Sprite* _bottom;
|
|
|
|
|
Sprite* _bottomRight;
|
|
|
|
|
|
|
|
|
|
bool _opacityModifyRGB;
|
|
|
|
|
|
|
|
|
|
/** Original sprite's size. */
|
|
|
|
|
CC_SYNTHESIZE_READONLY(Size, _originalSize, OriginalSize);
|
|
|
|
|
/** Prefered sprite's size. By default the prefered size is the original size. */
|
|
|
|
|
|
|
|
|
|
//if the preferredSize component is given as -1, it is ignored
|
|
|
|
|
CC_PROPERTY(Size, _preferredSize, PreferredSize);
|
|
|
|
|
/**
|
|
|
|
|
* The end-cap insets.
|
|
|
|
|
* On a non-resizeable sprite, this property is set to CGRect::ZERO; the sprite
|
|
|
|
|
* does not use end caps and the entire sprite is subject to stretching.
|
|
|
|
|
*/
|
|
|
|
|
CC_PROPERTY(Rect, _capInsets, CapInsets);
|
|
|
|
|
/** Sets the left side inset */
|
|
|
|
|
CC_PROPERTY(float, _insetLeft, InsetLeft);
|
|
|
|
|
/** Sets the top side inset */
|
|
|
|
|
CC_PROPERTY(float, _insetTop, InsetTop);
|
|
|
|
|
/** Sets the right side inset */
|
|
|
|
|
CC_PROPERTY(float, _insetRight, InsetRight);
|
|
|
|
|
/** Sets the bottom side inset */
|
|
|
|
|
CC_PROPERTY(float, _insetBottom, InsetBottom);
|
2012-04-16 18:58:43 +08:00
|
|
|
|
};
|
|
|
|
|
|
2012-06-20 18:09:11 +08:00
|
|
|
|
// end of GUI group
|
|
|
|
|
/// @}
|
|
|
|
|
/// @}
|
|
|
|
|
|
2012-04-27 18:47:49 +08:00
|
|
|
|
NS_CC_EXT_END
|
2012-04-17 11:12:05 +08:00
|
|
|
|
|
2012-04-16 18:58:43 +08:00
|
|
|
|
#endif // __CCScale9Sprite_H__
|