詰将棋用XMLビューア説明書

　詰将棋用XMLビューア（TMLView.xap、以下「本ビューア」または「TMLView」と略す）は、ブラウザ上でフェアリー詰将棋（変則詰将棋）を動かして鑑賞することを目的としたビューアです。

• 通常は使わない駒を使うことがある
• 駒の動きが普通と異なることがある

• 駒文字の表示に画像データを使わない
• ルールに関する知識がなくても再生可能な棋譜形式を使う

1. TMLViewが埋め込まれたページを閲覧する
2. TMLViewをオフラインで使う
3. TMLViewを自分のサイトで使う

2.2 TMLViewをオフラインで使う

TMLViewは自分のＰＣにあるXML棋譜を読み込み閲覧することができます。これはどこにあるTMLViewを使っても良いのですが、ＰＣにインストールしておけばネットに繋がっていない状態でも使うことができます。
この作業には、特に難しい点はありません。このサイトにあるTMLViewの表示画面で右クリックを行うと以下のようにインストールの選択肢が出ます。

このメニューから「このコンピュータにTMLViewをインストールします」を選択すると、次のようなインストール画面が出るので、必要な項目を選択してＯＫを押下してください。

インストールが終わったら、実際に起動してみてください。以下のような画面が出るので、「開く」から閲覧するXML棋譜を選んでください。（マウスを乗せると拡大表示）

今すぐインストールする場合は、以下のサンプルページをご利用下さい。
サンプルページ（別ウィンドウで表示）

インストールしたTMLViewをアンインストールする場合は、起動したTMLViewの画面を右クリックしてください。アンインストールのメニューが表示されます。（Del等で無理やり削除しないでください。不具合の原因になります。）

2.3 TMLViewを自分のサイトで使う

<object width="800" height="600"
    data="data:application/x-silverlight-2," 
    type="application/x-silverlight-2" >
    <param name="source" value="TMLView.xap"/>
    <param name="background" value="white"/>
    <param name="initParams" 
                value="Kifu=purity951.xml,CellSize=36"/>

    <!-- Display installation image. -->
    <a href="http://go.microsoft.com/fwlink/?LinkID=149156" 
        style="text-decoration: none;">
        <img src="http://go.microsoft.com/fwlink/?LinkId=108181" 
            alt="このページの表示はSilverlightが必要です" 
            style="border-style: none"/>
    </a>

</object>

本ビューアではXML形式で記述された棋譜を用いるので、まずは既存のファイルをこの形式に変換しなくてはいけません。テキストエディタでこれを記述するのも難しくはないのですが、手作業では結構面倒です。
幸い、神無次郎氏がfmviewにXML形式でファイルを保存する機能を付けてくれたので、fmo形式（ｆｍの出力形式）や、kif形式（Kifuwなど多くの将棋ソフトで使用されている形式）を自動的にXML形式の棋譜に変換することができます。

操作手順

1. fmviewで変換対象の棋譜を開き、「名前を付けて保存」（赤丸で囲ったアイコン）を選択します。

2. 「ファイルの種類」を「fmXMLファイル」とし、名前を付けて保存します。

3. 保存したファイルをエディタで開き、必要に応じ固定項目（赤で囲った項目）やコメント（青で囲った項目）を編集すれば棋譜の準備は完了です。

fmviewの変換機能に頼らず、テキストエディタで直接XML棋譜を作成する場合や、変換後のXML棋譜をエディタで編集する場合の注意点がひとつあります。
それは保存するときのコードを「UTF-8」にすることです。
理念上、XMLは文字コードに依存しない言語体系なのですが、実際に世に出回っているツールやライブラリは文字コードがUTF-8でないと動かないものが多いのです。
本ビューアも余計な手間を省くため、UTF-8でXML棋譜が記述されていることを前提としています。

ボタンとコントロール

	最初の局面を表示します。
	自動で局面を戻します。局面を表示する間隔は横にあるスライダーで調整してください。
	表示中の局面から一つ前の局面に戻します。
	局面の自動再生を停止します。
	表示中の局面から一つ先の局面に進めます。
	自動で局面を先に進めます。局面を表示する間隔は横にあるスライダーで調整してください。
	最後の局面を表示します。
	ローカルファイルを開くためのダイアログを表示します。お使いのＰＣ上にある棋譜ファイルを閲覧するときにお使い下さい。
	XML棋譜編集パネルを表示します。閲覧中の棋譜を変更したり、お使いのＰＣ上に保存したりする時に使います。
	手順パネルを表示します。手順を一覧表示し、ダイレクトに指定の局面に移動することができます。
	作品情報パネルを表示します。局面に依存しない固定項目（作者名等）を見るときに使います。
	コメントパネルを表示します。各局面に対するコメントを見るときに使います。

	自動再生の時に局面を表示する間隔を調整するためのスライダーです。間隔を短くするときはツマミの左側を、長くするときは右側をクリックします。ツマミを直接動かすと、大きく値を変えることができます。 表示間隔の単位はms（ミリ秒）で、表示中の変更も可能です。最小値は1msですが、実際はそんなに早く表示できません。
	盤の升目の大きさを調整するためのスライダーです。升目を小さくするときはツマミの左側を、大きくするときは右側をクリックします。ツマミを直接動かすと、大きく値を変えることができます。 升目の大きさに合わせ駒文字の大きさも同時に変化します。

タイトル部

• <作者名>、<作品名>の表示欄。作者名には“作”が付加され、作品名は「」で囲まれます
• <発表年月>、<発表場所>の表示欄。全体は()で囲まれます。
• <ルール>、<総手数>の表示欄。総手数には「手」が付加されます。

局面部

• <手数>、<指手>の表示欄
• 局面の表示欄。<攻方配置><受方配置>が反映されます。受方の駒文字は180°回転して表示されます。
• 攻方持駒、受方持駒の表示欄。受方持駒が省略されているときは、表示されません。

ダイアログ画面及び各種パネル

ファイルダイアログ

XML棋譜表示・編集パネル

手順表示パネル

作品情報パネル

コメントパネル

★10×10以上の盤への対応

古将棋を扱えるよう盤の大きさの上限を36×36としました。これは大局将棋が扱えるようにするためです。
ただし、長方形盤には対応していません。必要な場合は正方形盤の部分領域をご利用することで対応して下さい。
サンプルとして中将棋盤（12×12）の表示例を用意しました。盤が10×10以上の場合の表示やXML棋譜の書式をこれでご確認下さい。
中将棋盤の表示例（別ウィンドウで表示）

★可変サイズ

盤のマスの大きさと駒文字の大きさを可変としました。ビューア全体のサイズを変更する場合は、ブラウザのズーム機能をお使いください。表示領域全体が指定した倍率で表示されるはずです。

★巨大な棋譜の読み込みへの対応

理論上は棋譜の大きさの制限はありませんが、XML棋譜のサイズは通常の棋譜ファイルに比べ大きくなるので、ダウンロードに掛かる時間やメモリサイズに考慮して棋譜を指定してください。
オフラインで使う場合はかなり大きなファイルでも（棋譜読み込み時間を我慢すれば）ご利用できます。例えば加藤徹氏作「寿限無３」（49909手）でも、オフラインであれば差し支えなく閲覧できます。

• 編集機能の追加
  表示項目の多くは表示専用ではなく、入力も可能なテキストボックスになっています。これは表示画面を入力にも使えるようにと考えてそうしたのですが、現在未着手です。
   
• パラメータの追加
  パネルの表示・非表示、表示位置、フォントや色調など、可変にした方が良いと思われる項目はたくさんあります。これらの設定や初期値のパラメータの追加が望ましいですが、これらも未着手です。
   
• 複数棋譜の利用
  複数の棋譜を指定して「作品集」として表示する機能の追加。XML棋譜の形式を拡張して「詰将棋」の上に「詰将棋集」というノードを設けるか、あるいは単にファイルの寄せ集めにするか、要検討です。
   
• 分岐棋譜の検討
  これはXML棋譜のデータ形式から検討しなければいけませんが、分岐棋譜をどう表現し、表示していくかは今後の課題と考えています。