Inspired-Lua Wiki - User contributions [en]

gc:fillArc

2019-02-13T09:37:56Z

Zirconium: See Also my edit at gc:drawArc. The original article stated that the last argument was the ending angle, however, this is the angle over which the rountine turns, so 180 will always result in a semicircle)

__NOTOC__

gc:'''fillArc''' is a function that is part of [[:Category:gc|gc]] (Graphics Context).

Draws a color-filled arc in the rectangle with upper left corner (x,y) and pixel ''width'' and ''height''. The arc is drawn beginning at ''startAngle'' degrees and turns over ''turnAngle'' degrees. 
Zero degrees points to the right and 90 degrees points up (standard mathematical practice but worth mentioning since the y axis is inverted).

{{Since|3.0}}

== Syntax ==
gc:'''fillArc'''(x, y, width, height, start angle, turn angle)

{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <center>x</center> || number || The x-coordinate of the upper-left point
|-
| <center>y</center> || number || The x-coordinate of the upper-left point
|-
| <center>width</center> || number || Width of the rectangle containing the arc
|-
| <center>height</center> || number || Height of the rectangle containing the arc
|-
| <center>start angle</center> || number || The starting angle of the arc
|-
| <center>turning angle</center> || number || The angle over which the arc turns
|}

In this syntax ''turnAngle'' can be negative. This means the arc will be drawn clockwise, whereas a positive number results in an arc turning counterclockwise. (Standard mathematical practice as well.)

== Examples ==
<syntaxhighlight>gc:drawArc(10, 10, 20, 30, 0, 120)</syntaxhighlight>
The syntax above fills an arc from the right to the point turned 120 degrees.
 
<syntaxhighlight>gc:drawArc(50, 50, 25, 25, 90, 180)</syntaxhighlight>
The syntax above fills a semicircle from the top to the bottom, turning counterclockwise while doing so. Resulting in the semicircle being on the left side.
<syntaxhighlight>gc:drawArc(50, 50, 25, 25, 90, -180)</syntaxhighlight>
The syntax above fills a semicircle as well. Again from the top to the bottom. This time however, the routine will turn the arc clockwise, resulting in the semicircle being on the right side.

== Good to know ==
To draw a circle, the width and height must be equal length and the turning angle must be 360. If width and height are different lengths, this routine will draw an oval. It is standard procedure to set the starting angle at 0 degrees. However, this is not necessary.

Any number over 360 set for ''startAngle'' will roll back to be within the domain of [0,360].

Any number over 360 set for ''turnAngle'' will have no influence. All numbers higher than 360 will result in a circle.

== See Also ==
[[gc:drawArc]]

 

[[Category:gc]]

gc:drawArc

2019-02-13T09:36:13Z

Zirconium: Made sure this looks the same as gc:fillArc, which had some places with more enters. And added a See Also to gc:fillArc

__NOTOC__

gc:'''drawArc''' is a function that is part of [[:Category:gc|gc]] (Graphics Context).

Draws an arc in the rectangle with upper left corner (x,y) and pixel ''width'' and ''height''. The arc is drawn beginning at ''startAngle'' degrees and turns over ''turnAngle'' degrees. 
Zero degrees points to the right and 90 degrees points up (standard mathematical practice but worth mentioning since the y axis is inverted).

{{Since|3.0}}

== Syntax ==
gc:'''drawArc'''(x, y, width, height, start angle, turn angle)

{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <center>x</center> || number || The x-coordinate of the upper-left point
|-
| <center>y</center> || number || The x-coordinate of the upper-left point
|-
| <center>width</center> || number || Width of the rectangle containing the arc
|-
| <center>height</center> || number || Height of the rectangle containing the arc

|-
| <center>start angle</center> || number || The starting angle of the arc

|-
| <center>turning angle</center> || number || The angle over which the arc turns
|}

In this syntax ''turnAngle'' can be negative. This means the arc will be drawn clockwise, whereas a positive number results in an arc turning counterclockwise. (Standard mathematical practice as well.)

== Examples ==
<syntaxhighlight>gc:drawArc(10, 10, 20, 30, 0, 120)</syntaxhighlight>
The syntax above draws an arc from the right to the point turned 120 degrees.
 
<syntaxhighlight>gc:drawArc(50, 50, 25, 25, 90, 180)</syntaxhighlight>
The syntax above draws a semicircle from the top to the bottom, turning counterclockwise while doing so. Resulting in the semicircle being on the left side.
<syntaxhighlight>gc:drawArc(50, 50, 25, 25, 90, -180)</syntaxhighlight>
The syntax above draws a semicircle as well. Again from the top to the bottom. This time however, the routine will turn the arc clockwise, resulting in the semicircle being on the right side.

== Good to know ==

To draw a circle, the width and height must be equal length and the turning angle must be 360. If width and height are different lengths, this routine will draw an oval. It is standard procedure to set the starting angle at 0 degrees. However, this is not necessary.

Any number over 360 set for ''startAngle'' will roll back to be within the domain of [0,360].

Any number over 360 set for ''turnAngle'' will have no influence. All numbers higher than 360 will result in a circle.

== See Also ==
[[gc:fillArc]]

 

[[Category:gc]]

gc:drawArc

2019-02-13T09:30:01Z

Zirconium: After my testing, it seems as though it isn't finish angle, but the turning angle the arc makes. Maybe it has changed actually, I wouldn't know that.

cursor.show

2018-11-26T13:19:58Z

Zirconium: added "operator" after handheld

cursor.'''show'''() is a function that is part of the [[:Category:cursor|cursor functions]].

It shows the cursor (mouse pointer) on the screen. 
It is mostly used after a [[cursor.hide]]. 

This function will be ignored if not executed on a handheld operator. 

{{Since|3.0}}

== Syntax ==
cursor.'''show'''() 
No arguments.

== Example ==
<syntaxhighlight>if (isPlaying) then
cursor.hide()
else
cursor.show()
end</syntaxhighlight>

== See also ==
*[[cursor.hide]]

 

[[Category:cursor]]

cursor.hide

2018-11-26T13:19:09Z

Zirconium: As I found out by myself, and as (https://education.ti.com/html/webhelp/EG_TINspireLUA/EN/content/libraries/cursorlib/show.htm) states, cursor.hide and cursor.show only work on handhelds

cursor.'''hide'''() is a function that is part of the [[:Category:cursor|cursor functions]].

It hides the cursor (mouse pointer) on the screen. 
NB : Even with TouchPad devices, the user can't have it shown again, until [[cursor.show]]() is called. 

This function will be ignored if not executed on a handheld operator. 

{{Since|3.0}}

== Syntax ==
cursor.'''hide'''() 
No arguments.

== Example ==

<syntaxhighlight>if (isPlaying) then
cursor.hide()
else
cursor.show()
end</syntaxhighlight>

== See also ==
*[[cursor.show]]

 

[[Category:cursor]]

cursor.show

2018-11-26T13:08:50Z

Zirconium: As I found out by myself, and as (https://education.ti.com/html/webhelp/EG_TINspireLUA/EN/content/libraries/cursorlib/show.htm) states, cursor.hide and cursor.show only work on handhelds

cursor.'''show'''() is a function that is part of the [[:Category:cursor|cursor functions]].

It shows the cursor (mouse pointer) on the screen. 
It is mostly used after a [[cursor.hide]]. 

This function will be ignored if not executed on a handheld. 

{{Since|3.0}}

== Syntax ==
cursor.'''show'''() 
No arguments.

== Example ==
<syntaxhighlight>if (isPlaying) then
cursor.hide()
else
cursor.show()
end</syntaxhighlight>

== See also ==
*[[cursor.hide]]

 

[[Category:cursor]]

platform.window:setBackgroundColor

2018-08-20T13:59:42Z

Zirconium: apparently I had '==' instead if '=' in the example…

'''platform.window:setBackgroundColor''' is a function that is part of [[:Category:platform.window|platform.window]].

{{Since|3.9}}
Sets the background color of the script's window.

== Syntax ==
'''platform.window:setBackgroundColor'''(color) 

{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <center>color</center> || number || A number representing the color of the background. Must be an integer between 0 and 16777216
|-
|}
NB: You can also use hexadecimal numbers instead of decimal ones for each of the arguments (from 0x000000 to 0xFFFFFF). The first two digits here represent the red, the third and fourth the green and the last two blue

== Example ==
Below is an example that sets the background color of the window to HTML silver.

<source lang="lua">
platform.apilevel = '2.4'
platform.window:setBackgroundColor(12632256) --0xC0C0C0 (HTML silver)
</source>

[[Category:platform.window]]

platform.window:setBackgroundColor

2018-08-20T13:55:32Z

Zirconium: Added page for platform.window:setBackgroundColor, and placed it in the platform.window category

'''platform.window:setBackgroundColor''' is a function that is part of [[:Category:platform.window|platform.window]].

{{Since|3.9}}
Sets the background color of the script's window.

== Syntax ==
'''platform.window:setBackgroundColor'''(color) 

{| class="wikitable"
|-
! Parameter !! Type !! Description
|-
| <center>color</center> || number || A number representing the color of the background. Must be an integer between 0 and 16777216
|-
|}
NB: You can also use hexadecimal numbers instead of decimal ones for each of the arguments (from 0x000000 to 0xFFFFFF). The first two digits here represent the red, the third and fourth the green and the last two blue

== Example ==
Below is an example that sets the background color of the window to HTML silver.

<source lang="lua">
platform.apilevel == '2.4'
platform.window:setBackgroundColor(12632256) --0xC0C0C0 (HTML silver)
</source>

[[Category:platform.window]]

Category:platform.window

2018-08-20T11:12:20Z

Zirconium: Added a link to a new page that was linked elsewhere already. Page has yet to be created

Returns the window object currently owned by the script application. The window consists of the portion of the page allotted to the script app. 
Several applications can be visible when the page is arranged in a split layout. 
Each visible application has its own window.

== Quick Overview ==

*[[platform.window:height|height]] : Returns the height in pixel of the current display window.
*[[platform.window:invalidate|invalidate]] : Sets a flag to invalidate [a region of] the window by firing the [[on.paint]] event.
*[[platform.window:width|width]] : Returns the width in pixel of the current display window.
*[[platform.window:setFocus|setFocus]]''(true or false)'' : Focus/Unfocus the script's window.
*[[platform.window:setBackgroundColor|setBackgroundColor]]''(color)'' : Sets the background color of the script's window. ''Available only when used with apilevel '2.4' or above''

[[Category:platform]]

User:Zirconium

2018-08-20T10:25:58Z

Zirconium: language correction

Hi, I'm a student at a high school in the Netherlands.

I really like programming, but not in an ordinary way. Programming on the TI-Nspire definitely is not a usual way of programming.
I have partially learned to code myself and partially used sites to learn it.
Also, I want to contribute to keeping this wiki up to date.