2014-03-10 14:04:58 +08:00
--------------------------------
-- @module Label
2014-03-26 14:03:04 +08:00
-- @extend SpriteBatchNode,LabelProtocol
2014-06-25 17:36:50 +08:00
-- @parent_module cc
2014-03-18 15:55:30 +08:00
2014-03-25 17:30:11 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-25 17:30:11 +08:00
-- @function [parent=#Label] isClipMarginEnabled
-- @param self
-- @return bool#bool ret (return value: bool)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Enable shadow for the label<br>
-- todo support blur for shadow effect
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] enableShadow
-- @param self
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the untransformed size of the label in a more efficient way.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setDimensions
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #unsigned int width
-- @param #unsigned int height
2014-03-10 14:04:58 +08:00
2014-03-11 16:38:10 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] getString
2014-03-11 16:38:10 +08:00
-- @param self
2014-04-10 11:24:38 +08:00
-- @return string#string ret (return value: string)
2014-03-11 16:38:10 +08:00
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] getHeight
2014-03-10 14:04:58 +08:00
-- @param self
2014-04-10 11:24:38 +08:00
-- @return unsigned int#unsigned int ret (return value: unsigned int)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- disable shadow/outline/glow rendering
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] disableEffect
-- @param self
2014-05-07 16:30:46 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- set TTF configuration for Label
2014-05-07 16:30:46 +08:00
-- @function [parent=#Label] setTTFConfig
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #cc._ttfConfig ttfConfig
2014-05-07 16:30:46 +08:00
-- @return bool#bool ret (return value: bool)
2014-03-21 15:01:27 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Returns the text color of this label<br>
-- Only support for TTF and system font<br>
-- warning Different from the color of Node.
2014-03-21 15:01:27 +08:00
-- @function [parent=#Label] getTextColor
-- @param self
2014-05-08 11:19:36 +08:00
-- @return color4b_table#color4b_table ret (return value: color4b_table)
2014-03-21 15:01:27 +08:00
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the untransformed size of the label.<br>
-- The label's width be used for text align if the set value not equal zero.<br>
-- The label's max line width will be equal to the same value.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setWidth
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #unsigned int width
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getMaxLineWidth
-- @param self
-- @return unsigned int#unsigned int ret (return value: unsigned int)
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getHorizontalAlignment
-- @param self
2014-07-17 22:20:04 +08:00
-- @return int#int ret (return value: int)
2014-03-10 14:04:58 +08:00
2014-03-25 17:30:11 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- clip upper and lower margin for reduce height of label.
2014-03-25 17:30:11 +08:00
-- @function [parent=#Label] setClipMarginEnabled
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #bool clipEnabled
2014-03-25 17:30:11 +08:00
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- changes the string to render<br>
-- warning It is as expensive as changing the string if you haven't set up TTF/BMFont/CharMap for the label.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setString
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string text
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] setSystemFontName
2014-03-10 14:04:58 +08:00
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string systemFont
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setBMFontFilePath
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string bmfontFilePath
-- @param #vec2_table imageOffset
2014-03-10 14:04:58 +08:00
-- @return bool#bool ret (return value: bool)
2014-03-27 16:43:46 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-27 16:43:46 +08:00
-- @function [parent=#Label] getFontAtlas
-- @param self
-- @return FontAtlas#FontAtlas ret (return value: cc.FontAtlas)
2014-06-19 15:22:49 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the line height of the label<br>
-- warning Not support system font<br>
-- since v3.2.0
2014-06-19 15:22:49 +08:00
-- @function [parent=#Label] setLineHeight
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #float height
2014-06-19 15:22:49 +08:00
2014-03-11 16:38:10 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] setSystemFontSize
2014-03-11 16:38:10 +08:00
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #float fontSize
2014-03-11 16:38:10 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- update content immediately.
2014-03-11 16:38:10 +08:00
-- @function [parent=#Label] updateContent
-- @param self
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getStringLength
-- @param self
-- @return int#int ret (return value: int)
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setLineBreakWithoutSpace
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #bool breakWithoutSpace
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getStringNumLines
-- @param self
-- @return int#int ret (return value: int)
--------------------------------
2014-09-02 13:45:07 +08:00
-- only support for TTF
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] enableOutline
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #color4b_table outlineColor
-- @param #int outlineSize
2014-03-10 14:04:58 +08:00
2014-06-19 15:22:49 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Returns the additional kerning of this label<br>
-- warning Not support system font<br>
-- since v3.2.0
2014-06-19 15:22:49 +08:00
-- @function [parent=#Label] getAdditionalKerning
-- @param self
-- @return float#float ret (return value: float)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-07-17 10:28:34 +08:00
-- @overload self, cc.Texture2D, int, int, int
-- @overload self, string, int, int, int
-- @overload self, string
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setCharMap
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string charMapFile
-- @param #int itemWidth
-- @param #int itemHeight
-- @param #int startCharMap
2014-10-17 22:56:22 +08:00
-- @return bool#bool ret (return value: bool)
2014-03-10 14:04:58 +08:00
2014-03-11 16:38:10 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-11 16:38:10 +08:00
-- @function [parent=#Label] getDimensions
-- @param self
-- @return size_table#size_table ret (return value: size_table)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the max line width of the label.<br>
-- The label's max line width be used for force line breaks if the set value not equal zero.<br>
-- The label's width and max line width has not always to be equal.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setMaxLineWidth
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #unsigned int maxLineWidth
2014-03-10 14:04:58 +08:00
2014-04-10 11:24:38 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] getSystemFontName
-- @param self
-- @return string#string ret (return value: string)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setVerticalAlignment
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #int vAlignment
2014-03-11 16:38:10 +08:00
2014-06-19 15:22:49 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Returns the line height of this label<br>
-- warning Not support system font
2014-06-19 15:22:49 +08:00
-- @function [parent=#Label] getLineHeight
-- @param self
-- @return float#float ret (return value: float)
2014-03-11 16:38:10 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] getTTFConfig
2014-03-11 16:38:10 +08:00
-- @param self
2014-04-10 11:24:38 +08:00
-- @return _ttfConfig#_ttfConfig ret (return value: cc._ttfConfig)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getVerticalAlignment
-- @param self
2014-07-17 22:20:04 +08:00
-- @return int#int ret (return value: int)
2014-03-10 14:04:58 +08:00
2014-03-21 15:01:27 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the text color of the label<br>
-- Only support for TTF and system font<br>
-- warning Different from the color of Node.
2014-03-21 15:01:27 +08:00
-- @function [parent=#Label] setTextColor
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #color4b_table color
2014-03-21 15:01:27 +08:00
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the untransformed size of the label.<br>
-- The label's height be used for text align if the set value not equal zero.<br>
-- The text will display of incomplete when the size of label not enough to support display all text.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setHeight
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #unsigned int height
2014-03-10 14:04:58 +08:00
2014-03-19 09:56:50 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-19 09:56:50 +08:00
-- @function [parent=#Label] getWidth
-- @param self
-- @return unsigned int#unsigned int ret (return value: unsigned int)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- only support for TTF
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] enableGlow
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #color4b_table glowColor
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getLetter
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #int lettetIndex
2014-03-10 14:04:58 +08:00
-- @return Sprite#Sprite ret (return value: cc.Sprite)
2014-06-19 15:22:49 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Sets the additional kerning of the label<br>
-- warning Not support system font<br>
-- since v3.2.0
2014-06-19 15:22:49 +08:00
-- @function [parent=#Label] setAdditionalKerning
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #float space
2014-06-19 15:22:49 +08:00
2014-04-10 11:24:38 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] getSystemFontSize
-- @param self
-- @return float#float ret (return value: float)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] getTextAlignment
-- @param self
2014-07-17 22:20:04 +08:00
-- @return int#int ret (return value: int)
2014-03-10 14:04:58 +08:00
2014-03-19 09:56:50 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-19 09:56:50 +08:00
-- @function [parent=#Label] getBMFontFilePath
-- @param self
-- @return string#string ret (return value: string)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setHorizontalAlignment
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #int hAlignment
2014-03-10 14:04:58 +08:00
2014-03-11 16:38:10 +08:00
--------------------------------
2014-07-17 22:20:04 +08:00
-- @overload self, int, int
-- @overload self, int
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] setAlignment
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #int hAlignment
-- @param #int vAlignment
2014-03-10 14:04:58 +08:00
2014-10-14 14:32:12 +08:00
--------------------------------
--
-- @function [parent=#Label] requestSystemFontRefresh
-- @param self
2014-03-10 14:04:58 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] createWithBMFont
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string bmfontFilePath
-- @param #string text
-- @param #int alignment
-- @param #int maxLineWidth
-- @param #vec2_table imageOffset
2014-03-10 14:04:58 +08:00
-- @return Label#Label ret (return value: cc.Label)
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] create
2014-03-10 14:04:58 +08:00
-- @param self
2014-04-10 11:24:38 +08:00
-- @return Label#Label ret (return value: cc.Label)
2014-03-10 14:04:58 +08:00
--------------------------------
2014-07-17 10:28:34 +08:00
-- @overload self, cc.Texture2D, int, int, int
-- @overload self, string, int, int, int
-- @overload self, string
2014-03-10 14:04:58 +08:00
-- @function [parent=#Label] createWithCharMap
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string charMapFile
-- @param #int itemWidth
-- @param #int itemHeight
-- @param #int startCharMap
2014-10-17 22:56:22 +08:00
-- @return Label#Label ret (return value: cc.Label)
2014-03-10 14:04:58 +08:00
2014-03-11 16:38:10 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
-- Creates a label with an initial string,font[font name or font file],font size, dimension in points, horizontal alignment and vertical alignment.<br>
-- warning It will generate texture by the platform-dependent code
2014-04-10 11:24:38 +08:00
-- @function [parent=#Label] createWithSystemFont
2014-03-11 16:38:10 +08:00
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #string text
-- @param #string font
-- @param #float fontSize
-- @param #size_table dimensions
-- @param #int hAlignment
-- @param #int vAlignment
2014-03-11 16:38:10 +08:00
-- @return Label#Label ret (return value: cc.Label)
2014-04-02 17:58:03 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-02 17:58:03 +08:00
-- @function [parent=#Label] draw
-- @param self
-- @param #cc.Renderer renderer
2014-09-02 13:45:07 +08:00
-- @param #mat4_table transform
-- @param #unsigned int flags
2014-04-02 17:58:03 +08:00
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] addChild
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #cc.Node child
-- @param #int zOrder
-- @param #int tag
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-02 17:58:03 +08:00
-- @function [parent=#Label] setScaleY
2014-03-18 15:55:30 +08:00
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #float scaleY
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] setScaleX
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #float scaleX
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] isOpacityModifyRGB
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] getScaleY
-- @param self
-- @return float#float ret (return value: float)
2014-03-31 16:52:27 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-31 16:52:27 +08:00
-- @function [parent=#Label] setBlendFunc
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #cc.BlendFunc blendFunc
2014-03-31 16:52:27 +08:00
2014-05-23 11:12:39 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-05-23 11:12:39 +08:00
-- @function [parent=#Label] visit
-- @param self
-- @param #cc.Renderer renderer
2014-09-02 13:45:07 +08:00
-- @param #mat4_table parentTransform
-- @param #unsigned int parentFlags
2014-05-23 11:12:39 +08:00
2014-04-02 17:58:03 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-02 17:58:03 +08:00
-- @function [parent=#Label] getScaleX
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-02 17:58:03 +08:00
-- @function [parent=#Label] getDescription
-- @param self
-- @return string#string ret (return value: string)
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] setOpacityModifyRGB
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #bool isOpacityModifyRGB
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] setScale
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #float scale
2014-03-18 15:55:30 +08:00
2014-04-01 10:09:55 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-04-01 10:09:55 +08:00
-- @function [parent=#Label] sortAllChildren
-- @param self
2014-03-21 15:01:27 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-21 15:01:27 +08:00
-- @function [parent=#Label] updateDisplayedOpacity
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #unsigned char parentOpacity
2014-03-21 15:01:27 +08:00
2014-03-18 15:55:30 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-18 15:55:30 +08:00
-- @function [parent=#Label] getContentSize
-- @param self
-- @return size_table#size_table ret (return value: size_table)
2014-03-28 16:20:29 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-28 16:20:29 +08:00
-- @function [parent=#Label] getBoundingBox
-- @param self
-- @return rect_table#rect_table ret (return value: rect_table)
2014-03-19 14:14:23 +08:00
--------------------------------
2014-09-02 13:45:07 +08:00
--
2014-03-19 14:14:23 +08:00
-- @function [parent=#Label] updateDisplayedColor
-- @param self
2014-09-02 13:45:07 +08:00
-- @param #color3b_table parentColor
2014-03-19 14:14:23 +08:00
2014-03-10 14:04:58 +08:00
return nil