Translations by akakyouryuu

Tiles `child` until it fills the area allocated to this displayable.

A displayable that creates an empty box on the screen. The size of the box is controlled by `width` and `height`. This can be used when a displayable requires a child, but no child is suitable, or as a spacer inside a box.

A displayable that fills the area its assigned with `color`.

Dynamic Displayables

Dynamic displayables display a child displayable based on the state of the game. They do not take any properties, as layout is controlled by the properties of the child displayable they return.

This is a displayable that changes what it is showing based on python conditions. The positional argument should be given in groups of two, where each group consists of:

A string containing a python condition.

A displayable to use if the condition is true.

The first true condition has its displayable shown, at least one condition should always be true.

A displayable that can change its child based on a Python function, over the course of an interaction.

`function`

A function that is called with the arguments:

The amount of time the displayable has been shown for.

The amount of time any displayable with the same tag has been shown for.

Any positional or keyword arguments supplied to DynamicDisplayable.

and should return a (d, redraw) tuple, where:

`d` is a displayable to show.

`redraw` is the amount of time to wait before calling the function again, or None to not call the function again before the start of the next interaction.

`function` is called at the start of every interaction.

As a special case, `function` may also be a python string that evaluates to a displayable. In that case, function is run once per interaction.

This is a displayable that changes what it is showing based on the images are showing on the screen. The positional argument should be given in groups of two, where each group consists of:

A string giving an image name, or None to indicate the default.

A default image should be specified.

One use of ShowingSwitch is to have side images change depending on the current emotion of a character. For example::

Applying Transforms to Displayables

The At function produces a displayable from a displayable and one or more :ref:`transforms <transforms>`.

Given a displayable `d`, applies each of the transforms in `args` to it. The transforms are applied in left-to-right order, so that the outermost transform is the rightmost argument. ::

Layout Boxes and Grids

Layout boxes are displayables that lay out their children on the screen. They can lay out the children in a horizontal or vertical manner, or can lay them out using the standard positioning algorithm.

The box displayables take any number of positional and keyword arguments. Positional arguments should be displayables that are added to the box as children. Keyword arguments are style properties that are applied to the box.

Boxes take :ref:`position-style-properties` and :ref:`box-style-properties`.

A box that fills the screen. Its members are laid out from back to front, with their position properties controlling their position.

A box that lays out its members from left to right.

A layout that lays out its members from top to bottom.

The Grid layout displays its children in a grid on the screen. It takes :ref:`position-style-properties` and the :propref:`spacing` style property.

Lays out displayables in a a grid. The first two positional arguments are the number of columns and rows in the grid. This must be followed by `columns * rows` positional arguments giving the displayables that fill the grid.