スタイル link

スタイルとスタイルの継承 link

それぞれの displayable にはスタイルが組み込まれています。displayable が作成されると、直接に、またはスクリーンシステムを利用して style プロパティーが与えられ、そのスタイルが displayable の見た目の更新に使用されます。以下の例で:

image big hello world = Text("Hello, World", size=40)

テキスト displayable に size プロパティーが与えられており、テキストのサイズが変更されます。このカスタマイズでは、テキスト displayable の見た目として高さが40ピクセルのテキストを表示するようにしています。

スクリーン言語と同様に、各ユーザーインターフェース用のステートメントは適切なスタイルプロパティーを受け取ります。

screen big_hello_world:
    text "Hello, World" size 40

Ren'Py はスタイルの継承をサポートし、各スタイルは親を 1 つ持っています。スタイルでスタイルプロパティーが定義されていないと、そのプロパティーの値は直近の親から継承します。

各 displayable はその displayable のスタイルの親を指定する "style" というプロパティーを受け取ります。

image big hello world = Text("Hello World", style="big")

screen hello_world:
    text "Hello, World" style "big"

style プロパティーが指定されないと、提供された displayable の種類に基づいて親が選ばれます。選ばれた親はスクリーン言語のユーザーインターフェースステートメントにある ref:style_group <style-group> から影響を受けます。

スタイルが親を定義せずに定義されるとデフォルトの親がそのスタイルに選ばれます。そのスタイル名にアンダースコア (_) があるなら親は最初のアンダースコアまでを取り除いて名付けられます。例えば my_button というスタイルは button というスタイルを継承します。この継承は style ステートメントやスタイルオブジェクトのメソッド呼び出しで変更可能です。存在しないスタイルが使用され、またそのスタイル名にアンダースコアがあるなら Ren'Py はデフォルトの親を使用してそれを作成します。

アンダースコアで始まる名前のスタイルは Ren'Py 内部での使用のために予約されています。

Ren'Py は起動時にスタイルをビルドするので、名前を持つスタイルは style ステートメントや init コードの外で変更するべきではありません。

スタイルインスペクター link

config.developer が true なら、ある displayable に使用されているスタイルを確認出来るスタイルインスペクターが使用可能です。

To activate the style inspector, place the mouse over a displayable, and press shift+I. Ren'Py will display a list of displayables that include the mouse position, in the order they are drawn to the screen. (That is, the last displayable is the one on top of the others.)

スタイル名をクリックするとその displayable が継承するスタイルと、各 displayable が最終的な displayable に寄与するプロパティーが表示されます。

スタイルの定義: スタイルステートメント link

スタイル は style statement を使用して定義されます。

style my_text is text:
    size 40
    font "gentium.ttf"

あるスタイルが存在しなければ style ステートメントはそのスタイルを作成し、そうでなければ既存のスタイルは style ステートメントによって修正されます。

style ステートメントはキーワード style と定義するスタイル名で始まります。最初の行にはこれに 0 以上の節や、任意のコロンが続きます。

コロンが存在すると、次にブロックが続かなければなりません。ブロックの各行は 1 つ以上の節を含み、そうでなければステートメントが終了します。

style ステートメントは以下の節を受け取ります。

スタイルプロパティー 単純式

単純式の値を指定されたスタイルプロパティーに代入します。

is 親

このスタイルの親を設定します。親はスタイル名でなければなりません。

clear

この style ステートメントが実行されるより前に代入されたこのスタイルの全てのプロパティーを除去します。これはスタイルが親からプロパティーの値を継承することを防ぎません。

take スタイル名

この style ステートメントが実行されるより前に代入されたこのスタイルの全てのプロパティーを除去し、その名前のスタイルのプロパティーで置き換えます。これはスタイルの親を変更しません。

variant 単純式

単純式を評価し、 screen variants として解釈される文字列か文字列のリストを生成します。少なくとも 1 つ指定されたバージョンがアクティブなら style ステートメントが実行され、そうでなければ無視されます。

properties simple-expression

単純式を評価して辞書を得ます。辞書はスタイルとその値が期待され、値は style ステートメントに与えられたように代入されます。

スタイルステートメントの例は:

# Creates a new style, inheriting from default.
style big_red:
    size 40

# Updates the style.
style big_red color "#f00"

# Takes the properties of label_text from big_red, but only if we're
# on a touch system.

style label_text:
    variant "touch"
    take big_red

style ステートメントは常に初期化時に実行されます。 style ステートメントが init ブロックにない場合は自動的に init 0 ブロックに配置されます。

スタイルの定義: Python link

名前付きスタイルは、グローバルな style オブジェクト上のフィールドに存在します。新しいスタイルを作成するには、Style クラスのインスタンスを作成し、 style オブジェクト上のフィールドに割り当てます。:

init python:
     style.big_red = Style(style.default)

スタイルプロパティーは、style のフィールドプロパティーへの割り当てによって設定できます。:

init python:
     style.big_red.color = "#f00"
     style.big_red.size = 42

class Style(parent) link

新しいスタイルオブジェクトを作成します。スタイルプロパティーはこのオブジェクトのフィールドに割り当てられます。

parent

親となるスタイル。これは他のスタイルオブジェクトまたは文字列にできます。

clear() link

これは、すべてのスタイルプロパティーをこのオブジェクトから削除します。値はオブジェクトの親から継承されます。

set_parent(parent) link

このスタイルオブジェクトの親を parent に設定します。

take(other) link

これはスタイルプロパティーを other から持ってきます。 other はスタイルオブジェクトにする必要があります。

インデックスされたスタイル

Indexed styles are lightweight styles that can be used to customize the look of a displayable based on the data supplied to that displayable. An index style is created by indexing a style object with a string or integer. If an indexed style does not exist, indexing creates it.:

init python:
    style.button['Foo'].background = "#f00"
    style.button['Bar'].background = "#00f"

インデックススタイルは、displayable にインデックスされたスタイルを与えることで使用できます。:

screen indexed_style_test:
    vbox:
        textbutton "Foo" style style.button["Foo"]
        textbutton "Bar" style style.button["Bar"]

init python:
    renpy.register_style_preference("text", "decorated", style.say_dialogue, "outlines", [ (1, "#000", 0, 0) ])
    renpy.register_style_preference("text", "decorated", style.say_dialogue, "size", 22)

    renpy.register_style_preference("text", "large", style.say_dialogue, "outlines", [ ])
    renpy.register_style_preference("text", "large", style.say_dialogue, "size", 24)

textbutton "Decorated" action StylePreference("text", "decorated")
textbutton "Large" action StylePreference("text", "large")