Difference between revisions of "Shape"

From GiderosMobile
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
<!-- GIDEROSOBJ:Shape -->
 
<!-- GIDEROSOBJ:Shape -->
−
'''<translate>Supported platforms</translate>:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/>
+
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/>
−
'''<translate>Available since</translate>:''' Gideros 2011.6<br/>
+
'''Available since:''' Gideros 2011.6<br/>
−
'''<translate>Inherits from</translate>:''' [[Special:MyLanguage/Sprite|Sprite]]<br/>
+
'''Inherits from:''' [[Sprite]]<br/>
−
=== <translate>Description</translate> ===
+
 
−
<translate><br />
+
=== Description ===
−
The [[Special:MyLanguage/Shape|Shape]] class is used create and display vector graphics.<br />
+
The '''Shape''' class is used to create and display vector graphics.
−
<br /></translate>
+
 
−
=== <translate>Examples</translate> ===
+
=== Examples ===
−
'''Drawing red square'''<br/>
+
'''Drawing a red square'''
−
<source lang="lua">local shape = Shape.new()
+
<syntaxhighlight lang="lua">
 +
local shape = Shape.new()
 
shape:setFillStyle(Shape.SOLID, 0xff0000, 1)
 
shape:setFillStyle(Shape.SOLID, 0xff0000, 1)
 
shape:beginPath()
 
shape:beginPath()
Line 20: Line 21:
 
shape:endPath()
 
shape:endPath()
 
shape:setPosition(0, 150)
 
shape:setPosition(0, 150)
−
stage:addChild(shape)</source>
+
stage:addChild(shape)
 +
</syntaxhighlight>
 +
 
 +
'''Drawing a grid'''
 +
<syntaxhighlight lang="lua">
 +
application:setBackgroundColor(0xaaaaaa)
 +
 
 +
local g_tilesize = 256 -- 8
 +
local grid = Sprite.new()
 +
local steps = 16 -- 2
 +
for i = 1, g_tilesize + 1, steps do
 +
local line = Shape.new()
 +
if i == 1 or i == g_tilesize + 1 then -- outside borders
 +
line:setLineStyle(1, 0x0000ff, 1)
 +
else
 +
line:setLineStyle(1, 0x0000ff, 0.25)
 +
end
 +
line:beginPath()
 +
line:moveTo(i - 1.5, -0.5)
 +
line:lineTo(i - 1.5, g_tilesize - 0.5)
 +
line:endPath()
 +
grid:addChild(line)
 +
end
 +
for i = 1, g_tilesize + 1, steps do
 +
local line = Shape.new()
 +
if i == 1 or i == g_tilesize + 1 then -- outside borders
 +
line:setLineStyle(1, 0x0000ff, 1)
 +
else
 +
line:setLineStyle(1, 0x0000ff, 0.25)
 +
end
 +
line:beginPath()
 +
line:moveTo(-0.5, i-1.5)
 +
line:lineTo(g_tilesize - 0.5, i-1.5)
 +
line:endPath()
 +
grid:addChild(line)
 +
end
 +
 
 +
grid:setPosition(16, 16)
 +
stage:addChild(grid)
 +
</syntaxhighlight>
 +
 
 
{|-
 
{|-
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
−
=== <translate>Methods</translate> ===
+
=== Methods ===
−
[[Special:MyLanguage/Shape.new|Shape.new]] ''<translate>creates a new Shape object</translate>''<br/><!-- GIDEROSMTD:Shape.new -->
+
[[Shape.new]] ''creates a new Shape object''<br/><!--GIDEROSMTD:Shape.new() creates a new Shape object-->
−
[[Special:MyLanguage/Shape:beginPath|Shape:beginPath]] ''<translate>resets the current path</translate>''<br/><!-- GIDEROSMTD:Shape:beginPath -->
+
[[Shape:beginPath]] ''resets the current path''<br/><!--GIDEROSMTD:Shape:beginPath(winding) resets the current path-->
−
[[Special:MyLanguage/Shape:clear|Shape:clear]] ''<translate>clears the graphics that were drawn to this Shape object, and resets fill and line style settings</translate>''<br/><!-- GIDEROSMTD:Shape:clear -->
+
[[Shape:clear]] ''clears the graphics that were drawn to this Shape object''<br/><!--GIDEROSMTD:Shape:clear() clears the graphics that were drawn to this Shape object, and resets fill and line style settings-->
−
[[Special:MyLanguage/Shape:closePath|Shape:closePath]] ''<translate>marks the current subpath as closed, and starts a new subpath with a point the same as the start and end of the newly closed subpath</translate>''<br/><!-- GIDEROSMTD:Shape:closePath -->
+
[[Shape:closePath]] ''marks the current subpath as closed''<br/><!--GIDEROSMTD:Shape:closePath() marks the current subpath as closed, and starts a new subpath with a point the same as the start and end of the newly closed subpath-->
−
[[Special:MyLanguage/Shape:endPath|Shape:endPath]] ''<translate>ends the current path and draws the geometry by using the specified line and fill styles</translate>''<br/><!-- GIDEROSMTD:Shape:endPath -->
+
[[Shape:endPath]] ''ends the current path''<br/><!--GIDEROSMTD:Shape:endPath() ends the current path and draws the geometry by using the specified line and fill styles-->
−
[[Special:MyLanguage/Shape:lineTo|Shape:lineTo]] ''<translate>adds the given point to the current subpath, connected to the previous one by a straight line.</translate>''<br/><!-- GIDEROSMTD:Shape:lineTo -->
+
[[Shape:lineTo]] ''adds the given point to the current subpath, connected to the previous one by a straight line''<br/><!--GIDEROSMTD:Shape:lineTo(x,y) adds the given point to the current subpath, connected to the previous one by a straight line-->
−
[[Special:MyLanguage/Shape:moveTo|Shape:moveTo]] ''<translate>creates a new subpath with the given point</translate>''<br/><!-- GIDEROSMTD:Shape:moveTo -->
+
[[Shape:moveTo]] ''creates a new subpath with the given point''<br/><!--GIDEROSMTD:Shape:moveTo(x,y) creates a new subpath with the given point-->
−
[[Special:MyLanguage/Shape:setFillStyle|Shape:setFillStyle]] ''<translate>sets the fill style that Shape object uses for subsequent drawings</translate>''<br/><!-- GIDEROSMTD:Shape:setFillStyle -->
+
[[Shape:setFillStyle]] ''sets the fill style that Shape object uses for subsequent drawings''<br/><!--GIDEROSMTD:Shape:setFillStyle(type,...) sets the fill style that Shape object uses for subsequent drawings-->
−
[[Special:MyLanguage/Shape:setLineStyle|Shape:setLineStyle]] ''<translate>sets the line style that Shape object uses for subsequent drawings</translate>''<br/><!-- GIDEROSMTD:Shape:setLineStyle -->
+
[[Shape:setLineStyle]] ''sets the line style that Shape object uses for subsequent drawings''<br/><!--GIDEROSMTD:Shape:setLineStyle(width,color,alpha) sets the line style that Shape object uses for subsequent drawings-->
 +
 
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
−
=== <translate>Events</translate> ===
+
=== Events ===
−
=== <translate>Constants</translate> ===
+
=== Constants ===
−
[[Special:MyLanguage/Shape.EVEN_ODD|Shape.EVEN_ODD]]<br/><!-- GIDEROSCST:Shape.EVEN_ODD -->
+
[[Shape.EVEN_ODD]]<br/><!--GIDEROSCST:Shape.EVEN_ODD evenOdd-->
−
[[Special:MyLanguage/Shape.NONE|Shape.NONE]]<br/><!-- GIDEROSCST:Shape.NONE -->
+
[[Shape.NONE]]<br/><!--GIDEROSCST:Shape.NONE none-->
−
[[Special:MyLanguage/Shape.NON_ZERO|Shape.NON_ZERO]]<br/><!-- GIDEROSCST:Shape.NON_ZERO -->
+
[[Shape.NON_ZERO]]<br/><!--GIDEROSCST:Shape.NON_ZERO nonZero-->
−
[[Special:MyLanguage/Shape.SOLID|Shape.SOLID]]<br/><!-- GIDEROSCST:Shape.SOLID -->
+
[[Shape.SOLID]]<br/><!--GIDEROSCST:Shape.SOLID solid-->
−
[[Special:MyLanguage/Shape.TEXTURE|Shape.TEXTURE]]<br/><!-- GIDEROSCST:Shape.TEXTURE -->
+
[[Shape.TEXTURE]]<br/><!--GIDEROSCST:Shape.TEXTURE texture-->
 
|}
 
|}
 +
 +
{{GIDEROS IMPORTANT LINKS}}

Latest revision as of 02:15, 25 December 2024

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: Sprite

Description

The Shape class is used to create and display vector graphics.

Examples

Drawing a red square 

local shape = Shape.new()
shape:setFillStyle(Shape.SOLID, 0xff0000, 1)
shape:beginPath()
shape:moveTo(0,0)
shape:lineTo(100, 0)
shape:lineTo(100, 100)
shape:lineTo(0, 100)
shape:lineTo(0, 0)
shape:endPath()
shape:setPosition(0, 150)
stage:addChild(shape)

Drawing a grid 

application:setBackgroundColor(0xaaaaaa)

local g_tilesize = 256 -- 8
local grid = Sprite.new()
local steps = 16 -- 2
for i = 1, g_tilesize + 1, steps do
	local line = Shape.new()
	if i == 1 or i == g_tilesize + 1 then -- outside borders
		line:setLineStyle(1, 0x0000ff, 1)
	else
		line:setLineStyle(1, 0x0000ff, 0.25)
	end
	line:beginPath()
	line:moveTo(i - 1.5, -0.5)
	line:lineTo(i - 1.5, g_tilesize - 0.5)
	line:endPath()
	grid:addChild(line)
end
for i = 1, g_tilesize + 1, steps do
	local line = Shape.new()
	if i == 1 or i == g_tilesize + 1 then -- outside borders
		line:setLineStyle(1, 0x0000ff, 1)
	else
		line:setLineStyle(1, 0x0000ff, 0.25)
	end
	line:beginPath()
	line:moveTo(-0.5, i-1.5)
	line:lineTo(g_tilesize - 0.5, i-1.5)
	line:endPath()
	grid:addChild(line)
end

grid:setPosition(16, 16)
stage:addChild(grid)

Methods

Shape.new creates a new Shape object
Shape:beginPath resets the current path
Shape:clear clears the graphics that were drawn to this Shape object
Shape:closePath marks the current subpath as closed
Shape:endPath ends the current path
Shape:lineTo adds the given point to the current subpath, connected to the previous one by a straight line
Shape:moveTo creates a new subpath with the given point
Shape:setFillStyle sets the fill style that Shape object uses for subsequent drawings
Shape:setLineStyle sets the line style that Shape object uses for subsequent drawings

Events

Constants

Shape.EVEN_ODD
Shape.NONE
Shape.NON_ZERO
Shape.SOLID
Shape.TEXTURE


Retrieved from ‘https://wiki.gideros.rocks/index.php?title=Shape&oldid=24134’