将棋棋譜再現 Java Applet "Kifu for Java"

2007.5.17 柿木　義一

１．ソフトの概要

ホームページ(Web)上で将棋の棋譜を再現する Java Applet です。

特徴：

• 殆どのブラウザが対応（Java 1.1）。
• 柿木形式の棋譜ファイル(*.kif)を直接再現します。
• 平手、駒落ち、詰将棋の棋譜に対応しています。
• 各指し手のコメントを表示します（オプションで表示なし可）。
• 変化手順を再現できます。
• 棋譜の指し手をクリックすることで、その局面の表示ができます。
• 棋譜ファイルを保存できます。
• 自動更新が可能で、対局の中継ができます。
• 棋戦名、場所、持ち時間を表示できます。
• 将棋盤は、木目・無地切り替え可能。
• 駒・盤・駒台の画像は変更可能。
• 駒の小さいLight版もあります。

２．制限

• KI2形式には対応していません。
• ジオシティーズ等、棋譜ファイルをサーバへ転送できないプロバイダでは、拡張子を txt に変えて下さい。
• 棋譜ファイルは、SHIFT-JISコードになっている必要があります。
  Kifu for Windows や柿木将棋が出力するのは、SHIFT-JISコードです。
• 棋譜の最大手数は、変化を含め、3000手です。

３．動作環境

Java 1.1

対応ブラウザ：
Windows:

• Microsoft Internet Explorer 4.01以上
• Firefox
• Netscape Communicator 4.06以上

Macintosh (OS X):

• Safari
• Firefox
• Microsoft Internet Explorer

Macintosh (Classic):

• Microsoft Internet Explorer 4.5以上

（注）

• Java を有効にしなければなりません。
• Macintosh (OS X)では、棋譜のスクロールができない場合があります。
  Safari を推奨します。

４．ファイルの構成

・通常版

・Light版

・データ等

５．使用法

(1) ファイル

• サーバ上で、Kifu for Java を使用するディレクトリを作成します。
• ここに、kifuj.jar、koma.gif、komaoto.au、ban.jpg、komadai.jpg （Light版ならLight版用のファイル）を転送します。
  これらのファイルは、バイナリモードで転送しなければいけません。
• 棋譜ファイルは、そのディレクトリ、または、サブディレクトリに転送します。
  （位置はパラメータで指定）

(2) HTMLファイル
HTMLファイルに以下のように記述します。

• 通常版

<APPLET
CODEBASE = "."
CODE = "kifuj.Applet1.class"
ARCHIVE = "kifuj.jar"
WIDTH = 580
HEIGHT = 456
HSPACE = 0
VSPACE = 0
ALIGN = middle
>
<PARAM NAME=KIFU VALUE="test.kif"> ←棋譜ファイル名を指定します。
<PARAM NAME=HELP VALUE="kifujhelp.html"> ←HELPファイル名を指定します（オプション）。
</APPLET>

• Light版

<APPLET
CODEBASE = "."
CODE = "kifujl.Applet1.class"
ARCHIVE = "kifujl.jar"
WIDTH = 480
HEIGHT = 383
HSPACE = 0
VSPACE = 0
ALIGN = middle
>
<PARAM NAME=KIFU VALUE="test.kif"> ←棋譜ファイル名を指定します。
<PARAM NAME=HELP VALUE="kifujhelp.html"> ←HELPファイル名を指定します（オプション）。
</APPLET>

• ファイル名は、アプレットのあるディレクトリからの相対表現とします。
• HELPファイルは、ファイル名を変え、任意のHTMLファイルにすることができます。
• HELPファイル指定の行をなくすと、HELPボタンも消えます。
• ファイル名に日本語を使ってはいけません。
• ファイル名の大文字と小文字の違いがあってはいけません。
• 駒音ファイルがないと、駒音なしとなります。

• 木目を使用しないときは、次の指定をします。
  <PARAM NAME=NO_MOKUME VALUE="1">

• 最終駒を強調しないときは、次の指定をします。
  <PARAM NAME=NO_LAST VALUE="1">

• 最終駒の強調色を指定するときは、次の指定をします。
  <PARAM NAME=LAST_COLOR VALUE="100 200 100"> 赤、緑、青の順で各0-255

• ページを開いたとき、指定手数の局面を表示するときは、次の指定をします。
  <PARAM NAME=START_TESUU VALUE="（手数）">
  （手数）は半角数字、LASTで最終局面

• 棋譜を表示しないオプション
  <PARAM NAME=NO_KIFU VALUE="1"> 棋譜を表示しない、棋譜表示ボタンあり、再現不可
  <PARAM NAME=NO_KIFU VALUE="2"> 棋譜を表示しない、棋譜表示ボタンなし、再現不可
  <PARAM NAME=NO_KIFU VALUE="3"> 棋譜を表示しない、棋譜表示ボタンなし、再現可能
  棋譜表示しない設定のページを棋譜表示ボタンで表示した場合、ブラウザの更新で棋譜は消えます。

• 自動更新
  一定時間毎に棋譜ファイルを読み込み、最新の棋譜を表示する機能です。
  対局の中継に便利です。
  <PARAM NAME=AUTO_UPDATE VALUE="1"> 30秒毎に自動更新する
  <PARAM NAME=AUTO_UPDATE VALUE="2"> 60秒毎に自動更新する
  <PARAM NAME=AUTO_UPDATE VALUE="3"> ３分毎に自動更新する
  なお、
  <PARAM NAME=START_TESUU VALUE="LAST">
  も使わないと、最新の局面を表示しません。
  
• 自動更新設定メニューの表示（通常版のみ）
  自動更新の間隔を設定するメニューを表示するオプション
  <PARAM NAME=UPDATE_MENU VALUE="1"> 自動更新メニューを表示する
  自動更新メニューの初期値は、"AUTO_UPDATE" の設定に従います。

• 変化手順を使用しないオプション
  <PARAM NAME=NO_HENKA VALUE="1"> 変化手順を使用しない
  [+<] [>+] 変化選択のボタンを表示しません。
  <PARAM NAME=NO_HENKA VALUE="0"> 変化手順を使用する。
  <PARAM NAME=NO_HENKA VALUE="2"> 棋譜に変化があるときのみ、変化手順を使用する。
  指定の無い場合は、"2" の動作となります。

• 棋譜コメントを表示しないオプション
  <PARAM NAME=NO_COMMENT VALUE="1"> 棋譜コメントを表示しない
  HEIGHT 380 程度に小さくします。
  
• 棋譜の消費時間を表示するオプション（通常版のみ）
  <PARAM NAME=DISP_TIME VALUE="1"> 消費時間を秒単位で表示する
  
• 残り時間を表示するオプション（通常版のみ）
  <PARAM NAME=NOKORI_JIKAN VALUE="1">　残り時間を表示する
  残り時間を表示するためには、棋譜ファイルの棋譜情報で、持ち時間と消費時間を設定する必要があります。
  消費時間は、次の形式で記述します。
  
  手数▲先手の消費時間（分）△後手の消費時間（分）
  
  持ち時間は、全角（または半角で）で「Ｎ時間」と記述します。分がある場合は、半角２桁で「NN分」と記述します。

例：
---------- 棋譜ファイル --------------
消費時間：159▲347△359
持ち時間：４時間06分
-----------------------------------

• 対局中継例：
  　自動更新あり、自動更新設定メニュー表示、最終局面表示、棋譜コメントを表示しない

<APPLET
CODEBASE = "."
CODE = "kifuj.Applet1.class"
ARCHIVE = "kifuj.jar"
WIDTH = 580
HEIGHT = 380
HSPACE = 0
VSPACE = 0
ALIGN = middle
>
<PARAM NAME=KIFU VALUE="test.kif"> ←棋譜ファイル名を指定します。
<PARAM NAME=HELP VALUE="kifujhelp.html"> ←HELPファイル名を指定します（オプション）。
<PARAM NAME=AUTO_UPDATE VALUE="1"> 30秒毎に自動更新する
<PARAM NAME=UPDATE_MENU VALUE="1"> 自動更新設定メニューを表示する
<PARAM NAME=START_TESUU VALUE="LAST"> 自動更新で最終局面を表示する
<PARAM NAME=NO_COMMENT VALUE="1"> 棋譜コメントを表示しない
<PARAM NAME=NOKORI_JIKAN VALUE="1">　残り時間を表示する
</APPLET>

６．棋譜ファイル

棋譜ファイルは、フリーソフトの Kifu for Windows, Kifu for Macintosh 、または、柿木将棋シリーズで作成できます。

７．画像ファイル

koma.gif や ban.jpg を変更すれば、駒・盤を変えることができます。

８．情報の表示

右上の欄には、次の情報を表示します。

▲先手名　　　　
△後手名　　　　
開始日時 　
棋戦名　　　　　
場所　　　　　　
手合割：　
手数： 　
***** まで
棋譜 手
本手順/変化手順

開始日時、棋戦名、場所のいずれかの記述がなく、持ち時間の記述があれば、持ち時間を表示します。

９．詰将棋情報の表示

作者が設定されているとき、

作者
作品名
出典 or 発表誌
発表年月

を表示します。

10．うまくいかないとき

Javaコンソール（12.参照）を使うと、エラーメッセージ（11.参照）を見ることができます。

確認項目：

• ファイル名の大文字と小文字の違いがないですか？
• 棋譜ファイルは、SHIFT-JISコードになっているでしょうか？
  棋譜が表示されない、との問い合わせで、EUCコードになっている場合がありました。

・棋譜保存ボタンを押しても保存できない場合

• ツール等でポップアップを抑制しているときは、解除して下さい。
• Internet Explorer では、「インターネットオプション」の「セキュリティの設定」で、「ファイルのダウンロード時に自動的にダイアログを表示」を「有効にする」としてみて下さい。

Javaプラグインは、次のURLからダウンロードできます。
http://java.com/ja/

・アプレットを変更したときは、ブラウザをすべて終了し、再起動しないと変更されません。

11．警告・エラーメッセージ

***ERROR 101: KIFU is null 棋譜の指定がありません。
***WARN 102: KOMAOTO is null 駒音ファイルがありません。
***ERROR 103: kifu file not found: "ファイル名" 棋譜ファイルが見つかりません。
棋譜があるか、名前が正しいか、ご確認下さい。

***ERROR 104: cannot access koma.gif koma.gif が読めません。
***WARN 105: cannot access ban.jpg ban.jpg が読めません。
***WARN 106: cannot access komadai.jpg komadai.jpg が読めません。

12．Javaコンソールの表示法

(1) Windows: Microsoft Internet Explorer 5.0/5.5/6.0

ツール/インターネットオプション/詳細設定/Microsoft VM
Java コンソールの使用　をチェックする
表示/Java コンソール　を実行

SunのJAVAプラグインを使っている場合：

ツール/SunのJAVAコンソール

(2) Windows: Netscape Communicator 4.7

Communicator/ツール/Java Console を実行

(3) Macintosh: Microsoft Internet Explorer 5.0

表示/Java メッセージ　を実行

13．履歴

2000.12.14 V0.00 を公開

2000.12.17 V0.01 を公開
・Macで正しく動作しなかった（classicblueさんの報告）。

2000.12.18 V0.02 を公開
・example.html の記述が間違っていた。
・HELPボタンを追加。
・棋譜サイズを表示。

2000.12.22 V0.03 を公開
・駒画像をプログラムと同じディレクトリに
・使えないボタンを無効化する。
・本手順か変化手順かを表示。

2000.12.23 V0.04 を公開
・エラーになる棋譜があった問題を修正（mozuyamaさんの報告）。

2000.12.27 V0.10 を公開
★盤と駒台を木目に。

2000.12.29 V0.11 を公開
・Windows の Netscape Communicator で木目が表示されなかった。
・木目を使わないオプションを追加

2000.12.29 V0.12 を公開
・表示を改良

2000.12.29 V0.20 を公開
★棋譜と分岐を表示

2001.1.22 V0.21 を公開
・サイズを小さく 60KB->57KB
・対局日を表示
・表示を改良

2001.3.21 V1.00 を公開
・将棋倶楽部24の棋譜に対応

2001.4.9 V1.10 を公開
・最終駒を強調しないオプションを追加
・最終駒の強調色を指定可能に

2001.5.25 V1.11 を公開
・最終局面を表示するオプションを追加
・サイズを小さく 57KB->52KB
・不詰に対応

2001.5.27 V1.20 を公開
・変化ボタンを>+に
★小さい駒のLight版を追加

2001.5.30 V1.21 を公開
・分岐を進めたときの動作・棋譜の表示が正しくなかった(V1.11/1.20)。

2001.7.12 V1.22 を公開
・一部の環境で +< のボタンが動作しなかった問題を回避（mozuyamaさんの報告）。

2001.9.22 V1.23
・分岐の無い棋譜で +< のボタンが有効になった問題を修正
・詰将棋情報を表示する

2001.9.22 V1.24
・棋譜を表示しないオプションを追加

2001.9.25 V1.25
・詰将棋情報の表示を変更

2001.10.15 V1.26
・駒を打ったときの表示が正しくなかった問題を修正（駒落ＡＢＣさんの報告）。
・最初の手数を指定可に。

2002.12.5 V2.00
★自動更新機能の追加
・棋譜コメントを表示しないオプションの追加
・棋戦名、場所、持ち時間を表示

2004.08.27 V2.02
・開始日時が３文字以下だと実行できなかったバグの修正

2004.08.27 V2.03
・手合割がその他等でエラーになったバグの修正

2004.11.16 V2.04
・棋譜最大を2000手から3000手に拡大
・オプションを追加：<PARAM NAME=NO_KIFU VALUE="3"> 棋譜を表示しない、棋譜表示ボタンなし、再現可能

2005.08.26 V2.05
★盤面反転ボタンの追加
・変化手順を使用しないオプションを追加
・"対局日："、"棋戦："、"場所："を表示しないように
・自動更新の５分を３分に変更

2005.09.18 V2.06
・棋譜に変化手順があるときだけ変化ボタンを表示するオプションを追加
・反則負けに対応

2005.12.27 V2.07
・盤駒の色を変更（従来のものも使用可能）
・*/*手と間違った表示をしたバグの修正
・▽の表示を△に変更
・説明書（このファイル）を HTML に

2006.3.13 V2.10

• 駒落ちの棋譜を正しく再現できない場合があったバグの修正
• 消費時間を表示するオプションを追加
  <PARAM NAME=DISP_TIME VALUE="1">
• 自動更新時のサーバの負荷を軽減

2007.2.1 V2.25

• 自動更新設定メニューを表示するオプションを追加（通常版のみ）
  <PARAM NAME=UPDATE_MENU VALUE="1">
• 残り時間を表示するオプションを追加（通常版のみ）
• 自動更新時のサーバの負荷を軽減(V2.10)を中止（一部のサーバで正しく動作しないため）
• 駒台の画像を変更

2007.5.17 V2.26

• Java1.6で自動更新が働かない場合があった問題の対策