Difference between revisions of "Path2D:setPath"

From GiderosMobile
(removed language stuff)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<languages />
+
'''Available since:''' Gideros 2016.04<br/>
'''<translate>Available since</translate>:''' Gideros 2016.04<br/>
+
'''Class:''' [[Path2D]]<br/>
'''<translate>Class</translate>:''' [[Special:MyLanguage/Path2D|Path2D]]<br/>
+
 
=== <translate>Description</translate> ===
+
=== Description ===
<translate>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>
 
and provided coordinates as table or simply arguments</translate>
 
 
<source lang="lua">
 
<source lang="lua">
Path2D:setPath(commands,coordinates,moreCoordinates)
+
Path2D:setPath(commands,coordinates,moreCoordinates)
 
</source>
 
</source>
  
=== <translate>Parameters</translate> ===
+
=== Parameters ===
'''commands''': (string) <translate>list of commands as ML**Z expecting according coordinates</translate> <br/>
+
'''commands''': (string) list of commands as ML**Z expecting according coordinates<br/>
'''coordinates''': (table or number) <translate>lua table with coordinates for each command, in the same order as commands</translate> <br/>
+
'''coordinates''': (table or number) lua table with coordinates for each command, in the same order as commands<br/>
'''moreCoordinates''': (number) <translate>if second argument is not table, you can provide more coordinates as separate arguments</translate> '''optional'''<br/>
+
'''moreCoordinates''': (number) if second argument is not table, you can provide more coordinates as separate arguments '''optional'''<br/>
  
=== <translate>Examples</translate> ===
+
=== Example ===
 
'''Drawing Moon'''<br/>
 
'''Drawing Moon'''<br/>
<source lang="lua">--Moon
+
<source lang="lua">
 +
--Moon
 
local p=Path2D.new()
 
local p=Path2D.new()
 
local ms="MQQZ" --MoveTo, QuadTo, QuadTo, Close
 
local ms="MQQZ" --MoveTo, QuadTo, QuadTo, Close
Line 37: Line 36:
 
p:setLineColor(0xC0C0C0) --Line color
 
p:setLineColor(0xC0C0C0) --Line color
 
p:setAnchorPosition(100,100)
 
p:setAnchorPosition(100,100)
stage:addChild(p)</source>
+
stage:addChild(p)
 +
</source>
  
 
{{Path2D}}
 
{{Path2D}}

Revision as of 20:11, 12 March 2021

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)