17
17
"Content-Transfer-Encoding: 8bit\n"
19
19
#: ../../source/style.rst:9
20
# f67c11ace7a04e6caae0be7e44143a00
20
# 9cdacd8d8a454adb8dcce60076e99a3c
21
21
msgid "Styles and Style Properties"
24
24
#: ../../source/style.rst:11
25
# b6c0ee8236d3481d8d08ec1e291596cd
25
# ec5f8856cce84929916b3bd47849e078
26
26
msgid "Styles allow the look of displayables to be customized. This is done by changing the value of style properties for displayables. For example, changing the :propref:`background` property allows the background of a window or button to be customized."
29
29
#: ../../source/style.rst:16
30
# 1258d48ca70643d2bd4a5521232cfa0f
30
# 156ada6a9ff34f4d90bebc1e8837ea03
31
31
msgid "Each displayable has a style built-into it. When the displayable is created, either directly or using the screen system, style properties can be supplied to it, and these styles are used to update the look of the displayable. In the following example::"
34
34
#: ../../source/style.rst:23
35
# b830cbc0edb94e4799bff28a922fc41f
35
# 206dd325951b4855a532c9c1f533ebd7
36
36
msgid "the :propref:`size` property is supplied to a Text displayable, allowing us to change its text size. This will customize the look of the text displayable by displaying the text 40 pixels high."
39
39
#: ../../source/style.rst:27
40
# 65ca4b8d387140bdbda1e669ac0339ef
40
# 3744b8337a78491fb760b07499211027
41
41
msgid "Ren'Py also supports style inheritance. Each displayable takes a `style` property, that gives the name of the style to use. If a property is not defined for a style, Ren'Py will look it up in the named style, that style's parent, and so on. This allows us to customize a named style in a central place."
44
44
#: ../../source/style.rst:33
45
# 05373caff3c946af80d99a0605708175
45
# 99990e7e5bd44577ab409c0a3cf944c1
46
46
msgid "A named style exists as a field on the global ``style`` object. Style properties exist as fields on styles. So to set the size property of the default style, one can use a python block::"
49
49
#: ../../source/style.rst:41
50
# 1adf05c28e1b429989b296dac22ea0e3
50
# 3429083bc5334062ab78631805a5e7a1
51
51
msgid "As Ren'Py caches styles, named styles should not be changed outside of init blocks."
54
54
#: ../../source/style.rst:46
55
# 7079ff55957e4b21944a041506062813
55
# 6b79fb81e20c4e47a969e46479d20122
56
56
msgid "Style Property Prefixes"
59
59
#: ../../source/style.rst:48
60
# 64845902c96c4823850e0b55e285760a
60
# ea7f1b57fdf94263bfec9b488255c1fe
61
61
msgid "Applying a prefix to a style property indicates allows a displayable to change it's look in response to its focus or selection status. For example, a button can change its color when the mouse hovers above it, or to indicate when the choice represented by the button is the currently selected one."
64
64
#: ../../source/style.rst:53
65
# c904b6f7aba04119813f265494f54037
65
# 3431a3de22aa4c2b8b0a6f1e6665969b
66
66
msgid "There are five states a displayable can be it."
69
69
#: ../../source/style.rst:56
70
# b4975c0b4dd94e45adb40663affcc6c2
70
# 10be7a0d20ef43a0aa496d4de3f14837
71
71
msgid ":dfn:`insensitive`"
74
74
#: ../../source/style.rst:56
75
# ced4e56a772c49e684831e240490560a
75
# 76f559dbe9e04d7799e2067b2729de04
76
76
msgid "Used when the user cannot interact with the displayable."
79
79
#: ../../source/style.rst:59
80
# 208bd5e36d2a40388779fe6ed040c3ab
80
# ad9ccd35f46f4d71a7f2c738384762bc
81
81
msgid ":dfn:`idle`"
84
84
#: ../../source/style.rst:59
85
# 7c7fc2e9ed2f4f9496d658bfa35784fe
85
# c3ea00a6e62a494699d3a151c717f112
86
86
msgid "Used when the displayable is neither focused nor selected."
89
89
#: ../../source/style.rst:62
90
# 757069f87feb419387288158091d1c46
90
# 68f47f26975c4954b47b77dd64ccb67c
91
91
msgid ":dfn:`hover`"
94
94
#: ../../source/style.rst:62
95
# 83203202ef1949a2a3536d95399e30fa
95
# ba906f3357cb42738ddfca2cf8a2ebf4
96
96
msgid "Used when the displayable is focused, but not selected."
99
99
#: ../../source/style.rst:65
100
# 1bdde3ab15684a3ab5664cb3438952ca
100
# 37e88c30fea54d3a81a76e1ca0f5ab50
101
101
msgid ":dfn:`selected_idle`"
104
104
#: ../../source/style.rst:65
105
# 9a2a62dedfb340d88073be658106b517
105
# 353d856eef924cfbb22c385e4dbcfa2c
106
106
msgid "Used when the displayable is not focused, and is selected."
109
109
#: ../../source/style.rst:68
110
# dc94303022964ee5b213c0e544546ad2
110
# 28c5f8641f66471aa647f688d22ce556
111
111
msgid ":dfn:`selected_hover`"
114
114
#: ../../source/style.rst:68
115
# 0af8d313be794d62be4b1edb60e308eb
115
# bdaec89611004dbeb3e7efb1051087e3
116
116
msgid "Used when the displayable is focused and selected."
119
119
#: ../../source/style.rst:70
120
# 55027c99c0ef44998dbb8e69dd2cc2d3
120
# 9f0494a0e496493a92ec484f1b924fcc
121
121
msgid "Button and Bar displayables (and their variants) update their state, and the state of their children, in response to events. For example, when the user puts his mouse over an unselected button, it and all its children will be put into the hover state."
124
124
#: ../../source/style.rst:75
125
# 1fa2fe4b915c42818266bdfa25835b29
125
# dd9478b6c27e4bed9f542484c891c02d
126
126
msgid "Style property prefixes allow one to set style properties for the different states. There is a system of implications set up, so that a prefix can imply setting the property for more than one state."
129
129
#: ../../source/style.rst:79
130
# e9c595025617487499c717ea321115b0
130
# f53059d6c4144aa1b78d11418a145890
131
131
msgid "The implications are:"
134
134
#: ../../source/style.rst:84
135
# 8e31004a94b2432e8299838f4f1d8037
135
# 739098fbae4e45169672d6b36ef725b0
139
139
#: ../../source/style.rst:85
140
# 08c7dbfe028042d481e0bd9a1dcbde37
140
# f60173ea764b419b89ac6e0c443b6ac7
141
141
msgid "states implied by prefix"
144
144
#: ../../source/style.rst:87
145
# db5eb193e39b4c2f9ab6dbc75b760562
145
# d0abcb323d7946ccacefe3502151ab11
146
146
msgid "(no prefix)"
149
149
#: ../../source/style.rst:88
150
# 2cff926de13e473e8a9d1b4225c67f1e
150
# 4dcef3f27c934034aa61076592dbb54c
151
151
msgid "insensitive, idle, hover, selected_idle, selected_hover"
154
154
#: ../../source/style.rst:90
155
# 5f5a6eed4cf44fd5b500f3f807993cf7
155
# ceb8b1191540481481189752cc7950ae
156
156
msgid "``insensitive_``"
159
159
#: ../../source/style.rst:91
160
# 466750fede074eaa8b24b9d7a8b0b12d
160
# 1c305e65a0c541bfa6c3089017cbf707
161
161
msgid "insensitive"
164
164
#: ../../source/style.rst:93
165
# 8b15d1205b46405c86d304fdb7973b54
165
# 3992648e79b146aeb92c8555e3ffb9b9
166
166
msgid "``idle_``"
169
169
#: ../../source/style.rst:94
170
# 106e93892966400084cdf82e90a48fae
170
# e9942daa2e694e399274a405a14ecb10
171
171
msgid "idle, selected_idle"
174
174
#: ../../source/style.rst:96
175
# 60500e5753b04d28b4f403a26acf575f
175
# f46c31168b9c42db8df329a59ccd394f
176
176
msgid "``selected_``"
179
179
#: ../../source/style.rst:97
180
# 94442f6075a54e1b93a1ab7a5d7c2e9c
180
# 06f14ad62db84b199a2e96df2d36a7bb
181
181
msgid "selected_idle, selected_hover"
184
184
#: ../../source/style.rst:99
185
# a0e55d037850487ebf35be4a87bb8319
185
# d09d82cbd2e34b72bb31884e65f10f87
186
186
msgid "``selected_idle_``"
189
189
#: ../../source/style.rst:100
190
# 78fe949025034d1993bc3152d0479d11
190
# a09b84bc20f14a9ab8b1990cfebd697b
191
191
msgid "selected_idle"
194
194
#: ../../source/style.rst:102
195
# 374d0e3ddd0549ecb8950380ed7cc29a
195
# 8cd288e11da7477484c90632ad0151c9
196
196
msgid "``selected_hover_``"
199
199
#: ../../source/style.rst:103
200
# bfc12f973bae4243886831dd05f7b744
200
# 1fc1a7a507a14fab9767a0289144bdb5
201
201
msgid "selected_hover"
204
204
#: ../../source/style.rst:105
205
# 5c2c74c83c4a413aabee5738dc0ca6a5
205
# 8c96fc94fc3d4592be788fa5c392d06e
206
206
msgid "Using a text button, we can show this in action. Text buttons use two styles by default: ``button`` for the button itself, and ``button_text`` for the text inside the button. The :propref:`background` style property sets the background of a button, while the :propref:`color` property sets the color of text.::"
209
209
#: ../../source/style.rst:125
210
# 9ee4e173cba5478996d12111df683472
210
# 50534de7d0144ffabaaf522ad9f1c21a
211
211
msgid "Style Property Values"
214
214
#: ../../source/style.rst:127
215
# 42b81ebb918349969c1160fd1a075a54
215
# 368d4133ef3b4c71a7fc366f3451329f
216
216
msgid "Each style property expects a specific kind of data. Many of these are standard python types, but a few are novel. Here are descriptions of the novel kinds of value a style property can expect."
219
219
#: ../../source/style.rst:152
220
# 7b14487072f84a2e822c154a2092bf5d
220
# ede9cca8c7a84f0199bcae5ea92f9a60
221
221
msgid "`position`"
224
224
#: ../../source/style.rst:132
225
# c9198a04d34d4f3da9554c303f73bc82
225
# adabb193adbc4795b81d41990a21e498
226
226
msgid "Positions are used to specify locations relative to the upper-left corner of the containing area. (For positions, the containing area is given by the layout the displayable is in, if one is given, or the screen otherwise. For anchors, the containing area is the size of the displayable itself.)"
229
229
#: ../../source/style.rst:138
230
# da4f2fb689ab472aa5dbd1167a398c07
230
# 21806a98865f4295a868591d5c8767be
231
231
msgid "The way a position value is interpreted depends on the type of the value:"
234
234
#: ../../source/style.rst:142
235
# 8940ba9bd3414bfba238e5b0dd764424
235
# 684532ed81544a0d9b3ea1e879dd0760
236
236
msgid "int (like 0, 1, 37, or 42)"
239
239
#: ../../source/style.rst:142
240
# 2cbe4335875b4c518b06ce1fd952df7d
240
# 6bb3cbea6eef4db7afae106637b64294
241
241
msgid "An integer is intepreted as the number of pixels from the left or top side of the containing area."
244
244
#: ../../source/style.rst:147
245
# cb19751071c74f309fba6d53603eaad3
245
# bce7433f75234fbd93218a98ab344abe
246
246
msgid "float (like 0.0, 0.5, or 1.0)"
249
249
#: ../../source/style.rst:145
250
# 0749b7ce97e940daa87a0341df206327
250
# 38ab67876c1d45fc97eaaf126769be27
251
251
msgid "A floating-point number is intepreted as a fraction of the containing area. For example, 0.5 is a point halfway between the sides of the containing area, while 1.0 is on the right or bottom side."
254
254
#: ../../source/style.rst:152
255
# ad7be05a3dbc4842999e2b282db6d64f
255
# fb367de884914e1489e6ef99d211df39
256
256
msgid "renpy.absolute (like renpy.absolute(100.25))"
259
259
#: ../../source/style.rst:150
260
# 3759214edd7640a1a40feadf3083e359
260
# 5bd6ea78f67842728898009c6e75b9d2
261
261
msgid "A renpy.absolute number is intepreted as the number of pixels from the left or top side of the screen, when using subpixel-precise rendering."
264
264
#: ../../source/style.rst:155
265
# 732dff4dca3f466c93f28d1efbda343c
265
# 9a258c1f94994dd3ad584b72d2dfc64e
266
266
msgid "`displayable`"
269
269
#: ../../source/style.rst:155
270
# b45e67e3d9cf4523a4e670948450b16e
270
# 823e6c73abdb41ada8f55757014b14c4
271
271
msgid "Any displayable."
274
274
#: ../../source/style.rst:177
275
# 3c67d766877e45268e1b772d54bc8878
275
# a98426f41a014524a7116a08f1699429
279
279
#: ../../source/style.rst:158
280
# 751e3018a26b4d8d8cb25c059fa6fb76
280
# a21777183e1f407a8f9d40dab5e5f881
281
281
msgid "Colors in Ren'Py can be expressed as strings beginning with the hash mark (#), followed by a hex triple or hex quadruple, with each of the three or four elements consisting of a one or two hexidecimal character color code."
284
284
#: ../../source/style.rst:163
285
# 61c336a85615482fb2b38c0410b19888
285
# e85900c0245a44838c4c61df52d382cc
286
286
msgid "In a triple, the components represent red, green, and blue. In a quadruple, the components represent red, green, blue, and alpha. For example:"
289
289
#: ../../source/style.rst:167
290
# 9f5138a4439b4087980b683331a0d59c
290
# 075c6bcb4b734e06bcba95966275c226
291
291
msgid "``\"#f00\"`` and ``\"#ff0000\"`` represent an opaque red color."
294
294
#: ../../source/style.rst:168
295
# b30bdd57e86541feb8dc64bc51a6bc32
295
# e40b1891ddc34960a01149bb75fd9e36
296
296
msgid "``\"#0f08\"`` and ``#00ff0080\"`` represent a semi-transparent green color."
299
299
#: ../../source/style.rst:171
300
# 6dbf8adf20e543239a79d68cab802c49
300
# 6ec09b267c454273b8ec78a20ce77e04
301
301
msgid "The color triples are the same as used in HTML."
304
304
#: ../../source/style.rst:173
305
# 3bc2f855c3434c50a8ea5cdbff4433ec
305
# 61765e2711e24280981eac8380223f3a
306
306
msgid "Colors can also be represented as a 4-component tuple, with the 4 components being integers between 0 and 255. The components correspond to red, green, blue, and alpha, in that order."
309
309
#: ../../source/style.rst:177
310
# b1376eb5ad82483cbb9299278acc5ab0
310
# 6cec18353a1d4f4b9e0b1ad8d259449d
311
311
msgid "``(0, 0, 255, 255)`` represents an opaque blue color."
314
314
#: ../../source/style.rst:180
315
# 51815526a1d448909dd5f61a4677c804
315
# 0e3583e0e2604a6393414d88b459d102
316
316
msgid "List of All Style Properties"
319
319
#: ../../source/style.rst:182
320
# dddcabd7f4bb4d3788d058d77f48c327
320
# 2087fa664a8843248cff1a5d4e11bc28
321
321
msgid "The style properties control the look of the various displayables. Not all style properties apply to all displayables, so we've divided them up into groups."
324
324
#: ../../source/style.rst:189
325
# 2dcd33b2fa1a475f9c9047e0a95af9bd
325
# ed1b8f70982d48d78621d365c1d2a85c
326
326
msgid "Position Style Properties"
329
329
#: ../../source/style.rst:191
330
# 488da4dfc8184155811c1b2219ce70bf
330
# 1a98ccebf144431b933abab6ba6a997f
331
331
msgid "These are used to control the position of a displayable inside the area allocated to it by a layout, or on the screen when not inside a layout."
334
334
#: ../../source/style.rst:196
335
# d5aa20a169374448925ee2e6510411fd
335
# 47db4a7d078544f8801b5e844ad29abb
336
336
msgid "The position of the displayable relative to the left side of the containing area."
339
339
#: ../../source/style.rst:201
340
# 4bb88f2004eb4e4cad32e37aec99cb9d
340
# 2e3b74ef68a3476c8c74b2acc15ca8ba
341
341
msgid "The position of the displayable relative to the right side of the containing area."
344
344
#: ../../source/style.rst:206
345
# 21f49b2134cf4d76b5b545f741f444fa
345
# 1563d03466c048de9cd072a1e3fde137
346
346
msgid "Equivalent to setting xpos to the first component of the tuple, and ypos to the second component of the tuple."
349
349
#: ../../source/style.rst:211
350
# a2ef5f454435421190e120ddea8b0c3b
350
# 5d4b8200970043949ef54a0343819c15
351
351
msgid "The position of the anchor relative to the left side of the displayable."
354
354
#: ../../source/style.rst:216
355
# 6eec7d80208f4883b4d9aa80d51c8ecf
355
# 9cc14c9d7988449ab85383e7827b580f
356
356
msgid "The position of the anchor relative to the top side of the displayable."
359
359
#: ../../source/style.rst:221
360
# 6a896dd7060e4b5aa646f7153b1ed7bc
360
# 5e8cad8c2f8f4f73ade51ee96941c5f5
361
361
msgid "Equivalent to setting xanchor to the first component of the tuple, and yanchor to the second component of the tuple."
364
364
#: ../../source/style.rst:226
365
# 759af39e37e14658a24fbcb720d89591
365
# 8cd13a7602f14204a3431b53cb2d49ae
366
366
msgid "Equivalent to setting xpos and xanchor to the same value. This has the effect of placing the displayable at a relative location on the screen, with 0.0 being the left side, 0.5 the center, and 1.0 being the right side."
369
369
#: ../../source/style.rst:233
370
# c5f18719894f402dae03879043d4c61e
370
# 640bf41bc3a74b8bb09a551f73fa38b3
371
371
msgid "Equivalent to setting ypos and yanchor to the same value. This has the effect of placing the displayable at a relative location on the screen, with 0.0 being the top, 0.5 the center, and 1.0 the bottom."
374
374
#: ../../source/style.rst:240
375
# 050af8a6a6b94c5d9954ea1eb1a7e693
375
# c655dfb8c765436a8d325b7530c136f0
376
376
msgid "Equivalent to setting xalign to the first component of the tuple, and yalign to the second."
379
379
#: ../../source/style.rst:245
380
# a51d202645ab42b392d1924ad9b0575e
380
# df54c071f56c400890f72e8f2d9a61c2
381
381
msgid "Equivalent to setting xpos to the value of this property, and xanchor to 0.5."
384
384
#: ../../source/style.rst:250
385
# a162a293b94f4cbca5730e6d9070a558
385
# b5b4d13930014bb4a1213902f7f08187
386
386
msgid "Equivalent to setting ypos to the value of tihis property, and yanchor to 0.5."
389
389
#: ../../source/style.rst:255
390
# b25770c232bd4ed3af77c914f87f31f6
390
# 3b11b138daca4a2b9531acc259ece20b
391
391
msgid "Gives a number of pixels that are added to the horizontal position computed using xpos and xalign."
394
394
#: ../../source/style.rst:260
395
# 4eda1be8791f450888ac9dfc7d35cda6
395
# 6484568cc6e94678b06d05489a5059d6
396
396
msgid "Gives a number of pixels that are added to the vertical position computed using ypos and yalign."
399
399
#: ../../source/style.rst:265
400
# 19612c0e29d34a279f3e7940c07c2b81
400
# c453a3dbfa874cb89b519c8baec17467
401
401
msgid "Specifies the maximum horizontal size of the displayable, in pixels."
404
404
#: ../../source/style.rst:269
405
# b1f7b678a93a44ab8494d795eb504491
405
# 7d73e3d44d9845dc9979c1b40559b8b0
406
406
msgid "Specifies the maximum vertical size of the displayable in pixels."
409
409
#: ../../source/style.rst:273
410
# a0d782c6af094eba9886fba5f1269c8f
410
# 0bae63fcbaaa4c2e8c8ec1edf19f2e33
411
411
msgid "Equivalent to setting xmaximum to the first component of the tuple, and ymaximum to the second."
414
414
#: ../../source/style.rst:278
415
# 5d59d03610bc42ffbc4daae61009f0e1
415
# 9d9b7af17fb445a09d4ae828a5cce6e7
416
416
msgid "Sets the minimum width of the displayable, in pixels. Only works with displayables that can vary their size."
419
419
#: ../../source/style.rst:283
420
# e60c2f025ff24bb1932b325885da7ee6
420
# 93d4bf3053da485c9af13c45c3eb8342
421
421
msgid "Sets the minimum height of the displayables, in pixels. Only works with displayables that can vary their size."
424
424
#: ../../source/style.rst:288
425
# 8573b73bb5e44ad5bd61e80af7bfa1ef
425
# 450fed95970c446196dfff4207c2825b
426
426
msgid "Equivalent to setting xminimum to the first component of the tuple, and yminimum to the second."
429
429
#: ../../source/style.rst:293
430
# 322fc2783a06413db8a4dd5739b50c65
430
# d7dff810ed924a37a21c75f7ce76e37d
431
431
msgid "If true, the displayable will expand to fill all available horizontal space. If not true, it will only be large enough to contain its children."
434
434
#: ../../source/style.rst:297
435
435
#: ../../source/style.rst:305
436
# 1bb000cceeb0440f82b6e86815c878bb
437
# 0b89c35437fc44779e45a9a0ab2f67d2
436
# 5e5aec0e677846138b725b746dfba6a6
437
# 64aaf3f5a6dc46fc9f6bf1a026040dac
438
438
msgid "This only works for displayables that can change size."
441
441
#: ../../source/style.rst:301
442
# 0312c443315d49f9ab4cdb07dc0330f5
442
# 32c00c6cd6374ca896c9f5eb2b001ec6
443
443
msgid "If true, the displayable will expand to fill all available vertical space. If not true, it will only be large enough to contain its children."
446
446
#: ../../source/style.rst:309
447
# c3d02da048ca4690b6f29be83a7f1e90
447
# 5d504c17dc8844a2b352ee042549f6f1
448
448
msgid "The tuple is interpreted as (`xpos`, `ypos`, `width`, `height`). Attempts to position the displayable such that it's upper-left corner is at `xpos` and `ypos`, and its size is `width` and `height`."
451
451
#: ../../source/style.rst:314
452
# a5fd786172464322bcba542a5737a6f2
452
# 807fab2e896b4fe09eeb05ec779986cf
453
453
msgid "It does this by setting the xpos, ypos, xanchor, yanchor, xmaximum, ymaximum, xminimum, yminimum, xfill, and yfill properties to appropriate values."
456
456
#: ../../source/style.rst:318
457
# 264fd63d3b0f420c99bade57c8887ee5
457
# 873669d52282407bb32d96bd8f4ab30f
458
458
msgid "This will not work with all displayables and all layouts."
461
461
#: ../../source/style.rst:324
462
# 9328ec40a53141a6aac65f4517ce1eb4
462
# a2133b27effb42219e231a4848c87d60
463
463
msgid "Text Style Properties"
466
466
#: ../../source/style.rst:328
467
# 39f4deec969040beb359a5d3909d3c79
467
# 0153e1d256a049fa95f2e03c4bbf6ebd
468
468
msgid "If True, the default, truetype font text will be rendered anti-aliased."
471
471
#: ../../source/style.rst:333
472
# f947d9bc648b4c59a8dd61def2cfa3a2
472
# e5d07408a7d546029de5cc981ec60ec5
473
473
msgid "When rendering an image-based font, black will be mapped to this color. This has no effect for truetype fonts."
476
476
#: ../../source/style.rst:338
477
# 93b8b5de64024bdc9f0f141d1986527a
477
# 681f8c7ac7d44a8599f6d8d2e445047b
478
478
msgid "If True, render the font in a bold style. For a truetype font, this usually involves synthetically increasing the font weight. It can also cause the font to be remapped, using :var:`config.font_replacement_map`."
481
481
#: ../../source/style.rst:345
482
# 85328385cd8d432d9b6b48b7aa7f6635
482
# fd3436238bc44a568ab18bf86608250c
483
483
msgid "If not None, this should be a displayable. The input widget will use this as the caret at the end of the text. If None, a 1 pixel wide line is used as the caret."
486
486
#: ../../source/style.rst:351
487
# 469bbb3b9c0f4d7e9ce14ee4f994fb78
487
# 538a333c626a4108bcfa38f974714b52
488
488
msgid "The color the text is rendered in. When using a truetype font, the font is rendered in this color. When using an image-based font, white is mapped to this color."
491
491
#: ../../source/style.rst:357
492
# eb07c78f5b1a4169bdd86f5d0c778aad
492
# 85a605a1fe2d4d40b85a95931e4cde33
493
493
msgid "The amount that the first line of text in a paragraph is indented by, in pixels."
496
496
#: ../../source/style.rst:362
497
# fc8510e0ef374f889ad74ff4f550c01d
497
# 1ed69bc6253549409f24cf525dd44594
498
498
msgid "A string giving the name of the font used to render text."
501
501
#: ../../source/style.rst:364
502
# 0386370c853e402993b66287f83eff73
502
# 23567aede27e476a93158e99372c5d27
503
503
msgid "For a truetype font file, this is usually the name of the file containing the font (like ``\"DejaVuSans.ttf\"``). To select a second font in a collection, this can be prefixed with a number and at sign (like ``\"0@font.ttc\"`` or ``\"1@font.ttc\"``). For an image-based font, this should be the name used to register the font."
506
506
#: ../../source/style.rst:373
507
# e6b8d1eea6b4498286779d44e3b78b2d
507
# 161aa11da5e04cc19abc048a54ca7a71
508
508
msgid "The size of the font on the screen. While this is nominally in pixels, font files may have creative interpretations of this value."
511
511
#: ../../source/style.rst:379
512
# d6b5ce4d48894fb1a9673ba002ee39d1
512
# 26aa0ef2da714d75b4bd17e77bafea2d
513
513
msgid "If true, the text will be rendered in italics. For a truetype font, this usually involves synthetically increasing the font slant. It can also cause the font to be remapped, using :var:`config.font_replacement_map`."
516
516
#: ../../source/style.rst:386
517
# a081008298244853a48c05314b8d0190
517
# 1f7cb788b5f24ff8bb0a7a5b537311e1
518
518
msgid "If true, additional whitespace is inserted between words so that the left and right margins of each line are even. This is not performed on the last line of a paragraph."
521
521
#: ../../source/style.rst:392
522
# 445d23da75ff457095ec825f7a5b88cf
522
# 36db2c7b26e54727aef9616778b901c1
523
523
msgid "A kerning adjustment, the number of pixels of space that's added between each pair of characters. (This can be negative to remove space between characters.)"
526
526
#: ../../source/style.rst:398
527
# 05db78e1827548dfaa20988cbc9b5eee
527
# 34a7a863a3264618bed995c6b59279d3
528
528
msgid "Controls the language family used to break text into lines. Legal values are:"
531
531
#: ../../source/style.rst:403
532
# cdfc8c37b11c43099ef7af7f39d6ebfd
532
# d34055ad4508441698f21476e4924f6b
533
533
msgid "``\"unicode\"`` (default)"
536
536
#: ../../source/style.rst:402
537
# 0f504a5bc0bf46239d4b65a46e9b40c4
537
# f50691bff9d74c75a4ca4b42267bb059
538
538
msgid "Uses the unicode linebreaking algorithm, which is suitable for most languages."
541
541
#: ../../source/style.rst:407
542
# 6e7363b0680647099690bb779a77a824
542
# 70f146dcf94144cebff465ad302018bd
543
543
msgid "``\"japanese-strict\"``"
546
546
#: ../../source/style.rst:406
547
# ac8c01a531734a4c8853020f95ea23b8
547
# e8513d4992ab4970b5dedca4d24582ca
548
548
msgid "Formats Japanese text in a \"strict\" manner. It forbids breaks before small kana and prolonged sound marks."
551
551
#: ../../source/style.rst:412
552
# b4ceeeccfb2549578f3bf5900b00bffb
552
# 036203d4515c46d98767a75527ff9616
553
553
msgid "``\"japanese-normal\"``"
556
556
#: ../../source/style.rst:410
557
# 44f3845f8f574176879a0f123afdfe70
557
# e7c4b11e8aec43feba0e813c0a2abc89
558
558
msgid "Formats Japanese text in a \"normal\" manner. It allows breaks before small kana, prolonged sound marks, and certain hyphens."
561
561
#: ../../source/style.rst:418
562
# 516db88bdcda4ba5bf8de4d7176af9f1
562
# df398139254e4da78d29eda4a047202d
563
563
msgid "``\"japanese-loose\"``"
566
566
#: ../../source/style.rst:415
567
# 9754e152f9b64566aa47c70f78e61ce4
567
# e0c8776b53bb49cea3d831f8c8b42d0d
568
568
msgid "Formats Japanese text in a \"loose\" manner. It allows breaks before small kana , prolonged sound marks, iteration marks, inseparable characters, centered punctuation marks, and postfixes; and allows breaks before prefixes."
571
571
#: ../../source/style.rst:422
572
# 981df69d5c4049cd912bceeb465a596f
572
# 7e7afbd31bcf475f93b3589f9c374610
573
573
msgid "``\"korean-with-spaces\"``"
576
576
#: ../../source/style.rst:421
577
# 15aedc46501b418b8d90429e7670dabb
577
# 6db934fa7e5a4283b2fd24a9b692258b
578
578
msgid "Used for Korean text delimited by whitespace. This prevents linebreaking between adjacent Korean characters."
581
581
#: ../../source/style.rst:426
582
# 3cee9ab9849b44c6b0e98f40819be30d
582
# 937939f6ed4e48b78b2e35654215421b
583
583
msgid "``\"western\"``"
586
586
#: ../../source/style.rst:425
587
# 2af51db421bf4eb4af5b18eabcbb4725
587
# 464336ff82c84ebbac8e7d663bdab1b1
588
588
msgid "Allows breaking only at whitespace. Suitable for most languages."
591
591
#: ../../source/style.rst:428
592
# 0f43cddcecc446cbb4794a7de5de688c
592
# c505097868da4868b8e0f3ebdbb2b285
593
593
msgid "The three Japanese breaking modes are taken from the `CSS3 text module <http://www.w3.org/TR/css3-text/#line-break>`_."
596
596
#: ../../source/style.rst:432
597
# 18c14a44de164c6e9618d78fd175b499
597
# 0c680d4a62814245a6148bc05673cf58
598
598
msgid "Controls how words are allocated to lines. Legal values are:"
601
601
#: ../../source/style.rst:436
602
# 15d39b86b8f8439793ff3c6122ada67b
602
# ff68636b98df433fbf8d04a0e7d01d8e
603
603
msgid "``\"tex\"`` (default)"
606
606
#: ../../source/style.rst:435
607
# ace6abe293c44a0e85ab645063093fc7
607
# 07e2e4c307e1469cb43f14a916e481ae
608
608
msgid "Uses the Knuth-Plass linebreaking algorithm, which attempts to minimize the difference in line lengths of all but the last line."
611
611
#: ../../source/style.rst:440
612
# 4293d5ba00714863ab002f8f88a13c9a
612
# 2d3b0bdb2daf487884e9fd4fc2e410cd
613
613
msgid "``\"subtitle\"``"
616
616
#: ../../source/style.rst:439
617
# 53ec3940cef94e1b82347ef4fe9f5868
617
# e885eaf74e2b4a00920a099c550ccbea
618
618
msgid "Uses the Knuth-Plass linebreaking algorithm, but attempts to even out the lengths of all lines."
621
621
#: ../../source/style.rst:443
622
# 69ccf2a485144d2d8dd270e4643d051f
622
# 6712aa5f19e1499cb43c117a7f873897
623
623
msgid "``\"greedy\"``"
626
626
#: ../../source/style.rst:443
627
# 63649ceabcc04fd08473a04f8ade895f
627
# 77b653c92d1644dea69fe044cf1ad0d3
628
628
msgid "A word is placed on the first line that has room for it."
631
631
#: ../../source/style.rst:445
632
# 2305cb105c9641999c5c832767cac52a
632
# dc320bd494ae4eff9cf3deb440d7b19b
633
633
msgid "``\"nowrap\"``"
636
636
#: ../../source/style.rst:446
637
# 18227d50235548aab75e6b4513f8d7ac
637
# 57de3b6ea13b4ef994c53d8e4c47c034
638
638
msgid "Do not line-break."
641
641
#: ../../source/style.rst:450
642
# f22a6ca8c2e64268bd10be8445462e01
642
# 93c2bfe4baff42d2826b60160768138f
643
643
msgid "The number of pixels of spacing to include above each line."
646
646
#: ../../source/style.rst:454
647
# 1e0ce8316a564a859c0672af5aac0c95
647
# 24b17a3b24b645be9993b0cfd53096fe
648
648
msgid "When in slow text mode, and two lines overlap, this many pixels of the overlap are allocated to the top line. Increase this if the bottoms of characters on the top line are clipped."
651
651
#: ../../source/style.rst:460
652
# edf0e11214da482592a6b2cd139a7b78
652
# b684416dc702471f8f44a83995c0465e
653
653
msgid "The number of pixels of spacing to include below each line."
656
656
#: ../../source/style.rst:464
657
# aac0e65f9d6f476abcbab0e681aa3546
657
# d56480a1330940d594ea759f72bc636f
658
658
msgid "Sets the minimum width of each line of that. If a line is shorter than this, it is padded to this length, with text_align used to specify where such padding is placed."
661
661
#: ../../source/style.rst:470
662
# b20a6eef36654135b0cb9ab5c81530d9
662
# 5c84e1f8fb2945928e872ead62a0deba
663
663
msgid "If true, the :propref:`first_indent` indentation is used after each newline in a string. Otherwise, the :propref:`rest_indent` indentation is used."
666
666
#: ../../source/style.rst:476
667
# d431ee52381645539cbeb80fa89f1156
667
# 439edd4d2daf433c812a5c1eb3432ff2
668
668
msgid "This is a list of outlines that are drawn behind the text. Each tuple specifies an outline, and outlines are drawn from back to front."
671
671
#: ../../source/style.rst:480
672
# 01686d11acb341ee8b52b2b17ec215e4
672
# 561c336170164c9fa2d838ce9ecb9b21
673
673
msgid "The list contains (`size`, `color`, `xoffset`, `yoffset`) tuples. `Size` is the amount the font is expanded by, in pixels. `Color` is the color of the outline. `xoffset` and `yoffset` are the amount the outline is shifted by, in pixels."
676
676
#: ../../source/style.rst:485
677
# 1e70f2d078804e69b1a9532393810727
677
# 421a3a8da1294fb788d06e76eca77bfe
678
678
msgid "The outline functionality can also be used to give drop-shadows to fonts, by specifiying a size of 0 and non-zero offsets."
681
681
#: ../../source/style.rst:488
682
# b29f0349d4fb4e4088b334811572238f
682
# a5d7b2828be74711ae85da27062b63e6
683
683
msgid "Outlines only work with truetype fonts."
686
686
#: ../../source/style.rst:492
687
# 5e0576cc8b3e4d0f9bf12f5cb545b9dc
687
# bf797dad9e3c44e58a392a843986943d
688
688
msgid "Specifies the number of pixels the second and later lines in a paragraph are indented by."
691
691
#: ../../source/style.rst:497
692
# 587bd61da2a2411899c7c8d38be41122
692
# b3afc9128eb44aea90c3d05d547d44aa
693
693
msgid "If not None, this should be a style object. The style that's used for ruby text."
696
696
#: ../../source/style.rst:502
697
# 40fd0e1d0c1a4e84b47562e81d1f4c7e
697
# cf98dbd9776a4fbeb97bfa6d4a36b42d
698
698
msgid "If a number, shows text at the rate of that many characters per second. If True, shows text at the speed taken from the \"Text Speed\" preference."
701
701
#: ../../source/style.rst:508
702
# d5be72b4d58d4b429963147bfedccf5e
702
# 12dddf192c4e426cb1a38c97968aef31
703
703
msgid "The speed of the text is multiplied by this number. This can be used to have a character that speeks at a faster-than-normal rate of speed."
706
706
#: ../../source/style.rst:514
707
# ae85ed7324f54bd0b4505fe1071a7a2e
707
# 35f65545cb9248479cabda39c2ec124c
708
708
msgid "If True, a line is drawn through the text."
711
711
#: ../../source/style.rst:518
712
# e72a9922164b44c39f7cdf47c0234c5d
712
# bedcc182ba684eefae537a7e4c1bc6aa
713
713
msgid "This is used when a line is shorter than the width of the text displayable. It determines how much of the extra space is placed on the left side of the text. (And hence, the text alignment.)"
716
716
#: ../../source/style.rst:522
717
# dd24a80e289046d8b80a04a69739bf8a
717
# 7735df218f6f4a22957d62ff10c6052a
718
718
msgid "0.0 will yield left-aligned text, 0.5 centered text, and 1.0 right-aligned text."
721
721
#: ../../source/style.rst:527
722
# 3d08eb54b9eb4c408143637b095f245b
722
# b222a47fffc64ee0b485fbd660d5f46a
723
723
msgid "If true, an underline will be added to the text."
726
726
#: ../../source/style.rst:531
727
# 80be663f975a49e4a74b0b124a654b2e
727
# d0f083d8170943e69540a11570e7841d
728
728
msgid "This is a tuple of three functions relating to hyperlinks in text."
731
731
#: ../../source/style.rst:533
732
# 62968d951d3543198a9e5374baf37e46
732
# f6cd404a3a524cc491d60b5136f6d3eb
733
733
msgid "The first item is the hyperlink style function. When called with a single argument, the argument of the hyperlink, it must return a style object to use for the hyperlink, such as ``style.hyperlink_text``. Note that a style object is not a string."
736
736
#: ../../source/style.rst:538
737
# 5318103eb50c4a00a639f9f331512b58
737
# c91014bc54b347c996097e76e6d4881a
738
738
msgid "The second item is the hyperlink clicked function. This function is called when a hyperlink is chosen by the user. If it returns a value other than None, the interaction returns that value."
741
741
#: ../../source/style.rst:542
742
# 6d4fc6a2c72c412aba6f2f07940f636f
742
# e1f9acb1c2ae4aa683b3fdd5a8a606cf
743
743
msgid "The third item is the hyperlink focus function. This function is called with the argument of the hyperlink when the hyperlink gains focus, and with None when it loses focus. If it returns a value other than None, the interaction returns that value"
746
746
#: ../../source/style.rst:549
747
# edd2dd69b7654f9581f0b6833c94b086
747
# f242252c278040c68868415b6ae435e6
748
748
msgid "If true, the text will be rendered vertically."
751
751
#: ../../source/style.rst:554
752
# 23823bd4d3aa49fa984b6505b16bb852
752
# 18554338893d43509628ce1128ac8db6
753
753
msgid "Window Style Properties"
756
756
#: ../../source/style.rst:556
757
# cee6957c39f8484f88fb68c7ffcd2f72
757
# fa387fb954ec4459b0441cbe161e16e6
758
758
msgid "Window properties are used to specify the look of windows, frames, and buttons."
761
761
#: ../../source/style.rst:560
762
# 04fda057a47f41b195bbe78b67f3be11
762
# 87cb706346ce430b8d459d8e88fb9666
763
763
msgid "A displayable that is used as the background of the window. This is often a :func:`Frame`, allowing the size of the background to scale with the size of the window."
766
766
#: ../../source/style.rst:564
767
# d1eaf4c2f9bc4dca838576cf313eff24
767
# a4103a4607c64f35932c0088bcb5cf7d
768
768
msgid "If None, no background is drawn, but other properties function as if the background was present."
771
771
#: ../../source/style.rst:569
772
# 4d5d8bec4c2642099d51f9045b872021
772
# cff53f92a03049498dde1dc18616164b
773
773
msgid "If not None, this displayable is drawn above the contents of the window."
776
776
#: ../../source/style.rst:574
777
# 6fce6f09b8ee4f219a91efde1351d6ef
777
# 6fd3f9e882fa407bb1a7e5832aa7af0c
778
778
msgid "The amount of transparent space to the left of the background, in pixels."
781
781
#: ../../source/style.rst:579
782
# 1dc149126e844b259ada983c0ba4365d
782
# 2db51df1efc8480d9d6fb7a0f96e5a6f
783
783
msgid "The amount of transparent space to the right of the background, in pixels."
786
786
#: ../../source/style.rst:584
787
# 10de364bdc014867938f8243289da07c
787
# b5988827a0fa4377a574bad518642234
788
788
msgid "Equivalent to setting left_margin and right_margin to the same value."
791
791
#: ../../source/style.rst:589
792
# 52bb2f6940254372a656deefe98c3aaa
792
# 1b5f6fadc34a424e8ace6d42ba4c5326
793
793
msgid "The amount of transparent space above the background, in pixels."
796
796
#: ../../source/style.rst:593
797
# cb1556d1aa384816b55def343c4ea26c
797
# 7ec300d07cd544589122d20107bb0960
798
798
msgid "The amount of transparent space below the background, in pixels."
801
801
#: ../../source/style.rst:597
802
# 42a010b635824c8ba96079afa5ed0cc0
802
# d104a276cbba4e92a2a16f1cd1cc4ef6
803
803
msgid "Equivalent to setting top_margin and bottom_margin to the same value."
806
806
#: ../../source/style.rst:602
807
# 3a55726421394c68aa59a98f82134dfe
807
# 5504a218eeed4ffe8cb5157818c7400f
808
808
msgid "The amount of space between the background and the left side of the window content, in pixels."
811
811
#: ../../source/style.rst:607
812
# ae9dcd6cde3c4500a52fdb47bf830b27
812
# 196963275afb43f28f65f5713f9da07d
813
813
msgid "The amount of space between the background and the right side of the window content, in pixels."
816
816
#: ../../source/style.rst:612
817
# cfda6c5997d54b8c9fee1809333eac79
817
# e89d93cf81934fca855786b5fd4860fa
818
818
msgid "Equivalent to setting left_padding and right_padding to the same value."
821
821
#: ../../source/style.rst:617
822
# b742f8cbff2e47bea83c48b0c28a1dc1
822
# f0e40dc53c3242f88ba3aad93c1209cc
823
823
msgid "The amount of space between the background and the top side of the window content, in pixels."
826
826
#: ../../source/style.rst:622
827
# b1b7e233557c49c4b868ddc0fcde81b1
827
# a5f838974ce9462c95bf418d4852bbdb
828
828
msgid "The amount of space between the background and the bottom side of the window content, in pixels."
831
831
#: ../../source/style.rst:627
832
# f9e5bb4aee4f4da397a18d7138749284
832
# d353582471174745bb2c231ee634b016
833
833
msgid "Equivalent to setting top_padding and bottom_padding to the same value."
836
836
#: ../../source/style.rst:632
837
# b506ebc9782f4c8d9e9b5e9b80abcf04
837
# e7035da687094057905ac09e8d2af5d9
838
838
msgid "If not None, this should be a string. Ren'Py will render all windows with the same size_group value at the same size."
841
841
#: ../../source/style.rst:639
842
# b483a2e544fb4c3b9c40bb3aeb625bff
842
# bdd95a8984bc47dea2d2aa7a08778cc8
843
843
msgid "Button Style Properties"
846
846
#: ../../source/style.rst:643
847
# 89e28fe19dd14a1e959ebd9eaba75e06
847
# 83cf54ea184f431b8a69ad319c993085
848
848
msgid "If not None, this gives a displayable that replaces the child of the button. For example, this (as insensitive_child) can be used to replace the contents of an insensitive button with an image that indicates the button is locked."
851
851
#: ../../source/style.rst:650
852
# 71e7c3130ca846ffa4d19543c2db0e40
852
# 27391cbb890f4961b242268a0925c6e6
853
853
msgid "A sound that is played when the button gains focus."
856
856
#: ../../source/style.rst:654
857
# 7257dedf1a744762af718eb157d0ce23
857
# 017ca7d4e5f949e6b4d6b3de177865dc
858
858
msgid "A sound that is played when the button is clicked."
861
861
#: ../../source/style.rst:658
862
862
#: ../../source/style.rst:755
863
# 868a5b16653b43c4b92f6317fde0fbd5
864
# 3b6294bbf1cb4c188a71af99a01470f8
863
# 8c30586abd12420399916db478b1528b
864
# 6b1ee0db680545ef87cf27de4ec09cdf
865
865
msgid "The mouse style that is used when the button is focused. This should be one of the styles in :var:`config.mouse`."
868
868
#: ../../source/style.rst:663
869
# dc9ee08c1c34403090bd30de3e3665e9
869
# 49f53b4996614709a5ef980effaa1e26
870
870
msgid "A mask that's used to control what portions of the button can be focused, and hence clicked on. If it's a displayable, then areas of the displayable that are not transparent can be focused. If it's True, then the button itself is used as the displayable (so non-transparent areas of the button can be focused.) Otherwise, the entire button can be focused."
873
873
#: ../../source/style.rst:674
874
# 3fd95677b8f441abb0ccbea2dc0abebc
874
# 20b7858aaee342eba33f39e2fb2dc9a6
875
875
msgid "Bar Style Properties"
878
878
#: ../../source/style.rst:676
879
# 2ebe992ae86f4e2caf25c0ff16b10bf3
879
# c6bcc99189754e5aadf5e5a0694db0e0
880
880
msgid "Bars are drawn with gutters on the left and right, that when clicked can cause the bar to move by a small amount. The remaining space is the portion of the bar that can change, with the amount on each side proportional to the bar's value as a fraction of the range."
883
883
#: ../../source/style.rst:681
884
# 29862e3ca1ec4a3c8e2982933ec9bc8e
884
# 15c76f125f584cc7807a96ba3454ee06
885
885
msgid "The thumb is an area in the center of the bar that can be dragged by the user."
888
888
#: ../../source/style.rst:683
889
# 36681fb9d7e549be8b2e658980b6921a
889
# 28c3209cabfd49ba89fdd62de6d3762c
890
890
msgid "When a bar is drawn, the thumb's shadow is drawn first. Then the left/bottom and right/top sides of the bar, followed by the thumb itself."
893
893
#: ../../source/style.rst:686
894
# e8ac882756e84c59837657277bfddccf
894
# 5af967289b6443fe9ed990ae943e0800
895
895
msgid "Note that the valid sides of a bar depend on the value of the bar_vertical property. If it's True, the top and bottom sides are relevant. Otherwise, the left and right sides are used."
898
898
#: ../../source/style.rst:692
899
# 613ba22dbd1b4d869d704e277eec86f0
899
# 41cd52ee641146608292164a9f347c24
900
900
msgid "If true, the bar has a vertical orientation. If false, it has a horizontal orientation."
903
903
#: ../../source/style.rst:697
904
# 14da17c71d504e4e9351cae0754218e6
904
# a14cd303b99c40d4a57236cf7b78c862
905
905
msgid "If true, the value of the bar is represented on the right/top side of the bar, rather than the left/bottom side."
908
908
#: ../../source/style.rst:702
909
# e5680f850ae74c81bd7bcea70078fda2
909
# 73bf86d203f44745a1f25fb16bb8245f
910
910
msgid "If true, we resize the sides of the bar. If false, we render the sides of the bar at full size, and then crop them."
913
913
#: ../../source/style.rst:707
914
# bcc87026904947a2bbf3e292c8adcc63
914
# 499d74cbd02a4e86a7bdb2987cc45469
915
915
msgid "The size of the gutter on the left side of the bar, in pixels."
918
918
#: ../../source/style.rst:711
919
# 6d3f68fe94ff44cc84eb7419a29a45b4
919
# d6335086a1a243f9835489f533381afc
920
920
msgid "The size of the gutter on the right side of the bar, in pixels."
923
923
#: ../../source/style.rst:715
924
# d6a89ffcbfa24be4b4b9337fa7cf8404
924
# fa0406af42ef405c98f24cbb93c30025
925
925
msgid "The size of the gutter on the top side of the bar, in pixels."
928
928
#: ../../source/style.rst:719
929
# 4e0bfd06d3d849d195e6aa81e612cea3
929
# 8eda7cc24a334d4f8fef579ccaa62d1f
930
930
msgid "The size of the gutter on the bottom side of the bar, in pixels."
933
933
#: ../../source/style.rst:723
934
# b26caa75044942ba86939735aae7b91f
934
# 61ad4b171cf042dca737845fe67464e3
935
935
msgid "The displayable used for the left side of the bar."
938
938
#: ../../source/style.rst:727
939
# 31f8cfb013ec424ea9cab112b0bab5b5
939
# 42755e2b7a974ef68d2c0ca3fa66eb0a
940
940
msgid "The displayable used for the right side of the bar."
943
943
#: ../../source/style.rst:731
944
# bf14ce2f3da445fc96f28b83cc1a9984
944
# 3ad8611391b74f74ae4d385613311b56
945
945
msgid "The displayable used for the top side of the bar."
948
948
#: ../../source/style.rst:735
949
# 584060461748499189c019a1f6e06b73
949
# 15d87b39a0994bd3be6529c8c80ab3d7
950
950
msgid "The displayable uses for the bottom side of the bar."
953
953
#: ../../source/style.rst:739
954
954
#: ../../source/style.rst:744
955
# 39d5050c058e46b0a9c8a1e0e806b38e
956
# 1f444d5e21d646b29dfc3882f130b923
955
# 8d9e582aa8ec4ad39e8aa6050b978741
956
# fa6ccab94879406b8ab1a878370213c0
957
957
msgid "If not None, this is a displayable that is drawn over the break between the sides of the bar."
960
960
#: ../../source/style.rst:749
961
# c33cc17f56b74c559b82dc93aa4f6b0d
961
# 597fbdac9f594a81bb01ceb61c58a697
962
962
msgid "The amount that by which the thumb overlaps the bars, in pixels. To have the left and right bars continue unbroken, set this to half the width of the thumb in pixels."
965
965
#: ../../source/style.rst:760
966
# 53f3a476c18c4a9795b35e1e57a31050
966
# d85c58d5d8ef4bac959c6e2fba9864e3
967
967
msgid "Controls what happens if the bar is unscrollable (if the range is set to 0, as is the case with a viewport containing a displayable smaller than itself). There are three possible values:"
970
970
#: ../../source/style.rst:765
971
# afd2c4eacd4648ddab4975b845c3748a
971
# 971c81e66cc647638320c45864c10b81
975
975
#: ../../source/style.rst:765
976
# 75493e4eafb64acdb5500cdc773d6955
976
# 9f9690144daf4684a9e96bb3e8223741
977
977
msgid "Renders the bar normally."
980
980
#: ../../source/style.rst:769
981
# d9fd1fe8fcb447ec845d4e1fa79163b0
981
# 4fa8e0ed24bc48c8b5bbbb3178c1909d
982
982
msgid "``\"insensitive\"``"
985
985
#: ../../source/style.rst:768
986
# 0a7559b345cc4dcd92582d4763230f98
986
# 168bb1005e2248b5a8826e1bec85feea
987
987
msgid "Renders the bar in the insensitive state. This allows the bar to change its style to reflect its lack of usefulness."
990
990
#: ../../source/style.rst:772
991
# 95b863aadc2744dd8dfed42fbefe2b72
991
# 997bcfc634374f09bcb944bc84bd3182
992
992
msgid "``\"hide\"``"
995
995
#: ../../source/style.rst:772
996
# 1580f2cf233248939ddca6fc26188dde
996
# 4fe2a22914b3481295d8ad355a6a259e
997
997
msgid "Prevents the bar from rendering at all. Space will be allocated for the bar, but nothing will be drawn in that space."
1000
1000
#: ../../source/style.rst:779
1001
# a1f5dde9553f43b3b45504f327f5f772
1001
# a95b2795b5304687b3043d5088e71528
1002
1002
msgid "Box Style Properties"
1005
1005
#: ../../source/style.rst:781
1006
# 7a99100b47c0462785f584419537700d
1006
# f226577dd4d24b8c920532843c700f1f
1007
1007
msgid "These are used for the horizontal and vertical box layouts."
1010
1010
#: ../../source/style.rst:785
1011
# 917c89540eed4ecf99cb1e27db422322
1011
# 3364a502568745e1a08a4e38fe2cb5eb
1012
1012
msgid "The spacing between members of this box, in pixels."
1015
1015
#: ../../source/style.rst:789
1016
# c922cddb2da843a8baf1d189d686d477
1016
# a2effaab87884650ac224174c00403aa
1017
1017
msgid "If not None, the spacing between the first and second members of this box, in pixels. This overrides the spacing property."
1020
1020
#: ../../source/style.rst:794
1021
# a458d19a96ca406184bb2814e3538c28
1021
# b6132a9a396145e4a89a2e4853ae5a84
1022
1022
msgid "If true, the placement of the items in the box will be reversed. When this is true, a hbox will be filled right-to-left, and a vbox will be filled bottom-to-top. This defaults to false."
1025
1025
#: ../../source/style.rst:800
1026
# 581bb7558da2488bb8b7c908455c6ba8
1026
# accd5958b7b84f4e82c69c49846efeb4
1027
1027
msgid "If true, then boxes will wrap when they reach the end of a line or column. If false (the default), they will extend past the end of the line."
1030
1030
#: ../../source/style.rst:805
1031
# adca5c344c5340d5886941d81a6d4118
1031
# 0c5c7dec50eb4a439b77eceae086b805
1032
1032
msgid "If false, the default, the items in the box will be draw first-to-last, with the first item in the box being below the second, and so on. If true, this order will be reversed, and the first item in the box will be above all other items in the box."
1035
1035
#: ../../source/style.rst:814
1036
# 96ddf02570fa4af4a89b805a1302e1c0
1036
# e2df3c644f4d4b84a7b11a079ec5107e
1037
1037
msgid "Fixed Style Properties"
1040
1040
#: ../../source/style.rst:816
1041
# 1f022446a9fb4ba48c670503f77b9803
1041
# 431b179829d94fe0bd2a3b62515b88c8
1042
1042
msgid "These are used with the fixed layout."
1045
1045
#: ../../source/style.rst:820
1046
# 83553a4dab3748e4a60674d41f8b6c7e
1046
# 10fe329763174fc79c8da55343511bba
1047
1047
msgid "If true, then the size of the fixed layout is shrunk to be equal with the size of the first item in the layout."
1050
1050
#: ../../source/style.rst:825
1051
# cc196fb7c34446b4b418e6010369f253
1051
# 83227352cc874301af16b7f19a275924
1052
1052
msgid "Creating New Named Styles"
1055
1055
#: ../../source/style.rst:827
1056
# 5b00528357b44fbca94a22075950c5b0
1056
# d131f4c3ad974f779a3bd98140c62613
1057
1057
msgid "Named styles exists as fields on the global ``style`` object. To create a new style, create an instance of the Style class, and assign it to a field on the ``style`` object.::"
1060
1060
#: ../../source/style.rst:835
1061
# 16068aef9e79450c99da87273d64f2f0
1061
# efbc86d175504af796574b7aa55fb2a3
1062
1062
msgid "Once created, a named style can be applied to displayables by supplying it's name, or the style object.::"
1065
1065
#: ../../source/style.rst:845
1066
# 4b1fc8a7f32a43129b4917c1a48ddef1
1066
# ac7150d6246a45a8ad0b0e642c287f40
1067
1067
msgid "Creates a new style object. Style properties can be assigned to the fields of this object."
1070
1070
#: ../../source/style.rst:850
1071
# 7da1af015e024a0caa104aeee4ff81eb
1071
# c08f24078dde41cba73a22a66cdcb040
1072
1072
msgid "`parent`"
1075
1075
#: ../../source/style.rst:849
1076
# 7bdf05038fa6466cbc6c778a82b3cb74
1076
# a5756b810a1f48078422fad4903b9135
1077
1077
msgid "The styles parent. This can be another style object, or a string."
1080
1080
#: ../../source/style.rst:854
1081
# e816bb197b8743ca81d6edd92494f505
1081
# eeca28396e354c818fa6932aad65e270
1082
1082
msgid "This removes all style properties from this object. Values will be inherited from this object's parent."
1085
1085
#: ../../source/style.rst:859
1086
# 4bafe703d65c4eb79960dd69a8a27155
1086
# dc09f3d6a9df46cdbde82bb7f2977690
1087
1087
msgid "Sets the parent of this style object to `parent`."
1090
1090
#: ../../source/style.rst:863
1091
# f61ea2a2318549209109a248416a5e54
1091
# 1287a1227c894819907dae0d144d337e
1092
1092
msgid "This takes all style properties from `other`. `other` must be a style object."
1095
1095
#: ../../source/style.rst:868
1096
# 26e8a9e63e404500adc735ac04a7829a
1096
# 4286acb7d20a4a86be98e0ca33cb1fd3
1097
1097
msgid "Indexed Styles"
1100
1100
#: ../../source/style.rst:870
1101
# d49f7846bc834eeea1ddcd7c3375105a
1101
# ceaa6aa9953a4567822688b86b1ef586
1102
1102
msgid "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.::"
1105
1105
#: ../../source/style.rst:879
1106
# 368ba94d81fb40b6b4cd63ab0a135498
1106
# b2efe3c22272485f8d86484891e04704
1107
1107
msgid "An index style is used by supplying the indexed style to a displayable.::"
1110
1110
#: ../../source/style.rst:888
1111
# b5080a630cbe47ce813d9b60d52c248d
1111
# ec95e568c08849d194f1acbacc661da1
1112
1112
msgid "Style Inheritance"
1115
1115
#: ../../source/style.rst:890
1116
# b3028d68ea444074b1cf970fb18b2925
1116
# a3ebbf0fbe18422d869259d637df4cdc
1117
1117
msgid "When a property is not defined by a style, it is inherited from the style's parent. When indexing is involved, properties are inherited first from the unindexed form of the style, then from the indexed form of the parent, then the unindexed form of the parent, and so on."
1120
1120
#: ../../source/style.rst:895
1121
# 8523958fc2ee44ff956ff688588b3d07
1121
# 97789dc563c0497ab8cf6678c0eec497
1122
1122
msgid "For example, when ``style.mm_button`` inherits from ``style.button``, which in turn inherits from ``style.default``, then the properties of ``style.mm_button[\"Start Game\"]`` are taken from:"
1125
1125
#: ../../source/style.rst:899
1126
# a2149692d69c4418a0885895c9b01aa3
1126
# 57796dd19ec0419583070b61b74e526f
1127
1127
msgid "``style.mm_button[\"Start Game\"]``"
1130
1130
#: ../../source/style.rst:900
1131
# 52c63422ef464ceeb1a8fcc7c70bfd24
1131
# fbd2f2ac153342a4bcf86ee4f415709e
1132
1132
msgid "``style.mm_button``"
1135
1135
#: ../../source/style.rst:901
1136
# 69059d7ed17d4a11ae0277fbb1d2e57e
1136
# c21a6f00a793435fb51088383a73fc9f
1137
1137
msgid "``style.button[\"Start Game\"]``"
1140
1140
#: ../../source/style.rst:902
1141
# a76866cc4d4e4fecbeb78440eb6f0670
1141
# d6d4392987024e308c8403478dffa464
1142
1142
msgid "``style.button``"
1145
1145
#: ../../source/style.rst:903
1146
# 9a6e55b6dc434eda85362a891666804c
1146
# 1ad1a3414c374529b680f6866dc0e3aa
1147
1147
msgid "``style.default[\"Start Game\"]``"
1150
1150
#: ../../source/style.rst:904
1151
# a0c1b683359140c7b03dfe43f2206c19
1151
# 2183d66b023a4362a15beadb64c2215c
1152
1152
msgid "``style.default``"
1155
1155
#: ../../source/style.rst:906
1156
# e99e6819be0f4bcaa043f8a6088b3b35
1156
# a8c053dc55914a639a40ca93de200b31
1157
1157
msgid "With the property value taken from the lowest numbered style with the property defined."
1160
1160
#: ../../source/style.rst:912
1161
# bf5092e0ca2443f2a50c4b64b0780051
1161
# 5defc427271343d0a5c32d140c8f76ac
1162
1162
msgid "Style Preferences"
1165
1165
#: ../../source/style.rst:914
1166
# 366618c506c14c5c997b880ee98a3eed
1166
# 97955acdc7dc42fb8312438a08c46a6f
1167
1167
msgid "It's often desireable to allow the user to customize aspects of the user interface that are best expressed as styles. For example, a creator may want to give players of his game the ability to adjust the look, color, and size of the text. Style preferences allow for this customization."
1170
1170
#: ../../source/style.rst:919
1171
# 0fe2a6514a3f4e73a7bd5644e6508a01
1171
# 6e69ade3c27a4453accef90be6ca6b74
1172
1172
msgid "A style preference is a preference that controls one or more style properties. A style preference has a name and one or more alternatives. At any given time, one of the alternatives is the selected alternative for the style preference. The selected alternative is saved in the persistent data, and defaults to the first alternative registered for a style property."
1175
1175
#: ../../source/style.rst:925
1176
# a73c98ef6e90436db6399161bbd94580
1176
# 01c19af24fe145a299a596cecc3f1bcd
1177
1177
msgid "An alternative has one or more associations of style, property, and value associated with it, and represents a promise that when the alternative becomes the selected alternative for the style preference, the property on the style will be assigned the given value. This occurs when Ren'Py first initializes, and then whenever a new alternative is selected."
1180
1180
#: ../../source/style.rst:931
1181
# 424ea039310c476ca19752030d49ec12
1181
# 45e590dde7734e4aa249658ef09192a4
1182
1182
msgid "One should ensure that every alternative for a given style preference updates the same set of styles and properties. Otherwise, some styles may not be assigned values, and the result will not be deterministic."
1185
1185
#: ../../source/style.rst:935
1186
# faebcb6fde2649f4996c16398bb6df87
1186
# 4623abec019d4aa8ab511511f32b96ff
1187
1187
msgid "The style preference functions are:"
1190
1190
#: ../../source/inc/style_preferences:5
1191
# 5712f23be0ee44bb9d9ffd2490e1f3f1
1191
# 7c13a3951a29433a9133b1b1ce9560de
1192
1192
msgid "An action that causes `alternative` to become the selected alternative for the given style preference."