Difference between revisions of "Shape:setFillStyle"

From GiderosMobile
m (some typos plus formatting)
(remove language stuff)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<languages />
+
'''Available since:''' Gideros 2011.6<br/>
'''<translate>Available since</translate>:''' Gideros 2011.6<br/>
+
'''Class:''' [[Shape]]<br/>
'''<translate>Class</translate>:''' [[Special:MyLanguage/Shape|Shape]]<br/>
 
  
=== <translate>Description</translate> ===
+
=== Description ===
Sets the fill style that [[Special:MyLanguage/Shape|Shape]] object uses for subsequent drawings. The fill style remains in effect until you call ''setFillStyle()'' function with different parameters.
+
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.
 
 
See examples below for more detailed usage of this function.
 
 
<source lang="lua">
 
<source lang="lua">
Shape:setFillStyle(type,...)
+
Shape:setFillStyle(fillstyle,...)
 
</source>
 
</source>
[[Special:MyLanguage/type|type]] parameter can be one of the following values:
+
 
 +
''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
  
=== <translate>Parameters</translate> ===
+
=== Parameters ===
'''type''': (string) <translate>the type of the fill. Can be one of the Shape.NONE, Shape.SOLID or Shape.TEXTURE</translate><br/>
+
'''fillstyle''': (string) the fill style type<br/>
'''...''': (any) <translate>parameters of the fill style</translate><br/>
+
'''...''': (any) parameters of the fill style<br/>
  
=== <translate>Examples</translate> ===
+
=== Examples ===
 
<source lang="lua">
 
<source lang="lua">
 
setFillStyle(Shape.NONE) -- clears the fill style
 
setFillStyle(Shape.NONE) -- clears the fill style
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
-->
+
]]
 
</source>
 
</source>
  
 
{{Shape}}
 
{{Shape}}

Revision as of 03:30, 25 January 2021

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
]]