﻿
:lang: ja
include::config.adoc[]

:toc: left

{ExtendStyle}
// After need empty-one-line

= CSRenderCLI Readme

[.text-right]
--
2022/05/08
--

== Change Log

* V1.3.2.x:2022/05/08 :
	- /fc時のhashFile異常時にhashFileを再作成する。PDFファイル更新をチェック
	- /fc時のターゲットとリファレンスの同一パスを禁止
* V1.3.2.0:2021/12/20 :aRGB4チャンネル保存からRGB3チャンネルに変更
* V1.3.1.0:2021/10/04 :UWP用、Data.pdfの削除、整理
	- UWP用コード削除。通常のファイルアクセスやMemoryStreamに変更
	- Widnows RT Windows.Data.pdfの使用を削除.PDFiumのみとした
	- /ParaPageオプション追加。PageRenderのスレッド数(Def=4)
	- TIFF出力時のJpegのノイズ削除
* V1.3.0.4:2021/04/29 :Helpの記述抜け "/Result"の対応
* V1.3.0.3:2020/11/22 :/Result <比較結果> を実装。diff画像を出力
* V1.3.0.2:2020/07/11 :不具合修正
	比較時に差異があるとクラッシュしていた。streamのフラッシュミス 
* V1.3.0.1:2020/06/20 :不具合修正
	２つのファイルの比較が常にOKになっていた可能性があるので修正
* V1.3.0.0:2020/06/10 :基本的なPDFの画像化(PNG,JPG)とPDFの比較を行えるもの

== Command-Line Parameters

以下、CSRender /? のヘルプ内容です
TestSampleフォルダに使用例がありますので合わせて参照のこと

CSRender.exe [/<Opts>] <PDFPath or PDFDir>
* Render of PDF file. available 3 command mode:[Basic Rendering] [Make Hash command] [Compare command], and [Render Options]
	PDFの画像化は[Basic Rendering]。
	比較は/MkHash([Make Hash command])後に、/FC([Compare command])で高速実行できます。

[Basic Rendering] 基本的なレンダリング
	CSRender.exe [/<Render Options>] <PDFPath|PDFDir>
	/F <pdfPath|pdfDir> : pdfPath(pdfファイル名|ディレクトリ) /Fは省略可能
	/O <output directory> : 出力ディレクトリ。省略時は"IMG"フォルダ

[Render Options] レンダリングオプション
	/D <解像度> : 解像度指定 9 - 300dpi(default=72dpi)
	/JPG,/JPEG,/PNG,/TIF,/TIFF,/GIF,/BMP: Select one output format.(default=/JPG)
	/JPEGQ <quality>: Jpegの品質指定1-100(default=91)

	/P <PageRange> : ページの範囲を指定する(省略時は全ページ)
		連続した範囲を指定する場合は、ハイフン（'-'）を用いる。終了側を省略すると最終pageまで。
		複数のページを指定する場合は、カンマ（','）を用いる
		Ex. /P "1,2,30-100" //1,2pages and 30-100pages.
	[Unsupport] 未対応↓
	/L <input List text> : 入力PDFファイルリスト(*unsupport)
	/T  <tempPath> : テンポラリフォルダを指定（省略時は出力先フォルダと同じ(*unsupport no need)
	/OP <0|1> : オーバープリントのOn/Off (省略時は1)(*unsupport allways on[1])
	/U <0|1> : 同名上書き設定 0:上書きしない 1:上書き(*unsupport allways overwrite[1])
	/OFFSET <X> <Y> : ミリ単位でオフセットを指定する（省略時は共に0mm)(*unsupport)
	/PDFium <0or1>: GoogoleのPDFiumViewerエンジンを使用する(default=1>
	【未】/BM,/BT,/BA,/BA,/BC: Select one box.(default=/BC:CrobBox): Boxies:MediaBox/BleedBox/TrimBox/ArtBox/CropBox

[Make Hash command] 比較用ハッシュ値作成コマンド
	CSRender.exe /MkHash ...<Render Options>... <PDF|PDF dir>
	/MKHash : ハッシュ値を出力する。前記の[Render Options]を指定すること
	[HASHファイル作成]

[Compare command] 比較コマンド
	CSRender.exe /FC ...<Render Options>... <Target PDF|PDF dir> <Reference PDF|PDF dir>
	/FC : 2つのPDFを比較する。前記の[Render Options]を指定すること。無名引数が2つ必要です
	 事前に/MkHashを実行しておくことで高速に処理できる

	【未】/RESULT <result file> : 比較結果を格納するファイルパス
		/FCコマンドを指定すると一致したら0，不一致なら1を返却するようになる
		<result file>は、<pageNum(1始まり)>,<OK or NG>の行で構成される

[ELSE ] その他のオプション
	/PDFium <0|1>:PDFiumライブラリを使う,デフォルト=1
	/NoExeSepa :実行分離しない(遅い)
	内部コマンド：/SubExe <WCF_PipeAddress> :実行分離,PDF単位で別Processで処理

/H or /?  : This help

END