PilotGOne - view/record GO games (SGF) in PalmOS

Introduction, Download, New Version, Key Features, Getting Started

PilotGOne can be used for three things - recording a Go game; playing back existing SGF files, including variations and comments; and as a board, for stand-alone play while travelling. The feature set is rather precisely tailored to these roles - it is not a general SGF editor. However, since the SGF source lives directly in memos, you can simply edit the memo to make any extra changes that you want. It is for any PalmOS® 2.0, or later, handheld device.

Contents

• Introduction,  Download (Program and Documentation),  New Version,  Key Features,  Getting Started
• Mini-info view in listview,  Open Old/New Game,  The Gadgets:  Done,  <<,  <,  Move Number/ Description,  >,  >>,  "Move co-ordinates",  ( Mode:  black play  [includes Insert Extra Move,  Create New Variation,  Change Last Stone Position,  Replace "NN" Stones],  white play,  add black,  add white,  add empty,  add mark,  score,  view),  # White captures,  # Black captures,  Annotation,  Comment,  Zoom,  Next/Marks,  Variation. 
• The Menus:  Game  (Edit Current Var,  Delete Current Var,  Game Info,  Zoom On ...,  Goto Game End,  Save Dead Groups Info,  Pass,  Undo),  Options (Preferences:  Last Stone (Flashing?),  Goto Move,  Goto Memo,  Show Next Vars as Letters,  Remap Buttons),  Handling Variations
• Manage SGF Files:  Recommendation,  What contents can be displayed in List View? – The First Line,  Generate First Line ...,  List View: what to display  (First Line,  Game Name,  Date,  Board Size,  Mini Info View),  Sorting capabilities:  What can be used for sorting?,  Searching for game records
• Moving SGF files between your PC and PalmOS® device,  Using Palm™ Desktop to store games "offline",  Removing game-records from the PalmOS® device,  Moving Files from Palm™ Desktop to PC,  File/memo sizes,  Some Odds and Ends:  Known "Bugs"/Limitations,  Ideas for future features,  Some Sources of SGF Files,  PilotGOne Mailing lists,  Using ZIP Files,  Splitting Files,  How can you help?,  PilotGOne Team – Credits,  Development Platforms,  PalmGOne – Japanese version
• Old versions: main changes to earlier versions,  detailed Change History,  and download earlier versions (also sources and documentation)

Introduction

PilotGOne is distributed under GNU General Public License – the documentation, under the GNU Free Documentation License. Therefore, it is free - anyone may download and use it as long as they want, without payment.

Like the program? Found a bug? – please do write to Brian Brunswick, or Sylvain Soliman, to tell them how great it is, or to report bugs (please check Known "Bugs"/Limitations first!). The PilotGOne Team are giving you source code in the hope that someone else might do some more useful work that they can't be bothered to! :-)

You can share your thoughts with other users, or help PilotGOne's developers by joining one of the specialised PilotGOne Mailing lists, or even joining the PilotGOne Team!

Here is how PilotGOne displays a game played between Yu Bin and Cho Hun-hyeon:

Download the latest version (0.8.0) – 27 kb (zip format)

Documentation: you can also download your own, copy of the documentation that you are now reading. This is a 91 kb zip format file (163 kb uncompressed), which includes the web pages, and all the graphics – these will be unzipped into a directory of their own called pgdocs. To print the documentation, either read/print the frames as separate files, or print the frames (Microsoft Internet Explorer: File/ Print .../ Only the Selected Frame/ [OK]; Netscape: File/ Print .../ The Selected Frame/ [OK]; Opera: File/ Print Preview/ Active Frame/ [OK]).

To find out about new versions, either regularly check the rec.games.go newsgroup, or subscribe to the pilotgone-announce mailing list.

New version August 2002 – version 0.8.0

• Mini-info view – helps you find right game in list mode.
• Soft buttons – "Calculator" and "Find" – now like mappable Hard buttons.
• Zoom mappable to hard, and soft, buttons
• "Show_next" flashes when there are (undisplayed) marks in game record.
• New "add empty" mode – thanks to Dan Stromberg.
• New "Delete Current Var" command.
• Basic Clie JogDial support – thanks to Nishikawara Youichi.
• Variations displayed as letters on large-scale board – thanks to Nishikawara Youichi.
• Simple colour support (board only!)
• Dis-allow multiple add (Black/White/Empty) in same node.
• Multiple add black/white/empty now more compact in SGF – e.g. "AB[aa][bb]".
• [bugfix] "undo" fixed – now avoids leaving "()" in SGF.
• [bugfix] Gadgets ">", ">>", and "<" blocked – don't go through variations.
• [bugfix] when komi too big, "–" is shown instead.
• A few other bugfixes, and a little code cleaning.

Earlier versions, as well as the documentation, and the source files, are all available for download.

Key Features

• For any PalmOS®(v 2.0, and later) devices. Known to work with most Personal Digital Assistants (PDAs) from Palm, and Handspring (one annoying bug). Please tell us your experience with other devices – should be OK with PDAs from IBM (search for "Workpad"), TRG/ Handera, and the Sony Clie. We have no idea how the program may behave with other devices: Garmin GPS products; Samsung – a phone/PDA: SPH-I300; Symbol data capture devices; Kyocera's Smartphones; Acer (Products and Services/ Handhelds/ Acer s10), and maybe something from Nokia. From now on, in this documentation, we will say PalmOS® device to talk about all of these.
• Uses the SGF standard format for all games – very portable; readable/writeable by many other programs. With an Infrared port you can beam games (which are simply memos) to another PalmOS® device, even if they do not yet have PilotGOne.
• Supports Variations, Comments, Marks/Labels, and Annotations.
• Finger-friendly : can do many things without a stylus, especially if you map main operations to hard, and soft, buttons.
• Zoom In for bigger image.
• Guess Move in existing game record
• Sorting / Searching Games
• Handicaps; Komi; Board sizes 5x5, 9x9, 13x13, and 19x19
• (Semi-automatic) scoring of games.
• Editing of Game records various techniques.
• Compact – uses only 51 kb of PalmOS® device memory.
• Can view large (> 4 kb) SGF files.

Getting Started

For most of the basic uses, it is usually fairly clear how to do it. If/when you want to do more specialised things, you will find much fuller details later.

We suggest that you configure Board Preferences, especially remapping buttons.

To create a new game record do "New ..."; supply the information; tap "New" again; place the stones (also "backspace" to delete/undo previous move; "space" to pass), until "done". Finally, add the "Result" to the "Game Info".

To view an existing game, select an SGF memo, and use (Skip)Forward and (Skip)Back, or the PalmOS® device's "page up"/"page down" buttons, until "done". You can either guess the next move (by tapping on an empty point), or simply play through the game.

Editing an existing game record: You can use PilotGOne to do many things – lots of details below. Alternatively, use Memo Pad to edit the raw SGF game record directly – beware!

Start         Contents         Next: Using PilotGOne (Mini-info in Listview; Open Old/New Game; Gadgets)

HotSync and Palm OS are registered trademarks of Palm, Inc.