Ren'Py のゲームを見ると、ゲームを画像とユーザーインターフェイスの2つの部分に分割できることに気づくでしょう。画像は scene、show、hide ステートメントを使ってユーザーに表示し、一般には進行中のストーリーの一部となっています。それ以外の部分はユーザーインターフェイスの一部で、スクリーンを使ってカスタマイズします。
スクリーンは4つの方法で表示することができます:
スクリプトのステートメントが実行されるとき、暗黙的に表示する。例えば、say ステートメントが事項されると、 say スクリーンが表示されます。
自動的に表示する。例えば、Ren'Py はゲーム開始時や、ユーザーがメインメニューに戻るとき、 main_menu スクリーンを表示します。
ボタン、マウスのボタン、キーボードのキーによるアクションで表示する。デフォルトでは、ユーザーが右クリックするか、エスケープキーが押された時に save スクリーンが表示されます。他にも、スクリーン上にボタンを定義して save スクリーンを表示することも可能です。
明示的に、ステートメントを使ってスクリーンを表示する。
一度に複数のスクリーンを表示できます。
スクリーンには主に2つの機能があります。1つはユーザーに情報を示すことです。情報はテキスト、バー、画像を使って示すことができます。ゲームのプレイにおいて、情報のいくつかをこのような決まりのもとで表示することは重要です。 say スクリーンで例を挙げると、これはキャラクター名と彼女が話している内容を含んだダイアローグをユーザーに表示するために使用されます。
他に、スクリーンはユーザーからの入力を受け付けてゲームに反映することができます。ボタンやバーを使うとアクションを起こしたり値を調整したりできます。Ren'Py には事前に定義されているアクションのプールがあり、ゲームを進められるようにしたり、設定を調整したり、ゲームをロード・セーブしたり、その他多数のアクションを発生させたりできます。ゲーム製作者も新しいアクションを Python で書くことができます。
スクリーンは、ゲームがインタラクションを開始した時、及びインタラクションが再開される度に更新されます。
スクリーンのコードはスクリーン外への副作用を起こしてはいけません。 Ren'Py はスクリーンが最初に表示される前に画像予測処理の一部として必要なら何度もスクリーンのコードを実行します。結果としてスクリーンのコードが副作用を持つなら、それが何回実行されるかはわかりません。
スクリーンはそれに関連付けられたスコープを持ち、変数に値を与えます。スクリーンから変数にアクセスされると最初にそのスコープ内を参照し、次にグローバルスコープを参照します。
スクリーン言語はほとんどが表示するスクリーンを宣言することに使用され、新しい displayable の宣言、スクリーンへの displayable の追加、ステートメントを制御するステートメントで構成されます。
ここにスクリーンの例があります。
screen say(who, what):
window id "window":
vbox:
spacing 10
text who id "who"
text what id "what"
この最初の行は screen ステートメントで、スクリーンを宣言するために使用される Ren'Py ステートメントです。スクリーンの名前は say なので、これは台詞を表示するために使用されるスクリーンです。 2 つの引数 who, what を取ります。
このスクリーンには「 window 」の id を持つウィンドウがあります。このウィンドウは縦長の箱を持ち、その中に 10 ピクセルの空白を含みます。さらにその箱には二つのテキスト用の領域があり、一つは話し手の名前、もう一つは話している内容です。
ほとんどのスクリーン言語は共通の構文を持ちます。 ( 制御用ステートメントのいくつかは違う構文を持ちますが ) ステートメントはステートメントを導入するキーワードで行の最初から始まります。
ステートメントがパラメーターを取るなら、キーワードの直後に続きます。パラメーターはスペースで区切られた単純式で、そうでないなら記載します。
位置パラメーターの後にはプロパティーリストが続きます。プロパティーはプロパティーの名前とそれに続くそのプロパティーの値で構成されます。プロパティーの値は特に記載がなければ単純式です。プロパティーリストはスペースで区切られた一連のプロパティーです。
ステートメントがコロン (:) で終るとその後にブロックが続きます。ブロックの各行は以下の二つのどちらかです。
プロパティーリスト
スクリーン言語のステートメント
The screen statement is a Ren'Py script language statement that is used to declare a new screen. It is parsed using the screen language common syntax.
一つのパラメーターを取り、それはスクリーンの名前です。これは名前であって、式ではありません。以下のプロパティーも取ります。 :
True ならそのスクリーンはモーダルです。モーダルなスクリーンはデフォルトのキーマップを除いて、ユーザーがその下にある displayable に作用できないようにします。
式ではなく名前として解釈されます。これはこのスクリーンと関連づけられるタグを指定します。スクリーンの表示は同じタグの他のスクリーンを置き換えます。これは一つのコンテキストには同時に一つだけメニューのスクリーンが表示されることを保証するために使用されます。
これはスクリーンがどれぐらいユーザーに近いかを制御します。数字が大きいほどスクリーンはユーザーの近くに表示されます。デフォルトでは 0 です。
与えられるならこれは定義されるスクリーンバージョン名の文字列または文字列のリストです。 スクリーンバージョン を参照してください。
screen hello_world():
tag example
zorder 1
modal False
text "Hello, World."
スクリーンは引数もとれます。
screen center_text(s, size=42):
text s size size
ユーザーインターフェイスステートメントは displayable を作成し、それをスクリーンか、これを含めるdisplayable に追加します。ユーザーに情報を表示し、ゲームに作用したり、ゲームが様々なイベントに反応できるようにします。
すべてのユーザーインターフェイスステートメントは以下の共通のプロパティーを取ります。 :
変換または変換のリストで、この displayable に適用されます。もしこれが与えられ、直接スクリーンに加えられていたら show,hide,replace やその他のイベントが変換に送られます。
例えば vbox に変換が適用されて、直接スクリーンに追加されているとイベントはその変換に送られます。しかしある変換が vbox に追加されているテキストボタンに適用されていると、この第二の変換にはイベントが送られません。
True を与えると displayable はデフォルトでフォーカスを持つようになります。一つの displayable のみがこれを持つべきです。
ユーザーインターフェイスステートメント用の識別記号です。スクリーンが表示されると適切な値が与えられた id を持つ displayable に提供されます。いくつかのスクリーンは与えられた id を持つ displayable の作成を必要とします。
デフォルトでは id は自動的に生成されます。
この displayable に適用されるスタイルの名前です。これは名前の文字列か、 style オブジェクトです。そのスタイルはスタイルプロパティーにデフォルトの値を与えます。
この displayable と、その子がより限定的なスタイルやスタイル接頭辞を持っていなければ、そのすべての子のスタイルに接頭辞を与えます
スタイル名はスタイル接頭辞とアンダースコア、スタイル接尾辞を繋げて作られる。スタイル接尾辞は style_suffix を使用して指定するか、displayableに決定されます。
例えば vbox がスタイル接頭辞「 pref 」を持っていると、 vbox にはスタイル「 pref_vbox 」が与えられます。より限定的なスタイルやスタイル接頭辞が与えられていなければ、その vbox 内のボタンはスタイル「 pref_button 」を持ちます。
このようにアクセスされるスタイルは、もしなければ作成されます。接頭辞を None に設定するとこの displayable とその子から接頭辞が取り除かれます。
style_prefix と結合してスタイル名になる接尾辞を指定します。これが "small_button" でスタイル接頭辞が "pref" なら、スタイルは "pref_small_button" が使用されます。
スタイル接頭辞がなければ、これはスタイル名が直接使用されます。スタイル接尾辞は単独の displayable のみに適用され、 displayable の子には適用されません。
文字列か整数を受け取って displayable にフォーカス用の名前を与えます。Ren'Py はインタラクションの開始時にフォーカスを与える displayable を決定するとき、フォーカスの名前の間に構造的な類似点を探します。例えばある box にフォーカス名が与えられて、その box の三つ目のボタンがインタラクションの最後にフォーカスを所得すると、同じフォーカス名を持つ box の三つ目のボタンが次のインタラクションの開始時にハイライトされるます。
tooltip をこの dispalyable に代入します。displayable がフォーカスを得ると、このプロパティーの値は GetTooltip() 関数から利用可能になります。詳細は Tooltip を参照してください。
Many user interface statements take classes of style properties, or transform properties. These properties can have a style prefix associated with them, that determines when they apply. For example, if text is given the hover_size property, it sets the text size when the text is hovered.
Adds an image or other displayable to the screen. This optionally takes transform properties. If at least one transform property is given, a Transform is created to wrap the image, and the properties are given to the transform.
displayable が None ならスクリーンには何も追加されません。
これは子を取りません。
screen add_test():
add "logo.png" xalign 1.0 yalign 0.0
データを閲覧したり調整するための水平方向のバーを作成します。以下のプロパティーを取ります。
バーの現在の値。これは bar value オブジェクトか数字です。
バーの最大値です。これは value が数字なら必要です。
このバーを調整する ui.adjustment() オブジェクトです。
バーがフォーカスを所得したときのアクションです。
バーがフォーカスを失うときのアクションです。
value か adjustment のどちらかは与えられなければなりません。さらにこの関数は以下を取ります。 :
これは子は取りません。
screen volume_controls():
frame:
has vbox
bar value Preference("sound volume")
bar value Preference("music volume")
bar value Preference("voice volume")
スクリーンのあるエリアを、アクションを実行するために押せるようにします。ボタンはパラメーターを取らず以下のプロパティーを取ります。
ボタンが押されると実行するアクションです。ボタンはクリックされるか、プレイヤーが選択してキーボードのエンターを押すかするとアクティベートされます。これは`sensitive` がなければボタンが有効かどうかの、 selected がなければ選択されているかどうかの制御もします。
ボタンが代替方法で押されると実行されるアクションです。代替方法はプレイヤーがマウスベースのプラットフォームでボタン上で右クリックするか、タッチベースのプラットフォームで長押しすると発生します。
ボタンがフォーカスを所得するときのアクションです。
ボタンがフォーカスを失うときのアクションです。
ボタンが選択されているかどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが選択状態決定に使用されます。
ボタンが有効かどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが有効無効決定に使用されます。
押すとこのボタンのアクションを実行するキーボードのキーを表わす keysym の文字列です。
押すとこのボタンの代替アクションを実行するキーボードのキーを表わす keysym の文字列です。
以下も取ります。 :
これは子を一つ取ります。 ゼロまたは二つ以上の子が与えられるとそれらは暗黙のうちに fixed に追加され、それがボタンに追加されます。
これは子を追加可能な領域を作成します。デフォルトでは fixed は利用可能な領域をすべて使用しますが、 xmaximum や ymaximum プロパティーを使用すればこれを変更できます。
子はそれぞれの位置スタイルプロパティーに従って配置されます。適切に位置が指定されていないと、これらは重なり合ってしまうかもしれません。
fixed ステートメントはパラメーターは取らず、以下のプロパティーを取ります。 :
これは fixed に追加されるすべての子を受け取ります。
fixed displayable を明示的に作成する必要はほとんどありません。各スクリーンは fixed displayable に含まれており、多くのスクリーン言語は二つ以上の子を持つと自動的に fixed を生成します。
screen ask_are_you_sure:
fixed:
text "Are you sure?" xalign 0.5 yalign 0.3
textbutton "Yes" xalign 0.33 yalign 0.5 action Return(True)
textbutton "No" xalign 0.66 yalign 0.5 action Return(False)
frame はユーザーインターフェイスを表示するための背景を含むウィンドウで、以下のプロパティーを取ります。 :
これは一つの子を取ります。 0 か 2 以上の子が与えられると、それらを含めるために fixed が作成されます。
screen test_frame():
frame:
xpadding 10
ypadding 10
xalign 0.5
yalign 0.5
vbox:
text "Display"
null height 10
textbutton "Fullscreen" action Preference("display", "fullscreen")
textbutton "Window" action Preference("display", "window")
これはその子をグリッドに表示します。各子には最大のサイズの子と同じサイズの領域が与えられます。
二つのパラメーターを取ります。最初の要素はグリッドの縦の列の数で、第二要素はグリッドの横の列の数です。以下のプロパティーを取ります。 :
デフォルトは False で、横の列が縦の列より先に埋められます。 True なら立ての列が横の列より先に埋められます。
以下も取ります。 :
これは縦掛ける横だけの子を与えられる必要があり、違う数の子が与えられるとエラーになります。
screen grid_test:
grid 2 3:
text "Top-Left"
text "Top-Right"
text "Center-Left"
text "Center-Right"
text "Bottom-Left"
text "Bottom-Right"
これはその子を透明な横長の箱に左から見に並べて表示します。これはパラメーターを取らず、以下のプロパティーを取ります。 :
UI displayable の子はボックスに追加されます。
screen hbox_text():
hbox:
text "Left"
text "Right"
その上にマウスがあると状態が変化する画像で構成されるボタンを作成します。これはパラメーターを取らず、以下のプロパティーを取ります。 :
このボタンに使用する画像を自動的に定義するために使用されます。これは %s を含む文字列であるべきです。これが与えられて、画像のプロパティーの一部が省略されていると %s をそのプロパティーの名前で置き換えて、その値をそのプロパティーのデフォルトとして使用します。
例えば auto が "button_%s.png" で idle が省略されると、 idle はデフォルトで "button_idle.png" になります。同様に auto が "button %s" なら button idle 画像が使用されます。
auto の動作は config.imagemap_auto_function を変更することで動作します。
ボタンが無効の時使用される画像
ボタンがフォーカスを持っていない時使用される画像
ボタンがフォーカスを持っている時使用される画像
ボタンが選択されアイドル状態の時使用される画像
ボタンが選択されフォーカスを持っている状態の時使用される画像
ボタンが押されると実行されるアクションです。これは`sensitive` がなければボタンが有効かどうかの、 selected がなければ選択されているかどうかの制御もします。
ボタンが代替方法で押されると実行されるアクションです。代替方法はプレイヤーがマウスベースのプラットフォームでボタン上で右クリックするか、タッチベースのプラットフォームで長押しすると発生します。
ボタンがフォーカスを所得するときのアクションです。
ボタンがフォーカスを失うときのアクションです。
ボタンが選択されているかどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが選択状態決定に使用されます。
ボタンが有効かどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが有効無効決定に使用されます。
押すとこのボタンのアクションを実行するキーボードのキーを表わす keysym の文字列です。
押すとこのボタンの代替アクションを実行するキーボードのキーを表わす keysym の文字列です。
以下も取ります。 :
これは子を取りません。
screen gui_game_menu():
vbox xalign 1.0 yalign 1.0:
imagebutton auto "save_%s.png" action ShowMenu('save')
imagebutton auto "prefs_%s.png" action ShowMenu('preferences')
imagebutton auto "skip_%s.png" action Skip()
imagebutton auto "afm_%s.png" action Preference("auto-forward mode", "toggle")
テキスト入力をする領域を作成し、ユーザーがテキストを入力できるようにします。ユーザーが Enter を押すと、テキストがインタラクションから返されます (call screen からスクリーンを呼び出したとき、 _return 変数に結果が代入されます) 。
input ステートメントはパラメーターを取らず、以下のプロパティーを取ります。 :
この input が使用する input value オブジェクトです。 InputValue オブジェクトはデフォルト値、テキスト変更、エンター押下時の動作、テキストがデフォルトで変更可能かどうかを決定します。
これは default や changed と同時に指定してはいけません。
入力されるデフォルトのテキストです。
入力されるテキストの最大の長さです。
入力の最大ピクセル幅です。入力した文字がこの幅を越えると、そのキー入力は無視されます。
入力できる文字を含む文字列です。 (デフォルトではすべての文字が許可されます。 )
入力出来ない文字を含む文字列です。 (デフォルトでは「{}」です。 )
ユーザーが入力したテキストの先頭に追加される文字列です。
ユーザーが入力したテキストの末尾に追加される文字列です。
以下も取ります。 :
これは子を取りません。
screen input_screen():
window:
has vbox
text "Enter your name."
input default "Joseph P. Blow, ESQ."
これはキーが押されるとアクションを実行するキーバインドを作成します。 キーはここではジョイスティックやマウスイベントも含む大まかな意味で使用されています。
key は一つのパラメーターを取り、それは関連づけるキーの文字列です。利用可能なキーについては キーマップのカスタマイズ の章を参照してください。これは1つのプロパティーを取ります:
これはキーが押されると実行されるアクションを与えます。このプロパティーは必ず必要です。
これは子を取りません。
screen keymap_screen():
key "game_menu" action ShowMenu('save')
key "p" action ShowMenu('preferences')
key "s" action Screenshot()
ラベルスタイルのウィンドウを作成し、その内側にテキストを置きます。同時にこの連携はフレーム内部にラベルを貼るために使用されます。
パラメーターを一つ持ち、それはラベルの文字列です。以下のプロパティーも取ります。 :
ボタンテキストに使用されるスタイルの名前です。これが与えられず、さらに style プロパティーが文字列なら、「 _text 」がその文字列に追加されてデフォルトのテキストスタイルになります。
text を接頭辞に持つその他のプロパティーは、この接頭辞を取ってテキスト displayable に渡されます。
以下も取ります。 :
子は取りません。
screen display_preference():
frame:
has vbox
label "Display"
textbutton "Fullscreen" action Preference("display", "fullscreen")
textbutton "Window" action Preference("display", "window")
null ステートメントはスクリーンに空白の領域を挿入します。これは間を開けるために使用されます。 null ステートメントはパラメーターは取らず、以下のプロパティーを取ります。 :
ピクセル数での空白の幅です。
ピクセル数での空白の高さです。
以下も取ります。 :
子は取りません。
screen text_box():
vbox:
text "The title."
null height 20
text "This body text."
マウスエリアはマウスの出入りに反応できるスクリーンの領域です。ボタンと違ってマウスエリアはフォーカスを取らないので、その内部にボタンを持つマウスエリアも可能です。 mousearea ステートメントはパラメーターを取らず、以下のプロパティーを取ります。 :
マウスエリアにマウスが入ると実行されるアクション
マウスエリアからマウスが出ると実行されるアクション
focus_mask スタイルプロパティーで、 displayable か None です。displayable ならマウスがその displayable の不透明な領域上にあるときのみマウスエリアはフォーカスを持ちます。 ( displayable はユーザーには表示されません。 )
以下も取ります。 :
子は取りません。
通常 mouseare ステートメントは area スタイルプロパティーを受け取ってマウスエリアのサイズや位置を制御します。そのサイズを制御しないとマウスエリアは画面全体になり、かなり不便です。
注釈
Ren'Py のゲームはキーボードとジョイスティックでもプレイ出来るので、他の方法でもマウスエリアの機能を再現してください。
screen button_overlay():
mousearea:
area (0, 0, 1.0, 100)
hovered Show("buttons", transition=dissolve)
unhovered Hide("buttons", transition=dissolve)
screen buttons():
hbox:
textbutton "Save" action ShowMenu("save")
textbutton "Prefs" action ShowMenu("preferences")
textbutton "Skip" action Skip()
textbutton "Auto" action Preference("auto-forward", "toggle")
label start:
show screen button_overlay
これはグリッドの中心か端に displayable を配置します。これは一つのパラメーターを取り、それはスペースで区切られたその子を配置する場所のリストです。このリストの各要素は以下のうちの一つです。 :
'c', 't', 'b', 'l', 'r', 'tl', 'tr', 'bl', 'br'
「c」は中心、「t」は上端、「tl」は左上端、「br」は右下など
side は以下のプロパティーを取ります。 :
グリッドの縦横の列の間のスペース
side は以下の種類のプロパティーも取ります。 :
レンダリング時に、これは最初に角を、次に側面、最後に中心のサイズを決定します。角と側面は利用可能な領域を 0 としてレンダリングされるので、それらに最小のサイズを与えて ( xminimum または yminimum を使用して ) すべてが描画される保証をする必要は多分ないです。
位置リストのすべてに対応する子があるので、これは位置リストに登録されているのと同じ数の子を持たなければなりません。
screen side_test():
side "c tl br":
text "Center"
text "Top-Left"
text "Bottom-Right"
text ステートメントはテキストを表示します。これはパラメーターを一つ取り、それは表示するテキストです。以下のプロパティーも取ります。 :
子は取りません。
screen hello_world():
text "Hello, World." size 40
テキストトラベル付きのボタンを作成します。ボタンはパラメーターを一つ取り、それはボタンの一部に含むテキストです。以下のプロパティーを取ります。 :
ボタンが押されると実行されるアクションです。これは`sensitive` がなければボタンが有効かどうかの、 selected がなければ選択されているかどうかの制御もします。
ボタンが代替方法で押されると実行されるアクションです。代替方法はプレイヤーがマウスベースのプラットフォームでボタン上で右クリックするか、タッチベースのプラットフォームで長押しすると発生します。
ボタンがフォーカスを所得するときのアクションです。
ボタンがフォーカスを失うときのアクションです。
ボタンが選択されているかどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが選択状態決定に使用されます。
ボタンが有効かどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが有効無効決定に使用されます。
押すとこのボタンのアクションを実行するキーボードのキーを表わす keysym の文字列です。
押すとこのボタンの代替アクションを実行するキーボードのキーを表わす keysym の文字列です。
ボタンテキストに使用されるスタイルの名前です。これが与えられず、さらに style プロパティーが文字列なら、「 _text 」がその文字列に追加されてデフォルトのテキストスタイルになります。
text を接頭辞に持つその他のプロパティーは、この接頭辞を取ってテキスト displayable に渡されます。
以下も取ります。 :
子は取りません。
screen textbutton_screen():
vbox:
textbutton "Wine" action Jump("wine")
textbutton "Women" action Jump("women")
textbutton "Song" action Jump("song")
これは時間が来るとアクションを実行するタイマーを作成します。これは一つのパラメーターを取り、それは秒数です。以下のプロパティーも取ります。 :
時間が来ると実行するアクションを指定します。このプロパティーは必須です。
True ならその時間が経つ度にタイマーが繰り返し実行されます。
これは子を取りません。
screen timer_test():
vbox:
textbutton "Yes." action Jump("yes")
textbutton "No." action Jump("no")
timer 3.0 action Jump("too_slow")
横向きになった bar です。プロパティーは bar と同じです。
screen volume_controls():
frame:
has hbox
vbar value Preference("sound volume")
vbar value Preference("music volume")
vbar value Preference("voice volume")
これはその子を透明な縦長の箱に縦に並べて表示します。これはパラメーターを取らず、以下のプロパティーを取ります。 :
UI displayable の子はボックスに追加されます。
screen vbox_test():
vbox:
text "Top."
text "Bottom."
viewport はドラッグやマウスホイールまたはスクロールバーでスクロール可能なスクリーンの領域です。画面より大きいものを表示するために使用され、以下のプロパティーを取ります。 :
レンダリングのために子に与えられるサイズで、 (xsize, ysize) のタプルです。子が自身のサイズを算出できるとき、これは通常省略されます。どちらかの要素が None なら子のサイズが使用されます。
これはつぎのうちの一つです
マウスホイールを無視します。 (デフォルト)
縦にスクロールします。
水平にスクロールします。
viewport が動くときのみ、viewport を縦にスクロールします。そうでないなら、マウスホイールイベントは残りのインターフェースに渡されます(例えば、changeが指定されていて、 key "viewport_wheeldown" action Return() がviewportの前に記述されていれば、 viewport が下端に達しているならそのスクリーンに処理を返させるようにできます)。
Change モードと水平スクロールを組み合わせます。
True ならマウスのドラッグで viewport をスクロール出来ます。
マウスが viewport の端に到達するとスクロールします。 None を設定するか、2要素か3要素のタプルを設定します :
タプルの最初の要素は viewport の端からのピクセル数での距離であり、その距離からエッジスクロールが開始されます。
第二要素は一秒ごとに何ピクセルスクロールするかの最大値です。
与えられるなら三番目の要素はスクロールのスピードをマウスポインターと端との距離に基づいて調整する関数です。関数は -0.0 から 1.0 までの範囲の数字を引数に取り、同じ範囲の数字を返すべきです。デフォルトの関数では入力をそのまま返し、端との近さに比例スクロールを加速させます。関数が入力された符号に基づき 1.0 か -1.0 を返すと一定の速度のスクロールになります。
ui.adjustment() は viewport の x 軸のために使用されます。省略されると新しい adjustment が作成されます。
ui.adjustment() は viewport の y 軸のために使用されます。省略されると新しい adjustment が作成されます。
viewport の初期の水平位置のオフセットです。これはピクセル数の整数か、可能なオフセットの割合の小数です。
viewport の初期の垂直位置のオフセットです。これはピクセル数の整数か、可能なオフセットの割合の小数です。
None でなければスクロールバーがこの viewport に追加されます。これは side レイアウトを作成し、その sideの中心に viewport を作成した viewport を置くことで動作します。 scrollbars が "horizontal" なら水平なスクロールバーが viewport の下に追加され、 scrollbars が "vertical" なら垂直なスクロールバーが viewport の右に追加されます。 scrollbars が "both" なら水平垂直両方のスクロールバーが作成されます。
scrollbars が None でなければ viewport は「side」で始まるプロパティーを受け取ります。これらは作成された side レイアウトに渡されます。
さらにこれは以下のスタイルプロパティーを取ります。 :
これは一つの子を取ります。 0 か 2 以上の子が与えられると、それらを含めるために fixed が作成されます。
viewport のスクロールバーを作成するためにはそれに id を与えて、その id を引数に XScrollValue() と YScrollValue() を使用するのが最適です。
screen viewport_example():
side "c b r":
area (100, 100, 600, 400)
viewport id "vp":
draggable True
add "washington.jpg"
bar value XScrollValue("vp")
vbar value YScrollValue("vp")
vpgrid (viewport grid) は viewport と grid を一つの displayable に結合します。 vpgrid は grid のように複数の子を受け取り、それらの子のレンダリングは最適化され、 viewport 内に表示されている子のみがレンダリングされます。
vpgrid はすべてのセルが同じサイズで、最初の子のサイズであると想定します。 vpgrid が誤ってレンダリングされたら、すべての子が同じサイズであるか確認してください。
vpgrid には col か rows の少なくとも一つのまたは両方のプロパティーが指定されなければいけない。一つが省略されるか None なら他方か子の数から自動的に決定されます。すべてのセルに対して十分な子がなければ、空のセルはレンダリングされません
Vgrids は以下のプロパティーを取ります。 :
グリッドの行数
グリッドの列数
True なら列の前に行が埋められます。これのデフォルトは cols と rows プロパティーに依存します。 cols が与えられたなら、行が列の前に埋められ、そうでなければ列が行の前に埋められます。
さらに vpgrid は ref:viewport <sl-viewport> が可能なすべてのプロパティーと以下のスタイルプロパティーを受け取ります。 :
screen vpgrid_test():
vpgrid:
cols 2
spacing 5
draggable True
mousewheel True
scrollbars "vertical"
# Since we have scrollbars, we have to position the side, rather
# than the vpgrid proper.
side_xalign 0.5
for i in range(1, 100):
textbutton "Button [i]":
xysize (200, 50)
action Return(i)
widow はゲーム内の台詞を表示するための背景を含むウィンドウのことです。これは以下のプロパティーを取ります。 :
これは一つの子を取ります。 0 か 2 以上の子が与えられると、それらを含めるために fixed が作成されます。
screen say(who, what):
window id "window"
vbox:
spacing 10
text who id "who"
text what id "what"
A convenient way of creating a screen, especially for those who think visually is to create an imagemap. When creating an imagemap, the imagemap statement is used to specify up to six images. The hotspot and hotbar images are used to carve rectangular areas out of the image, and apply actions and values to those areas.
ここに imagemap を使用した preferences スクリーンの例があります。
screen preferences():
tag menu
use navigation
imagemap:
auto "gui_set/gui_prefs_%s.png"
hotspot (740, 232, 75, 73) action Preference("display", "fullscreen") alt _("Display Fullscreen")
hotspot (832, 232, 75, 73) action Preference("display", "window") alt _("Display Window")
hotspot (1074, 232, 75, 73) action Preference("transitions", "all") alt _("Transitions All")
hotspot (1166, 232, 75, 73) action Preference("transitions", "none") alt _("Transitions None")
hotbar (736, 415, 161, 20) value Preference("music volume") alt _("Music Volume")
hotbar (1070, 415, 161, 20) value Preference("sound volume") alt _("Sound Volume")
hotbar (667, 535, 161, 20) value Preference("voice volume") alt _("Voice Volume")
hotbar (1001, 535, 161, 20) value Preference("text speed") alt _("Text Speed")
imagemap ステートメントは画像を指定するために使用されます。これはパラメーターは取らず、以下のプロパティーを取ります。 :
この imagemap に使用する画像を自動的に定義するために使用されます。これは %s を含む文字列であるべきです。これが与えられて、画像のプロパティーの一部が省略されていると %s をそのプロパティーの名前で置き換えて、その値をそのプロパティーのデフォルトとして使用します。
例えば auto が "imagemap_%s.png" で idle が省略されると、 idle はデフォルトで "imagemap_idle.png" になります。同様に auto が "imagemap %s" なら imagemap idle 画像が使用されます。
auto の動作は config.imagemap_auto_function を変更することで動作します。
hotspot や hotbar の一部ではない画像を配置するために使用される画像
hotspot や hotbar が無効の時に使用される画像
hotspot が選択されておらず、フォーカスを持たないとき、また hotbar がフォーカスを持たずバーが空のときに使用される画像
hotspot が選択されておらず、フォーカスを持つとき、また hotbar がフォーカスを持ちバーが空のときに使用される画像
hotspot が選択され、フォーカスを持たないとき、また hotbar がフォーカスを持たずバーが満タンのときに使用される画像
hotspot が選択され、フォーカスを持つとき、また hotbar がフォーカスを持ちバーが満タンのときに使用される画像
これはデフォルトでは True で、 hotspot はマウスが画像の不透明な領域上にあるときだけフォーカスを持ちます。 False なら hotspot はマウスが長方形の領域上にあるとフォーカスを持ちます。
これはデフォルトでは True で、 hotspot のデータはキャッシュして追加のディスク消費の代わりにパフォーマンスを改善します。
以下のプロパティーを取ります。 :
imagemap は fixed を作成し、 ( hotspot と hotbar だけでなく ) すべての子をそこに追加します。
hotspot は画像で構成されるボタンです。ボタンを作成する imagemap の領域を与えるタプル (x, y, width, height) を一つのパラメーターとして受け取ります。これは以下のプロパティー取ります。 :
ボタンが押されると実行されるアクションです。これはボタンが有効か、選択されているかどうかの制御もします。
ボタンが代替方法で押されると実行されるアクションです。代替方法はプレイヤーがマウスベースのプラットフォームでホットスポットを右クリックするか、タッチベースのプラットフォームで長押しすると発生します。
ボタンがフォーカスを所得するときのアクションです。
ボタンがフォーカスを失うときのアクションです。
ボタンが選択されているかどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが選択状態決定に使用されます。
ボタンが有効かどうかを決定する式です。この式はインテラクション毎に少なくとも一回評価されます。 与えられなければ、アクションが有効無効決定に使用されます。
押すとこのボタンのアクションを実行するキーボードのキーを表わす keysym の文字列です。
押すとこのボタンの代替アクションを実行するキーボードのキーを表わす keysym の文字列です。
以下も取ります。 :
hotspot は fixed を作成し、そこに子を追加出来るようにします。 fixed は hotspot と同じ大きさの領域を持つので、子は hotspot に対する相対距離で配置されます。
hotspot に alt スタイルプロパティーを与えることで、Ren'Py の自己発話機能が動くようになります。
hotbar は画像で構成されるバーです。バーを作成する imagemap の領域を与えるタプル (x, y, width, height) を一つのパラメーターとして受け取ります。これは以下のプロパティー取ります。 :
バーの現在の値。これは bar value オブジェクトか数字です。
バーの最大値です。これは value が数字なら必要です。
このバーを調整する ui.adjustment() オブジェクトです。
value か adjustment のどちらかは与えられなければなりません。さらにこの関数は以下を取ります。 :
これは子は取りません。
hotbar に alt スタイルプロパティーを与えることで、Ren'Py の自己発話機能が動くようになります。
よく使用されるステートメントに加えてスクリーン言語は高度な displayable に対応するステートメントを持ちます。displayable とステートメントの対応は単純です。displayable の位置引数はそのステートメントの位置パラメーターになり、キーワード引数と、関連するスタイルプロパティーはスクリーン言語のプロパティーになります。
高度な displayable のステートメント :
dragDrag クラスを作成します。 drag には任意の子が与えられるか、または child スタイルプロパティーを使用して子や、それがフォーカスを所得した場合のバージョンが提供されます。drag は focus_mask スタイルプロパティーも取れます。
draggroupDragGroup クラスを作成します。DragGroup はその子として 0 以上の drag を持ちます。
has ステートメントは fixed の代わりに子を一つだけ受け取るステートメントのために使用するコンテナを指定できるようにします。 has ステートメントはおそらく一つの子を受け取るステートメントの内部でのみ使用されるでしょう。キーワード引数 has の (同じ行の) 後にはもう一つのステートメントが続き、それは一つ以上の子を受け取るコンテナの displayable を作成するステートメントでなければなりません。
has ステートメントはそれを含むブロックの解釈を変更しします。そのブロックで作成された子の displayable は親の displayable ではなくそのコンテナに追加されます。親の displayable に対するキーワード引数は has ステートメントの後は許可されません。複数の has ステートメントが同じブロックで使用可能です。
has ステートメントは以下のステートメントの子として提供されます。
has ステートメントには以下のステートメントが入れ物として与えられます。
screen volume_controls():
frame:
has vbox
bar value Preference("sound volume")
bar value Preference("music volume")
bar value Preference("voice volume")
スクリーン言語には、条件実行や反復、他のスクリーンを含んだり、イベントによるアクションの実行や任意の python コードの実行のための制御用ステートメントがあります。
default ステートメントはそのスクリーンが最初の 1 つなら変数のデフォルト値を設定します。 SetScreenVariable()
The default statement sets the default value of a variable, if it is not passed as an argument to the screen, or inherited from a screen that calls us using the use statement.
screen scheduler():
default club = None
vbox:
text "What would you like to do?"
textbutton "Art Club" action SetScreenVariable("club", "art")
textbutton "Writing Club" action SetScreenVariable("club", "writing")
if club:
textbutton "Select" action Return(club)
The for statement is similar to the Python for statement, except that it does not support the else clause. It supports assignment to (optionally nested) tuple patterns, as well as variables.
$ numerals = [ 'I', 'II', 'III', 'IV', 'V' ]
screen five_buttons():
vbox:
for i, numeral in enumerate(numerals):
textbutton numeral action Return(i + 1)
The screen language if statement is the same as the Python/Ren'Py if statement. It supports the if, elif, and else clauses.
screen skipping_indicator():
if config.skipping:
text "Skipping."
else:
text "Not Skipping."
The on statement allows the screen to execute an action when an event occurs. It takes one parameter, a string giving the name of an event. This should be one of:
"show""hide""replace""replaced"イベント時に実行するアクションを与えるプロパティーを取ります。
screen preferences():
frame:
has hbox
text "Display"
textbutton "Fullscreen" action Preferences("display", "fullscreen")
textbutton "Window" action Preferences("display", "window")
on "show" action Show("navigation")
on "hide" action Hide("navigation")
The use statement allows a screen to include another. The use statement takes the name of the screen to use. This can optionally be followed by an argument list, in parenthesis.
使用したスクリーンにパラメーターがあれば、引数をそれらのパラメーターに代入した結果でそのスコープは初期化されます。そうでなければ現在のスクリーンのスコープが渡され、現在のスクリーンに渡されたキーワード引数で更新されます。
screen file_slot(slot):
button:
action FileAction(slot)
has hbox
add FileScreenshot(slot)
vbox:
text FileTime(slot, empty="Empty Slot.")
text FileSaveName(slot)
screen save():
grid 2 5:
for i in range(1, 11):
use file_slot(i)
use ステートメントは必要ならプロパティー id を引数リストの後に 1 つ取れます。このスクリーンは同じタグを持つ 2 つのスクリーンが同じスクリーンを使用するときのみ便利です。この場合、あるスクリーンが別のスクリーンを置き換えると、使用されたスクリーンの状態は以前のスクリーンから新しいスクリーンへ譲渡されます。
transform t1():
xpos 150
linear 1.0 xpos 0
screen common():
text "Test" at t1
screen s1():
tag s
use common id "common"
text "s1" ypos 100
screen s2():
tag s
use common id "common"
text "s2" ypos 100
label start:
show screen s1
pause
show screen s2
pause
return
A use statement may also take a block containing screen language statements.
When a block is given, the screen that is used may contain the transclude
statement. The transclude statement is replaces with the statements
contained within the use statement's block.
これによりスクリーンを使用する再利用可能なレイアウトが定義出来るようになります。例えば次のスクリーン
screen movable_frame(pos):
drag:
pos pos
frame:
background Frame("movable_frame.png", 10, 10)
top_padding 20
transclude
は他の要素をラップする再利用可能な要素で、以下のように使用します。
screen test:
use movable_frame((0, 0)):
text "You can drag me."
use movable_frame((0, 100)):
vbox:
text "You can drag me too."
textbutton "Got it!" action Return(True)
use と transclude は :ref:` ユーザー定義スクリーン言語ステートメント <creator-defined-sl>` に基づいて組み立てます。
The screen language also includes single-line and multiple-line python statements, which can execute Python. The Python runs in the scope of the screen.
python コードはスクリーンの外への副作用を起こしてはいけません。 Ren'Py はスクリーンが最初に表示される前に画像予測処理の一部として必要なら何度もスクリーンのコードを実行します。結果としてスクリーンのコードが副作用を持つなら、それが何回実行されるかはわかりません。
screen python_screen:
python:
test_name = "Test %d" % test_number
text test_name
$ test_label = "test_%d" % test_label
textbutton "Run Test" action Jump(test_label)
The showif statement takes a condition. It shows its children when the condition is true, and hides the children when the condition is false. When showif's children have transforms, it will supply them with ATL events to manage the show and hide process, so that Ren'Py can animate the show and hide process.
複数の showif ステートメントは if ステートメント同様 1 つの showif/elif/else 構造に纏められます。** if ステートメントとは違い、条件が False であっても python コードを含むそのブロックを showif はすべて実行します。これは showif ステートメントが非表示される子を作成する必要があるためです。 **
showif は 3 つのイベントをその子に送ります。
appearスクリーンが最初に表示されたときで、条件が True なら送られ、即座に子を表示します。
show条件が False から True に変わると送られます。
hide条件が True から False に変わると送られます。
これらの目的のため、 elif 節の条件はそれ以前の条件が True なら常に False で、すべての条件が False なら else 節だけが True になります。
例
transform cd_transform:
# This is run before appear, show, or hide.
xalign 0.5 yalign 0.5 alpha 0.0
on appear:
alpha 1.0
on show:
zoom .75
linear .25 zoom 1.0 alpha 1.0
on hide:
linear .25 zoom 1.25 alpha 0.0
screen countdown():
default n = 3
vbox:
textbutton "3" action SetScreenVariable("n", 3)
textbutton "2" action SetScreenVariable("n", 2)
textbutton "1" action SetScreenVariable("n", 1)
textbutton "0" action SetScreenVariable("n", 0)
showif n == 3:
text "Three" size 100 at cd_transform
elif n == 2:
text "Two" size 100 at cd_transform
elif n == 1:
text "One" size 100 at cd_transform
else:
text "Liftoff!" size 100 at cd_transform
label start:
call screen countdown
Ren'Py 言語にはスクリーンに作用する三つのスクリーンステートメントがあります。
Two of these statements take a keyword argument list. This is a python argument list, in parenthesis, consisting of only keyword arguments. Positional arguments, extra positional arguments (*), and extra keyword arguments (**) are not allowed.
The show screen statement causes a screen to be shown. It takes an screen name, and an optional argument list. If present, the arguments are used to initialize the scope of the screen.
The show screen statement takes an optional nopredict keyword, that prevents screen prediction from occurring. During screen prediction, arguments to the screen are evaluated. Please ensure that evaluating the screen arguments does not cause unexpected side-effects to occur.
警告
スクリーンの引数の評価が副作用を起すなら、あなたのゲームは予測しない方法で動作するかもしれません。
このように表示されたスクリーンは明示的に非表示にされるまで表示されます。これによりそれらで意図的に上書きが出来ます。
show screen overlay_screen
show screen clock_screen(hour=11, minute=30)
if rare_case:
show rare_screen nopredict
The hide screen statement is used to hide a screen that is currently being shown. If the screen is not being shown, nothing happens.
hide screen overlay_screen
hide screen clock
The call screen statement shows a screen, and then hides it again at the end of the current interaction. If the screen returns a value, then the value is placed in _return.
This can be used to display an imagemap. The imagemap can place a
value into the _return variable using the Return() action,
or can jump to a label using the Jump() action.
call screen ステートメントは任意で nopredict キーワードを受け取り、スクリーンの予測を禁止します。スクリーンの予測中にスクリーンへの引数は評価されます。スクリーン引数の評価が不測の副作用を起さないように確認してください。
call screen ステートメントは任意で with キーワードに続くトランジションを受けとります。トランジションはスクリーンが最初に置き換えられると実行されます。
警告
スクリーンの引数の評価が副作用を起すなら、あなたのゲームは予測しない方法で動作するかもしれません。
call screen my_imagemap
call screen my_screen(side_effect_function()) nopredict
# Shows the screen with dissolve and hides it with fade.
call screen my_other_screen with dissolve
with fade
Ren'Py は Windows, Mac, Linux PC のような伝統的なマウスを持つデバイスと Android ベースのスマートフォンやタブレットのような最新のタッチベースのデバイス、両方で動作します。スクリーンバージョンはゲームが複数の種類のスクリーンを持てるようにし、実行中のハードウェアに最適なものを使用可能にします。
Ren'Py は config.variants にリストされた順番でバージョンを探索して使用するスクリーンバージョンを選択します。存在する最初のバージョンが使用されます。
環境変数 RENPY_VARIANT があれば空白でその変数を分割し、 None を追加して config.variants を初期化します。RENPY_VARIANT を 「medium tablet touch」や「small phone touch」のように設定すると PC で android デバイス用のスクリーンをテスト出来ます。
環境変数がなければバージョンのリストは以下のリストを順番に探索して現在のプラットフォームに対応するものを選びます。
"large"比較的小さなテキストを快適に読め、ボタンを簡単にクリックできる十分大きな画面です。これはコンピューターの画面に使用されます。
"medium"やや小さいテキストは読めるが、ボタンは快適に押せるためにはサイズを大きくしなければならない画面です。これはタブレットで使用されます。
"small"テキストを読むためにも字を大きくする必要がある画面です。これは携帯やテレビで使用されます。 ( テレビは物理的には大きいですが、大概遠くて見にくいです。 )
"tablet"画面の対角線が 6 インチタッチかそれ以上のタッチスクリーンベースのデバイスで定義されます。 ( 通常は「 medium 」が「 tablet 」の代わりに使用されます。 )
"phone"画面の対角線が 6 インチタッチかそれ以下のタッチスクリーンベースのデバイスで定義されます。そのような小さなデバイスではボタンを十分に大きくして簡単に選択できるようにすることが重要です。 ( 通常は「 small 」が「 phone 」の代わりに使用されます。 )
"touch"タッチスクリーンベースのデバイスで定義されます。
"tv"TV ベースのデバイスで定義されます。
"ouya"OUYA のコンソール上で定義されます。 ("tv" と "small" も定義されます。 )
"firetv"Amazon Fire TV のコンソール上で定義されます。 ("tv" と "small" も定義されます。 )
"android"すべての Android デバイスで定義されます。
"ios"iPad ( "tablet" と "medium" も定義されます )や iPhone ("phone" と "small" も定義されます)のような iOS デバイスで定義されます。
"mobile"Android や iOS のようなモバイルプラットフォームを定義します。
"pc"Windows, Mac OS X, Linux で定義されます。 PCはマウスとキーボードを所持し、ボタンへのフォーカスと正確な移動が出来ると期待されます。
None常に定義されます。
スクリーンバージョンを定義する例です。 :
# A variant hello_world screen, used on small touch-based
# devices.
screen hello_world():
tag example
zorder 1
modal False
variant "small"
text "Hello, World." size 30