------------------------------------------------------------------------
slBmpViewer
Version 1.3
Copyright (C) 2002-2004 Stadio Lilla
Web Page: http://stadiolilla.com/
------------------------------------------------------------------------
1. slBmpViewer とは
2. 動作環境
3. 動作確認
4. 配布形態
5. 梱包内容
6. 使用方法
7. 他アプリケーションからの呼び出し方法
8. 確認事項
9. 免責事項
10. 謝辞
11. 改版履歴
1. slBmpViewer とは
slBmpViewer は、外部メモリーカード上の BMP ファイルを表示するアプリ
ケーションです。
Palm デバイスが 16ビット(65,536色)対応機であれば、全ての形式の BMP
ファイル(Windowsタイプ、OS/2タイプ、非圧縮、圧縮、1ビット、4ビット、
8ビット、24ビット)を表示する事ができます。(表示可能な BMP ファイルの
サイズはメモリーの空き領域に依存します)
他アプリケーションからの呼び出しにも対応しています。
最大の特徴は、基本的な操作がスタイラスを全く使用せずに行える事です。
2. 動作環境
外部メモリーカードを装備し、Palm OS 3.5 以上が搭載されている Palm デ
バイス上で動作します。
※ Palm OS 5.x には対応していません。
SONY CLIE シリーズのハイレゾスクリーンと Jog ダイアルに対応していま
す。また、NR70 の縦長ハイレゾスクリーンにも対応しています。
画像を表示するという性格上、メモリーには十分な空き領域が必要です。
3. 動作確認
実機 SONY PEG-N700C(OS 4.1S)、CLIE PEG-T650C
POSE Palm m500、m505
SONY PEG-S300、PEG-S500C、PEG-N700C、PEG-N710C、
PEG-N750C、PEG-N760C、PEG-T400、PEG-T600C、
PEG-T615C、PEG-NR70
4. 配布形態
このアプリケーションはフリーウェアです。
5. 梱包内容
slBmpView.prc slBmpViewer 本体
Readme.txt ReadmeJ.txt の英語版
ReadmeJ.txt このファイル
slBmpView_jpJP.prc 日本語オーバーレイ
FileManageType.h 他アプリケーションから slBmpViewer を呼び出す際に
使用する C言語用ヘッダファイル
6. 使用方法
a. インストール
slBmpView.prc を Palm デバイスにインストールします。
表示を日本語にしたい場合は slBmpView_jpJP.prc もインストールしま
す。
b. 起動
ランチャーから slBmpView を起動します。
この時、外部メモリーカードが装備されていないかメモリーカードが挿
入されていない場合はエラーメッセージを表示して終了します。
起動直後はファイル一覧画面が表示されます。
c. ファイル一覧画面
初回起動時は、メモリーカードのルートディレクトリのファイル一覧
(ディレクトリと BMP ファイルのみ)を表示します。
次回以降は、終了時に表示されていたディレクトリを起動時に表示する
様になります。
上下ボタン、Jog ダイアル、スタイラスのいずれかで任意のファイルま
たはディレクトリを選択します。
ディレクトリが選択されている状態で Open 機能ボタン(初期状態では
アドレスボタン)または Jog ダイアルを押すかスタイラスで再度タップ
すると、ディレクトリを移動します。
ファイルが選択されている状態で Open 機能ボタンまたは Jog ダイア
ルを押すかスタイラスで再度タップすると、画面右下の View モードに
沿った処理を行います。
View モードが「Image(イメージ)」の場合、画像を表示します。
View モードが「Info(情報)」の場合、ファイル情報を表示します。
ファイルまたはディレクトリが選択されている状態で Cancel 機能ボタン
(初期状態では予定表ボタン)または Back ボタンを押すかスタイラスで
ファイル一覧の枠外をタップすると、選択を取り消します。
View モードをタップすると、Image(イメージ) と Info(情報) とが交互
に切り替わります。
何も選択されていない状態で Open 機能ボタンまたは Jog ダイアルを
押した場合にも、同様に View モードが切り替わります。
d. 画像表示画面
画像がスクリーンより大きい場合は、各スクロール機能を割り当てたボ
タンを押すか Jog を操作する事で画像をスクロールさせる事ができま
す。初期状態での機能割り当ては以下の通りです。
予定表ボタン Close (ファイル一覧に戻る)
アドレスボタン 左 1/4 スクロール
上ボタン 上 1/4 スクロール
下ボタン 下 1/4 スクロール
ToDo ボタン 右 1/4 スクロール
メモ帳ボタン なし
Jog アップ 上 1/4 スクロール
Jog ダウン 下 1/4 スクロール
Jog プッシュドアップ 右 1/4 スクロール
Jog プッシュドダウン 左 1/4 スクロール
Jog プッシュ 上/下 <-> 右/左
Back ボタン Close (ファイル一覧に戻る)
上/下 <-> 右/左 機能が割り当てられた操作を行うと、一時的に上スク
ロール機能と右スクロール機能が、下スクロール機能と左スクロール機
能が入れ替わります。これは一時的な機能入れ替えですので、設定内容
には影響しません。
また、スタイラスをドラッグして画像を任意の方向にスクロールさせる
事も可能です。
Close 機能が割り当てられた操作を行う(初期状態では予定表ボタンま
たは Back ボタンを押す)か、スタイラスで Graffiti エリアにバック
スペースを入力する(右から左に線を書く)か、スタイラスでスクリーン
をダブルタップすると、ファイル一覧画面に戻ります。
e. ファイル情報表示画面
BMP ファイルのヘッダー情報を全て表示します。
画面の OK ボタンをタップするか Cancel 機能ボタンまたは Back ボタン
を押すと、ファイル一覧画面に戻ります。
f. メニュー
ファイル一覧画面でタイトルをタップするかシルクスクリーン上のメ
ニューボタンをタップすると、メニューが表示されます。
Preferences BMP ファイルの識別方法や各ボタンへ機能割
(設定) り当てを変更する事ができる Preferences
画面を表示します。
Jog Preferences 画像表示画面での Jog への機能割り当てを
(ジョグ設定) 変更する事ができる Jog Preferences 画面
を表示します。
(SONY CLIE シリーズの場合のみ表示)
About slBmpViewer About 画面を表示します。
(slBmpViewerについて)
g. Preferences (設定) 画面
Preferences (設定) 画面では以下の項目の設定を変更する事ができます。
Recognize BMP file by BMP ファイルの識別方法。
(BMPファイル識別方法) 拡張子(Ext)、ファイルヘッダ(Header)
のどちらかを選択します。
拡張子を選択した場合、拡張子が BMP、
DIB、RLE のファイルを BMP ファイルと
みなします。
Open (=Jog Push) ファイル一覧画面での Open 機能ボタン。
(オープン) Jog のプッシュは常に Open 機能となり
ます。
None(なし)、Datebook(予定表)ボタン、
Address(アドレス)ボタン、ToDoボタン、
Memopad(メモ帳)ボタンのいずれかを割
り当てます。
Cancel (=Jog Back) ファイル一覧画面での Cancel 機能ボ
(キャンセル) タン。
Back ボタンは常に Cancel 機能となり
ます。
None(なし)、Datebook(予定表)ボタン、
Address(アドレス)ボタン、ToDoボタン、
Memopad(メモ帳)ボタンのいずれかを割
り当てます。
Open 機能と Cancel 機能に同じボタン
を割り当てる事はできません。
Datebook (予定表) 画像表示画面での予定表ボタンの機能。
Address (アドレス) 画像表示画面でのアドレスボタンの機能。
Page Up (上) 画像表示画面での上ボタンの機能。
Page Down (下) 画像表示画面での下ボタンの機能。
ToDo 画像表示画面での ToDo ボタンの機能。
Memopad (メモ帳) 画像表示画面でのメモ帳ボタンの機能。
上記 6つのボタンには、以下の機能のうちの 1つを割り当てる
事が可能です。
None 機能なし
Close ファイル一覧画面に戻る
Scroll Up 上スクロール
Scroll Up 1/2 上 1/2 スクロール
Scroll Up 1/4 上 1/4 スクロール
Scroll Left 左スクロール
Scroll Left 1/2 左 1/2 スクロール
Scroll Left 1/4 左 1/4 スクロール
Scroll Down 下スクロール
Scroll Down 1/2 下 1/2 スクロール
Scroll Down 1/4 下 1/4 スクロール
Scroll Right 右スクロール
Scroll Right 1/2 右 1/2 スクロール
Scroll Right 1/4 右 1/4 スクロール
画面の OK ボタンをタップすると設定を保存してファイル一覧画面に戻
ります。
画面の Cancel ボタンをタップするか Cancel 機能ボタンまたは Back
ボタンを押すと、設定を保存せずにファイル一覧画面に戻ります。
h. Jog Preferences (ジョグ設定) 画面
Jog Preferences (ジョグ設定) 画面では以下の項目の設定を変更する事
ができます。
Up 画像表示画面での Jog アップ操作の機能。
Down 画像表示画面での Jog ダウン操作の機能。
Pushed Up 画像表示画面での Jog プッシュドアップ操作の
機能。
Pushed Down 画像表示画面での Jog プッシュドダウン操作の
機能。
Push/Release 画像表示画面での Jog プッシュ操作の機能。
Back 画像表示画面での Back ボタンの機能。(Back ボ
タンがある場合のみ表示)
上記 6つの操作またはボタンには、以下の機能のうちの 1つを
割り当てる事が可能です。
None 機能なし
Close ファイル一覧画面に戻る
Scroll Up 上スクロール
Scroll Up 1/2 上 1/2 スクロール
Scroll Up 1/4 上 1/4 スクロール
Scroll Left 左スクロール
Scroll Left 1/2 左 1/2 スクロール
Scroll Left 1/4 左 1/4 スクロール
Scroll Down 下スクロール
Scroll Down 1/2 下 1/2 スクロール
Scroll Down 1/4 下 1/4 スクロール
Scroll Right 右スクロール
Scroll Right 1/2 右 1/2 スクロール
Scroll Right 1/4 右 1/4 スクロール
U/D <-> R/L 上/下 <-> 右/左 スクロールの一時
入れ替え
画面の OK ボタンをタップすると設定を保存してファイル一覧画面に戻
ります。
画面の Cancel ボタンをタップするか Cancel 機能ボタンまたは Back
ボタンを押すと、設定を保存せずにファイル一覧画面に戻ります。
i. About 画面
バージョン情報等を表示します。
画面の OK ボタンをタップするか Cancel 機能ボタンまたは Back ボタン
を押すと、ファイル一覧画面に戻ります。
j. 終了
シルクスクリーン上のホームボタンをタップするか、ファイル一覧画面
が表示されていて何も選択されていない状態で Cancel 機能ボタンを押
すと、アプリケーションを終了してランチャーに戻ります。
7. 他アプリケーションからの呼び出し方法
ファイルマネージャ等のアプリケーションから slBmpViewer を呼び出して
BMP ファイルを表示したい場合は、以下の手順で行って下さい。
a. 必要なパラメータをセットして CMDPARAMINIT マクロを呼び出します。
(第1パラメータは 'mFil' 固定、第2パラメータ〜第4パラメータは例を
参照の事)
b. タイプ 'appl'、クリエーターID 'vBmp' のデータベースのカードNO と
データベースID を取得します。
c. パラメータに BMP ファイルのフルパスをセットして、取得したカードID
とデータベースID でアプリケーションを起動します。
d. エラーが発生した場合は、CMDPARAMFREE マクロを呼び出します。
パラメータを受け取ると、slBmpViewer はファイル一覧画面をスキップして
BMP イメージを表示します。そして、終了時はランチャーに戻らずに直前の
アプリケーションに戻ります。
例)
#include "FileManageType.h"
UInt16 cardNo;
LocalID dbID;
DmSearchStateType state;
Err error;
CMDPARAMINIT('mFil', メモリーカードのボリューム番号,
BMPファイルのフルパス, error);
if (!error)
error = DmGetNextDatabaseByTypeCreator(true, &state, 'appl',
'vBmp', true, &cardNo, &dbID);
if (!error)
error = SysUIAppSwitch(cardNo, dbID, AppLaunchFromSLFM, cmdParam);
if (error)
CMDPARAMFREE();
8. 確認事項
BMP ファイルの色数には 1ビット(モノクロ)、4ビット(16色)、8ビット(256
色)、24ビット(16,777,216色)の 4種類がありますが、Palm デバイスの表示
可能色数が 1ビット(モノクロ)、2ビット(4階調)、4ビット(16階調)、8ビッ
ト(256色)の場合、表示可能色数より大きい色数を持つ BMP ファイルを表示
する事はできません。
Palm デバイスの表示可能色数が 16ビット(65,536色)の場合のみ、24ビット
の BMP ファイルを 16ビットに変換して表示します。
9. 免責事項
このアプリケーションを使用した事によって発生したいかなる問題にも作者
はその責を負わないものとします。
10. 謝辞
BMP (DIB) ファイルの仕様について
- 八城 年伸さん
「DIB(BMP)フォーマットの構造説明書」がなければ作成をあきらめていた
事でしょう。
Palm OS プログラミングに関して
- Palm OS 4 バイブル (山田達司さん監訳)
まさにバイブルです。今回は様々な機能を盛り込ませる必要があった為、
ひっきりなしにめくっていました。
SONY CLIE シリーズ対応に関して
- CLIE デベロッパーサイト
SDK やドキュメントはもちろん、山田さん、しゃあみんさんの講座(高座?)
にも大変お世話になりました。
その他
- その他多くの WEB リソースを参考にさせて頂きました。
皆様に大変感謝しております。ありがとうございました。
11. 改版履歴
1.3 (2004/02/01)
- 機能修正
BMPファイルのヘッダーチェックを少し甘くした
1.2 (2002/09/15)
- 機能追加
オーバーレイに対応して、表示を日本語にする日本語オーバーレイを同
梱した
他のアプリケーションからの起動方法を変更してヘッダファイルを同梱
した
- 不具合修正
ハイレゾ機でない場合、終了時にスクリーンモードを元に戻していなかっ
たのを修正した
1.1 (2002/08/15)
- 機能追加
他のアプリケーションからの起動に対応した
1.0 (2002/08/11)
- 正式版としてリリース
英語版ドキュメントを同梱した
0.1b3 (2002/08/09)
- 機能追加
ファイル一覧画面も SONY PEG-NR70 の縦長ハイレゾスクリーンに対応
させた
- 不具合修正
2バイト文字を使ったディレクトリがある場合にソート処理でループに
陥る事があるのを修正
0.1b2 (2002/08/07)
- 機能追加
スタイラスでの画像スクロール機能を追加(それに伴いスタイラスでの
Close 操作方法を変更)
Jog 操作による上下スクロールと左右スクロールの機能を一時的に入れ
替える機能を追加(Jog の割り当て機能に U/D <-> R/L を追加)
- 不具合修正
画像表示エラーの際にスクリーンタップ以外でファイル一覧に戻れない
のを修正
BMP 識別、ファイル一覧ソートの際の拡張子を最後の . 以降の文字列
とする様に修正
親ディレクトリ(..)が _ 等で始まるディレクトリより後に並んでしま
うのを修正
0.1b1 (2002/08/03)
- 基本的な機能が完成したのでβ版とした
圧縮ファイル形式に対応
24ビット画像を 16ビットに変換して表示する機能を追加
- 不具合修正
VFS のボリューム取得の際にエラー判定が正しく行われていなかったの
を修正
0.1a4 (2002/08/01)
- α版として最初の公開
Palm OS のビットマップへ変換して表示する様に変更 (速くなった)
画像のスクロール機能を追加
但し、圧縮ファイルには未対応
0.1a3 (2002/07/30)
- 非公開
Pixel 描画による BMP 表示機能を追加 (めちゃめちゃ遅いっす)
24ビットを除く全てのフォーマットの BMP ファイルを表示可能
0.1a2 (2002/07/26)
- 非公開
BMP ファイル識別機能(拡張子およびファイルヘッダーチェック)とヘッ
ダー情報表示機能を追加
0.1a1 (2002/07/23)
- 非公開
メモリーカードのファイラーとしての機能がほぼ完了
|