Pilot-Link への誘い

MemoPad

さて, まずは MemoPad。 でも安心し給へ。これってば一番簡単な構造なんだから。なにせ 1行目が表題になってるだけっつーんだから。他にこれといった情報もない, も〜 テキストだけ。 まぁ注意するのは改行コードかな。PCでは, よく復帰・改行になってっけど(つまり 0x0d, 0x0a ね), .PDBでのソレは改行(0x0a)だけ。 あっそれから, テキストの最後に nulコード(0x00)が付いていたりするよ。

ToDoList

で, お次が ToDoList。 これには, 優先順位と期日と, そしてノートがある(それと完了チェックも)。では, どーゆー構造なのかさっそく見てみよう。

なんじゃそらってゆーくらい簡単な表になっちった。recordの先頭の 3バイトがそーゆー情報で, あとは 案件 0x00 ノート 0x00 とゆーふーになっておるのじゃ。 ノートがなかったら 0x00が 2つ続くだけ。それから 案件は最大 255バイトまで。

んで先頭の期日, これは 7bit, 4bit, 5bit でそれぞれ 年, 月, 日になっている。月と日は範囲内だからよいとして, 年は 1904〜2031 になってるんだよ。 でも, 期日の指定がなかったら 0xffff になるのさっ。 それから, 優先順位の先頭 1bitは, 完了チェックが付いているかどうかってヤツ。
あっそーそー, これらは libsockにある todo.cが参考になるかも知れない。

AddressBook

今度は AddressBook。これは, ちょいと構造が面倒かも。

AddressBook は項目数でゆーと 19個個。そりは ・・・ 姓, 名, 会社名, 5つ分の電話, 住所, 市町村, 都道府県, 郵便番号, 国, 役職, カスタム4つ分, ノートて感じ。 こーゆーのが nulコードターミネーター付きの文字列として連続して入っている訳。でも 19個すべてではなくて, 入力されているものだけってことに注意。 たとえば, 姓, 名と住所が入っているとすると 姓 0x00 名 0x00 住所 0x00 ってことで, 他の項目はそもそも含まれていない。

では, どの項目が選択されているのか, それを知るには contents を調べる必要がＲ。 コレ 1項目 1bit。だからこの場合 0x00000103 とゆーことになるんだよっ。下位から数えて 2bit分と, それから 6項目分飛ばして 1bitとゆーことだねっ。 うじゃ残りの (32-19=) 13bit分は？ ・・・ んーと たぶん未使用, かな (だから全項目なら 0x0007ffff)。
それから, (↑)にある 19項目の, それぞれの長さは最大 255バイト。んでも最後の項目「ノート」はそーゆー制限はなかったりする(無制限ちゅー訳じゃないだろうけどもさ)。

んで, phoneとゆーのは何か。それは 5つ分の電話が何の電話番号かを表すもの。中には電話と関係ないのもあるけどさ。だから, どっちかっつーと連絡先って感じかな？
この 5つ分の連絡先は, それぞれ 8つの中から選ぶことができるよーになってて, そりは 会社, 自宅, Fax, その他, E-mail, 代表(メイン), ポケベル(ペ-ジャ), 携帯。これらは 0から順に番号が割りふられている模様。 phoneの, 下位 2バイト半(5ニブル？分) には, この情報が入ってたりする。もしもすべて E-Mailなら 0x00044444 って感じな訳。
先頭の 1バイトは余分で, 次の 1バイトの上位 4bit は, 多分 一覧表を見た時に表示される電話項目を表している(よーなものだろー。けっこう適当)。わはは。
(ニブル(nibble) を, 1ニブルとか 2ニブルとかって数えたことないんで, ホントにそーゆー表現してよいか不明)

offsetは会社名の項目のオフセットを表しているらしいんだけど, ちょっち矛盾があるような無いような・・。

◇

さて, WorkPad-J, つまり日本語版では新たに 3つほど項目が増えていたりする。 ソレらはすべてよみ (バビル二世ではない) 項目。 J-OS では, Lastnameを名前読み, Firstnameを名前 に扱ってたんだけど, それが日本語版 Palmデバイスでは, こんなバラバラになっちった。

• よみ(姓)
• よみ(名)
• 姓
• 名

さらに会社名(Company)も, よみ(会社), 会社名 とゆー具合に分離。 で, 最終的に項目が 3つ増えて, 全部で 22項目になったのけ？ とゆーと, それが違う。

つまり, Lastname だけで姓とその読み, Firstname で名とその読み, Company で会社名とその読み, となったのじゃ。 それぞれ 0x01のコードを境にして 二つずつに分かれた訳なのさっ。 だから日本語版 Palmデバイスでのソレを別の環境に取り込むと, 途中にトーフが出てきたりなんかするのだ。「よみ」は 0x01 の後ろ側で「よみ」が入ってなかったりした場合は 0x01そのものも入っていないっぽい。

それから, 項目名について, 実は app_infoの中に項目名がすべて入ってんだよね, コレが。だから J-OSのばやいでも, 日本語版 Palmデバイスのばやいでも, 同様になっている。ただし「よみ」の項目については入っていないみたい。

TealPaint

それでは, TealPaintのフォーマットを紹介しよう。 これは, 次のような順番でデータが並んでいる。

• ヘッダー
• 一覧時のイメージ
• 通常時のイメージ
• コメント

んで, ヘッダーは, (↓)のような構造をしている。この表では, 横は 4バイト分を表している。 こんなもんかな。なんだか簡単に済ませ過ぎているような気がしなくもない (^^;

Q Paint

では次に, Q Paintのフォーマットを取り上げよう。 こちらも TealPaint同様, 一覧時のイメージとゆーのがあるんだけど, コメントとゆーのはない(と思う)。 一つの項目当たり 2バイトで, その後ろに 10バイトの不明項目が続いている。んで, イメージとゆーのは, 高さ×長さのサイズになってる。
ところで, 横幅と長さの違いって何だっけ。ビット数とバイト数の違いか, それとも 8の倍数で繰り上げた感じのアレだったのか ・・・ 忘れちった。

そして, この後ろに (↓)の形式が続く。見れば分かるかもだけど 形式は全く同じ。

Mail

さてさて, Mailであ〜る。 これも, ほかの PDBと同じような感じになっている。すなわち, Inbox, Outbox, Deleted, Filed, Draft が, カテゴリーになってるってことさっ。 で, レコードの構造は とゆーと, メールヘッダの項目がいくつかと, 最後にメールボディ, そんな感じ。

最初は日付。この日付の構造は ToDoListのものと同じ。ただし 無効って場合は 0。 次に, 時間は 時, 分が 1バイトずつ。そして フラグ, 0x00 と続く, 計６バイト。
フラグはこんな感じ(↓)。 これって, たぶん readと addressing以外は, 新規にメールを作るときに設定できるもの(のはず)。

• read (読んだかどうか？)
• signature (サイン)
• confirmRead (受信確認)
• confirmDelivery (配送確認)
• priority (優先順位:2bit 高い/普通/低い)
• addressing (？？？:2bit)

この 6バイトの項目の次からは, 0x00を区切りとして幾つかの項目が並んでいて, そしてこの後に, (↑)でもゆったように 本文が続き, これも 0x00 で終わっている。 ・・・ はずなんだけど, 調べてみると 最後の最後に 余分に１バイト何かがくっついてくる感じ。しかも不定。何か意味がアルのか？

1. Subject:
2. From:
3. To:
4. Cc:
5. Bcc:
6. Reply-To:
7. Sent-To:

うーむ, Sent-To:なんてあったっけ

Decrio EMemo

んで, デクリオの 手書きメモ: EMemoについての構造。 実は, Mutoh の BBSで, コレの公開の確認取ろうとしたんだけっちょ, やっぱし返事がない。うーみゅ ・・・ かといって, なにも公開しないんじゃ その手のツールは出てこないと思うしぃ, まっ, フライングっつーことで構わないかな。(^^;
当然だけれど, ここで公開しているのは Mutoh からのものではない訳なので, そこに問い合わせたりしないよーに。 ついでにゆーと, σ(^^) も, そことは関係ないパンピー。

さて, とりあえず, EMemoを PCにバックアップしたとしよう。すると, 次の二つがソレらしきものだと分かる訳だよね。

• EMXref-EM10.pdb
• EMInk-EM10.pdb

もちろん, そのメモ帳 MemoDB.pdb にも特殊なマーカーみたいなのが入ることになーる。 てことで, まずは, コレ MemoDB.pdb の部分, そして その次には EMXref-EM10.pdb をアレしていこう。

MemoDB.pdb ... 通常の MemoPadでのソレと, EMemoでのソレは, どう違うのだろーか。 たいてい, そのままにしておくと 手書きのとこには, EMemo-00-1-25-22-52-5 なーんてのが入ることになる。コレってば, 見たまんまのアレで, その時の日付と時刻な訳だよね。 でもその内部には, も少し別なものも入ってたりする。

でも, ここにはコレといった情報は含まれていない。トラブルかなんかで MemoDB.pdbがつぶれたとしても, 手書き情報は大丈夫。 (^^)v

◇

んで, 次に EMXref-EM10.pdb。ここにも手書き画像は入ってなくって, 手書き画像とメモ(MemoDB.pdb)との橋渡しって感じになっている。
レコードは, カテゴリー 1つで 1レコードのよう。つまりカテゴリーごとに分類された (手書きメモの)UIDの集合ってことだね。 てことで, 少なければここには 1レコード, 多くても 16レコードしかない。でも, ま, 多少間違っちゃってるかもだけどね。てへっ (^^)

カテゴリーについての情報の中にある 手書きメモ数で, その後につづく 手書きメモ UIDリンクの数が表されていて, コレで手書き画像の数がわかる ・・・ て訳ではない。残念ながら。 とゆーのも, ひとつの手書きメモの中に, 複数のページが含まれることもあるから。
で, (↓)がメモ帳UIDと手書き画像UIDのリンク情報。

1ページしか手書き画像がなければ全部で 51バイト。ページ数が増えるに従って 4バイトずつ増えるって訳だね。ページ数は最大 16ページのよーだから, それほど大きくなったりもしない。
それから, 作成日時と更新日時は 新しいバージョンではバイナリで入ってる模様。 そもそもこの日時, 作成だか更新だか, どっちなのか不明なんだよね。(^^)

◇

さて, 画像DBである EMInk-EM10.pdb の構造を見てみよう。 コレって ほかの, たとえば 手書きアドレス帳とか, そーゆーのと同じかどうかは分かっていない。 なぜかって, ソレ動かしたことないから。でへへ。 ま, 似たようなもんだと思うんだけどさ。

コレのレコードってのは, ひとつひとつが手書き画像の情報になってて, レコード数＝画像数+1 になっていたりする。 +1 っつーのは, 何か入っているらしいんだけど, まだ詳しく分かっている訳じゃない。(^^;
んで, 手書き画像レコードは？ とゆーと ・・・

まずその先頭に, この手書き画像に対応するもの, 手書きメモならそのメモ帳レコードの UIDと, その中でのページ番号など, 画像の全体的な情報がある。 つぎに, 一筆書きで描くことができるよーな線があり, コレが並んでいる。一筆書きの線が何本か現れた後, 一番最後に終端 ってこと。 それぞれの先頭の 1バイトは固定の値なので, ソレで識別できたりする。

一筆書きは, 開始座標から始まって, まえの座標からの相対座標がいくつも続き, 座標の数までで一筆書きは終わる。 そしてその次の 1バイトが一筆書きを表すものならば, 次の一筆書きが始まるし, 終端ならばそこまで, ってこと。
てことで, それらの項目を少しばっかり解説してみよう。んじゃ 上から順番に ・・・

画像番号

えー, コレはドキュメントによると, ひとつのメモにつき最大 16画像のはずだったんで, 1.5バイトの余分な部分がある。 てことで, もしかしてビミョーに勘違いしてるかもしんない。あしからず。(^^)

メモレコードのUID

UIDって ホントは 3Bytesなんで, 頭 1Byteは余分。・・・ は, いいんだけど, この情報を持ってる訳だから, ここから EMXref-EM10.pdb を生成したりもできちゃうかも。

座標の数

座標の数を表している訳だから, 「1」が入ってたら 開始座標だけってことで『点』になるはず。 んで, 「3」とかだったら 開始座標と つづく相対座標が 2つ って感じだね。難しくはないよね。

開始座標

最初の 2 Bytesが X座標, あとが Y座標。んで, ビットで表すと 0b0xxxxxxx 0b0xxxxxxx て感じで, 上位 7ビットと下位7ビットに分れてるのだ。 値の範囲は, 解像度が 1016ライン/インチで, そのサイズが 5インチ × 7.1インチ。あとは勝手に計算してみよう。

相対座標

座標の数-1 個分 座標が繰り返し入っている。1つあたり 2 Bytes で, ソレは X座標, Y座標が それぞれ 1Byteずつ。 前の位置からの相対座標になっていて, 下位 7ビットは距離を, 最上位ビットで方向(符合)になる。てことで, どんなに長くても 127ドットまでな訳だよん。

他の情報源として, アプリケーションに対応するファイル名だとか, 手書き画像にテキストデータを添付できるかどーかとか, そーいった情報があるです。 はせがわ(あ)さんとこの edf2psのページれす。

Datebook

あ さて〜, 今度は, Datebook(予定表)なのら。 コレってゆーのが, 難しい使い方をしててもそーでなくても, 色々な使い方もできるよーに 構造はかなり複雑になってたりする。 コレを見れば, こんな使い方もできるのか？ とか思うに違いない。 ・・・ のかも。
で, ソースファイルは libsock/datebook.cと それから include/pi-datebook.hだお。

まずは, 先頭の部分(↓)。よくみると項目数とバイト数が合わない ! と, 思うかもだけど, 年月日は 2バイトなのら。 それから, 開始時刻(の時と分)が 0xffffなら時間の指定はないってこと。

んで, この 8バイトの後に数々のオプションがくっつく。ソレらは, flagsに示されてる通りのもので, もし flagsが 0x00なら, 後ろには何も付かないってことなのさっ。
で, まずは alarm。これは 2バイト。その値はとゆーと, たとえば 0x03 0x01 だったとすると, ３時間前にアラームを鳴らす ってこと。 って, アラームを予定時間の後に鳴らしても意味ないもんね。

で, repeat とゆーのは繰返し, つまり定期的な予定のこと。 先頭の repeatType は None, Daily, Weekly, MonthlyByDay, MonthlyByDate, Yearly のどれか(0〜5)。 コレによって, その後の構造も多少変化する。 ・・・ んだけど, 全体で 8バイトなのは変わらない。 あ, 終了日は 2バイトね。0xffffなら 終了日がないってこと。

repeatの項目, repeatOnは repeatTypeが Weekly (2)の時だと, bitフィールドとして幾つかの曜日を記録することになーる。 ソレは下位から順に, 日曜・月曜・火曜 ・・ 土曜 になる訳だね。だから 例えば 0x41なら 土・日ってこと。

repeatTypeが MonthlyByDay (3)の時だと, repeatOnの値で, その月の「ある日」を曜日でアレするって意味になるのだ。 つまり, その値を 7で割ると 余りが曜日を表していて, 答えがその週を表している ・・・ ってとこ。

       0:第一日曜 ......  6:第一土曜日
       7:第二日曜 ...... 13:第二土曜日
      14:第三日曜 ...... 20:第三土曜日
      21:第四日曜 ...... 27:第四土曜日
      28:最終日曜 ...... 34:最終土曜日

repeatWeekstartは, 普通は 0で「日曜始まり」。んで 1だと「月曜始まり」。 ただし, repeatTypeが指定されている場合のみ てことらしい。情報ありがと ＞宇野さん

それから, except は例外を表していて, 予定だけれど予定じゃないっつーか そんな感じ ・・・ なのかな？ そんな画面見たことないので分からないんだけど。(^^)
ソレが 一つしかなかったら 2 ＋ 2 × 1 ＝ 4バイト, みっつあったら 2 ＋ 2 × 3 ＝ 8バイト。

残るは, descと note。両方とも文字列で, だから 0x00で終わる構造。 descriptionってゆーのは, その予定のとこに書いた説明のこと。んで, noteはコメントとして書き込んだもの。
ま, どちらも単なる文字列なので図をアレする必要はないよね。だって, 図をアレするのって大変なんだもん。 (← ぉぃ)

PenPen, PenPenCol

今回は手書きメモの一つ PenPen のソレをアレしてみるにょ。 でも, だからって ペンギンが登場したり, 草が生えたりする訳じゃない。

PenPen の機能は どんなのかっつーと ・・・ 手書きメモが書ける。って, まんまだね。(^^)＼(☆バキッ
で, そのほかに, 4 Sectionの手書きメモを まとめ表示もできたりする。実は, 1ページ(=1レコード) は, 4 Sectionで構成されているのら。 つっても 高解像度のばやいは分かんないけど。でも, たぶんコレと同じなのかも。 そのうえ, 4ページ(つまり 16 Section)をまとめての表示も可能なのら。そーゆーののどこがアレなのかっつーと, 位置をずらすことで, 隣のマスに表示して重ね合せることもできるんだよ。 ・・・ どんな利用法があるのかは謎だけど。 地図と道順？ あ, ソレ よいかも。 ただ, 別のSection表示させたとこに 手書きメモを書き込むなんて出来ないんだけど。 (←じゃ, ダメじゃん)

基本的なこの構造は, ベクトルの集合。 てことで, コレを利用しての拡大縮小機能もついていたりするんだけど, ソレは置いといて ・・・。

「最大 約800本の線分」っつーのは, 始点(x,y) 〜 終点(x,y) の座標, コレが 1本の線(4バイト)として, 約 800本ってことなのら。 最後の 1本分(4バイトは)は空けてあるっぽい。 で, ソレが何本あるのかは「各Sectionの件数」のとこに入っていたりするのだ。

◇

ジツをゆーと, すでに PenPenのカラー版が公開されていて, コレの構造とは異なってるっぽい。 んで PenPenColは, まずその用語からして違う。 1ページを構成するものはフレームなのだ。

でも基本的には同じ構造なので, コレを扱うプログラムは共通にできるかも。