================================================================================
1Patsu: A symple shortcut manager
Version 1.13 (27 Dec 2005)
Noriyuki Mihashi
================================================================================
[Contents]
1. Summary
2. System reqirement
3. Installation
4. Uninstallation
5. Usage
6. Note
7. Licences
8. Changes history
Thanks
Thanks to all these people for giving me great helps to make this program.
Mr. Keita Kawabe:
For giving me informations about silkscreen icon setting.
For giving me informations about netBook and testing on netBook.
Mr. Rudolf Koenig:
For giving me informations about file structure of .AIF file and MBM file.
Mr. John Williams:
For finding and reporting bug. (Ver.1.13)
1. Summary
"1Patu" is a Japanese word pronouncing "ippatsu" meaning "just one action".
This program manages "shortcuts" of other programs on your Psion. "Shortcut"
is a small application that launches other program registared to it with or
without arguments. It can be placed on the "Extras" bar as an individual
application. And also can be assigned to the silkscreen icon by remapping
original application.
For example, you make it be able to do such jobs in only one step of action
by using this program:
- Starting "Agenda" with opening "C:\Documents\FootballGames" from the
"Extras" bar on your Psion.
- Starting non-appication programs such as "Eshell" or OPL ".OPO" programs
from "Extras" bar on your Psion like applicatios.
- Starting "Data" with opening "C:\Documents\Contacts" from silkscreen icon
"Contacts" on your Psion instead of starting "Contacts" application.
2. System reqirement
This program needs following environment:
- Psion Series 5 or Series 5mx or Revo or netBook.
- Sysram1.OPX (It is included in SIS file and automatically installed.)
3. Installation
After you uncompress ZIP archive, you can find files following.
./ ----- 1Patsu.txt This text.
1Patsu.SIS Installation file.
srcs/ ------- 1Patsu.opl Source files.
common.oph
icon.mbm
skel.opl
ShIniOp.opl
ShIniOp.oph
AifOp.opl
imgs/------- 1Patsu.mbm
misc/------- MkAppDat.opl
app.dat
Appdat.src
Silkdat.src
Pick up the extracted "1Patsu.SIS" file and install it into your Psion. After
finishing installation you will see an 1Patsu icon on the "Extras" bar on
your Psion.
4. Uninstallation
At first, remove all shortcuts from the "Extras" bar and the silkscreen icons
by using "1Patsu". You need to restart the system shell if you remapped the
silkscreen icons after you removed shortcuts.
Then you can remove "1Patsu" itself. If you have "Add/remove" icon on your
Psion's control panel, select "1Patsu" on "Add/remove" window and remove it.
Or find "1Patsu" directory from under the "\System\Apps\" directorirs in
drive C: and D: on your Psion, and delete them with all files and directories
included in these "1Patsu" directories.
5. Usage
5.1. Starting up
Tap "1Pasu" icon on the "Extras" bar in your Psion. Then you will see a
main screen of it.
5.2. Main screen
There are two boxes you will see when you start "1Patsu". The upper one
named "EXTRAS BAR" is a list box that shortcuts created on the "Extras"
bar are recorded. The lower one named "SILKSCREEN" is an icon indicator
that shortcuts created on the silkscreen icons are listed. You can set
focus to each box to press "[Tab]" key or to tap directly them.
In "EXTRAS BAR" box, there listed captions, program names and arguments
of each shortcuts on one row. You can change selection of each shortcuts
by tapping each row or pressing cursor keys.
In "SILKSCREEN" box, you can see icons just above* the hard printed silk-
screen icons. There indicated "hand" icons pointing under** if no shortcut
is assigned to the silkscreen icon below**. Caption, program name and
arguments of selected icon is shown in the top of this box. You can change
selection of each icons by tapping each icon or pressing cursor keys.
In the main screen, you can do following these actions:
Action Menu Key Toolbar***
-------------------------------------------------------------------------
Creating shortcuts Edit>Add Ctrl-A Add
Modifying shortcuts Edit>Modify Ctrl-M Enter Modify
Deleting shortcuts Edit>Delete Ctrl-H Del Delete
Seeing details of shortcuts Edit>Detail Ctrl-D Space Detail
Restarting the system shell File>Restart Shell Ctrl-R
Switching selection of box Window>Switch Ctrl-I Tab
* Left of the silkscreen icons if on the netBook.
** Right side if on the netBook.
*** Toolbar is not shown on the netBook.
5.3. Creating shortcuts
To create new shortcut, set cursor to ether "EXTRAS BAR" box or "SIKSCREEN"
box where you want to create them first. If you want create them onto the
silkscreen icons, you have to select icon in "SILKSCREEN" box. Then select
"Add" in "Edit" menu.
You can create up to eight shortcuts on the "Extras" bar. And also can
create up to seven**** shortcuts on the silkscreen icon by replacing the
original application assigned to them.
Each shortcuts have several information to run programs. One of them is
a path of program file launched by the shortcut. It can take three types
of executables: applications, ".exe" programs, and OPL ".opo" programs.
The icon of shortcut becomes same one to the program to be launched if it
has own icon. The "Hand" icon is used if the program has no icon.
One of another information is a group of arguments given to the program.
Any type of strings such as switches or document path can be set to the
arguments. There attached small document icon on the shortcut icons if the
arguments are specified.
In the "EXTRAS BAR" box, you can specify caption of shortcuts. The caption
is shown on the "Extras" bar together with the icon. The caption is auto-
matically created from argument or program name if it was omitted.
In the "SILKSCREEN" box, you can specify whether the original application
assigned to the silkscreen icon to be hidden or not. Icon of the original
application appears on the "Extras" bar if it was not set to be hidden.
**** Up to nine shortcuts on the netBook.
5.4. Modifying shortcuts
To modify existing shortcut, set cursor to the shortcut which you want to
modify first. Then select "Modify" in "Edit" menu.
5.5. Deleting shortcuts
To delete existing shortcut, set cursor to the shortcut which you want to
delete first. Then select "Delete" in "Edit" menu. If the shortcut to be
deleted is assigned to the silkscreen icon, the assignment of application
to it will be back to the original one after deleting shortcut.
5.6. After creating, modifying, or deleting shortcuts
Shortcuts created on the "Extras" bar immediately take effect after created
or modified or deleted them. But it needs to restart the system shell if
shortcuts are on the silkscreen icon.
Each shortcut is a small application which can work alone. So you do not
have to keep running "1Patsu" to use shortcuts.
6. Note
6.1. This program works only on the machines listed in the section 2. It will
harm your system if it was used on the other kind of machines.
6.2. You can specify any kind of executables to shortcuts. But be careful to
that not all executables can run safety from shortcut. Some executables
such as server programs might raise the system crush.
6.3. The shortcuts bring the program to foreground if it is already running.
But some programs cannot be brought it to foreground and they start
another tasks each time the shortcuts start them. The "Data" application
with opening "Help" formatted file is known as such kind of program.
7. Licences
7.1. The copyright of this program and other related products distributed
together (source codes, icon, documents, etc.) belongs to the author of
this program except the "Sysram1.opx" by the Symbian Ltd.
7.2. This program is distributed as freeware by the copyrighter. There needs
no payment to use it whichever for commercial or noncommercial.
7.3. The author of this program accepts no claims for physical, mental,
material, monetary, social, religious, political or any kind of damages
brought on you through using this program. Anyone who use this program
must abandon its claims for all damages described above.
7.4. Anyone who got this program can reuse a whole or part of its soure code
for own products and can redistribute them whichever for commercial or
noncommercial without permission of the copyrighter except the official
application UID allocated by the Symbian Ltd.
7.5. Anyone who makes own products by reusing source code of this program
must not prevent the other people from any rights about this program:
free distribution, free use, free redistribution and free reuse.
7.6. It regards that you agreed to all articles listed above in this chapter
when you use this program or reuse source code of it.
8. Changes history
Ver.1.00 (18 Jun 2002):
- Released.
Ver.1.01 (22 Jun 2002):
- Fixed bug that cannot get hidden flag from the original application
when it changes shortcuts on the silkscreen icons.
- Changed shortcut icon for OPL .opo programs to the icon of OPL.
Ver.1.02 (23 Jun 2002):
- Fixed bug that column line in "EXTRAS BAR" box corrupts if UniFEP V2 is
installed.
Ver.1.03 (28 Jun 2002):
- Fixed bug that font spacing is wrong if UniFEP V2 is installed.
Ver.1.04 (10 Apr 2003):
- Fixed bug that screen returns to the system ones right after launching
programs from shortcuts.
Ver.1.05 (17 Jun 2003):
- Disabled to hide itself and to create new files on the Symbian OS ver-
sion 3.
- Fixed bug that assignment of the silkscreen icons are changed unfortu-
nately when position of the icons on the "Extras" bar are changed.
- Added some source file into ZIP archive which were missed in archive of
previous version.
Ver.1.06 (6 Jul 2003):
- Fixed bug that assignment shortcuts to the silkscreen icons cannot work
correctly on the Series 5mx or Revo.
- Fixed bug that assignment shortcuts to the silkscreen icons cannot work
correctly right after hard reset.
Ver.1.10 (20 Jul 2003):
- Supported the netBook.
- Improved usability that it starts creating shortcut when "Enter" key
pressed on empty "EXTRAS BAR" box or the icons of assigned no programs
in "SILKSCREEN" box.
- Fixed bug of redrawing screen twice when pen event occurs.
- Fixed bug of generating strange caption when an argument is not a file
path.
Ver.1.11 (12 Sep 2003):
- Fixed bug that assignment shortcuts to the silkscreen icons cannot work
correctly on the Series 5mx.
Ver.1.12 (19 Nov 2004):
- Improved reliability by updating "ShIniOp.opo" on remapping silkscreen
icons.
- Changed the name of launcher program from "alias" to the "shortcut".
- Changed default naming rule of the caption.
- Removed a feature of creating new files.
- Removed a feature of hide itself from the "Extras" bar.
- Removed a "Preferences" menu.
Ver.1.13 (27 Dec 2005):
- Fixed bug that an error occures when running the EXE type program with
arguments.
- Fixed bug that the programs includes space charactor in its file path
becomes error at start up.
1Patsu