File: layout.imagemap_load_save.html

package info (click to toggle)
renpy 6.10.2.dfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 19,468 kB
  • ctags: 5,383
  • sloc: python: 17,801; ansic: 7,116; makefile: 127; sh: 15
file content (127 lines) | stat: -rw-r--r-- 10,302 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<html><head><title>layout.imagemap load save - Ren'Py Visual Novel Engine</title><link href="../../shared.css" rel="stylesheet"><link href="../../monobook.css" rel="stylesheet"><link href="../../common.css" rel="stylesheet"><link href="../../monobook2.css" rel="stylesheet"><link href="../../docs.css" rel="stylesheet" /></link></link></link></link></head><body><div id="bodyContent">
			<p class="docnav"><a href="../../index.html">documentation index</a> &#9702; <a href="../Reference_Manual.html">reference manual</a> &#9702; <a href="../Function_Index.html">function index</a></p><p><a id="layout.imagemap_load_save" name="layout.imagemap_load_save"></a></p>
<h1><span class="mw-headline">layout.imagemap_load_save</span></h1>
<div class="thumb tright">
<div class="thumbinner" style="width:182px;"><a class="image" href="/wiki/File:imagemap_load_save.png.html" title="imagemap load save.png"><img alt="" border="0" class="thumbimage" height="135" src="../../images/180px-imagemap_load_save.png" width="180" /></a>
<div class="thumbcaption">
</div>
</div>
</div>
<p><span id="layout.imagemap_load_save" /></p>
<table>
<tr>
<td valign="top">Function:</td>
<td valign="top"><b><strong class="selflink">layout.imagemap_load_save</strong></b></td>
<td valign="top">(ground, idle, hover, selected_idle, selected_hover, hotspots, variant=None):</td>
</tr>
</table>
<div class="renpy-doc">
<p>This layout uses an imagemap to handle loading and saving.</p>
<p><i>ground</i> - The displayable used for disabled buttons, and areas that are not in a hotspot.</p>
<p><i>idle</i> - The displayable used for unfocused unselected hotspots.</p>
<p><i>hover</i> - The displayable used for focused unselected hotspots.</p>
<p><i>selected_idle</i> - The displayable used for unfocused selected hotspots.</p>
<p><i>selected_hover</i> - The displayable used for focused selected hotspots.</p>
<p><i>hotspots</i> - A list of tuples defining the hotspots. Each tuple consists of</p>
<ol>
<li>The x-coordinate of the left side.</li>
<li>The y-coordinate of the top side.</li>
<li>The x-coordinate of the right side.</li>
<li>The y-coordinate of the bottom side.</li>
<li>The function of this hotspot.</li>
</ol>
<p>The function of the hotspot should be one of:</p>
<ul>
<li>"previous" - go to the previous page.</li>
<li>"next" - go to the next page.</li>
<li>"page_auto" - go to the auto-save page.</li>
<li>"page_quick" - go to the quick-save page.</li>
<li>"page_1", "page_2", "page_3", ... - go to the specified page. The page numbers must start with 1, and be dense (not skip any numbers).</li>
<li>"slot_0", "slot_1", "slot_2", ... - a save/load slot. The slot numbers must start with 0, and be dense.</li>
</ul>
<p><i>variant</i> - Allows us to define only the save or load screens. This can be "save", "load", or None to define the save and load screens at once. If a save screen is defined, a load screen must be defined (perhaps with different parameters), and vice versa.</p>
<p>Screenshots and slot text are placed inside windows that are laid out relative to the slot. Adjusting style.file_picker_ss_window controls the screenshot placement, and adjusting style.file_picker_text_window controls the placement of per-slot test. It will usually be necessary to adjust these styles, as the default places both in the upper left.</p>
<p>Hotspot functions may also include the untranslated names of game menu buttons. If at least one such button is defined, the navigation is not shown, and the imagemap is expected to define all relevant game menu buttons.</p>
<p>Despite the name, this function can take arbitrary displayables as well as images. The images or displayables used should be transparent to allow the navigation to show through, unless the game menu buttons are defined here.</p>
<p><span id="config.disable_thumbnails" /></p>
<table>
<tr>
<td valign="top">Variable:</td>
<td valign="top"><b>config.disable_thumbnails</b></td>
<td valign="top">= False</td>
</tr>
</table>
<div class="renpy-doc">
<p>If True, thumbnails are not shown.</p>
</div>
<p><span id="config.load_save_empty_thumbnail" /></p>
<table>
<tr>
<td valign="top">Variable:</td>
<td valign="top"><b>config.load_save_empty_thumbnail</b></td>
<td valign="top">= None</td>
</tr>
</table>
<div class="renpy-doc">
<p>If not None, this should be a displayable that will be shown with empty load/save slots.</p>
</div>
<p><span id="config.time_format" /></p>
<table>
<tr>
<td valign="top">Variable:</td>
<td valign="top"><b>config.time_format</b></td>
<td valign="top">= &quot;%b&#160;%d,&#160;%H:%M&quot;</td>
</tr>
</table>
<div class="renpy-doc">
<p>The format used for file times in the file entry slots.</p>
</div>
<p><span id="config.file_entry_format" /></p>
<table>
<tr>
<td valign="top">Variable:</td>
<td valign="top"><b>config.file_entry_format</b></td>
<td valign="top">= "%(time)s\n%(save_name)s"</td>
</tr>
</table>
<div class="renpy-doc">
<p>The format of file entries in the file entry slots.</p>
</div>
</div>
<pre>
<span class="kwa">init</span> <span class="sym">-</span><span class="num">2</span> <span class="kwa">python</span><span class="sym">:</span>
    layout<span class="sym">.</span><span class="kwd">imagemap_load_save</span><span class="sym">(</span>
        <span class="str">"loadsave_ground.png"</span><span class="sym">,</span>
        <span class="str">"loadsave_idle.png"</span><span class="sym">,</span>
        <span class="str">"loadsave_hover.png"</span><span class="sym">,</span>
        <span class="str">"loadsave_selected_idle.png"</span><span class="sym">,</span>
        <span class="str">"loadsave_selected_hover.png"</span><span class="sym">,</span>
        <span class="sym">[</span>
            <span class="sym">(</span><span class="num">58</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">140</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"previous"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">140</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">227</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"page_auto"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">227</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">310</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"page_1"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">310</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">391</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"page_2"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">391</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">474</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"page_3"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">474</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">559</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"page_4"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">559</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">640</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"page_5"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">640</span><span class="sym">,</span> <span class="num">26</span><span class="sym">,</span> <span class="num">725</span><span class="sym">,</span> <span class="num">103</span><span class="sym">,</span> <span class="str">"next"</span><span class="sym">),</span>

            <span class="sym">(</span><span class="num">32</span><span class="sym">,</span> <span class="num">134</span><span class="sym">,</span> <span class="num">271</span><span class="sym">,</span> <span class="num">344</span><span class="sym">,</span> <span class="str">"slot_0"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">271</span><span class="sym">,</span> <span class="num">134</span><span class="sym">,</span> <span class="num">512</span><span class="sym">,</span> <span class="num">344</span><span class="sym">,</span> <span class="str">"slot_1"</span><span class="sym">),</span>
            <span class="sym">(</span><span class="num">512</span><span class="sym">,</span> <span class="num">134</span><span class="sym">,</span> <span class="num">754</span><span class="sym">,</span> <span class="num">344</span><span class="sym">,</span> <span class="str">"slot_2"</span><span class="sym">),</span>
            <span class="sym">])</span>


    style<span class="sym">.</span>file_picker_ss_window<span class="sym">.</span>xalign <span class="sym">=</span> <span class="num">0.5</span>
    style<span class="sym">.</span>file_picker_ss_window<span class="sym">.</span>yalign <span class="sym">=</span> <span class="num">0.35</span>
    style<span class="sym">.</span>file_picker_text_window<span class="sym">.</span>xalign <span class="sym">=</span> <span class="num">0.5</span>
    style<span class="sym">.</span>file_picker_text_window<span class="sym">.</span>yalign <span class="sym">=</span> <span class="num">.85</span>
    config<span class="sym">.</span>thumbnail_width <span class="sym">=</span> <span class="num">125</span>
    config<span class="sym">.</span>thumbnail_height <span class="sym">=</span> <span class="num">93</span>
</pre>



<div class="visualClear" />
		<hr /><p class="docnav"><a href="../../index.html">documentation index</a> &#9702; <a href="../Reference_Manual.html">reference manual</a> &#9702; <a href="../Function_Index.html">function index</a></p></div>
	</body></html>