Difference between revisions of "Shape:setFillStyle"

From GiderosMobile
m (Text replacement - "</source>" to "</syntaxhighlight>")
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''<translate>Available since</translate>:''' Gideros 2011.6<br/>
+
'''Available since:''' Gideros 2011.6<br/>
'''<translate>Class</translate>:''' [[Special:MyLanguage/Shape|Shape]]<br/>
+
'''Class:''' [[Shape]]<br/>
=== <translate>Description</translate> ===
 
<translate><br />
 
Sets the fill style that `Shape` object uses for subsequent drawings. The fill style remains in effect until you call `setFillStyle()` function with different<br />
 
parameters.<br />
 
<br />
 
`type` parameter can be one of the following values:<br />
 
<br />
 
&lt;ul&gt;<br />
 
&lt;li&gt;**Shape.NONE:** Clears the fill style.&lt;/li&gt;<br />
 
&lt;li&gt;**Shape.SOLID:** Sets the fill style as a solid color. In this mode, the parameters are color (in hexedecial value) and an optional alpha value.&lt;/li&gt;<br />
 
&lt;li&gt;**Shape.TEXTURE:** Sets the fill style as a textured. In this mode, the parameters are texture and an optional transformation matrix.&lt;/li&gt;<br />
 
&lt;/ul&gt;<br />
 
<br />
 
See the following example for more detailed usage of this function.<br />
 
<br /></translate>
 
<source lang="lua">
 
Shape:setFillStyle(type,...)
 
</source>
 
=== <translate>Parameters</translate> ===
 
'''type''': (string) <translate>The type of the fill. Can be one of the Shape.NONE, Shape.SOLID or Shape.TEXTURE.</translate> <br/>
 
'''...''': (any) <translate>Parameters of the fill style.</translate> <br/>
 
=== <translate>Examples</translate> ===
 
'''Example'''<br/>
 
<source lang="lua">setFillStyle(Shape.NONE) -- clears the fill style
 
  
setFillStyle(Shape.SOLID, 0xff0000) -- sets the fill style as solid red color
+
=== 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.
 +
<syntaxhighlight lang="lua">
 +
Shape:setFillStyle(fillstyle,...)
 +
</syntaxhighlight>
  
setFillStyle(Shape.SOLID, 0xff0000, 0.5) -- sets the fill style as solid red color with 0.5 transparency
+
''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
  
local texture = Texture.new(&quot;image.png&quot;)
+
=== Parameters ===
setFillStyle(Shape.TEXTURE, texture) -- sets the fill style as texture with &quot;image.png&quot;
+
'''fillstyle''': (string) the fill style type<br/>
 +
'''...''': (any) parameters of the fill style<br/>
 +
 
 +
=== Examples ===
 +
<syntaxhighlight lang="lua">
 +
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)
 
local matrix = Matrix.new(0.5, 0, 0, 0.5, 0, 0)
setFillStyle(Shape.TEXTURE, texture, matrix) -- sets the fill style as texture with &quot;image.png&quot; with a transformation matrix
+
setFillStyle(Shape.TEXTURE, texture, matrix) -- sets the fill style as texture with "image.png" with a transformation matrix
&lt;/code&gt;&lt;/pre&gt;
+
 
&lt;!--
+
--[[
&lt;pre&gt;&lt;code&gt;
+
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
+
]]
&lt;/code&gt;&lt;/pre&gt;
+
</syntaxhighlight>
--&gt;
+
 
</source>
+
{{Shape}}

Latest revision as of 15: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
]]