More key codes. Explain (sort of) raw key codes in the manual.
[enjoyable.git] / Resources / 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 pressing ⌘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> and pick a
78 location to save the file. This file can be shared with anyone;
79 it doesn't contain any personal information other than the
80 product IDs of the input devices you used and what you mapped
81 them to.
82 </p>
83 <p>
84 To import a mapping choose <b>Mappings > Import…</b> and select
85 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 <p>
92 You can also import mappings by opening them in Finder or
93 dragging the files onto the mapping list. Similarly, you can
94 export mappings by dragging them from the mapping list to
95 Finder.
96 </p>
97 </body>
98 </html>