MiniScript Wiki - User contributions [en]

Color

2022-11-14T23:29:41Z

Chaos95: Add Farmtronics category

Color in [[Mini Micro]], [[Farmtronics]], and [[Soda]] is represented in RGB or RGBA hexadecimal format, similar to [https://htmlcolorcodes.com/ HTML color codes].

[[File:ColorString.png|frameless]]

The leading pound sign (<c>#</c>) is required, as are the six digits representing the amounts of red, green, and blue in the color. The last two digits, representing alpha, are optional. If not specified, they are assumed to be FF (fully opaque).

<c>color</c> is also the name of a standard module defined in <c>/sys/startup.ms</c>. The <c>color</c> module defines the following 20 named colors:

[[File:ColorTable.png|frameless|505px]]

In addition to the above named colors, the <c>color</c> module defines the following methods:

{| class="wikitable"
|-
! Method or Property !! Purpose
|-
| [[color.rgb]](''red'', ''green'', ''blue'')|| return a color string from red, green, and blue values in the range 0-255
|-
| [[color.rgba]](''red'', ''green'', ''blue'', ''alpha'') || return a color string from red, green, blue, and alpha values in the range 0-255
|-
| [[color.lerp]](''colorA'', ''colorB'', ''t'') || return a color interpolated between ''colorA'' and ''colorB'' by amount ''t'' (0-1)
|-
| [[color.toList]](''colorStr'') || convert a color into a list of the form <c>[red, green, blue, alpha]</c>
|-
| [[color.fromList]](''colorList'') || convert a list of the above form into a color string
|}

== Usage Notes ==

System functions that return a color from one of the displays include the alpha component, even if it was left implied when the color was drawn or assigned. You must take this into account when comparing colors, for example by adding "FF" to any 7-character color string to extend it to the full 9 characters before comparing.

[[Soda]] does not yet have a built-in <c>color</c> module. It does, however, represent colors in the same string format.

== Example ==

The following example changes the text color to bright green, using the named color <c>lime</c> in the <c>color</c> module.

<ms>text.color = color.lime
print "Assigned " + color.lime + ", and text.color is now " + text.color</ms>

Output:
Assigned #00FF00, and text.color is now #00FF00FF

Notice that the color string assigned was only 6 digits (7 characters total), but the color string we get back is a full 9 characters long. These two representations of "lime" color are equivalent.

[[Category:Mini Micro]]
[[Category:Soda]]
[[Category:Farmtronics]]

Color

2022-11-14T23:09:19Z

Chaos95: Fix a typo

Color in [[Mini Micro]] and [[Soda]] is represented in RGB or RGBA hexadecimal format, similar to [https://htmlcolorcodes.com/ HTML color codes].

[[File:ColorString.png|frameless]]

The leading pound sign (<c>#</c>) is required, as are the six digits representing the amounts of red, green, and blue in the color. The last two digits, representing alpha, are optional. If not specified, they are assumed to be FF (fully opaque).

<c>color</c> is also the name of a standard module defined in <c>/sys/startup.ms</c>. The <c>color</c> module defines the following 20 named colors:

[[File:ColorTable.png|frameless|505px]]

In addition to the above named colors, the <c>color</c> module defines the following methods:

{| class="wikitable"
|-
! Method or Property !! Purpose
|-
| [[color.rgb]](''red'', ''green'', ''blue'')|| return a color string from red, green, and blue values in the range 0-255
|-
| [[color.rgba]](''red'', ''green'', ''blue'', ''alpha'') || return a color string from red, green, blue, and alpha values in the range 0-255
|-
| [[color.lerp]](''colorA'', ''colorB'', ''t'') || return a color interpolated between ''colorA'' and ''colorB'' by amount ''t'' (0-1)
|-
| [[color.toList]](''colorStr'') || convert a color into a list of the form <c>[red, green, blue, alpha]</c>
|-
| [[color.fromList]](''colorList'') || convert a list of the above form into a color string
|}

== Usage Notes ==

System functions that return a color from one of the displays include the alpha component, even if it was left implied when the color was drawn or assigned. You must take this into account when comparing colors, for example by adding "FF" to any 7-character color string to extend it to the full 9 characters before comparing.

[[Soda]] does not yet have a built-in <c>color</c> module. It does, however, represent colors in the same string format.

== Example ==

The following example changes the text color to bright green, using the named color <c>lime</c> in the <c>color</c> module.

<ms>text.color = color.lime
print "Assigned " + color.lime + ", and text.color is now " + text.color</ms>

Output:
Assigned #00FF00, and text.color is now #00FF00FF

Notice that the color string assigned was only 6 digits (7 characters total), but the color string we get back is a full 9 characters long. These two representations of "lime" color are equivalent.

[[Category:Mini Micro]]
[[Category:Soda]]

TextDisplay.color

2022-11-14T22:55:28Z

Chaos95: Add inline link to Color

<c>[[TextDisplay]].color</c> gets or sets the foreground [[Color|color]] used on any future printing to this
text display. This is the text color for normal text, or the surrounding
color for inverse-mode text.

== Example ==

<ms>text.color = color.aqua</ms>

[[Category:Mini Micro]]