Display.install - Revision history

JoeStrout: /* Usage Notes */

2023-02-07T01:09:59Z

Usage Notes

JoeStrout: /* Known Issues */

2023-02-07T01:07:05Z

Known Issues

JoeStrout at 21:32, 26 October 2022

2022-10-26T21:32:22Z

JoeStrout: /* Known Issues */

2022-08-14T17:43:53Z

Known Issues

JoeStrout at 17:40, 14 August 2022

2022-08-14T17:40:08Z

JoeStrout: Created page with "Display.install installs a Display into one of the eight display layers in the Mini Micro virtual machine, replacing (and detaching) the previous display in..."

2021-07-11T03:45:24Z

Created page with "<c>Display.install</c> installs a Display into one of the eight display layers in the Mini Micro virtual machine, replacing (and detaching) the previous display in..."

New page

<c>[[Display]].install</c> installs a [[Display]] into one of the eight display layers in the [[Mini Micro]] virtual machine, replacing (and detaching) the previous display in that layer.

=== Arguments ===

{| class="wikitable"
|-
! Parameter Name !! Type !! Default Value !! Meaning
|-
| ''index'' || number || 0 || display layer to install into, from 0 (frontmost) to 7 (back)
|}

=== Usage Notes ===
Any [[Display]] object is either installed in one of the 8 display layers, or it is detached (off-screen). A display created with <c>[[new]]</c> is initially detached. It may be configured, drawn into, and otherwise used, but will be completely invisible to the user until it is installed by calling this method.

This may be used for ''page flipping'': preparing a number of uninstalled (off-screen) displays ahead of time, and then installing them on the screen one at a time to produce animation. Installation of a display is very fast, so even if the preparation (drawing) takes a while, you can produce very smooth, flicker-free animation this way. (See example below.)

=== Example ===

This example demonstrates the page flipping technique by preparing 20 off-screen [[PixelDisplay|PixelDisplays]], each with a different drawing of a clock hand. The displays are then installed successively into layer 5, creating an animated clock. (Note that for such simple drawing, page flipping is not necessary; but it makes a good example.)

<ms>clear
pages = []
for i in range(0,19)
p = new PixelDisplay // create a detached PixelDisplay
p.clear color.black
ang = 2*pi/20 * i
p.line 480,320, 480+300*cos(ang), 320+300*sin(ang), color.yellow, 20
pages.push p
end for

curPage = 0
while true
pages[curPage].install 5 // install next PixelDisplay in layer 5
wait 1
curPage = (curPage+1) % 20
end while</ms>

[[Category:Mini Micro]]

← Older revision		Revision as of 01:09, 7 February 2023
Line 14:		Line 14:

	This may be used for ''page flipping'': preparing a number of uninstalled (off-screen) displays ahead of time, and then installing them on the screen one at a time to produce animation. Installation of a display is very fast, so even if the preparation (drawing) takes a while, you can produce very smooth, flicker-free animation this way. (See example below.)		This may be used for ''page flipping'': preparing a number of uninstalled (off-screen) displays ahead of time, and then installing them on the screen one at a time to produce animation. Installation of a display is very fast, so even if the preparation (drawing) takes a while, you can produce very smooth, flicker-free animation this way. (See example below.)
		+
		+	Note that when a display is freshly installed into a layer, the layer is automatically switched to that mode. However, if the display is already in the layer where you are trying to install it, then the call has no effect — it does not automatically switch to that mode. If you want to be sure a display is both installed and visible, you can always do something like:
		+
		+	<ms>myDisp.install layerIndex // (where layerIndex is the layer we want it to be in)
		+	display(layerIndex).mode = myDisp.mode</ms>

	=== Known Issues ===		=== Known Issues ===

@@ Line 17: / Line 17: @@
 === Known Issues ===
 Installing a [[PixelDisplay]] resets its [[PixelDisplay.color|color]] to white.  (Do not depend on this behavior; it may change in a future release.)
 === Example ===

@@ Line 17: / Line 17: @@
 === Known Issues ===
 Installing a [[PixelDisplay]] resets its [[PixelDisplay.color|color]] to white.  (Do not depend on this behavior; it may change in a future release.)
 === Example ===

@@ Line 16: / Line 16: @@
 === Known Issues ===
-Installing a [[PixelDisplay]] resets its [[PixelDisplay.color|color]] to white.
+Installing a [[PixelDisplay]] resets its [[PixelDisplay.color|color]] to white.  (Do not depend on this behavior; it may change in a future release.)
 === Example ===

← Older revision		Revision as of 17:40, 14 August 2022
Line 14:		Line 14:

	This may be used for ''page flipping'': preparing a number of uninstalled (off-screen) displays ahead of time, and then installing them on the screen one at a time to produce animation. Installation of a display is very fast, so even if the preparation (drawing) takes a while, you can produce very smooth, flicker-free animation this way. (See example below.)		This may be used for ''page flipping'': preparing a number of uninstalled (off-screen) displays ahead of time, and then installing them on the screen one at a time to produce animation. Installation of a display is very fast, so even if the preparation (drawing) takes a while, you can produce very smooth, flicker-free animation this way. (See example below.)
		+
		+	=== Known Issues ===
		+	Installing a [[PixelDisplay]] resets its [[PixelDisplay.color\|color]] to white.

	=== Example ===		=== Example ===