17
17
"Content-Transfer-Encoding: 8bit\n"
19
19
#: ../../source/screen_actions.rst:8
20
# 2acb2d9bdfdd4cdfbaee14710406195e
20
# e4e51cde448c45c5967f5ddcb90bac17
21
21
msgid "Screen Actions, Values, and Functions"
24
24
#: ../../source/screen_actions.rst:10
25
# 1704426bbf634f22ad6c64c78b624e0b
25
# d3b5d1abab9f49e4b4a749e5d63c3724
26
26
msgid "Ren'Py ships with a number of actions, values, and functions intended for use with screens and the screen language."
29
29
#: ../../source/screen_actions.rst:14
30
# b0bf280b2a7b4ad9b3a74b9eb0135040
30
# cedc2346158d46fc886ded089959b2f3
34
34
#: ../../source/screen_actions.rst:16
35
# 0364ba95359848c2b3bec4711335310c
35
# 20338e475c634684976e134e72613486
36
36
msgid "Actions are invoked when a button (including imagebuttons, textbuttons, and hotspots) is activated, hovered, or unhovered. Actions may determine when a button is selected or insensitive."
39
39
#: ../../source/screen_actions.rst:21
40
# 491b7b5c52334745904d11491df39b9d
40
# e76d7b4d83224591aeae4779890586ba
41
41
msgid "Along with these actions, an action may be a function that does not take any arguments. The function is called when the action is invoked. If the action returns a value, then the value is returned from an interaction."
44
44
#: ../../source/screen_actions.rst:26
45
# c34277fda3da47fbafad246a5a8ce358
45
# 132a082a4e994397a4e1188d799a6c9d
46
46
msgid "An action may also be a list of actions, in which case the actions in the list are run in order."
49
49
#: ../../source/screen_actions.rst:30
50
# db8ecb54e0ae4ed8b5bc0fab831c0954
50
# 0cee9305e2204c87b87364735c542944
51
51
msgid "Control Actions"
54
54
#: ../../source/screen_actions.rst:32
55
# e34e7852d4e44053ad0ab4539f04b577
55
# e08164cbbb394245ba55ab09ca6d323e
56
56
msgid "These are actions that manage screens, interaction results, and control flow."
59
59
#: ../../source/inc/control_action:5
60
# a0e0c2510a63429dae65f6db09a159d4
60
# 39bb25193d6d4df5b1990de23f3601ce
61
61
msgid "This causes the screen named `screen` to be hidden, if it is shown."
64
64
#: ../../source/inc/control_action:7
65
# 5da52d8c0e174fef8261c3ae4875dc9b
65
# 863e20070ef747ee9e30669b457c575f
66
66
msgid "`transition`"
69
69
#: ../../source/inc/control_action:8
70
# 0f21ec4f01fd40c8a9b288e52383fed2
70
# 117424a442d34246ab7f05d9f760efd9
71
71
msgid "If not None, a transition that occurs when hiding the screen."
74
74
#: ../../source/inc/control_action:12
75
# 532ea551baa448bb8c65f469d3816e4b
75
# 0013a70ac55b4eb7a3fe309a8ffd3ccf
76
76
msgid "Causes control to transfer to the given label. This can be used in conjunction with renpy.run_screen to define an imagemap that jumps to a label when run."
79
79
#: ../../source/inc/control_action:18
80
# 0d5b40d3fff545af842a6242d9819b0a
80
# 521fb6eb9e1c454e89053a315ea708eb
81
81
msgid "Does nothing."
84
84
#: ../../source/inc/control_action:20
85
# 2ecad7f5b451490e9bf1d8f4efcbdc66
85
# 04acfe485af5498fa0f417cf3aa2ad60
86
86
msgid "This can be used to make a button responsive to hover/unhover events, without actually doing anything."
89
89
#: ../../source/inc/control_action:25
90
# 702de1a8152943e685ad1525b488e2c0
90
# e345ef136cac4a599e72f5430ef8c19c
91
91
msgid "Causes the current interaction to return the supplied value. This is often used with menus and imagemaps, to select what the return value of the interaction is."
94
94
#: ../../source/inc/control_action:29
95
# 63a478dfb98c410486ba49e94d3c8356
95
# 0c1cb115776646a2918636484701bb51
96
96
msgid "When in a menu, this returns from the menu."
99
99
#: ../../source/inc/control_action:33
100
# bf727c8dea69421687b1794f177d86df
100
# a1aa8a475edb457dbfec541994da6ea1
101
101
msgid "This causes another screen to be shown. `screen` is a string giving the name of the screen. The keyword arguments are passed to the screen being shown."
104
104
#: ../../source/inc/control_action:37
105
# 37e2be4bde2c44eeab96dea2e504c994
105
# d56153679b244191a4aca6171c02f56a
106
106
msgid "If not None, `transition` is use to show the new screen."
109
109
#: ../../source/inc/control_action:41
110
# d6aa3f07f1f540cf84add736a984c947
110
# eaf85ec55006486b999ac5ad7e0f6949
111
111
msgid "Shows a transient screen. A transient screen will be hidden when the current interaction completes."
114
114
#: ../../source/screen_actions.rst:37
115
# 47c38e8cbfc946f9a475cd5ce90e6657
115
# 1649c399a4ea4f18b20d4545f6315155
116
116
msgid "Data Actions"
119
119
#: ../../source/screen_actions.rst:39
120
# c0be187d520c45f4a2200de57bcc8ba2
120
# afcbb0a6fa4f4daaad1354064c90a42a
121
121
msgid "These set or toggle data."
124
124
#: ../../source/inc/data_action:5
125
# 5baef9a710de4d6e812f9a7d89c95646
125
# bc8adb26eabc4e509ff663ce48064cf0
126
126
msgid "Causes the value of `key` in `dict` to be set to `value`."
129
129
#: ../../source/inc/data_action:9
130
# c78d2e3353f04973af421cb35607d497
130
# c7dd788ca89f4b92a580f1fc4bbc1868
131
131
msgid "Causes the a field on an object to be set to a given value. `object` is the object, `field` is a string giving the name of the field to set, and `value` is the value to set it to."
134
134
#: ../../source/inc/data_action:15
135
# 5c8f275635354aa09b2fe9acd3229ecb
135
# 2924b67493924fec95596a1dbe40ae37
136
136
msgid "Causes the variable `name` associated with the current screen to be set to `value`."
139
139
#: ../../source/inc/data_action:20
140
# 911a5e110b7546c690d55e3009b77715
140
# 2b6091fd4d404725b8a214c4dc2d4bab
141
141
msgid "Causes `variable` to be set to `value`."
144
144
#: ../../source/inc/data_action:24
145
# e256ccd9393a47a0a2abe16cdf882045
145
# bc41327af5174efdb3b126246e444707
146
146
msgid "Toggles the value of `key` in `dict`. Toggling means to invert the value when the action is performed."
336
336
#: ../../source/inc/file_action:36
337
337
#: ../../source/inc/file_action:88
338
338
#: ../../source/inc/file_action_function:88
339
# 2b8690ca7764412cb17ae5a2a7a513e7
340
# 0d4f20628f324167beef3bc1f116a6be
341
# 4bd26c29c6624f31b35f45ec2502f603
342
# 04d10e19e9734a628bb51704dcf3c8b6
343
# 86176364f7b3425caac3d2bceb77b892
339
# 46aba46d474c434fbec347aacdbe1940
340
# 7eae6ab48aae491187ecf1d455cc46f9
341
# 41d6c7ba88df4b079826a271a070a307
342
# 2337fe67412046189de1ec9cdb5b7399
343
# ebbe9254793b499d84aad55b5d321d00
347
347
#: ../../source/screen_actions.rst:62
348
# 1d42d15985604cf1a1ebf3955f6f76cf
348
# 1791ba0e565849028166a727ed9f5f2f
349
349
msgid "The page that this action acts on. This is one of \"auto\", \"quick\", or a positive integer. If None, the page is determined automatically, based on a persistent page number."
352
352
#: ../../source/inc/file_action:5
353
# 5a260cc2a3a94e9e943f1613f1b9a014
353
# f161cf4274e3478c952f87836311c397
354
354
msgid "\"Does the right thing\" with the file. This means loading it if the load screen is showing, and saving to it otherwise."
357
357
#: ../../source/inc/file_action:9
358
# 85af4d5ee15c450dbd9927744d5a9f9c
358
# 62adda5baf2c416ca5b837bb108be657
359
359
msgid "The name of the slot to save to or load from. If None, an unused slot (a large number based on the current time) will be used."
362
362
#: ../../source/inc/file_action:13
363
# 197a47c8f2284bb1a24e76def60c1d93
363
# 8c76f6993bc74f0990199ebe8e847a0a
364
364
msgid "The page that the file will be saved to or loaded from. If None, the current page is used."
367
367
#: ../../source/inc/file_action:18
368
# 8e5e815749ad460fa50c1e75d01b7346
368
# 828a78b569ae465fbadf67a64cf36451
369
369
msgid "Deletes the file."
372
372
#: ../../source/inc/file_action:21
373
# adc70657680a4b3a94964c58df2e0808
373
# 836e504435404c95bfa2ce9906fa37f2
374
374
msgid "If true, prompts before deleting a file."
377
377
#: ../../source/inc/file_action:25
378
# 342ea1c4b4074614a478270a415e6d69
378
# c46ee6dc90b840308fc51274c572abf7
379
379
msgid "Loads the file."
382
382
#: ../../source/inc/file_action:28
383
# 726c381e824f4ec1a03bfd551b18a9f0
383
# 20fff23d85e24ab59c8ee51b94bf0352
384
384
msgid "The name of the slot to load from. If None, an unused slot the file will not be loadable."
387
387
#: ../../source/inc/file_action:32
388
# 8e445f8e021147739df34df674eb8ede
388
# c4649187556c481aa66a3bc4701392d4
389
389
msgid "If true, prompt if loading the file will end the game."
392
392
#: ../../source/inc/file_action:35
393
# 77ca60422d5741fdb37968ab37e95f85
393
# 3ff3b65bf2d8415897d76a703032f0ac
394
394
msgid "The page that the file will be loaded from. If None, the current page is used."
397
397
#: ../../source/inc/file_action:38
398
398
#: ../../source/inc/file_action:84
399
399
#: ../../source/inc/file_action:111
400
# 5ce5b7f0143a4402b9b0719dbf65000b
401
# 1c8b2398adfc4891853835a58f791706
402
# 6b3473e8dc7e45258ea5981bded40667
400
# 489330d533224d1da6dcd2334ecbbff1
401
# b82dca0446904488afad953cd2b83b3a
402
# ca41f046f15b4ee491f0c54fd0bd5f8e
406
406
#: ../../source/inc/file_action:39
407
# 672b5a9e3f0347a6b0bcdb3b4b7f1da2
407
# 0aacd62d148d433eb5661aad45113f57
408
408
msgid "If true, the button is selected if this is the newest file."
411
411
#: ../../source/inc/file_action:43
412
# 0d5769884d86490d9da35a0a86faeae2
412
# 5cbc4f3727cf4b6d9519c854f1d76962
413
413
msgid "Sets the file page to `page`, which should be one of \"auto\", \"quick\", or an integer."
416
416
#: ../../source/inc/file_action:48
417
# 37c34e82b4b1453ca7f216c255451e53
417
# 4db5f9f196f948c8b292a9557b887adf
418
418
msgid "Goes to the next file page."
421
421
#: ../../source/inc/file_action:52
422
422
#: ../../source/inc/file_action:64
423
# f964699a71d54e27b98d97d9836d34f5
424
# ede922b5c0364432a89b134b8d5ebb34
423
# a48c8c93266d43919da6e46ebddfc03b
424
# 0d4e619b33b84b4995c5f06ecac1134c
428
428
#: ../../source/inc/file_action:51
429
# c488abba1d5041299e2514f74544610f
429
# 0499de72e1d648b19094b3f104cd13cc
430
430
msgid "If set, this should be an integer that gives the number of the maximum file page we can go to."
433
433
#: ../../source/inc/file_action:54
434
434
#: ../../source/inc/file_action:66
435
# 72d60a7757844136864aac5046892a87
436
# 4eb764e591fa4292963c5e940df58d6b
435
# 7efd6ccc043e4c14927fd6a0d3bfed02
436
# 653c1591a06345d9b99620a5a223bb66
440
440
#: ../../source/inc/file_action:55
441
# efc66a166ad34648a8e0917d59eb363d
441
# d9ee917c10a9428c83caf8d64be4d2a3
442
442
msgid "If true, we can go to the first page when on the last file page if max is set."
445
445
#: ../../source/inc/file_action:59
446
# 2bb52f0a763846528718843364ef1fe5
446
# 066419c6389848b1b116bb56786fec26
447
447
msgid "Goes to the previous file page, if possible."
450
450
#: ../../source/inc/file_action:62
451
# 2bc02fd43c804dcc86bbb20363bf97d2
451
# ba7576bec7614fe995fdd9a9a18cbd6f
452
452
msgid "If set, this should be an integer that gives the number of the maximum file page we can go to. This is required to enable wrap."
455
455
#: ../../source/inc/file_action:67
456
# e0614aafe1d54291989ab07180a5467a
456
# 33911d26ca1a4098a8a11076d5e0ba79
457
457
msgid "If true, we can go to the last page when on the first file page if max is set."
460
460
#: ../../source/inc/file_action:71
461
# cb098c2ff71b4a16acb9e56d8fde9da7
461
# 5ed60680702c49e499b9de3f7ec09d40
462
462
msgid "Saves the file."
465
465
#: ../../source/inc/file_action:73
466
# f65892931fb2444baa45829e5850d536
466
# 5396e88896614a07b7ca3685258e5fc0
467
467
msgid "The button with this slot is selected if it's marked as the newest save file."
470
470
#: ../../source/inc/file_action:77
471
# 7738491014e0483b901f2f58099543c4
471
# 54beb7eeccf14f4488422fca263ada81
472
472
msgid "The name of the slot to save to. If None, an unused slot (a large number based on the current time) will be used."
475
475
#: ../../source/inc/file_action:81
476
# eb2ec6f72a954b2a9f56c4d5e2bbefac
476
# 25dbc1d5934f4243af338c4af1a1291d
477
477
msgid "If true, then we will prompt before overwriting a file."
480
480
#: ../../source/inc/file_action:84
481
# 8c791901b83c4d538d830db20f101f28
481
# aa3461df4e184795a5f3fb65f187de21
485
485
#: ../../source/inc/file_action:87
486
# 654e1fea9c0546dda96a2314ba263a8a
486
# 49b5793b6ebe436ba21d673690c12285
487
487
msgid "The name of the page that the slot is on. If None, the current page is used."
490
490
#: ../../source/inc/file_action:91
491
# 057e5a9eb4db4a2fbda2275e7a4c1952
491
# e145d9869ca44380a2266ced402bc414
495
495
#: ../../source/inc/file_action:91
496
# b9c03dbc00044bf29f018ab19ea7c9be
496
# 34a8526f8d0d4743a6bf83c5dc591b95
497
497
msgid "If true, then saves on the supplied page will be cycled before being shown to the user."
500
500
#: ../../source/inc/file_action:96
501
# bb6e44632b1640978a4e1c48b3e49b51
501
# cbb700b70e4b4fde91260283e068b521
502
502
msgid "Take a screenshot to be used when the game is saved. This can be used to ensure that the screenshot is accurate, by taking a pictue of the screen before a file save screen is shown."
505
505
#: ../../source/inc/file_action:102
506
# a98945f2a85d47cbbbe1bfc1cde00236
506
# 9a4f0a72651641b2b552bca3c8ea3269
507
507
msgid "Performs a quick load."
510
510
#: ../../source/inc/file_action:106
511
# b33d3425f5c144cfb479ae2a3cba71b1
511
# 625a35eb4ce44ee385773348250d7154
512
512
msgid "Performs a quick save."
515
515
#: ../../source/inc/file_action:109
516
# 6ad71e7260834f8e9573eb7252b8fc0a
516
# 15e5cfe86c694858a72e54f0d9a5ce31
517
517
msgid "`message`"
520
520
#: ../../source/inc/file_action:109
521
# b68a2744cf45476ab89781e9552fb936
521
# 3d437023c95d491a840863ef4214332c
522
522
msgid "A message to display to the user when the quick save finishes."
525
525
#: ../../source/inc/file_action:112
526
# 26692a18a84c4a1bb97474f50704d01f
526
# c84f6eb566c04af8bd9c25b75188c554
527
527
msgid "Set to true to mark the quicksave as the newest save."
530
530
#: ../../source/screen_actions.rst:69
531
# 26f72b0c772e4639bbe902561a4ee3c8
531
# a35ec9381d704852af45e5675c087a55
532
532
msgid "Audio Actions"
535
535
#: ../../source/inc/audio_action:5
536
# 2e5a538f26e04cd6a5b30d235ee8475b
536
# 35e53f4d193e4f85ab88e9bae6e0c53b
537
537
msgid "Causes an audio file to be played on a given channel."
540
540
#: ../../source/inc/audio_action:7
541
541
#: ../../source/inc/audio_action:18
542
542
#: ../../source/inc/audio_action:41
543
# 2b90bbd63d6f49dc9b5f273c252f23bd
544
# fa685537646a41c6af1dc5e6cf8ff4b3
545
# d3c8b903d7704194845dfd94115a7036
543
# af0d5694e00f43a58de9cfa0a610edba
544
# 48e0a9afe68a442f9b1ed07f5b7b90a2
545
# cff2ce2c5037415ea28e87d1965d7a32
546
546
msgid "`channel`"
549
549
#: ../../source/inc/audio_action:8
550
550
#: ../../source/inc/audio_action:19
551
# b7f6fbf833f94c2bba48dddede355f07
552
# 63ff856c414a4bf3b81ef085ee0c8b48
551
# bcfb6f1288714012a4d0728c6834788b
552
# 5d9c42dab6bf4810b709d900d7ece3bf
553
553
msgid "The channel to play the sound on."
556
556
#: ../../source/inc/audio_action:10
557
557
#: ../../source/inc/audio_action:21
558
# 347b2783e4344d2588e507d7727cb034
559
# 3bc5449f804a40399afb3bdda3e5a960
558
# f22a084fec604455922e361a9995996e
559
# 00476c36962642bfb5bc77581d3ec32d
563
563
#: ../../source/inc/audio_action:10
564
564
#: ../../source/inc/audio_action:21
565
# 95f7ad7f387b454eaccb5d009714b06c
566
# 12b7e9935f3247c291f7d8ca7aab13d6
565
# 4b1d463febfa4559a4a2c73f559453ac
566
# e5f8953cf2864f7cb4835886b996154f
567
567
msgid "The file to play."
570
570
#: ../../source/inc/audio_action:12
571
# dce416ad77144d3fb727f9bdb83ccee6
571
# 0e2f4a9546234bca95cb440ecea280d3
572
572
msgid "Any keyword arguments are passed to :func:`renpy.music.play`"
575
575
#: ../../source/inc/audio_action:16
576
# c0dd7bc7cf734474a0d92428ad12d5ed
576
# c41c88607c924dc8a2dd3ba2f23ea1e2
577
577
msgid "Causes an audio file to be queued on a given channel."
580
580
#: ../../source/inc/audio_action:23
581
# f7af9c98404b43119ab46209faf08c55
581
# de048355f088455d89de35b4140590a6
582
582
msgid "Any keyword arguments are passed to :func:`renpy.music.queue`"
585
585
#: ../../source/inc/audio_action:27
586
# 305e2db2352644e6bbe779d6e7a746cd
586
# e48e9f5e89724243b04f486ee99c9b90
587
587
msgid "Sets the volume of `mixer` to `value`."
590
590
#: ../../source/inc/audio_action:30
591
591
#: ../../source/inc/value:55
592
# 3db8c7f54f2e489db0a52f0b222daf69
593
# d3d8e63b3f6d46e3b0077e735bb164ac
592
# b20123bdf1444c66a6d1682d1740fc1a
593
# fdd1be8c1b2141a0a165ea967fdb4c98
597
597
#: ../../source/inc/audio_action:30
598
# d4ce69c975964321979fd14f7ef848d1
598
# 3c63c2325d664c0aa472e003bd3bcfdd
599
599
msgid "The mixer to set the volume of. A string, usually one of \"music\", \"sfx\", or \"voice\"."
602
602
#: ../../source/inc/audio_action:33
603
603
#: ../../source/inc/value:9
604
604
#: ../../source/inc/value:63
605
# ce7f5138cae14eb3b4b40927260ce9f8
606
# 7bee7f22430d4be8adcd9a2fe3ede891
607
# 2114ead846ea41a8a8287019e0e767e6
605
# 0c07ea6ec6484a098ce9111ed7bd5522
606
# 7afe01d864484d6f94418ec1d655e81b
607
# 46750ec854af47468577165bfe99f993
611
611
#: ../../source/inc/audio_action:33
612
# 220fe46537d94597972f6adc3dc88642
612
# c81a5e2bbf6d4f1891d10a7ba2540fb7
613
613
msgid "The value to set the volume to. A number between 0.0 and 1.0, inclusive."
616
616
#: ../../source/inc/audio_action:38
617
# b00e87fc314a43ffa58c7a9c63fc0dad
617
# 128260cf63224cef9093ec5eb91683cf
618
618
msgid "Causes an audio channel to be stopped."
621
621
#: ../../source/inc/audio_action:41
622
# 61a0d55443b84d46ad4008a70d54b000
622
# d3fb9fd5a24f4a1ab799054befd51dfc
623
623
msgid "The channel to stop the sound on."
626
626
#: ../../source/inc/audio_action:43
627
# cd1551a024d94841bdf8dadf619db79c
627
# 21d63e0923e44b5eba31e95b15dc7696
628
628
msgid "Any keyword arguments are passed to :func:`renpy.music.stop`"
631
631
#: ../../source/screen_actions.rst:74
632
# 0d6559af6716403a9b6b27c6397d7fc0
632
# 89d77712a42a49a285335c258db8789a
633
633
msgid "Other Actions"
636
636
#: ../../source/screen_actions.rst:76
637
# b6fdc9fff30743c8ac11b8733ad716d4
637
# ed5e2b3a49764d10a1dc09a0b29e1baf
638
638
msgid "These are other actions, not found anywhere else."
641
641
#: ../../source/inc/other_action:5
642
# b7c5eef82d39458aa21af8e1172f8928
642
# 88a0b027f1de490194a52ff99acdac60
643
643
msgid "Displays help."
646
646
#: ../../source/inc/other_action:11
647
# 7b9f88413eed4c94ae76a56eda7e2919
647
# 3e485dd88eb746d890b52d378ce2948f
651
651
#: ../../source/inc/other_action:8
652
# 37d4788247694732b143ad8beff268bd
652
# bdeb669a43c54e0390cae60afeb2a4f5
653
653
msgid "If this is a string giving a label in the programe, then that label is called in a new context when the button is chosen. Otherwise, it should be a string giving a file that is opened in a web browser. If None, the value of config.help is used in the same wayt."
656
656
#: ../../source/inc/other_action:16
657
# a9950c7120ce479dbf9fb1bad6de4e7c
657
# f3a9d72dc7c14edf9885de68d4c355c0
658
658
msgid "This returns `true` if `expression` is true, and `false` otherwise. Use this to select an action based on an expression. Note that the default, None, can be used as an action that causes a button to be disabled."
661
661
#: ../../source/inc/other_action:23
662
# bf2bc89fc6f5417aa7deb2f371df1262
662
# 8aa985ada44f41aeb53aa4f4140e40dd
663
663
msgid "This inverts the selection state of the provided action, while proxying over all of the other methods."
666
666
#: ../../source/inc/other_action:28
667
# 92a5f65d043d4bcbb265b92ec839ac7f
667
# 0609fd5baff34c81bff2214dfcb4ea69
668
668
msgid "Displays `message` using :func:`renpy.notify`."
671
671
#: ../../source/inc/other_action:32
672
# 96e6555348a947238e07b57e6d60be4e
672
# 644594a8ff754d3c94c982f91888e18c
673
673
msgid "Causes `url` to be opened in a web browser."
676
676
#: ../../source/inc/other_action:36
677
# d93c2b36f23d4bc28aaa18c09ef924e2
677
# a19dc6d6c8b54625a5061e83efb3d77b
678
678
msgid "This action causes a rollforward to occur, if a roll forward is possible. Otherwise, it is insensitive."
681
681
#: ../../source/inc/other_action:41
682
# f0ee1beddd4045cea7b34f39b0a89c16
682
# 90e8d0ff2a32440ea43c6cb8964b3b0b
683
683
msgid "This action causes a rollback to occur, when a rollback is possible. Otherwise, nothing happens."
686
686
#: ../../source/inc/other_action:46
687
# 15a1a4226e854a3dbdb8baa91cd7a7cd
687
# beb55ad373a2435bbead974354aa7fce
688
688
msgid "Takes a screenshot."
691
691
#: ../../source/inc/other_action:50
692
# bc62c9e2fd9a47359a6db1fa5bb0ad10
692
# 7780e6fbd6ed406582bb12eb0cf712a5
693
693
msgid "This allows an expression to control if a button should be marked as selected. It should be used as part of a list with one or more actions. For example::"
696
696
#: ../../source/inc/other_action:60
697
# 652bc90a716d43009eb7f08f58650ca0
697
# 2050621d94a242bc95d809092308af76
698
698
msgid "Causes the game to begin skipping. If the game is in a menu context, then this returns to the game. Otherwise, it just enables skipping."
701
701
#: ../../source/inc/other_action:65
702
# 56fa4d1e71534298b2619ea6dcf6d38b
702
# 7ad99b46c77f4a8da7f9e3e138b0b57b
706
706
#: ../../source/inc/other_action:65
707
# f5051fbb284c4d34a9bbcf7a6b77661a
707
# a7822ce227d74d85b2231dce76983d25
708
708
msgid "If true, skips directly to the next menu choice."
711
711
#: ../../source/inc/other_action:68
712
# 456cae36ada54282a385dca25807153c
712
# 186f0374388540faaf8160ee8eabdd28
713
713
msgid "If true, asks for confirmation before beginning skipping."
716
716
#: ../../source/inc/other_action:72
717
# 96f3ccce6ea74b5289031cd8129cd158
717
# 889bf6327dda48ea84b2963616bedc8c
718
718
msgid "Causes `transition` to occur."
721
721
#: ../../source/screen_actions.rst:81
722
# 72fb4a42aa02465da1620938ddf991f0
722
# 4fa9c3f905b447e68295586ab436a300
726
726
#: ../../source/screen_actions.rst:83
727
# 0b6d588f9e5240b28c4406d1889d4425
727
# 12517ae46c5b4a9eb21187716fd28a60
728
728
msgid "Values are used with bars, to set the bar value, and to allow the bar to adjust an underlying property."
731
731
#: ../../source/inc/value:5
732
# 882446d04d7447fe9ea5a049fd4faecf
732
# 1d388f5c218e4e219fc21be1250d5081
733
733
msgid "This animates a value, taking `delay` seconds to vary the value from `old_value` to `value`."
736
736
#: ../../source/inc/value:9
737
737
#: ../../source/inc/value:63
738
# 370e0be64c344b87845075e08ec49b86
739
# 217a40e469fc40b286231e5e2b0e4f58
738
# 663dc53756ee41bfa0bda8a63b28b161
739
# 9abe29a0230f418e955a174d9be0d082
740
740
msgid "The value itself, a number."
744
744
#: ../../source/inc/value:32
745
745
#: ../../source/inc/value:65
746
746
#: ../../source/inc/value:72
747
# 069172135d4a4f9abc93c653680efc33
748
# d59559b759614b6cb30801f1cbe5e4bf
749
# c8bcd990dfd94e56b88d92a46e565305
750
# 5926436448fa490eaa101ad90b1b14fa
747
# f00bd137d86242589afa297689cca156
748
# b265f20aca744b34aa29115be2544ff1
749
# f7cf3c3a13114e479b916a0315839d04
750
# 4425548bac5048acab7779e08a32ac33
754
754
#: ../../source/inc/value:12
755
# 00bb1e82d3d64da38d2760117aa9a5fd
755
# aaf91c96f8824ff1a8ced7adc8718f7c
756
756
msgid "The range of the value, a number."
759
759
#: ../../source/inc/value:16
760
# 7decba279f9742e895d75fa484de1ce4
760
# 491c931c64a94e809d5acdad886427df
764
764
#: ../../source/inc/value:15
765
# 1dcca6c5df5342be81262bd2b26d1a9d
765
# bd22c284dedf4044b84f0d127391c32a
766
766
msgid "The time it takes to animate the value, in seconds. Defaults to 1.0."
769
769
#: ../../source/inc/value:20
770
# fa46210915804eb9937e92b7be415c39
770
# 55ddd826a36f47a68efed264ad921e5d
771
771
msgid "`old_value`"
774
774
#: ../../source/inc/value:19
775
# 5c21bcb77fa04bf3a2c6b4e705673816
775
# 77e26c99ec844d039507d480a5efd1de
776
776
msgid "The old value. If this is None, then the value is taken from the AnimatedValue we replaced, if any. Otherwise, it is initialized to `value`."
779
779
#: ../../source/inc/value:25
780
# afef0db20cd74dd6adf0979bee64efe6
780
# c6429e4f9132490baea9ecc0f54fd71b
781
781
msgid "A value that allows the user to adjust the value of a field on an object."
784
784
#: ../../source/inc/value:28
785
# a8f8e9a91a384e168bf5afdc3c3e8a95
785
# 72ded95d45254decb6d9a555ef2de0ba
789
789
#: ../../source/inc/value:29
790
# e1c3c819309d4d96996a87e51549bbd7
790
# e2aa637138c74537acd36437173a0d71
791
791
msgid "The object."
794
794
#: ../../source/inc/value:30
795
# fc96535047b946c0a463aacfb1614a4e
795
# 68ac5ae295a94592b820fcd0bc1aa6b5
799
799
#: ../../source/inc/value:31
800
# c15e3bc9deaf43349823befd8b439947
800
# 3e5e9a02789e40908a416acc0ca5bfd4
801
801
msgid "The field, a string."
804
804
#: ../../source/inc/value:33
805
805
#: ../../source/inc/value:73
806
# 966487cde502453d8a0caed5d9cf42ba
807
# 65551c489244472f82400460607db05f
806
# ee3e64c868aa4710860671c86fae8084
807
# a887fd1410ab43d2b8e20b3da4a921bd
808
808
msgid "The range to adjust over."
811
811
#: ../../source/inc/value:39
812
812
#: ../../source/inc/value:79
813
# 6bb004f687ee4192aa284139b4676b55
814
# abe3c4287cb342bebc4f550c88ee65f5
813
# 38a009c9b0cc40f186c14c3e1c65554e
814
# 2f8a426db2a24afe962c8de1509027ed
815
815
msgid "`max_is_zero`"
818
818
#: ../../source/inc/value:35
819
819
#: ../../source/inc/value:75
820
# 16980890daeb4f00a4f2ec3a17cb3ca4
821
# 1e7950f466034b71a8e7b0bf01ad3a06
820
# 105e226b1386478b98e567236a92df5d
821
# 0ec89e41089345a99487c8338bd0a7a3
822
822
msgid "If True, then when the field is zero, the value of the bar will be range, and all other values will be shifted down by 1. This works both ways - when the bar is set to the maximum, the field is set to 0."
825
825
#: ../../source/inc/value:40
826
826
#: ../../source/inc/value:80
827
# 31c8b552ff544f5ead81391e397ac614
828
# 327a1d0170144a51acf66425731a819a
827
# 476a3eaed1ca485f9b02793c89c8aafc
828
# 90576e1f59cc4428946a72ca7a22023b
829
829
msgid "This is used internally, for some preferences."
832
832
#: ../../source/inc/value:41
833
833
#: ../../source/inc/value:81
834
# 1c3d40c5566949abbd11ccbf0ec2e1b2
835
# 34cd1a6551b6498492c1d0565b246c21
834
# 71e8e0bc65d6482fbf1550b646913ae5
835
# ef17561830a04af88b8ec36388afd783
839
839
#: ../../source/inc/value:42
840
840
#: ../../source/inc/value:82
841
# 0d4065b504f64548b21d0d7ab28feaa1
842
# 08d85708b20c414293db776eb6dc0204
841
# 637379cb6a274dc09c3cddefc4e4697d
842
# 15189cb327e94004bbb75095a6c183e3
843
843
msgid "The styles of the bar created."
846
846
#: ../../source/inc/value:43
847
847
#: ../../source/inc/value:83
848
# bf0f680bf22f4eaf9890f0a66e49e1e0
849
# c90e615178a14524a8ba46e4cfdb6e80
848
# d1754a739ebf4082830aeeb66a0dba5d
849
# a60dcea377ec49c3b7349c5c711e0077
853
853
#: ../../source/inc/value:44
854
854
#: ../../source/inc/value:84
855
# 40e8b1a2ab15410290c97626cd6abcd8
856
# 7bf74834bc0f4b2881050f229cef02c7
855
# 6f9bd37507bd4950b33f228523cadb6f
856
# 9606eb7fd29c4ddbafe8a3d8585b08cd
857
857
msgid "An offset to add to the value."
860
860
#: ../../source/inc/value:46
861
861
#: ../../source/inc/value:86
862
# 39a2cdf3c75644b18e7e8abe8d1c27bb
863
# aba4ce0315dd4a39bce5999fea4ee81d
862
# e37b079b2f5e409eb2f385741d9b94a8
863
# 4cf7f901cf324d278b9e29399582419d
867
867
#: ../../source/inc/value:46
868
868
#: ../../source/inc/value:86
869
# 2c26f3c1362c4b69b4b892682e4be539
870
# 3c885d52647e4c8dadf223c5fdc67366
869
# 81ba6ee9ab7d4e84ad1ab331c1dea908
870
# 5cad04e211e74162bac666f18148c065
871
871
msgid "The amount to change the bar by. If None, defaults to 1/10th of the bar."
874
874
#: ../../source/inc/value:51
875
# 5f7b5643eb2343a18530c731aa07e3b2
875
# 46e977d9487244b6bdf3b1d6f42ff519
876
876
msgid "The value of an audio mixer."
879
879
#: ../../source/inc/value:54
880
# 17ca0709b4bf4531a665e7ff60773fa6
880
# f6a1150d5ec04a18b3fb9287555d35a3
881
881
msgid "The name of the mixer to adjust. This is usually one of \"music\", \"sfx\", or \"voice\", but user code can create new mixers."
884
884
#: ../../source/inc/value:60
885
# 93b67325ffee4d75bda504e0e44bc872
885
# 1324c36403644ff6b677a7228ed7d887
886
886
msgid "This allows a value to be specified statically."
889
889
#: ../../source/inc/value:66
890
# 06ad368fa01047cfbb3cce50d36e65a1
890
# 6b2217c06b97499d8bae7294953b2f75
891
891
msgid "The range of the value."
894
894
#: ../../source/inc/value:70
895
# c2026245317b4e78b2a810a5d12bd598
895
# 07df19f3046b4564bb95a4a42a7271af
896
896
msgid "`variable`"
899
899
#: ../../source/inc/value:71
900
# e0c7d73fcfed46d7b077c80d7e5c6cc3
900
# 00eba17969a54f8899d5094e51ffb8c9
901
901
msgid "A string giving the name of the variable to adjust."
904
904
#: ../../source/inc/value:91
905
# 5b74e3a38aa94881bbb07da6937f8e4c
905
# c01deca5a9e14c6da45ffed263101e5a
906
906
msgid "The value of an adjustment that horizontally scrolls the the viewport with the given id, on the current screen. The viewport must be defined before a bar with this value is."
909
909
#: ../../source/inc/value:97
910
# 9c29332d06714412ab27f4af90262d90
910
# 688ece90753743848766f1e539f5fcfa
911
911
msgid "The value of an adjustment that vertically scrolls the the viewport with the given id, on the current screen. The viewport must be defined before a bar with this value is."
914
914
#: ../../source/screen_actions.rst:89
915
# 808a099e587a4bcfa391675f21546a43
915
# 7ae12c1a7c4f4a65abc5a91fe71957dc
916
916
msgid "Functions and Classes"
919
919
#: ../../source/screen_actions.rst:91
920
# a2c63d2f62ea43bcbc1467ca32f6af52
920
# 734dba2c32404a9aba1d46a0189f9929
921
921
msgid "These functions and classes are useful in association with screens."
924
924
#: ../../source/screen_actions.rst:94
925
# fbe3c6665e0446189f25b42bd6557ebd
925
# 8550009c23a84a85a96b5483c3cd8798
926
926
msgid "Preferences"
929
929
#: ../../source/screen_actions.rst:96
930
# 7814e8236de6430baabb79b115a8b119
930
# 77755516b39241888aee76cc5f6a4e3b
931
931
msgid "While all preferences can be defined based on the Actions and Values given above, it requires some knowledge of Ren'Py to figure out the correct one to use. The preferences constructor makes this easy, by creation an action or value, as appropriate, based on the names used in the default preferences screen."
934
934
#: ../../source/inc/preference_action:5
935
# 9f3f267d3b2849b29797f217bf6aacb8
935
# 6d1c9f4f729e47838bbf9a198425b4f5
936
936
msgid "This constructs the approprate action or value from a preference. The preference name should be the name given in the standard menus, while the value should be either the name of a choice, \"toggle\" to cycle through choices, a specific value, or left off in the case of buttons."
939
939
#: ../../source/inc/preference_action:11
940
# 233937eb0bca48409e8482bd70e33316
940
# 227df2faa6a8401f9652379e007670f5
941
941
msgid "Actions that can be used with buttons and hotspots are:"
944
944
#: ../../source/inc/preference_action:13
945
# 41278939794940ef8fb42dfb482c9268
945
# e7a5854daa4641538d76a7a39efb724c
946
946
msgid "Preference(\"display\", \"fullscreen\") - displays in fullscreen mode."
949
949
#: ../../source/inc/preference_action:14
950
# 3ec791ce9ad14f76979e05d4175d6ea2
950
# 2d3e1716d0dd4896805ba05ddd0454d3
951
951
msgid "Preference(\"display\", \"window\") - displays in windowed mode at 1x normal size."
954
954
#: ../../source/inc/preference_action:15
955
# efc8329da4df4370a60f8d87a29038bf
955
# 705696559e5f4adaa27434adc3941855
956
956
msgid "Preference(\"display\", 2.0) - displays in windowed mode at 2.0x normal size."
959
959
#: ../../source/inc/preference_action:16
960
# 23cf7127c1c74d2dbfcd66ae500b415b
960
# e656163517fe45d7a13e5015f5f6fe4c
961
961
msgid "Preference(\"display\", \"toggle\") - toggle display mode."
964
964
#: ../../source/inc/preference_action:18
965
# 7d4cf21946b94dbca4a0a44257b70054
965
# 8fd3e4b36c2949e98eebfcedf2d7797d
966
966
msgid "Preference(\"transitions\", \"all\") - show all transitions."
969
969
#: ../../source/inc/preference_action:19
970
# e3ab433b35b04150b17b686a42f02e58
970
# 3ac4e5c46fdf4f24a909955e94853ea8
971
971
msgid "Preference(\"transitions\", \"none\") - do not show transitions."
974
974
#: ../../source/inc/preference_action:20
975
# 0c9dd15dfa8d4f0f9549398365c9cad7
975
# a042c089cbbe49a598a9bf4fdc66e706
976
976
msgid "Preference(\"transitions\", \"toggle\") - toggle transitions."
979
979
#: ../../source/inc/preference_action:22
980
# 421a9f003bdf4f9b9e7011e7aa46e06e
980
# eb732a279e3a48128154e782b7c41052
981
981
msgid "Preference(\"text speed\", 0) - make text appear instantaneously."
984
984
#: ../../source/inc/preference_action:23
985
# 5f2636cd0ef3483298e71cb68d436a3d
985
# 49298a9c606e42fa993f3d1fb34c4530
986
986
msgid "Preference(\"text speed\", 142) - set text speed to 142 characters per second."
989
989
#: ../../source/inc/preference_action:25
990
# e09469e7679244adb82b177689fbeaa5
990
# 78a4c236c38a4808977e8e6c63098303
991
991
msgid "Preference(\"joystick\") - Show the joystick preferences."
994
994
#: ../../source/inc/preference_action:27
995
# cee5c6fe13064439ba3955989dca8511
995
# f45a3e1913cf480ebb63c7b35f1b90e0
996
996
msgid "Preference(\"skip\", \"seen\") - Only skip seen messages."
999
999
#: ../../source/inc/preference_action:28
1000
# 26ee0f995c2d4f3ab457168555b8276d
1000
# f0c168ec221e46f797e54817af3126a7
1001
1001
msgid "Preference(\"skip\", \"all\") - Skip unseen messages."
1004
1004
#: ../../source/inc/preference_action:29
1005
# 2fc632013b12463c9df0a07b6ac0a634
1005
# ee30f92cef91448ca40ba7d15258fbe1
1006
1006
msgid "Preference(\"skip\", \"toggle\") - Toggle between skip seen and skip all."
1009
1009
#: ../../source/inc/preference_action:31
1010
# 9643b51d1d6343f285f2131eb549a395
1010
# e8f6f732e5b84c2c9d7d2ab754ac58c4
1011
1011
msgid "Preference(\"begin skipping\") - Starts skipping."
1014
1014
#: ../../source/inc/preference_action:33
1015
# 7ae811b44abf421abe19847263e23f69
1015
# d709f734c0ef4c19997b9d12069ce141
1016
1016
msgid "Preference(\"after choices\", \"skip\") - Skip after choices."
1019
1019
#: ../../source/inc/preference_action:34
1020
# b8609db947d04558b51335da2a1fc0b4
1020
# e9c0c2e0a5ce409dbeb8f7e37567d5cc
1021
1021
msgid "Preference(\"after choices\", \"stop\") - Stop skipping after choices."
1024
1024
#: ../../source/inc/preference_action:35
1025
# 8ca7e107ac624cb59348249b7439bfc1
1025
# cf1c732c25ef4a8ab32bad412266ac45
1026
1026
msgid "Preference(\"after choices\", \"toggle\") - Toggle skipping after choices."
1029
1029
#: ../../source/inc/preference_action:37
1030
# 083ee6dade0f41bb8b7ae6a40f1c2bf3
1030
# 8283aa05e8f34750aaa0c7316dc94ecf
1031
1031
msgid "Preference(\"auto-forward time\", 0) - Set the auto-forward time to infinite."
1034
1034
#: ../../source/inc/preference_action:38
1035
# 0963215627584e4796588311356ed6b9
1035
# 0413a6c01bef43f8af3632f7a89514fd
1036
1036
msgid "Preference(\"auto-forward time\", 10) - Set the auto-forward time (unit is seconds per 250 characters)."
1039
1039
#: ../../source/inc/preference_action:40
1040
# cfbf8268a60d4adfb1186d6d322de1da
1040
# 9d202118204d4dbba89add8e7a39c41e
1041
1041
msgid "Preference(\"auto-forward\", \"enable\") - Enable auto-forward mode."
1044
1044
#: ../../source/inc/preference_action:41
1045
# 536e7f0ce9474c81926764804513ee61
1045
# 3cbf5cb5daf84e29a9e1aef62d486c46
1046
1046
msgid "Preference(\"auto-forward\", \"disable\") - Disable auto-forward mode."
1049
1049
#: ../../source/inc/preference_action:42
1050
# 6d5f9904024c490e9cfd33f1dfa7b74a
1050
# 4f8ecf1811ec4ff988a5dea5247cbafe
1051
1051
msgid "Preference(\"auto-forward\", \"toggle\") - Toggle auto-forward mode."
1054
1054
#: ../../source/inc/preference_action:44
1055
# f67a495bba2943bf8dd4b4efa3136dc8
1055
# 3e0b64385b9043d795ec07be4c720182
1056
1056
msgid "Preference(\"wait for voice\", \"enable\") - Wait for the currently playing voice to complete before auto-forwarding."
1059
1059
#: ../../source/inc/preference_action:45
1060
# 862c33e460fc4ff99109c7fd894064ae
1060
# ed8fc04fbbf849ce825b121ed755f249
1061
1061
msgid "Preference(\"wait for voice\", \"disable\") - Do not wait for the currently playing voice to complete before auto-forwarding."
1064
1064
#: ../../source/inc/preference_action:46
1065
# 3e459d4943904327a108a5d47fa1e417
1065
# 8ccc7d35f4a24271a2ce71cfd95efc81
1066
1066
msgid "Preference(\"wait for voice\", \"toggle\") - Toggle wait voice."
1069
1069
#: ../../source/inc/preference_action:48
1070
# d2ffa5e6edd44ad9a91499940cdf7583
1070
# 409ced0999e44f9d902a317cb7e2a7ee
1071
1071
msgid "Preference(\"voice sustain\", \"enable\") - Sustain voice past the current interaction."
1074
1074
#: ../../source/inc/preference_action:49
1075
# a9f3e438bc3f4e7ea286edf30ac4a634
1075
# 0e25596ec7bd4589abc94793f53d97fb
1076
1076
msgid "Preference(\"voice sustain\", \"disable\") - Don't sustain voice past the current interaction."
1079
1079
#: ../../source/inc/preference_action:50
1080
# a99a88bb52af4237b491132293455189
1080
# a8d4444895584af5b745aed907f6e245
1081
1081
msgid "Preference(\"voice sustain\", \"toggle\") - Toggle voice sustain."
1084
1084
#: ../../source/inc/preference_action:53
1085
# 59213cc6faaf40459fd0808425acd1a1
1085
# 5e84097139ce4e3aaa603af9191b8dde
1086
1086
msgid "Preference(\"music mute\", \"enable\") - Mute the music mixer."
1089
1089
#: ../../source/inc/preference_action:54
1090
# 79a19bfed7934f88935e0ce1e9bd3842
1090
# 875b04581e6b467f93a9039b2308b159
1091
1091
msgid "Preference(\"music mute\", \"disable\") - Un-mute the music mixer."
1094
1094
#: ../../source/inc/preference_action:55
1095
# bbc12e47f6ed4ef191cdfde08e9b97f3
1095
# 24533a1d6ddc40dc963119716c3f87bc
1096
1096
msgid "Preference(\"music mute\", \"toggle\") - Toggle music mute."
1099
1099
#: ../../source/inc/preference_action:57
1100
# e161e384c6b64a68a468508c148d177b
1100
# 22c40abb0d744740bed7d956682c5d41
1101
1101
msgid "Preference(\"sound mute\", \"enable\") - Mute the sound mixer."
1104
1104
#: ../../source/inc/preference_action:58
1105
# 45bdafb9c6284eefa89f608ab2a40bfc
1105
# ad56e8dd29ed48068d6fb577e2f1386f
1106
1106
msgid "Preference(\"sound mute\", \"disable\") - Un-mute the sound mixer."
1109
1109
#: ../../source/inc/preference_action:59
1110
# 75ab14227fdc47bf9967ff76f26bba5f
1110
# b1b64d94c2874c6587eb769042447121
1111
1111
msgid "Preference(\"sound mute\", \"toggle\") - Toggle sound mute."
1114
1114
#: ../../source/inc/preference_action:61
1115
# f250d218100947529df1bae848833fec
1115
# 0a1882a44d0546978bce90b063877ad1
1116
1116
msgid "Preference(\"voice mute\", \"enable\") - Mute the voice mixer."
1119
1119
#: ../../source/inc/preference_action:62
1120
# a5a1476870cb44ef8dcc176f0d5a96f1
1120
# 73bf89784e014b8399a8db8b4d0c862d
1121
1121
msgid "Preference(\"voice mute\", \"disable\") - Un-mute the voice mixer."
1124
1124
#: ../../source/inc/preference_action:63
1125
# b1a4ccfd844a402d802e4dc7b09f682e
1125
# 11da28d6244b47bd98aebce00f8d0226
1126
1126
msgid "Preference(\"voice mute\", \"toggle\") - Toggle voice mute."
1129
1129
#: ../../source/inc/preference_action:65
1130
# 64cc042910804f1699055ece08ab884a
1130
# baab548d68ed480c9aab5a2da2960f87
1131
1131
msgid "Preference(\"music volume\", 0.5) - Set the music volume."
1134
1134
#: ../../source/inc/preference_action:66
1135
# 86900b935c78400e8bbee64aac2e30e2
1135
# aad129de29774e72867a633ac9ccc9ec
1136
1136
msgid "Preference(\"sound volume\", 0.5) - Set the sound volume."
1139
1139
#: ../../source/inc/preference_action:67
1140
# 702fadc168d44477a5b7cce8583d2471
1140
# a232c3bee5be44dbba218f3c57edcd5e
1141
1141
msgid "Preference(\"volice volume\", 0.5) - Set the voice volume."
1144
1144
#: ../../source/inc/preference_action:69
1145
# 0a828b83e17e4590aa16864768989a72
1145
# 5f2fcd8e71eb4fd5a4c9049dce17fa1e
1146
1146
msgid "Values that can be used with bars are:"
1149
1149
#: ../../source/inc/preference_action:71
1150
# 9bca49ccc0dd48dfae1d8ddc767d948e
1150
# e86a5b955f9940fdbda4139a7577ba29
1151
1151
msgid "Preference(\"text speed\")"
1154
1154
#: ../../source/inc/preference_action:72
1155
# 845c50ab22b942ec9dab4383636e27a2
1155
# 841af6a3f0754e65929b276c548b2f7e
1156
1156
msgid "Preference(\"auto-forward time\")"
1159
1159
#: ../../source/inc/preference_action:73
1160
# 9a6368d4e0d64020932e1cac8a963461
1160
# 187b5d507fe546d79ea6832ff08d1c20
1161
1161
msgid "Preference(\"music volume\")"
1164
1164
#: ../../source/inc/preference_action:74
1165
# f7a1409b9b6a4c63b9315991f78c87ab
1165
# f3e660dad6b24a2ba4040c4085a39dad
1166
1166
msgid "Preference(\"sound volume\")"
1169
1169
#: ../../source/inc/preference_action:75
1170
# 08d2a4c863424b21bbf0f3c415264f18
1170
# b2361cbcfa23455390cb4c49d10d2b57
1171
1171
msgid "Preference(\"voice volume\")"
1174
1174
#: ../../source/screen_actions.rst:106
1175
# 3e05c1e806bf462ba5ba57aaf1881533
1175
# 7510698764694e6687edeac5bd10b9d4
1176
1176
msgid "File Functions"
1179
1179
#: ../../source/screen_actions.rst:108
1180
# ec29c09cfdb2484186c9ab2221667c6d
1180
# 58852ba73963412eb8bc926b79911155
1181
1181
msgid "These functions return useful information about files. They use the same default page as the file actions."
1184
1184
#: ../../source/inc/file_action_function:5
1185
# 1261957c432b4431aed65b1b9575721d
1185
# 7a0c1dfef7894d768ed71482e85cdc45
1186
1186
msgid "Returns the current file page as a string."
1189
1189
#: ../../source/inc/file_action_function:9
1190
# c6736d9cf895430aa1ce87c35276e4a3
1190
# 58440c017d2c470b84c30a21e6ab5bed
1191
1191
msgid "Accesses the Json information associated with `name`."
1194
1194
#: ../../source/inc/file_action_function:11
1195
# 08444f8d852f4c25a6e9c61ef4a1d662
1195
# e45bc4605c1e4185afbd6b241b62a016
1196
1196
msgid "If `key` is None, returns the entire Json other object, or `empty` if the slot is empty."
1199
1199
#: ../../source/inc/file_action_function:14
1200
# 5fdf1420d6d6446c937a526a29a56e7c
1200
# 4c4ef9243e4a42a480b44d57dbac6464
1201
1201
msgid "Otherwise, this returns json[key] if `key` is defined on the json object of the save, `missing` if there is a save with the given name, but it does not contain `key`, or `empty` if the save slot is empty."
1204
1204
#: ../../source/inc/file_action_function:20
1205
# eb65cf5a69bd40b8bdc9f4fd99b58006
1205
# faa09d2c65754a8eaea771366a2e5bb5
1206
1206
msgid "This is a function that returns true if the file is loadable, and false otherwise."
1209
1209
#: ../../source/inc/file_action_function:25
1210
# 3d27651e85454bfeadc286789a7d641c
1210
# 163cd13bfd83455f8afa179ea5db34b4
1211
1211
msgid "Returns True if this is the newest file slot, or False otherwise."
1214
1214
#: ../../source/inc/file_action_function:29
1215
# ab20a947a01d476ca7fd4755dcb0c006
1215
# 351d2c2f4e934c2bbf2a02b326d5b599
1216
1216
msgid "Returns the name of the current file page, as a string. If a normal page, this returns the page number. Otherwise, it returns `auto` or `quick`."
1219
1219
#: ../../source/inc/file_action_function:35
1220
# fc6dc88511b84ac2aac7524526eff61b
1220
# 9b339a58779044f2bf10201568c8d6bf
1221
1221
msgid "Return the save_name that was in effect when the file was saved, or `empty` if the file does not exist."
1224
1224
#: ../../source/inc/file_action_function:40
1225
# 4d4ce517b95643ecb9ac91c9445f7878
1225
# edfcc26a14684faea122bf0de7ae7312
1226
1226
msgid "Returns the screenshot associated with the given file. If the file is not loadable, then `empty` is returned, unless it's None, in which case, a Null displayable is created."
1229
1229
#: ../../source/inc/file_action_function:44
1230
# eaa7de5ca2c34139b05a5c47f4a5e919
1230
# eef724fdc4024860b6a76208c867c36d
1231
1231
msgid "The return value is a displayable."
1234
1234
#: ../../source/inc/file_action_function:48
1235
# 5299172536ae43eaad13c6279ab95073
1235
# b1fc48739c454ad3a091ebde3a3e90dc
1236
1236
msgid "Returns the name of the numbered slot. This assumes that slots on normal pages are numbered in a linear order starting with 1, and that page numbers start with 1. When slot is 2, and slots_per_page is 10, and the other variables are the defauts:"
1239
1239
#: ../../source/inc/file_action_function:53
1240
# 0e91d47dcbf8441b8ebe5bffca88a07f
1240
# 7b373b13b11c4c56970d6531e2b71695
1241
1241
msgid "When the first page is showing, this returns \"2\"."
1244
1244
#: ../../source/inc/file_action_function:54
1245
# 976891564d0d4b61a72f5c835a384683
1245
# 9e5aedb900704bd3b06fd55c231d5843
1246
1246
msgid "When the second page is showing, this returns \"12\"."
1249
1249
#: ../../source/inc/file_action_function:55
1250
# 80c84d3097cf41d59f824dbddac12333
1250
# 0529e907929441848915310b011e10fb
1251
1251
msgid "When the auto page is showing, this returns \"a2\"."
1254
1254
#: ../../source/inc/file_action_function:56
1255
# 79b75481f66d4208ad038e9342153f1a
1255
# 3804fbc7ce7d4be5b57165cafa5b8170
1256
1256
msgid "When the quicksave page is showing, this returns \"q2\"."
1259
1259
#: ../../source/inc/file_action_function:59
1260
# 8c2db2a6df6d42e9a35700a2e30f9d91
1260
# 1dd5d440403143a483c1eb591818acaf
1264
1264
#: ../../source/inc/file_action_function:59
1265
# de1536fb9120442db70e84f48b796455
1265
# e66d6d72191346d6901e49f7ede31ee9
1266
1266
msgid "The number of the slot to access."
1269
1269
#: ../../source/inc/file_action_function:62
1270
# 123125319d6d42029af8a8687b4d3699
1270
# 6cf12e136184466ca2515c54220c016f
1271
1271
msgid "`slots_per_page`"
1274
1274
#: ../../source/inc/file_action_function:62
1275
# bdeb6150c9ab41779f23544758fe768a
1275
# 6d100c2237ee4d36bf9e3063cdc86730
1276
1276
msgid "The number of slots per page."
1279
1279
#: ../../source/inc/file_action_function:65
1280
# 6f51280e965149edad0df6560b2d08f0
1280
# 1f4d715e774d4c648d49e45b949003e8
1284
1284
#: ../../source/inc/file_action_function:65
1285
# f479bd9abf53464292be99fe416b6691
1285
# b4f40fbea04b441b81977eaff951dbab
1286
1286
msgid "A prefix to use for the auto page."
1289
1289
#: ../../source/inc/file_action_function:68
1290
# b12c4aaca5a2482292526534449a10ce
1290
# a3092c4915b64cd8b0ba99bf46d6a417
1291
1291
msgid "`quick`"
1294
1294
#: ../../source/inc/file_action_function:68
1295
# 653ed0f6dfc7405ebdd7b4c0e7c21429
1295
# ca5c385bc88241b39e7ce49d8774718e
1296
1296
msgid "A prefix to use for the quick page."
1299
1299
#: ../../source/inc/file_action_function:71
1300
# 8438fa9b5bb44943bac9000110d0487e
1300
# 475345d93dda4b85a2d23cd66aab78da
1301
1301
msgid "`format`"
1304
1304
#: ../../source/inc/file_action_function:71
1305
# bfe7ac8fde4e46fb89813707193d096e
1305
# f36a151cfcdf4383b71445f023e52f63
1306
1306
msgid "The formatting code to use. This is given two arguments: A string giving the page prefix, and an integer giving the slot number."
1309
1309
#: ../../source/inc/file_action_function:76
1310
# e4bcaef5f00a482a8ff0e7d9593b7df2
1310
# 13752f63a15e4a70b2cbfb3f25f8e79b
1311
1311
msgid "Returns the time the file was saved, formatted according to the supplied `format`. If the file is not found, `empty` is returned."
1314
1314
#: ../../source/inc/file_action_function:80
1315
# 10987594ee7148aaae4eda50de7d0a80
1315
# 26a5bc7274aa41dbba83dccf8c1d9b70
1316
1316
msgid "The return value is a string."
1319
1319
#: ../../source/inc/file_action_function:84
1320
# 65f487869702463ca22896cbfe4c2046
1320
# 2bd943c9fe1d4d19998f3c067d5f607f
1321
1321
msgid "Returns a list of used numeric file slots on the page."
1324
1324
#: ../../source/inc/file_action_function:87
1325
# ab1827826c804cd3a36fae2cc9449965
1325
# 4c6e000beed141bbb7c714dd16f087f1
1326
1326
msgid "The name of the page that will be scanned. If None, the current page is used."
1329
1329
#: ../../source/inc/file_action_function:91
1330
# 2792c8a43b86454facb42959e3dd29ec
1330
# f583fb13b2d3421f83c4ad45ae8ff55c
1331
1331
msgid "`highest_first`"
1334
1334
#: ../../source/inc/file_action_function:91
1335
# b5cd83183270456289177b5aab475179
1335
# 626410c7f3374a9b80a87d60b802b605
1336
1336
msgid "If true, the highest-numbered file slot is listed first. Otherwise, the lowest-numbered slot is listed first."
1339
1339
#: ../../source/screen_actions.rst:114
1340
# f54ebb9c939748b4a36136b30ccc7845
1340
# 6d86ac87e7514f43a8f6bab9d1a23ec2
1341
1341
msgid "Side Image Functions"
1344
1344
#: ../../source/screen_actions.rst:116
1345
# 3724d2a0846947479b72fe06dd51b550
1345
# 374e876c3f8c428d80352e3e9e45ee1e
1346
1346
msgid "This function returns the side image to use."
1349
1349
#: ../../source/inc/side_image_function:5
1350
# cb342468ce274cf592429aa2002dde5c
1350
# c1f090cf539041c585e01717bbac444f
1351
1351
msgid "Returns the side image associated with the currently speaking character, or a Null displayable if no such side image exists."
1354
1354
#: ../../source/screen_actions.rst:122
1355
# 1ea0d53ef77047b09f22fb9c8ed06ecc
1355
# 4dba9ca20e6c4916bd5829a30b9386d2
1356
1356
msgid "Tooltips"
1359
1359
#: ../../source/screen_actions.rst:124
1360
# ece6c107855742abaa6d7f9d6080bb1e
1360
# 640e742e8ae8496cbb47a17ef9897091
1361
1361
msgid "The tooltip class changes the screen when a button is hovered."
1364
1364
#: ../../source/inc/tooltips:5
1365
# f92ba443bb6f4327b082b3a2da485ad2
1365
# c2ee6b9ca8af4b3eab18d3231ad9f851
1366
1366
msgid "A tooltip object can be used to define a portion of a screen that is updated when the mouse hovers an area."
1369
1369
#: ../../source/inc/tooltips:8
1370
# acbbff3cde8b430baeed04753bc13c3e
1370
# b29b5d88df4e44b29e0fc92b6b86b44f
1371
1371
msgid "A tooltip object has a ``value`` field, which is set to the `default` value passed to the constructor when the tooltip is created. When a button using an action creadted by the tooltip is hovered, the value field changes to the value associated with the action."
1374
1374
#: ../../source/inc/tooltips:15
1375
# 990c10277d0d437088dc53e78709cc16
1375
# 9d5e0ce9526447929f0d9ea337b20feb
1376
1376
msgid "Returns an action that is generally used as the hovered property of a button. When the button is hovered, the value field of this tooltip is set to `value`. When the buttton loses focus, the value field of this tooltip reverts to the default."
1379
1379
#: ../../source/screen_actions.rst:128
1380
# 5fba8bfa2d144789bee1a93fbda1c8ee
1380
# d4db6bbfe8994993bfd838e620919508
1381
1381
msgid "When using a tooltip with a screen, the usual behavior is to create a tooltip object in a default statement. The value of the tooltip and the action method can then be used within the screen. The order of use within a screen doesn't matter - it's possible to use the value before an action is used."
1384
1384
#: ../../source/screen_actions.rst:134
1385
# 55c25feea85949148e688cbb75df6df8
1385
# e244ab33bae34adcb147de412c5e245a
1386
1386
msgid "Tooltips can take on any value. While in the example below we use the text statement to display a string on the screen, it's also possible to use the add statement to add a displayable. More complex behavior is also possible."