Diffstat (limited to 'core/launcher/specification.html') (more/less context) (ignore whitespace changes)
-rw-r--r-- | core/launcher/specification.html | 213 |
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> | ||
3 | Launcher Specification | ||
4 | </title> | ||
5 | |||
6 | <body> | ||
7 | |||
8 | <h1>Launcher Specification</h1> | ||
9 | |||
10 | |||
11 | <!-- | ||
12 | <h2>Specification goals</h2> | ||
13 | This 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 | --> | ||
35 | The 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> | ||
45 | The Qtopia Launcher allows you to start installed Applications, Games, and Settings. | ||
46 | It allows you to manage your documents. The launcher has a taskbar which shows current | ||
47 | running programs and allows switching between them. | ||
48 | The taskbar supports three plugin types: input | ||
49 | methods, taskbar applets, and menu applets (also called accessories). | ||
50 | The Launcher is also responsible for a number of system-level operations. | ||
51 | </p> | ||
52 | |||
53 | <p> | ||
54 | Status: 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 | --> | ||
210 | None. | ||
211 | |||
212 | </body> | ||
213 | </html> | ||