summaryrefslogtreecommitdiff
path: root/core/launcher/specification.html
Unidiff
Diffstat (limited to 'core/launcher/specification.html') (more/less context) (ignore whitespace changes)
-rw-r--r--core/launcher/specification.html213
1 files changed, 213 insertions, 0 deletions
diff --git a/core/launcher/specification.html b/core/launcher/specification.html
new file mode 100644
index 0000000..8e24837
--- a/dev/null
+++ b/core/launcher/specification.html
@@ -0,0 +1,213 @@
1<html>
2<title>
3Launcher Specification
4</title>
5
6<body>
7
8<h1>Launcher Specification</h1>
9
10
11<!--
12<h2>Specification goals</h2>
13This specification:
14<ol>
15<li> Describes all of the end-user stories and interactions.
16 (eg. the user can view a slide show of images from a digital camera).
17<li> Lists all features, derived from end-user stories,
18 in enough detail to allow the definition of
19 tests for all features.
20<li> Defines contraints and limitations on the application.
21 (eg. can view image sizes as large as 1MB).
22<li>Aides the developer on focusing on the most important aspects of
23 the application and ensuring all important elements are completed.
24</ol>
25-->
26
27<a name=description>
28</a>
29<!-- A one-line description of what this application is and does.
30 This description is then duplicated in the .desktop Comment and
31 the .control file description.
32
33 (eg. The image viewer allows viewing and very minor editing of image files.)
34-->
35The Qtopia Launcher is the your "home" in Qtopia.
36<!-- A one-paragraph description of what this application is and does.
37 This description is then duplicated in the .desktop Comment and
38 the .control file description.
39
40 (eg. The image viewer allows viewing and very minor editing
41 of image files. It assists format conversion, beaming logos
42 to phones, captioning, etc.)
43-->
44<p>
45The Qtopia Launcher allows you to start installed Applications, Games, and Settings.
46It allows you to manage your documents. The launcher has a taskbar which shows current
47running programs and allows switching between them.
48The taskbar supports three plugin types: input
49methods, taskbar applets, and menu applets (also called accessories).
50The Launcher is also responsible for a number of system-level operations.
51</p>
52
53<p>
54Status: RT
55</p>
56
57<a name=usecases>
58<h2>Use Cases</h2>
59</a>
60<!-- Describe real-world stories. Implicit in these use cases is
61 "these things are easy to do".
62 (eg.
63 Roving News Reporter
64
65 The journalist/cameraman takes photos with a digital camera,
66 loads them into the PDAs via CF card, adjusts the contrast,
67 blacks-out a license plate, adds a copyright caption, and
68 emails the image and short story to Reuters.
69 )
70
71 Note: TITLEs may be used as identifiers in bug reports.
72 -->
73<ul>
74<li><b>Write a new text document</b>
75 <p>The user clicks on the Text Editor to create a new text document
76 (or to edit an existing text document).
77<li><b>Play a game</b>
78 <p>The user looks at available games and chooses one to play.
79<li><b>Tweak the system</b>
80 <p>The user changes the way the device looks, feels, and operates
81 by using the Settings programs.
82<li><b>Edit a text document</b>
83 <p>The user clicks on a text document to edit it.
84<li><b>Organizing documents</b>
85 <p>The user looks at all documents of a certain type (such as images),
86 or looks at all documents in a certain category (such as Business).
87<li><b>Beam</b>
88 <p>The user selects a document and beams it to a friend.
89<li><b>Desktop Computer user</b>
90 <p>The user is familiar with desktop computer systems where a menu
91 is used for starting applications. A familiar interface is available
92 in Qtopia (the Q menu).
93<li><b>Accessories</b>
94 <p>The user installs software that appears as an item in the Q menu,
95 for invoking occasional actions.
96<li><b>Input methods</b>
97 <p>The user chooses Handwriting Recognition for most text input,
98 but switches to the more traditional Keyboard input method when
99 using the Terminal.
100<li><b>Switch between applications</b>
101 <p>Bob is writing an email about an upcoming event. Without
102 quitting the Email application, he starts the Calendar, views the event,
103 and easily switches back and forth between the two applications while
104 writing the email.
105<li><b>Broken software</b>
106 <p>Betty installs a game she downloaded off the Internet. When she
107 scores more than 99999 points, the game freezes and stops responding
108 to all input. The system informs her that the program is not responding
109 and she chooses to terminate the game.
110<li><b>Status display</b>
111 <p>The user installs various applets that show the current time,
112 the state of the network, battery level, and inserted media cards.
113 The small displays also provide minor interactions such as
114 setting an alarm clock, starting/stopping the network, getting more
115 detailed information, and ejecting cards.
116<li><b>Frequently used operations</b>
117 <p>The user installs various applets that provide quick access
118 to frequently used operations such as cut and paste, backlight adjustment,
119 and volume control.
120<li><b>Shutdown</b>
121 <p>The user is storing his device for an extremely long period. To prevent
122 system corruption when the battery eventually drains, he shuts down the
123 device.
124<li><b>Calibration</b>
125 <p>The touchpanel on some devices may "drift" over time, or in different
126 environmental conditions. The user then "recalibrates" the display.
127</ul>
128
129<a name=features>
130<h2>Features</h2>
131</a>
132<!-- features are brief
133
134 (eg.
135 * Slide show: view multiple images in sequence
136 * Configurable delay between images.
137 * Hardware-button-controlled stepping between images.
138 * Big images: view larger-than-available-RAM images in some formats.
139 * Formats: view JPEG, PNG, GIF format images.
140 * Scribbling: draw black or white lines on images.
141 * Save: in JPEG, PNG formats.
142 )
143
144 Note: TITLEs may be used as identifiers in bug reports.
145-->
146
147<ul>
148<li>Games tab: games are grouped on their own tab because they are a well-defined
149 group of applications. Games are programs useful solely for
150 entertainment.
151<li>Settings tab: settings are grouped on their own tab because they are a well-defined
152 group of applications. Settings are programs that configure the
153 device without actually contributing to productivity.
154<li>Applications tab: all programs that are not games or settings are grouped
155 as applications, presumably contributing to productivity.
156<li>Documents tab: all user documents are accessible through this tab.
157<li>Invoke application: selecting a application icon starts the application
158 or raises the application if it is already started.
159<li>Invoke document: selecting a document invokes the application associated
160 with the type of document.
161<li>Document Categorization: documents can be members of various categories. The user
162 can filter the view to show just members of a vertain category.
163<li>Document Type: documents each have a single MIME type. The user
164 can filter the view to show just documents of a certain type.
165<li>Beam Document: documents can be sent to other devices (via IrDA).
166<li>Move Document: documents can be moved to different storage locations (eg. CF or SD card).
167<li>Copy Document: documents can be duplicated, with the copy optionally on a different storage location.
168<li>Delete Document: documents can be deleted.
169<li>Q Menu Tab Equivalents: the Application, Games, and Settings tabs can be
170 visible in the Q Menu.
171<li>Q Menu Accessories: plugins (applets) can add items to the Q Menu (eg. IR on/off control).
172<li>Input Method Plugins: pluggable input methods can produce text input to
173 applications using programmed interactions with the user.
174<li>Task Bar: currently running applications are shown as icons in the taskbar,
175 and clicking on these raises the application. If the application does not
176 respond, the user is given the option to terminate it forcefully.
177<li>Status Bar: the task bar doubles as a status bar for temporary messages
178 generated by applications.
179<li>Applets: pluggable applets can show small widgets in the right-hand side
180 of the taskbar. eg. there is a clock applet.
181<li>Shutdown: the device may be shutdown, or the Launcher may be terminated
182 or restarted. The exact meaning of these operations is device-specific.
183<li>Recalibrate: the device may be recalibrated by takling 5 input points from
184 the user and adjusting physical to pixel transformations.
185</ul>
186
187<a name=prerequisites>
188<h2>Prerequisites</h2>
189</a>
190<!--
191 Describes unresolved limitations that cannot
192 be shown within the features list.
193
194 Describes memory and other requirements quantitatively.
195
196 This is a short list, mainly intended as a "known bugs"
197 list for missing features.
198
199 (eg.
200 * Stylus: required for Scribbling.
201 * Memory: requires 250 bytes per event, plus content strings.
202 )
203
204 Note: TITLEs may be used as identifiers in bug reports.
205
206<ul>
207 <li>[PREREQUISITE TITLE]: [PREREQUISITE DETAILS]
208</ul>
209-->
210None.
211
212</body>
213</html>