PenScript 3.0 User's Guide for Palm Computing® Devices

Copyright © 2000 Marathon Development Corporation. All Rights Reserved. Patent Nos. 5220649, 5231698, 5590257, 5953735. Patents Pending.

PenScript is a trademark of Marathon Development Corporation. Palm Computing and Graffiti are registered trademarks of Palm Incorporated. All other trademarks and registered trademarks are the property of their respective holders.

Marathon Development Corporation website: www.marathondc.com

Please read the ReadMe.txt and License.txt files included with PenScript.

 

What is PenScript?

PenScript is the most powerful ink-oriented notetaker available for Palm Computing® Platform devices. Handwritten or Graffiti® written memos can be edited with the power of a word processor. Sketches can be incorporated into a memo using the provided drawing tools. An efficient handwriting (ink) compression method allows memos to span many pages without consuming a lot of memory (a typical page uses about 500 bytes).

System Requirements

Removing PenScript

It is recommended that earlier versions of the PenScript program and any PenScript memos be removed before installing the latest version of the program. Make certain that you no longer need the PenScript memos held on your device and then do the following to remove them along with the PenScript program:

To install PenScript

Double-click on the PenScript.PRC file included in PScript.zip package and follow the instructions on the screen. You will be informed that PenScript will be installed during the next HotSync operation. When you try to run PenScript for the first time, you will be asked to enter a product key code. You should have received the key code in an email following the purchase of PenScript. Do not lose the key code. Should you ever need to reinstall PenScript you might need to enter it again. It is not necessary to write the dashes when entering the code. Once the code has been accepted on your device, there will be approximately a 15-second delay before the PenScript screen appears. If PenScript repeatedly refuses your code, it could be that the Palm Desktop User Name specified during the purchase of PenScript was incorrect or that we erred when generating your key code. If there is a problem, send us an email containing a Palm Desktop User Name identical to what is shown in the Palm Desktop application. We will then generate a new key code for you.

Using PenScript

The PenScript user interface consists of two screens - the Memo List Screen and the Memo Edit Screen. The Memo List Screen appears when you tap on the PenScript icon after having installed PenScript.

Memo List Screen

The Memo List Screen displays a list of all PenScript memos available on your palm-held computer. Tapping a memo list entry will cause the corresponding memo to be opened and displayed in the Memo Edit Screen. The first time PenScript is used, only the 'PenScript Tips' memo will be shown in the memo list. The tips provide basic information necessary to operate PenScript. Pressing the New button at the bottom of the Memo List Screen (or entering any Graffiti character) will cause the Memo Edit Screen to appear. Note that each memo in the memo list is identified by Graffiti (font) text that has been extracted from the first line of the corresponding memo. Memos that do not have font text on their first line are identified in the memo list by a timestamp giving the memo creation date and time.

Memo Edit Screen 

The Memo Edit Screen contains a number of user interface components that you should become familiar with before creating your first PenScript memo. The ruled lines are similar to those that would be found on a sheet of tablet paper. If you intend to use word processing features to edit your handwriting, you should try to write using the ruled lines as a guide - making sure that each word generally falls within the line area where you want the word to reside. It is normal to have descenders, such as the tail on the letter g, extending beneath the line that you are writing on. It is best to keep writing for a particular line beneath the preceding ruled line. The small open areas to the left and right of a ruled line are the margin areas. Placing the pen in the left margin will select lines or drawings. Pen actions or 'gestures' in the right margin are used to perform a number of functions as described below. In addition to a writing/drawing surface, the memo edit screen contains the following buttons and menus:

 -Buttons-

Done - Closes the memo and returns to the Memo List Screen.

Details - Provides information about the filing category for the memo.

U (Undo) - Causes the latest writing/drawing stroke to be removed from the screen. When used immediately following a deletion or erasure, the removed item is restored. This button must be pressed immediately after the edit that you want to undo, before any further edit actions, including selection or scrolling. The Undo button can also be used to clear the text cursor, deselect a selected area, cancel Space Gesture mode, cancel Eraser mode.

S (Space) - Pressing this button causes the pen to be placed in Space Gesture mode. The pen can then be used to shift writing/drawing in order to open/close blank space.

E (Eraser) - Pressing this button causes the pen to become an eraser upon contact with the screen. Ink touched by the eraser rectangle will be permanently erased. The pen will act as an eraser only as long as it remains in contact with the screen.

-Menus-

Record menu

Edit menu

Options menu

Ink menu

* New memos are created using the latest setting for this option.

-Gestures-

PenScript uses pen taps and straight-line pen motions or 'gestures' to facilitate edits. Some common edits include selecting text, changing the position of text, altering paragraph boundaries, and opening space within text for writing.

The Selection Gesture

To select some text, hold the pen to the screen until the selection prompt (a vertical bar) appears. Once the selection prompt is visible, selection is extended to other words by moving the pen across the screen. When the pen is lifted, the selection will be deemed complete and the entire selected area will continue to be displayed in reverse video. To quickly select a single word, double-tap on the word. Once selected, text can be cut, copied, or operated on in some other way.

To select entire ruled lines or drawings touch the pen in the left margin next to the item that you want to select. You can then drag the pen up or down to select additional items. If the pen is dragged to the top or bottom of the screen, the document will scroll to reveal items in the corresponding direction. Items brought on-screen by the scrolling are selected as the scrolling occurs.

For a drawing made over a series of ruled lines (rather than within a blank paper or graph paper drawing area) you should always select the entire drawing, not portions of it. If Smart Select is enabled, selection of the entire drawing will be automatic. If Smart Select is disabled, selection of the drawing is accomplished by placing the pen in the left margin next to the first line of the drawing and dragging it downward until all ruled lines touched by the drawing are selected. Operations then applied to the selection will operate on the drawing as a whole.

The Space Gesture

In order to open or close blank writing/drawing space, text and drawings can be shifted from their current positions. A space gesture is used to perform the shifting. To begin a space gesture, press the Space (S) button at the bottom of the screen and then touch the pen to the first word that needs to be moved. Drag the pen to the right or downward in order to open space. Drag it to the left or upward to close space. All text at and following the pen will move with the pen. Note that when closing space, text cannot be shifted into positions occupied by existing text.

Entire ruled lines and drawing areas can be shifted up or down by performing a space gesture in the right margin next to the item that you want to shift.

The fastest way to perform a space gesture is to avoid using the Space button. This can be done by tapping the pen on the word that you want to shift and then immediately touching and holding the pen to the same location. A space gesture prompt (circle) will appear beneath the pen indicating that the space gesture can be made.

 -Editing Features-

Tap to Open Writing Space

Although a space gesture can always be used to open writing space, there are a couple of quicker ways to open blank writing lines while writing:

Entering Graffiti® or Clipboard Text - Setting the Cursor Position

On a ruled line hold the pen to the screen until a selection prompt (vertical bar) appears. Lifting the pen will cause a blinking cursor to replace the selection prompt. The cursor is used to indicate the location within a PenScript document where a text editing action should take place, such as the location for pasting clipboard data, inserting the date/time, or entering Graffiti text. The fastest way to position a cursor between words is to double-tap between the words.

Moving Text and Drawings

The standard way of moving text/drawings from one place to another is to select the relevant items, Cut/Copy the selected items to the clipboard, set a target cursor position, and then Paste the clipboard items to that position. An easier way is to select the items that need to be moved, touch the pen to any location within the selected area, and then drag the pen to the desired destination. If the destination is off-screen, the document will automatically scroll as the pen reaches the upper or lower boundary of the screen. When the pen is lifted, the selected items will be inserted at the indicated position near the pen tip. If the pen is lifted in the left margin area, the item being moved will be inserted as a paragraph distinct from the existing contents of the line.

Splitting A Word Into Two Words

Occasionally PenScript will assume that two words are a single word because the words were written more closely together than normal. If this happens a lot, automatic word detection should be adjusted by choosing Word Boundaries from the Options menu. For less frequent occurrences, select the erroneous word and make a downward vertical stroke within the selected area at the position where you would like the word to be split. The word will be split into two words, with the appropriate amount of space being inserted between the words.

For delicate word splitting, a special space gesture is available. To perform the gesture, touch and hold the pen to a word at the position where you would like the word to be split. A cursor will appear indicating precisely where the word will be split. If the split position is satisfactory, lift the pen and then touch and hold the pen again at the same position. A space gesture prompt will appear enabling you to drag the right portion of the word with the pen. If the split position indicated by the cursor is not satisfactory, press the Undo button and try again.

Joining Two Adjacent Words

Sometimes PenScript splits a single word into two words because more space than usual was left between characters when the word was written. If this happens a lot, automatic word detection should be adjusted by choosing Word Boundaries from the Options menu. Less frequent occurrences can easily be corrected with one of two methods:

  1. Select the two adjacent words and then choose Join from the Edit menu.
  2. Perform a space gesture between the words and drag the right word to the left, removing the excess space between the words.

Splitting A Paragraph Into Two Paragraphs

When entering handwriting, PenScript will automatically assume that you have started a new paragraph if you skip a line, indent a line more than one quarter of an inch, or leave more than an inch of open space at the end of one line and continue writing at the beginning of the next line. There might be times when PenScript's automatic paragraph detection does not identify the beginning of a paragraph or you decide to split a paragraph into two paragraphs. At times like this the space gesture can be used to indicate the beginning of a paragraph. This is accomplished by dragging the first word of the intended second paragraph away from the first paragraph to the beginning of a subsequent line. If the first word of the intended second paragraph is already positioned where it should be (at the beginning of a line), shift the word slightly to the right. This will indicate to PenScript that the word is not part of the first paragraph.

Joining Two Adjacent Paragraphs

There are a few methods available for connecting two paragraphs in order to create a single paragraph:

  1. With the pen in the left margin, select the last line of the first paragraph and the first line of the second paragraph. The lines must be adjacent with no intervening lines. Choose Join from the Edit menu to connect the paragraphs.
  2. Use a space gesture to drag the first word of the second paragraph to a position immediately following the last word in the first paragraph. If the two words will not fit on the same line, shift the first word of the second paragraph to the left margin.
  3. Perform a horizontal space gesture following the last word of the first paragraph. The gesture should begin near the end of the line and move to the left. When the pen is lifted, the words at the beginning of the second paragraph will wrap back to fill the last line of the first paragraph.

Removing Undesired Writing

The eraser is always available to erase writing or drawing ink, but there are more powerful methods, such as deletion and erasure edits:

It is appropriate to use deletion in those cases where you want to get rid of some writing and to use erasure in those cases where you want to replace writing with new writing.

In addition to the Edit menu options Cut and Clear, two simple gestures can be used to cause a deletion or erasure. After having selected some writing, make a straight horizontal stroke from the right to the left within the selected area in order to perform a deletion. A straight horizontal stroke from the left to the right within the selected area will perform an erasure. Alternatively, pressing the Eraser (E) button will cause a selected area to be erased. A deletion or erasure can be undone by pressing the Undo button before performing any other edit action, including selection or scrolling.

Creating Drawings

PenScript allows you to write/draw anywhere between the left and right margins - at any time. It tries to understand the layout of your document as you write. In order to assure that a drawing made over a series of ruled lines is not interpreted as the continuation of a paragraph of writing, you should make sure that your entire drawing resides at least 1/4 of an inch to the right of the beginning of each line. A dark spot (tick mark) appears on each line to give you an indication of where 1/4 of an inch is. Do not enter writing that you expect to edit later onto the ruled lines where a drawing resides.

 

The best way to add a drawing or sketch to a PenScript document is to create a drawing area using Blank Paper or Graph Paper. First, select a series of ruled lines and then choose the desired paper type from the Options menu. Some benefits of drawing areas created with blank/graph paper are:

You can convert from one type of paper to another at any time. To do this, select the area that you want to convert and then choose a new paper type from the Options menu.

Special Scrolling Gestures

In place of a scrollbar PenScript has provided two special scrolling gestures:

  1. Line oriented scrolling is performed by dragging the pen in the right margin for at least a quarter of an inch. As the pen is dragged the screen contents will shift with the pen. If the pen is dragged outside the writing/drawing area of the screen, scrolling will occur.
  2. Page oriented scrolling is performed by holding the pen to the screen in the right margin until the scrolling indicator (3 dots) appears. Dragging the pen in the right margin for at least a quarter of an inch will cause the screen contents to scroll in page increments.

For people who prefer to use scrolling buttons, PenScript provides page oriented and line oriented scrolling buttons in the lower right corner of the screen. The leftmost up/down arrows are used for page scrolling; the rightmost for line scrolling.

Using the Palm OS Global Find Feature

When a search is requested by tapping the Palm Find icon, PenScript searches only its memo titles for the given text string. PenScript memos can be relatively long, causing significant delays if the entire text of multiple long memos were to be searched.

The PenScript Memo Find Feature

Within individual memos, searches for font text are supported through the PenScript Find feature. Selecting Find from the Edit menu will cause a popup window appear. A case-sensitive search string and a search direction can then be specified. Each time the search string is found, a cursor will be displayed next to the found text. If the search string cannot be found in the given direction a distinctive beep will be heard.

Let PenScript Sleep

When finished creating a memo it is best to press the Done button on the Memo Edit Screen rather than just turning off the computer. This will allow PenScript to sleep soundly, saving battery power.

-Feedback-

Please email any comments to support@marathondc.com. Thank you!