Difference between revisions of "Shape:setFillStyle"
From GiderosMobile
m (some typos plus formatting) |
m (Text replacement - "</source>" to "</syntaxhighlight>") |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | + | '''Available since:''' Gideros 2011.6<br/> | |
| − | ''' | + | '''Class:''' [[Shape]]<br/> |
| − | ''' | ||
| − | === | + | === Description === |
| − | Sets the fill style that | + | Sets the fill style that '''Shape''' object uses for subsequent drawings. The fill style remains in effect until you call ''setFillStyle()'' function with different parameters. |
| + | <syntaxhighlight lang="lua"> | ||
| + | Shape:setFillStyle(fillstyle,...) | ||
| + | </syntaxhighlight> | ||
| − | + | ''fillstyle'' parameter can be one of the following values: | |
| − | |||
| − | |||
| − | |||
| − | |||
* '''Shape.NONE''': clears the fill style | * '''Shape.NONE''': clears the fill style | ||
* '''Shape.SOLID''': sets the fill style as a solid color. In this mode, the parameters are color (in hexadecimal value) and an optional alpha value | * '''Shape.SOLID''': sets the fill style as a solid color. In this mode, the parameters are color (in hexadecimal value) and an optional alpha value | ||
* '''Shape.TEXTURE''': sets the fill style as textured. In this mode, the parameters are texture and an optional transformation matrix | * '''Shape.TEXTURE''': sets the fill style as textured. In this mode, the parameters are texture and an optional transformation matrix | ||
| − | === | + | === Parameters === |
| − | ''' | + | '''fillstyle''': (string) the fill style type<br/> |
| − | '''...''': (any) | + | '''...''': (any) parameters of the fill style<br/> |
| − | === | + | === Examples === |
| − | < | + | <syntaxhighlight lang="lua"> |
setFillStyle(Shape.NONE) -- clears the fill style | setFillStyle(Shape.NONE) -- clears the fill style | ||
setFillStyle(Shape.SOLID, 0xff0000) -- sets the fill style as solid red color | setFillStyle(Shape.SOLID, 0xff0000) -- sets the fill style as solid red color | ||
| Line 32: | Line 30: | ||
setFillStyle(Shape.TEXTURE, texture, matrix) -- sets the fill style as texture with "image.png" with a transformation matrix | setFillStyle(Shape.TEXTURE, texture, matrix) -- sets the fill style as texture with "image.png" with a transformation matrix | ||
| − | + | --[[ | |
setFillStyle(Shape.LINEAR_GRADIENT, {}, {}, {}, (optional) matrix) -- not supported yet | setFillStyle(Shape.LINEAR_GRADIENT, {}, {}, {}, (optional) matrix) -- not supported yet | ||
setFillStyle(Shape.RADIAL_GRADIENT, {}, {}, {}, (optional) matrix) -- not supported yet | setFillStyle(Shape.RADIAL_GRADIENT, {}, {}, {}, (optional) matrix) -- not supported yet | ||
| − | + | ]] | |
| − | </ | + | </syntaxhighlight> |
{{Shape}} | {{Shape}} | ||
Latest revision as of 14:31, 13 July 2023
Available since: Gideros 2011.6
Class: Shape
Description
Sets the fill style that Shape object uses for subsequent drawings. The fill style remains in effect until you call setFillStyle() function with different parameters.
Shape:setFillStyle(fillstyle,...)
fillstyle parameter can be one of the following values:
- Shape.NONE: clears the fill style
- Shape.SOLID: sets the fill style as a solid color. In this mode, the parameters are color (in hexadecimal value) and an optional alpha value
- Shape.TEXTURE: sets the fill style as textured. In this mode, the parameters are texture and an optional transformation matrix
Parameters
fillstyle: (string) the fill style type
...: (any) parameters of the fill style
Examples
setFillStyle(Shape.NONE) -- clears the fill style
setFillStyle(Shape.SOLID, 0xff0000) -- sets the fill style as solid red color
setFillStyle(Shape.SOLID, 0xff0000, 0.5) -- sets the fill style as solid red color with 0.5 transparency
local texture = Texture.new("image.png")
setFillStyle(Shape.TEXTURE, texture) -- sets the fill style as texture with "image.png"
local matrix = Matrix.new(0.5, 0, 0, 0.5, 0, 0)
setFillStyle(Shape.TEXTURE, texture, matrix) -- sets the fill style as texture with "image.png" with a transformation matrix
--[[
setFillStyle(Shape.LINEAR_GRADIENT, {}, {}, {}, (optional) matrix) -- not supported yet
setFillStyle(Shape.RADIAL_GRADIENT, {}, {}, {}, (optional) matrix) -- not supported yet
]]
