Ren'Py のスクリプトを Python で記述できるようにするため、それぞれの Ren'Py のステートメントには Python のコードとの等価性があります。これは通常 Python の関数で構成されていますが、ステートメントと等価に動作する複数のコードで構成されることもあります。
Ren'Py の say ステートメントはキャラクターオブジェクトを関数として呼び出すことと等価です。次は、同じ行を2回表示させるコードです
e "Hello, world."
$ e("Hello, world.")
台詞の表示は narrator キャラクターを用いて同様に行えます。キャラクターを呼び出すときは、キーワード引数 interact を与えられます。interact が False なら、 Ren'Py はキャラクターのダイアログボックスを表示しますが、インタラクションを実行する前に処理を戻します。
キャラクターと関数オブジェクトの等価性はその他の面でも同様に働きます。 python 関数を宣言して、キャラクターオブジェクトの代わりに使用できます。例えば、以下の関数は二人のキャラクターを選択するために変数を使用しています。
define lucy_normal = Character("Lucy")
define lucy_evil = Character("Evil Lucy")
init python:
def l(what, **kwargs):
if lucy_is_evil:
lucy_evil(what, **kwargs)
else:
lucy_normal(what, **kwargs)
label start:
$ lucy_is_evil = False
l "Usually, I feel quite normal."
$ lucy_is_evil = True
l "But sometimes, I get really mad!"
このように使用された関数は未知のキーワード引数を無視するか、 キャラクター関数に渡します。これによりでゲームは Ren'Py が追加のキーワード引数をキャラクター呼び出しに加えても動作し続けます。
renpy.say(who, what, *args, **kwargs) linksay ステートメントと等価です。
発言するキャラクターか、キャラクター名の文字列です。 None ならナレーターが使用されます。文字列なら say() を使用して発言するキャラクターが作成されます。
発言する文字列です。 % 置換文字列はこの文字列で使用されます。
True なら Ren'Py は台詞表示時にプレイヤーの入力を待ちます。 False なら Ren'Py は台詞を表示しますが、インタラクションを実行しません(これはキーワード引数として渡されます)。
次の3行が等価なためこの関数は滅多に必要ありません。 :
e "Hello, world."
$ renpy.say(e, "Hello, world.")
$ e("Hello, world.")
image, scene, show, hide ステートメントはそれぞれ等価な python 関数を持ちます。
renpy.get_at_list(name, layer=None, camera=False) linklayer 上の name タグの画像に適用されている transform のリストを返します。 transform が適用されていなければ空のリストを返し、画像が表示されていなければ None 返します。
layer が None なら、指定されたタグのデフォルトレイヤーを使用します。
renpy.hide(name, layer=None) linkレイヤーから画像を非表示します。 hide ステートメントと等価な python です。
非表示する画像の名前です。画像タグのみが使用され、そのタグのすべての画像が非表示されます(正確な画像名は必要ありません)。
この関数が処理するレイヤーです。None ならタグのデフォルトレイヤーを使用します。
renpy.image(name, d) link画像を定義する。この関数は image ステートメントと等価な python です。
表示する画像の名前で、文字列です。
その画像名に関連付けられる displayable
この関数は init ブロック内でのみ実行されます。一旦ゲームが実行されてからこの関数が実行されると、エラーになります。
renpy.scene(layer=u'master') linklayer からすべての displayable を除去します。これは表示する画像が与えられない時の scene ステートメントと等価です。
scene ステートメントは renpy.scene に続いて renpy.show() を呼び出すことと等価です。例えば
scene bg beach
これは次と等価です:
$ renpy.scene()
$ renpy.show("bg beach")
renpy.show(name, at_list=[], layer='master', what=None, zorder=0, tag=None, behind=[]) linkレイヤーに画像を表示します。これは show ステートメントとプログラム的に等価です。
表示する画像の名前で、文字列です。
画像に適用される transform のリストです。 at プロパティーと等価です。
画像が表示されるレイヤーの名前の文字列です。 onlayer と等価です。None ならそのタグに関連付けられたデフォルトレイヤーを使用します。
None でないならこれは画像を 探す代わりに表示される displayable です ( これは show expression ステートメントと等価です )。 what 引数が与えられると、 name はその画像とタグを関連づけるために使用されます。
zorder プロパティーと等価な整数です。 None だと zorder があれば維持され、そうでなければ 0 に設定されます。
表示される画像の画像タグを指定するために使用される文字列です。 as プロパティーと等価です。
この画像が背後に表示される画像タグの文字列のリストです。 behind プロパティーと等価です。
renpy.show_layer_at(at_list, layer=u'master', reset=True, camera=False) linkshow layer layer at at_list ステートメントおよび camera が True なら、 camera ステートメントのの Python による等価な書き方です。
True なら、 transform の状態は表示時までリセットされ、 False なら永続的になり、次のtransform が状態を更新できるようにします。
with ステートメントと等価な renpy.with_statement() 関数です。
renpy.with_statement(trans, always=False) linkトランジションを実行します。これは with ステートメントと等価な python です。
トランジション
True なら、トランジションはユーザーがトランジションを無効化していても常に実行します。
この関数はユーザーがトランジションの中断を選択するなら True を、そうでないなら False を返します。
jump ステートメントは renpy.jump() 関数と等価です。
renpy.jump(label) link現在のステートメントを終了し、制御を指定されたラベルに移します。
call ステートメントと等価なものは renpy.call() 関数です。
renpy.call(label, *args, **kwargs) link現在の Ren'Py ステートメントを終了し、指定された label にジャンプします。ジャンプから戻ると、現在のステートメントに続くステートメントに制御が移ります。
True なら、制御は現在のステートメントに続くステートメントではなく現在のステートメントに返ります(これにより現在のステートメントは二回実行されます。これはキーワード引数として渡されるべきです)。
renpy.return_statement(value=None) link現在の Ren'Py の呼び出しレベルから Ren'Py を返します。