1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
# This file demonstrates some of the text-layout and handling
# capabilities of Ren'Py.
init 1:
define eslow = Character(kind=e, what_slow_cps=20)
# init python:
# style.ruby_style = Style(style.default)
# style.ruby_style.yoffset = -20
# style.ruby_style.size = 12
#
# define eruby = Character(
# _("Eileen"),
# color="#c8ffc8",
# what_ruby_style=style.ruby_style,
# what_line_leading=10)
label a_label:
e "You just clicked to jump to a label."
jump after_a_label
label text:
e "Sometimes, when showing text, we'll want to change the way some of the text is displayed."
example tags1 hide:
e "For example, we might want to have text that is {b}bold{/b}, {i}italic{/i}, {s}struckthrough{/s}, or {u}underlined{/u}."
e "That's what text tags are for."
show example tags1
e "Text tags are contained in braces, like the {{b} tag above. When a text tag takes a closing tag, the closing tag begins with a slash, like {{/b} does."
e "We've already seen the b, i, s, and u tags, but there are lot more than those. I'll show you the rest of them."
example:
e "The a text tag can {a=https://www.renpy.org}link to a website{/a} or {a=jump:a_label}jump to a label{/a}."
label after_a_label:
example:
e "The alpha text tag makes text {alpha=.5}translucent{/alpha}."
example:
e "The color text tag changes the {color=#0080c0}color{/color} of the text."
example:
e "The cps text tag {cps=25}makes text type itself out slowly{/cps}, even if slow text is off."
e "The cps tag can also be relative to the default speed, {cps=*2}doubling{/cps} or {cps=*0.5}halving{/cps} it."
example:
e "The font tag changes the font, for example to {font=DejaVuSans-Bold.ttf}DejaVuSans-Bold.ttf{/font}."
e "Sometimes, changing to a bold font looks better than using the {{b} tag."
example:
e "The k tag changes kerning. It can space the letters of a word {k=-.5}closer together{/k} or {k=.5}farther apart{/k}."
example:
e "The size tag changes the size of text. It can make text {size=+10}bigger{/size} or {size=-10}smaller{/size}, or set it to a {size=30}fixed size{/size}."
example:
e "The space tag {space=30} adds horizontal space in text.{vspace=30}The vspace tag adds vertical space between lines."
hide example
e "There are a few text tags that only makes sense in dialogue."
example:
e "The p tag breaks a paragraph,{p}and waits for the player to click."
e "If it is given a number as an argument,{p=1.5}it waits that many seconds."
example:
e "The w tag also waits for a click,{w} except it doesn't break lines,{w=.5} the way p does."
example:
eslow "The nw tag causes Ren'Py to continue past slow text,{nw}"
with flashbulb
extend " to the next statement."
example:
e "To break a line without pausing,\none can write \\n. \\' and \\\" include quotes in the text."
hide example
e "The interpolation feature takes a variable name in square brackets, and inserts it into text."
example:
$ variable = _("{i}variable value{/i}")
e "For example, this displays the [variable!t]."
example:
e "When the variable name is followed by !q, special characters are quoted. This displays the raw [variable!q!t], including the italics tags."
example showtrans:
$ translatable = _("translatable text")
e "When the variable name is followed by !t, it is translated to [variable!t]. It could be something else in a different language."
example:
e "Finally, certain characters are special. [[, {{, and \\ need to be doubled if included in text. The %% character should be doubled if used in dialogue."
hide example
pause .5
return
# label demo_text:
#
# e "Ren'Py gives you quite a bit of control over how text appears."
#
# e "Text tags let us control the appearance of text that is shown to the user."
#
# e "Text tags can make text {b}bold{/b}, {i}italic{/i}, {s}struckthrough{/s}, or {u}underlined{/u}."
#
# e "They can make the font size {size=+12}bigger{/size} or {size=-8}smaller{/size}."
#
# e "They let you pause{w} the display of the text, optionally with{p}line breaks."
#
# e "They let you include images inside text{image=exclamation.png} Neat{image=exclamation.png}"
#
# e "We can pause the text for a short time, and have it auto-advance.{w=1} Just like that."
#
# eslow "We can even have the text auto-advance,{nw}"
#
# with flashbulb
# extend " when we reach the end of a block of text, in slow text mode."
#
# e "They can change the {color=#f00}color{/color} {color=#ff0}of{/color} {color=#0f0}the{/color} {color=#0ff}text{/color}."
#
# # e "There are also bold, italic, strikethrough, and underline style properties, which can be styled onto any text."
#
# e "The kerning tag lets you adjust the spacing between characters.\n{k=.5}The spacing between characters can be increased.{/k}\n{k=-.5}The spacing between characters can be decreased.{/k}"
#
# eruby "You are able to write ruby text, which can help clarify how to pronounce words, like {rb}Ren'Py{/rb}{rt}ren-pie{/rt}."
#
# e "{a=define_hyperlink}Hyperlinks{/a} let buttons be defined using text tags."
#
# e "The space and vspace tags add {space=30} horizontal and {vspace=20}vertical space, respectively."
#
# e "You can define your own text tags, {=pink}that use a style you define.{/=pink}"
#
# e "If you find yourself using text tags on every line, you should probably look at style properties instead."
#
# e "Used with care, text tags can enhance {b}your{/b} game."
#
# e "{u}Used{/u} with {i}abandon,{/i} they {b}can{/b} make {b}your{/b} game {color=#333}hard{/color} {color=#888}to{/color} {color=#ccc}read{/color}."
#
# e "With great power comes great responsibility, after all."
#
# e "And we want to give you all the power you need."
#
# e "There are a couple of text adjustments that don't correspond to text tags."
#
# eoutline "The outlines setting lets you put outlines around the text."
#
# eoutline "You can have more than one outline, and each has its own color and offset."
#
# window hide
#
# esubtitle "Here, we have two outlines around the white text."
#
# esubtitle "The bottom one is a translucent black that's offset a little, while the top one is green."
#
# esubtitle "By hiding the window and adjusting the layout method, we are able to create reasonable subtitles."
#
# esubtitle "This might be an interesting look for a game."
#
# window show
#
# e "Well, that's it for fonts and text tags."
#
#
# return
#
#
# label define_hyperlink:
#
# definition "A hyperlink is a button that is defined inside text, using text tags. They're ideal for including definitions of words used in the script, but they shouldn't be used in place of menus."
#
# return
|
