How displays work in Mini Micro

I've written here , , and

Layer 0 is in the front, and you can see that the first three display layers are off by default (as is layer 6). Then we have a text layer, a sprite layer, a graphics layer, and finally a solid color layer in the back.

In my

Easy enough, until you start thinking about it too deeply. Then it begins to seem mysterious. display(4) returns a Display object — by default, specifically a SpriteDisplay object. Then we assign a different value to the mode property. And now suddenly it's an entirely different kind of object (PixelDisplay in this example)? How can that be?

The magic trick revealed

Built-in classes like Display can do a special trick that ordinary MiniScript code can't do: they can intercept assignments to certain properties. You'll see this in some other places in the Mini Micro API, where you simply aren't allowed to alter certain maps. Image is an example of this; if you try to change (say) the width of an image, you simply get an error.

But where does it come from?

You might wonder where the display manager gets a display of the requested type. Well, at bootup, it actually prepares a display of each type for every slot. So in any given slot, there are solid-color, pixel, text, tile, and sprite displays just waiting to be used. The display manager keeps references to these five displays per slot, 40 displays total, ready for your use! When you change the mode at a given display index, the display manager just swaps in the prepared display it already has on hand.

If you manually , then the newly installed display replaces the previous display of that type in its list of 5 ready displays for that slot. Your display becomes the one "on hand" for the display manager to use again if the user simply changes the mode on that display index. The previous one of that type gets detached — and like any MiniScript object, if there are no more references to it, then it is destroyed.

Now you know!

To recap:

• Behind the scenes, a display manager keeps a display of each type on hand for each of the 8 display layers.


• When you assign to the .mode of a display, that assignment is intercepted and sent as a request to the display manager.


• The display manager swaps in the display of the appropriate type, keeping one previously there in reserve for future use.


• If you install a display yourself, it replaces the one the display manager uses for that slot and type.

So now you know what's happening! Beginners generally don't need to understand how things work in this much detail; it's fine to just remember "assign the mode you want, then get a reference to the display." But now that you know what that actually does, you can have a deeper understanding of what's going on.