<?xml version="1.0" encoding="Shift_JIS" ?>
<doc>
<title>Releaser</title>

<para>
<ptitle>Releaserについて</ptitle>
　Releaser は、フォルダをアーカイブファイルにまとめるためのツールです。<r/>
　また、吉里吉里のプロジェクトフォルダを指定し、そのプロジェクトフォルダを内部に持った単一の実行可能ファイルを作成することができます。<r/>
</para>

<para>
<ptitle>Releaser の使い方</ptitle>
<img src="ReleaserSelect.png"/><r/><r/>
　Releaser ( tools フォルダにある krkrrel.exe ) を実行すると、最初にフォルダを指定するように求められますのでフォルダを指定してください。<r/>
　ここで指定したフォルダの中にあるファイルを対象にします。<r/>
<r/>
<note>
　Releaser は、最終的なアーカイブを作成する過程で内容が全く同一のファイルを見つけると、たとえファイル名が異なっていても一つにまとめて、一つ分のファイルの容量しか使用しないという機能があります。
</note>
<note>
　Releaser は、CVS メタ情報ディレクトリ("CVS"という名前で、中に"Repository"という名前のファイルが存在するディレクトリ)を自動的に無視します。また、名前の先頭が . (ドット)で始まるファイルやディレクトリ(UNIX風の隠しファイルや Subversion メタ情報ディレクトリなど)を無視します。
</note>
<note>
　Releaser は、アーカイブを作成すると、アーカイブを作成したディレクトリに <kw>default.rpf</kw> というファイルを作成します。この中にはアーカイブを作成する際のオプションが記述されており、次回アーカイブを作成するときに同じ設定で簡単に作成することができます。
</note>
</para>

<para>
<ptitle>Releaser の設定画面</ptitle>
　フォルダを選択した後は設定画面になります。<r/>
<dl>
<dt>「フォルダ選択に戻る」ボタン</dt>
<dd>
　フォルダ選択をやり直す事ができます。
</dd>

<dt>「プロファイル : 保存」ボタン</dt>
<dd>
　現在の設定をファイルに保存します。
</dd>

<dt>「プロファイル : 読み込み」ボタン</dt>
<dd>
　設定をファイルから読み込みます。
</dd>

<dt>「作成」ボタン</dt>
<dd>
　現在の設定に基づき、アーカイブファイルや EXE 形式の実行可能ファイルを出力します。
</dd>

<dt>「キャンセル」(または終了) ボタン</dt>
<dd>
　Releaser を終了します。
</dd>

<dt>「出力」タブ</dt>
<dd>
<img src="ReleaserOutput.png"/><r/><r/>
<dl>
<dt>「出力形式」</dt>
<dd>
　「.XP3 アーカイブ」を選ぶと、xp3 形式 ( 吉里吉里標準のアーカイブ形式 ) のファイルを出力します。「.EXE 形式実行可能ファイル」を選ぶと、実行可能ファイルを出力します。「.EXE 形式実行可能ファイル」を選んだ場合は、Releaser ( krkrrel.exe ) と同じフォルダか、その親のフォルダにおいてある krkr.eXe が使用されます。
</dd>

<dt>「出力ファイル」</dt>
<dd>
　出力するファイルを指定してください。「参照」ボタンをクリックするとファイルをダイアログボックスで指定することができます。
</dd>
</dl>
</dd>

<dt>「ファイル」タブ</dt>
<dd>
<img src="ReleaserFiles.png"/><r/><r/>
　拡張子ごとに、「圧縮するもの」「アーカイブには含めるが圧縮しないもの」「アーカイブには含めないもの」を選ぶ事ができます。通常、デフォルトの分類のままでかまいません。<r/>
　「圧縮するもの」にファイルを分類すると圧縮が行われるため、ファイルサイズが小さくなります。また、テキストエディタやバイナリエディタで中を覗いても簡単には解読できない状態になります。しかし、圧縮を行うと展開時に時間がかかるというデメリットもあります。PNG や JPEG や ERI などは既に圧縮されていて、「圧縮する」に分類しても効果が薄い上に、展開に余計に時間がかかるようになるので、圧縮することはお勧めできません。
</dd>

<dt>「オプション」タブ</dt>
<dd>
<img src="ReleaserSettings.png"/><r/><r/>
<dl>
<dt>「大きなファイルを圧縮しない」</dt>
<dd>
　もし該当するファイルが「圧縮するもの」に分類されていても、指定されたサイズ以上であれば圧縮を行わない、という設定です。吉里吉里の構造上、圧縮されたファイルはメモリ上に展開しなければならないため、大きなファイルを圧縮するのは実行時のコストが高くなります。
</dd>

<dt>「展開プロテクト」</dt>
<dd>
　チェックすると、アーカイブ内部のインデックス ( 格納されているファイルのリスト ) に「展開プロテクト」の属性を付加します。これによりアーカイブ展開ツールに対し「著作者はファイルが展開されることを望んでいない」という意思表示をすることができます。
</dd>

<dt>「OggVorbisコードブック共有化」</dt>
<dd>
　チェックすると、OggVorbis ファイル ( .ogg ファイル ) のベクトル量子化用コードブックを共有させます。OggVorbisファイルは複数のファイル間で共通のコードブックをファイルごとに持っている場合が多いので、それらを一つにまとめてサイズの節約を行うことができます。
</dd>

<dt>「インデックスを圧縮する」</dt>
<dd>
　チェックすると、アーカイブ内部のインデックス ( 格納されているファイルのリスト ) を圧縮し、サイズの節約をすることができます。
</dd>
</dl>
<note>
「オプション」タブの「展開プロテクト」をチェックしても<b>実際に展開ができないように暗号化をしたりする訳ではありません</b>。意思表示を行うことができるだけです。また、アーカイブ展開ツールを作成される方は ( もしいるとして ) この展開プロテクトフラグの存在を考慮してください ( このフラグがたっていれば展開を拒否したり、展開する前に警告をするなど )。<r/>
</note>
</dd>

<dt>「実行可能ファイル設定」タブ</dt>
<dd>
　出力形式に実行可能ファイルを指定した場合にのみ表示されます。<r/>
　ここの設定画面は <link href="Configure"/> と同じです。<r/>
<r/>
<img src="ReleaserExeSettings.png"/><r/><r/>
<dl>
<dt>「オプション」</dt>
<dd>
　実行可能ファイルに対するデフォルトのオプションを設定できます。
</dd>

<dt>「アイコン」</dt>
<dd>
　実行可能ファイルのアイコンを指定することができます。
</dd>
</dl>
</dd>
</dl>
</para>

<para>
<ptitle>コマンドラインオプション</ptitle>
Releaser は以下のコマンドラインオプションを受け付けます。

<dl>

<dt>フォルダ名</dt>
<dd>ターゲットのフォルダを指定します。</dd>

<dt>-<kw>go</kw></dt>
<dd>すぐにアーカイブを作成し、そのまま終了します。バッチ処理などで用いてください。オプションなどはあらかじめ、ターゲットのフォルダに default.rpf という名前で保存しておいてください (これなくても -nowriterpf -out オプションと組み合わせてアーカイブを作ることは可能です )。</dd>

<dt>-nowriterpf</dt>
<dd>終了時に default.rpf を書き出しません。</dd>

<dt>-out ファイル名</dt>
<dd>出力ファイル名を指定します。</dd>

<dt>-rpf ファイル名</dt>
<dd>読み込むプロファイルを指定します。</dd>

</dl>
<r/>
たとえば、以下のように指定します。<r/>
<bq>
krkrrel project -out ..\release\data.xp3 -nowriterpf -go
</bq>

</para>

</doc>


