Move help files around. Build index correctly.
[enjoyable.git] / Help / Contents / Resources / English.lproj / pgs / mappings.html
1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4 <html xmlns="http://www.w3.org/1999/xhtml">
5 <head>
6 <title>Application Mappings</title>
7 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
8 <link href="../sty/default.css"
9 rel="stylesheet"
10 type="text/css"
11 media="all"/>
12 </head>
13
14 <body>
15 <a name="mappings"></a>
16
17 <div id="navbox">
18 <div id="navleftbox">
19 <a class="navlink_left"
20 href="help:anchor='home' bookID='com.yukkurigames.Enjoyable.help'">
21 Home
22 </a>
23 </div>
24 </div>
25
26 <div id="headerbox">
27 <div id="iconbox">
28 <img id="iconimg"
29 src="../gfx/Icon.png"
30 alt="Icon"
31 height="32" width="32"/>
32 </div>
33 <h1>Application Mappings</h1>
34 </div>
35
36 <p>
37 You can make many different mappings and switch between them
38 easily. To open the list of mappings click the button at the
39 top-left or press ⌘L.
40 </p>
41
42 <p>
43 Click on a mapping to switch to it. Create a new mapping with
44 the + button or by typing ⌘N. Delete the current mapping with
45 the - button or ⌘⌫. Rename a mapping by double-clicking on it or
46 pressing Return while it's selected.
47 </p>
48
49 <p>
50 You can also switch mappings with the <b>Mappings</b> menu, with
51 Enjoyable's dock menu, or by pressing ⌘1 through ⌘9.
52 </p>
53
54 <p>
55 Switching mappings can also be mapped to an input. Select the
56 input you wish to use and then choose a mapping from
57 the <b>Switch to mapping</b> option. For example, you could have
58 one mapping for a game's menu and another for its main screen
59 and switch between them in-game without returning to Enjoyable.
60 </p>
61
62 <h3><a name="automatic"></a>Automatic Switching</h3>
63 <p>
64 If you name a mapping after an application it will be
65 automatically chosen when you switch to that application. The
66 name of an application is usually shown on the dock when you
67 hover your mouse over it. If you don't know the name of the
68 application you want to create a mapping for, create a mapping
69 with the name <kbd>@Application</kbd> (note the <kbd>@</kbd> at
70 the start). The mapping will automatically be renamed for the
71 next application you switch to while it's enabled.
72 </p>
73
74 <h3><a name="sharing"></a>Import and Export</h3>
75 <p>
76 Mappings can be exported and shared with other people. To export
77 your current mapping choose <b>Mappings > Export…</b> or press ⌘S and
78 save the file. This file can be shared with anyone; it doesn't
79 contain any personal information other than the product IDs of
80 the input devices you used and what you mapped them to.
81 </p>
82 <p>
83 To import a mapping choose <b>Mappings > Import…</b> or press
84 ⌘O and select the file you want to import. Mapping files end
85 with <kbd>.enjoyable</kbd> (the default), <kbd>.json</kbd>,
86 or <kbd>.txt</kbd>. If the imported mapping conflicts with one
87 you already made, you can choose to merge the two mappings or
88 create a new one with the same name.
89 </p>
90 </body>
91 </html>