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