Difference between revisions of "Path2D:setPath"

From GiderosMobile
(Created page with "__NOTOC__ '''Available since:''' Gideros 2016.04<br/> === Description === Set path to draw, using string with commands represented as: <ul> <li>M - MoveTo, 2 values (x,y)</li>...")
 
m (Text replacement - "</source>" to "</syntaxhighlight>")
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
'''Available since:''' Gideros 2016.04<br/>
 
'''Available since:''' Gideros 2016.04<br/>
 +
'''Class:''' [[Path2D]]<br/>
 +
 
=== Description ===
 
=== Description ===
Set path to draw, using string with commands represented as:
+
Sets path to draw, using string with commands represented as:
<ul>
+
*M - MoveTo, 2 values (x,y)
<li>M - MoveTo, 2 values (x,y)</li>
+
*L - LineTo, 2 values (x,y)
<li>L - LineTo, 2 values (x,y)</li>
+
*Q - QuadTo, 4 values (c0x,c0y,x,y)
<li>Q - QuadTo, 4 values (c0x,c0y,x,y)</li>
+
*C - CubicTo, 6 values (c0x,c0y,c1x,c1y,x,y)
<li>C - CubicTo, 6 values (c0x,c0y,c1x,c1y,x,y)</li>
+
*H - Horzontal Line, 1 value (x)
<li>H - Horzontal Line, 1 value (x)</li>
+
*V - Vertical Line, 1 value (y)
<li>V - Vertical Line, 1 value (y)</li>
+
*A - ArcTo, 7 values (r1,r2,angle,largeArc,sweep,x,y)
<li>A - ArcTo, 7 values (r1,r2,angle,largeArc,sweep,x,y)</li>
+
*Z - Close, no parameter
<li>Z - Close, no parameter</li>
+
*'''*''' - repeats last command until all coordinates are exhausted
<li>* - repeat last command until all coordinates are exhausted</li>
+
and provided coordinates as table or simply arguments.
</ul>
+
<syntaxhighlight lang="lua">
and provided coordinates as table or simply arguments
+
Path2D:setPath(commands,coordinates,moreCoordinates)
<source lang="lua">
+
</syntaxhighlight>
= Path2D:setPath(commandscoordinatesmore coordinates,)
+
 
</source>
+
=== Parameters ===
'''commands:''' (string) list of commands as ML**Z expecting according coordinates ''''''<br/>
+
'''commands''': (string) list of commands as ML**Z expecting according coordinates<br/>
'''coordinates:''' (table or number) lua table with coordinates for each command, in the same order as commands ''''''<br/>
+
'''coordinates''': (table or number) lua table with coordinates for each command, in the same order as commands<br/>
'''more coordinates:''' (number) if second argument is not table, you can provide more coordinates as separate arguments '''optional'''<br/>
+
'''moreCoordinates''': (number) if second argument is not table, you can provide more coordinates as separate arguments '''optional'''<br/>
 +
 
 +
=== Example ===
 +
'''Drawing Moon'''<br/>
 +
<syntaxhighlight lang="lua">
 +
--Moon
 +
local p=Path2D.new()
 +
local ms="MQQZ" --MoveTo, QuadTo, QuadTo, Close
 +
local mp={100,0, -50,100, 100,200, 20,100, 100,0 }
 +
p:setPath(ms,mp) --Set the path from a set of commands and coordinates
 +
p:setLineThickness(3) -- Outline width
 +
p:setFillColor(0xE0E0E0,0.7) --Fill color
 +
p:setLineColor(0xC0C0C0) --Line color
 +
p:setAnchorPosition(100,100)
 +
stage:addChild(p)
 +
</syntaxhighlight>
 +
 
 +
{{Path2D}}

Latest revision as of 15:32, 13 July 2023

Available since: Gideros 2016.04
Class: Path2D

Description

Sets path to draw, using string with commands represented as:

  • M - MoveTo, 2 values (x,y)
  • L - LineTo, 2 values (x,y)
  • Q - QuadTo, 4 values (c0x,c0y,x,y)
  • C - CubicTo, 6 values (c0x,c0y,c1x,c1y,x,y)
  • H - Horzontal Line, 1 value (x)
  • V - Vertical Line, 1 value (y)
  • A - ArcTo, 7 values (r1,r2,angle,largeArc,sweep,x,y)
  • Z - Close, no parameter
  • * - repeats last command until all coordinates are exhausted

and provided coordinates as table or simply arguments.

Path2D:setPath(commands,coordinates,moreCoordinates)

Parameters

commands: (string) list of commands as ML**Z expecting according coordinates
coordinates: (table or number) lua table with coordinates for each command, in the same order as commands
moreCoordinates: (number) if second argument is not table, you can provide more coordinates as separate arguments optional

Example

Drawing Moon

--Moon
local p=Path2D.new()
local ms="MQQZ" --MoveTo, QuadTo, QuadTo, Close
local mp={100,0, -50,100, 100,200, 20,100, 100,0 }
p:setPath(ms,mp) --Set the path from a set of commands and coordinates
p:setLineThickness(3) -- Outline width
p:setFillColor(0xE0E0E0,0.7) --Fill color
p:setLineColor(0xC0C0C0) --Line color
p:setAnchorPosition(100,100)
stage:addChild(p)