Difference between revisions of "Display"
(Created page with "In Mini Micro, <c>Display</c> is the base class for all the display types, and the class of any display that is off (mode 0). In addition, <c>display</c> (all lowercase)...") |
(added link to new Display.install method) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
= Architecture of the display system = | = Architecture of the display system = | ||
| + | |||
| + | [[File:DisplayLayout.png|frameless|right]] | ||
Mini Micro supports eight simultaneous displays, numbered from 0 (frontmost) to 7 (in the back). Each display may be either off, or one of five more specific display types (solid color, text, pixels, tiles, or sprites). Any transparent or translucent areas of one display reveal the displays behind it. Behind all the display layers is solid black. | Mini Micro supports eight simultaneous displays, numbered from 0 (frontmost) to 7 (in the back). Each display may be either off, or one of five more specific display types (solid color, text, pixels, tiles, or sprites). Any transparent or translucent areas of one display reveal the displays behind it. Behind all the display layers is solid black. | ||
| Line 12: | Line 14: | ||
|- | |- | ||
| [[Display.mode]] || get or set the [[displayMode|display mode]] | | [[Display.mode]] || get or set the [[displayMode|display mode]] | ||
| + | |- | ||
| + | | [[Display.install]] ''index'' || install a display into the display layer with the given index | ||
|} | |} | ||
| Line 34: | Line 38: | ||
|} | |} | ||
| − | == | + | == Examples == |
| − | This example sets display layer 2 to pixel mode, clears it, and then draws a big translucent purple ellipse. | + | This first example sets display layer 2 to pixel mode, clears it, and then draws a big translucent purple ellipse. |
<ms>display(2).mode = displayMode.pixel | <ms>display(2).mode = displayMode.pixel | ||
g = display(2) | g = display(2) | ||
g.clear | g.clear | ||
g.fillEllipse 0, 0, 960, 640, "#8800FF88"</ms> | g.fillEllipse 0, 0, 960, 640, "#8800FF88"</ms> | ||
| + | |||
| + | |||
| + | The following longer example fills display 1 with a solid color, except for a clear circle that follows the mouse. The effect is like a flashlight or scope peering at the content of the screen (including the standard [[text]] layer) through a thick fog. | ||
| + | <ms>// set up a "fog" (overlay) layer to obscure most of the screen | ||
| + | display(1).mode = displayMode.pixel | ||
| + | fog = display(1) | ||
| + | fog.color = color.gray | ||
| + | fog.clear fog.color | ||
| + | |||
| + | // define the radius of our flashlight spot | ||
| + | r = 80 | ||
| + | |||
| + | // always keep track of the last position of the spot | ||
| + | spot = {"x":0, "y":0} | ||
| + | |||
| + | // main loop | ||
| + | while true | ||
| + | yield | ||
| + | |||
| + | // fill in the old spot | ||
| + | // (we'll actually fill a rectangle since that's faster) | ||
| + | fog.fillRect spot.x - r, spot.y - r, r*2, r*2 | ||
| + | |||
| + | // then clear the new spot (as an actual circle) | ||
| + | spot.x = mouse.x | ||
| + | spot.y = mouse.y | ||
| + | fog.fillEllipse spot.x - r, spot.y - r, r*2, r*2, color.clear | ||
| + | end while</ms> | ||
| + | |||
See also: [[displayMode]] | See also: [[displayMode]] | ||
[[Category:Mini Micro]] | [[Category:Mini Micro]] | ||
Latest revision as of 20:40, 17 May 2021
In Mini Micro, Display is the base class for all the display types, and the class of any display that is off (mode 0). In addition, display (all lowercase) is a function that returns one of the eight displays in Mini Micro's display system.
Contents
Architecture of the display system
Mini Micro supports eight simultaneous displays, numbered from 0 (frontmost) to 7 (in the back). Each display may be either off, or one of five more specific display types (solid color, text, pixels, tiles, or sprites). Any transparent or translucent areas of one display reveal the displays behind it. Behind all the display layers is solid black.
Display class
| Property | Purpose |
|---|---|
| Display.mode | get or set the display mode |
| Display.install index | install a display into the display layer with the given index |
Subclasses
display function
The global display function returns a reference to the current display for the given layer number (0-7). Note that the display object in each layer changes when the mode is changed, so you will need to get a fresh reference (using this function) after changing the mode.
Arguments
| Parameter Name | Type | Default Value | Meaning |
|---|---|---|---|
| n | number | 0 | display (layer) number to get |
Examples
This first example sets display layer 2 to pixel mode, clears it, and then draws a big translucent purple ellipse.
display(2).mode = displayMode.pixel
g = display(2)
g.clear
g.fillEllipse 0, 0, 960, 640, "#8800FF88"
The following longer example fills display 1 with a solid color, except for a clear circle that follows the mouse. The effect is like a flashlight or scope peering at the content of the screen (including the standard text layer) through a thick fog.
// set up a "fog" (overlay) layer to obscure most of the screen
display(1).mode = displayMode.pixel
fog = display(1)
fog.color = color.gray
fog.clear fog.color
// define the radius of our flashlight spot
r = 80
// always keep track of the last position of the spot
spot = {"x":0, "y":0}
// main loop
while true
yield
// fill in the old spot
// (we'll actually fill a rectangle since that's faster)
fog.fillRect spot.x - r, spot.y - r, r*2, r*2
// then clear the new spot (as an actual circle)
spot.x = mouse.x
spot.y = mouse.y
fog.fillEllipse spot.x - r, spot.y - r, r*2, r*2, color.clear
end while
See also: displayMode
