Negociación Horizontal: Se desarrolla en cada nivel de Dirección/

These positions can be used as the argument to the at clause of a scene or show statement.

Definition: left

A Position in which the left side of the image is aligned with the left side of the screen, with the bottom flush against the bottom of the screen.

Definition: right

A position in which the right side of the image is aligned with the right side of the screen, with the bottom of the image flush against the bottom of the

screen.

Definition: center

A position in which the image is centered horizontally, with the bottom of the image flush against the bottom of the screen.

Definition: offscreenleft

A position in which the image is placed just off the left side of the screen. Please note that an image placed in this position, while not visible to the user, still consumes resources, and so images should be hidden when not visible. This position is intended to be used with the move transition.

Definition: offscreenright

A position in which the image is placed just off the right side of the screen. Please note that an image placed in this position, while not visible to the user, still consumes resources, and so images should be hidden when not visible. This position is intended to be used with the move transition.

126

Transform

A Transform allows one to use a Python function to control many aspects of its child. While more complicated, Transform is powerful enough to

implement all of the position and motion functions. A Transform may be used as a displayable (by supplying a child) or a position and motion function (omit the child).

Function: Transform(child=None, function=None, **properties):

A transform applies rotation, zooming, and alpha-blending to its child, in that order. These operations, along with positioning of the transformed object, are controlled by fields on the Transform object. Transform objects can be

composed with minimal overhead.

Parameters. A transform takes these parameters:

child is the child of the Transform. This can be left None, in which case the Transform will act as a Position and Motion function.

function is a callback function that is called before the Transform is rendered, with the Transform object, the shown timebase, and the animation timebase. It can set any of the fields described below, to cause the Transform to alter how it is displayed. It is expected to return a floating-point number giving the amount of time before the Transform should be re-rendered, in seconds. If 0 is returned, the Transform will be re-rendered on the next frame.

Fields. The ATL transform properties are available as fields on a Transform object.

Additional fields are:

 hide_request - This is set to true when the Transform is hidden.

 hide_response - When hide_request is True, this can be set to False to prevent the Transform from being

immediately hidden.

Methods. A transform has the following method:

127

The update method should be called on a transform after one or more fields have been changed outside of the callback function of that Transform.

Method: set_child (d):

128

Transitions

By default, Ren'Py displays each scene by replacing the old scene with a new one. This is appropriate in general (such as for emotion changes), but it may be boring for large changes, such as a change in location or a character entering or leaving the scene. Ren'Py supports transitions that control how changes to the scene lists are exposed to the user.

Transitions occur between the last scene that was shown to the user, and the current scene that has been updated using the scene, show, or hide statements. A transition runs for a given amount of time, but may be dismissed early by the user. Once a transition is shown, the scene is considered shown for the purposes of future transitions.

Transitions are introduced with the `with` statement. The `with` statement takes an expression that is suitable for use with the `with` statement (that is, a callable that takes as input two scene lists), and runs that transition.

Alternatively, if the expression is `None`, then the `with` statement has the effect of showing the scene to the user, and returning instantly. This is useful in conjunction with a future `with` statement, so that only some changes to the scene list will be transitioned in.

An example is in order. First, let us define a few objects that can be passed in as the argument to a with statement:

init:

# Fades to black, then to the new scene. fade = Fade(0.5, 0, 0.5)

# Dissolves between old and new scenes. dissolve = Dissolve(0.5)

A simple use of with would be to place it after a series of show and hide statements of the program. As an example:

scene bg whitehouse show eileen happy with fade

This series of statements will cause the old scene (displayed before these statements started) to fade to black, and be replaced with the new scene all at once. This is a useful behavior, for example, when we are replacing a scene with a new one, such as when the story changes locations.

scene bg whitehouse with None

129

with dissolve

The `with None` statement is useful to break changes to the scene list into parts, as in the example above. When run, the background will be instantly shown, and then the character image will be dissolved in over the background. Another use of the `with None` statement is to remove transient elements before a transition begins. By default, the scene list includes transient elements like dialogue, thoughts, and menus. `with None` always executes without these elements, and so gets rid of them.

The `show`, `hide`, and `scene` statements all take a with clause. One of these statement with a with clause associated with it is actually converted into three statements: A `with None` statement, the original statement sans the with clause, and the with clause as a with statement. For example:

scene bg whitehouse with fade

show eileen happy at left with dissolve show lucy happy at right with dissolve becomes

with None

scene bg whitehouse with fade

with None

show eileen happy at left with dissolve

with None

show lucy happy at right with dissolve

This has the effect of fading out the old scene and fading in the new background, then dissolving in the characters one after the other. show albert at far_left

show bernardette at left show charles at center show derek at right

show eleanor at far_right with dissolve

Additionally, you can also show multiple images at once by ordering them consecutively and putting the 'with' statement at the end, followed by your transition.

We also allow with clauses to be supplied for say and menu statements. When a with clause is supplied on one of these statements, the transition is used to introduce the say or menu element. For example,

130

e "How are you doing?" with dissolve

Will dissolve in a line of dialogue. The line of dialogue will be dismissed immediately, unless it is followed by a with statement or clause that causes it to transition to something else.

There are two variables that control transitions:

Variable: default_transition = None

If not none, specifies a default transition that is applied to all say and menu statements that are not provided a with clause. This is only considered if the transitions preference is set to "All".

Variable: _window_during_transitions = False

If set to true, this will show an empty line of narration during transitions, provided you are in the outermost context, and there is nothing transient on the screen.

This only works for the default config.with_callback.

This variable may be changed outside of an init block, but a "with None" statement should be run after doing so for change to take effect.

This is more-or-less obsoleted by the window statement.