PERFORCE サムネイル・ジェネレータ
p4thumb リリースノート
GA リリース 2008.1
July 22, 2008
PERFORCE サムネイル・デーモンは、PERFORCE により管理されるグラフィック・
ファイルのサムネイルを作成し、そのサムネイルをサーバに保存します。P4V
では、[表示]>[ファイルを表示]>[サムネイル] を選択すると右側のパネルにサ
ムネイルが表示されます。P4V はサムネイル・デーモンと直接通信するのでは
なく、サーバからサムネイルを取得します。
デフォルトでは、P4V は画像ファイルのサムネイルをワークスペースに表示し
ます。また、P4V はサーバに保存されたサムネイルをサムネイル・ジェネレー
タ（p4thumb）で表示することもできます。
最初にサムネイル・デーモンをサーバで起動するとき、クライアント・ビュー
にあるすべてのグラフィック・ファイルのバージョンに対してサムネイルが作
成されます。 画像ファイルの新しいバージョンがディポに追加されると、サム
ネイル・デーモンはそれらのファイルのサムネイルを追加します。
PERFORCE サーバのパフォーマンスに影響しないように、サーバ・マシン以外の
マシン上で p4thumb を起動してください。サムネイル・デーモンはサーバがネ
ットワークからアクセス可能であれば、他のどのプラットフォームの PERFORCE
サーバとも通信することができます。
この README ファイルは、PERFORCE サムネイル・デーモン（p4thumb）の構成、
起動、停止を行う必要のある PERFORCE 管理者を対象として記述しています。
p4thumb がサムネイルを作成できるファイルの形式を以下に示します。
* PSD (Photoshop)
* MB (Maya)
* MAX (3ds Max)
* TGA
* BMP
* GIF
* JPEG
* MNG
* PBM
* PGM
* PNG
* PPM
* XBM
* XPM
必要条件
--------
32ビットバージョンの PERFORCE サムネイル・ジェネレータ（p4thumb）は、
以下の環境で動作します。
* Linux 2.6.4 カーネル
* Windows 2000、Windows XP、Windows Server 2003 および Windows Vista
* FreeBSD 5.4 (X86) および FreeBSD 6.0 (X86)
* Solaris 10 (X86) および Solaris 10 SPARC
注：日本語版では、FreeBSD および Solaris 10 (X86) は未サポートとな
ります。
64ビットバージョンの PERFORCE サムネイル・ジェネレータ（p4thumb）は、
以下の環境で動作します。
* Linux 2.6.4 カーネル
* FreeBSD 5.4 (x64) および FreeBSD 6.0 (x64)
注：日本語版では、64ビットバージョンの PERFORCEサムネイル・ジェネレー
タ（p4thumb）は未サポートとなります。
p4thumb 2008.1 はリリース 2005.1 以降の PERFORCE サーバと共に動作し
ます。
システム要件（ディスク空き領域）
-------------------------------
サムネイルの生成
p4thumb は、単一のチェンジリストでサブミットした（しようとしている）、
最大の画像ファイル群を（一時的に）保持するのに十分なディスク空き領域を
必要とします。パフォーマンスを最良にするため、最大の画像ファイルをメモ
リに保持するのに十分な RAM を搭載したマシンで p4thumb を起動することを
推奨します。RAM の容量が少ないとサムネイルの生成が遅くなりますが、それ
以外に副次的な作用はありません。
p4thumb を実行する際、PERFORCE サーバはサムネイルを格納するためにより多
くのディスク領域を必要とします。 おおよそのディスク使用量を算出するには、
クライアント仕様を作成し、サムネイルを取得したい画像ファイルをそこにマ
ッピングします。それらのファイルのリビジョン数を取得するには、以下のコ
マンドを実行します。
p4 files -a //image-client/... | wc
リビジョンの数に 40 を掛けると、サーバが必要とする領域がキロバイト単位
で得られます。これは最小限必要な値です。
p4thumb はサムネイルを .png ファイルとして生成します。画像が単純である
場合、.png ファイルにすると最も圧縮率が高くなります。画像ファイルが複雑
になると、PTD が消費するディスク領域に大きな影響を与えます。
チェックポイントとジャーナル
サムネイルはジャーナルとチェックポイントの両方のファイルに 16進形式で格
納されます。 チェックポイント設定、チェックポイントからの復元、およびジ
ャーナル取得は、結果的に処理速度が遅くなり、生成されるファイルの容量が
大きくなるため、サーバ・マシンに十分な空き領域を確保するようにしてくだ
さい。
p4thumb を実行しても PERFORCE サーバの処理速度が極端に遅くなることはあ
りませんが、サムネイルの取得および表示は、P4V のパフォーマンスにある程
度影響を与えます。
インストール
-------------
p4thumb を PERFORCE サーバと同じマシンで稼動させる必要はありません。た
だし、サーバが稼働するマシンへのネットワーク・アクセスが必要になります。
サーバのパフォーマンスへの影響を避けるために、p4thumb を別のマシン上で
起動してください。
Windowsの場合
-------------
1. PERFORCE Web サイトのダウンロード・ページから、p4thumb の ZIP ファ
イルをダウンロードします。
2. p4thumb を起動させたいマシンでファイルを解凍します。
3. 解凍されたフォルダにおいて vcredist_x86.exe を起動し、Visual C++
2005 のライブラリをインストールします。
4. 画像ファイルが保存されているサーバ上に、p4thumb のためのクライアン
ト仕様を作成し、サムネイルを取得したいファイルのみをマッピングしま
す。
例えば、このビューは Qt がサポートするすべての画像形式、および PERFORCE
がプラグインを作成した形式のすべてを、'p4thumb'（ご使用になるクライア
ント名に変更してください）というクライアントにマッピングします。
//depot/....ppm //p4thumb/....ppm
//depot/....PPM //p4thumb/....PPM
//depot/....bmp //p4thumb/....bmp
//depot/....BMP //p4thumb/....BMP
//depot/....jpg //p4thumb/....jpg
//depot/....JPG //p4thumb/....JPG
//depot/....bpm //p4thumb/....bpm
//depot/....BPM //p4thumb/....BPM
//depot/....gif //p4thumb/....gif
//depot/....GIF //p4thumb/....GIF
//depot/....pgm //p4thumb/....pgm
//depot/....PGM //p4thumb/....PGM
//depot/....png //p4thumb/....png
//depot/....PNG //p4thumb/....PNG
//depot/....mng //p4thumb/....mng
//depot/....MNG //p4thumb/....MNG
//depot/....xbm //p4thumb/....xbm
//depot/....XBM //p4thumb/....XBM
//depot/....xpm //p4thumb/....xpm
//depot/....XPM //p4thumb/....XPM
//depot/....max //p4thumb/....max
//depot/....MAX //p4thumb/....MAX
//depot/....ma //p4thumb/....ma
//depot/....MA //p4thumb/....MA
//depot/....mb //p4thumb/....mb
//depot/....MB //p4thumb/....MB
//depot/....tga //p4thumb/....tga
//depot/....TGA //p4thumb/....TGA
//depot/....psd //p4thumb/....psd
//depot/....PSD //p4thumb/....PSD
5.（任意） 使用したい追加の画像プラグインをインストールします。PERFORCE
のパブリック・ディポからプラグイン・ファイルを取得し、.dll ファイル
を p4thumb 実行可能ファイルが置かれている "plugins" フォルダ内の
"imageformats" というフォルダにコピーします。p4thumb は次回の起動時
に、自動的に新しいプラグインをロードします。さらに、新規にサポート
対象となったファイルタイプを p4thumb クライアントに追加する必要があ
ります。
注：ディポまたはチェックアウトされたファイルに存在しないローカル・フ
ァイルについて、Photoshop、Maya、3DS のファイルタイプのサムネイル
を参照したい場合、クライアント・コンピュータの P4V がインストール
されているディレクトリに、該当するプラグインをインストールする必
要があります。
Unixの場合
----------
1. PERFORCE Web サイトのダウンロード・ページから、p4thumb の tgz ファ
イルをダウンロードします。
2. ファイルを gzip で解凍し、ランタイム・ファイルを任意のディレクトリ
に展開します。
P4V 実行可能スクリプトを指し示すシンボリック・リンクを作成することが
できます。例えば、配布ファイルが untar された場所へのリンクを作成する
には、以下のコマンドを実行します。
$cd /foo
$gunzip p4thumb_jp.tgz
$tar xvf p4thumb_jp.tar
$ln -s foo/p4thumb-2008.1-123456/bin/p4thumb /usr/local/bin/p4thumb
3.画像ファイルが保存されているサーバ上に、p4thumb のためのクライアン
ト仕様を作成し、サムネイルを取得したいファイルのみをマッピングしま
す。
例えば、このビューは Qt がサポートするすべての画像形式、および PERFORCE
がプラグインを作成した形式のすべてを、'p4thumb'（ご使用になるクライア
ント名に変更してください）というクライアントにマッピングします。
//depot/....ppm //p4thumb/....ppm
//depot/....PPM //p4thumb/....PPM
//depot/....bmp //p4thumb/....bmp
//depot/....BMP //p4thumb/....BMP
//depot/....jpg //p4thumb/....jpg
//depot/....JPG //p4thumb/....JPG
//depot/....bpm //p4thumb/....bpm
//depot/....BPM //p4thumb/....BPM
//depot/....gif //p4thumb/....gif
//depot/....GIF //p4thumb/....GIF
//depot/....pgm //p4thumb/....pgm
//depot/....PGM //p4thumb/....PGM
//depot/....png //p4thumb/....png
//depot/....PNG //p4thumb/....PNG
//depot/....mng //p4thumb/....mng
//depot/....MNG //p4thumb/....MNG
//depot/....xbm //p4thumb/....xbm
//depot/....XBM //p4thumb/....XBM
//depot/....xpm //p4thumb/....xpm
//depot/....XPM //p4thumb/....XPM
//depot/....max //p4thumb/....max
//depot/....MAX //p4thumb/....MAX
//depot/....ma //p4thumb/....ma
//depot/....MA //p4thumb/....MA
//depot/....mb //p4thumb/....mb
//depot/....MB //p4thumb/....MB
//depot/....tga //p4thumb/....tga
//depot/....TGA //p4thumb/....TGA
//depot/....psd //p4thumb/....psd
//depot/....PSD //p4thumb/....PSD
4. （任意）使用したい追加の画像プラグインをインストールします。プラグ
イン・ファイルを、p4thumb 実行可能ファイルが置かれている "plugins"
フォルダ内の "imageformats" というフォルダにコピーします。p4thumb
は次回の起動時に、自動的に新しいプラグインをロードします。さらに、
新規にサポート対象となったファイルタイプを p4thumb クライアントに
追加する必要があります。
注：ディポまたはチェックアウトされたファイルに存在しないローカル・フ
ァイルについて、Photoshop、Maya、3DS のファイルタイプのサムネイル
を参照したい場合、クライアント・コンピュータの P4V がインストール
されているディレクトリに、該当するプラグインをインストールする必
要があります。
p4thumb の起動
---------------
サムネイルを有効にしたいサーバごとに 1 つずつ p4thumb のインスタンスを
実行します。同一のクライアント・ビューやサーバを使用して複数の p4thumb
のインスタンスを実行しないでください。（大規模なプロジェクトに対し 1 つ
ずつインスタンスを起動するなど、複数のインスタンスを異なるクライアント・
ビューで起動するとパフォーマンスが向上することがあります。）
p4thumb に関連するユーザを p4thumb 専用ユーザにする必要はありませんが、
ワークスペースについては p4thumb 専用ワークスペースを用意しなければなり
ません。また、デーモンを起動するためには、ユーザがサーバの 'admin' 権限
を持っている必要があります。
注: p4thumb を最初に特定の PERFORCE サーバで起動すると、そのサーバのク
ライアント・ビューにあるすべての画像ファイルに対してサムネイルが作
成されます。その処理がサーバのパフォーマンスに影響を与える可能性が
あります。最初にサムネイルが作成された後は、p4thumb はサーバのパフ
ォーマンスに大きな影響を与えません。
p4thumb を起動するには、以下のコマンドを発行し、画像ファイルを含むサー
バ、p4thumb が使用するワークスペース、および p4thumb の動作に関連する
PERFORCE ユーザ名を指定します。
p4thumb -p <起動するサーバ:ポート> -c <p4thumbのワークスペース> -u <ユーザ名> [オプション]
オプション
-----------
-t <秒>: p4thumb が PERFORCE サーバに対して新規または変更された画像ファ
イルをポーリングする間隔を指定します。 指定できる値は、1 から 2147483
（25日間）までです。デフォルトは 30 秒です。
-n <開始チェンジリスト>[<,終了チェンジリスト>]: 処理対象のチェンジリス
トの範囲を指定します。チェンジリストの範囲を指定すると、その範囲の処理
後に p4thumb は終了します。開始チェンジリストのみを指定すると、p4thumb
は指定されたチェンジリストから最新のチェンジリストまでを処理した後、通
常のポーリングを続行します。
-d: -n オプションで指定されたチェンジリストの範囲内のリビジョンに関連付
けられている、クライアント・ビューにあるサムネイルを削除します。
-f: 指定されたリビジョンに対して既にサムネイルが存在している場合でも、
強制的にサムネールを作成します。-n オプションを指定した場合にのみ有効で
す。
-L <ログファイル>: p4thumb ログファイルの場所と名前を指定します
（例："C:\Program Files\perforce\thumblog.txt"）。
デフォルトでは、ログ出力はシステム・コンソールに表示されます。
-v 0|1|2: ログレベルを指定します。レベル 0 はエラーを記録、レベル 1 は
エラーおよびすべての p4 コマンドを記録、レベル 2 はエラー、コマンド、お
よび 16進数でエンコードされたサムネイルを記録します。
-help: p4thumb のオプションを表示します。
-V: バージョン情報を表示します。
注：-L オプションで指定する p4thumb ログファイルの場所と名前に、マルチ
バイト文字（日本語）を使用することはできません。
p4thumb の停止
---------------
p4thumb を起動したコマンド・ウィンドウで CTRL-C を入力します。
デフォルトでは、p4thumb を再起動すると、前回処理された最後のチェンジリ
ストから処理を再開します。p4thumb はそのために特定のサーバ上にカウンタ
を保持します。「-n」オプションを使用して p4thumb を特定のチェンジリスト
から起動すると、一定の値を超えたときにこのカウンタがリセットされます。
サムネイルの削除はカウンタに影響しません。
独自の画像形式にサムネイルを追加する
-------------------------------------
p4thumb は Trolltech によって開発された技術に基づいており、他の画像形式
に対応するように拡張が可能です。上述した画像形式以外のプラグインを作成
したい場合は、Trolltech が提供している Unix/X11 および Mac OS X の無料
の開発バージョンを利用してください。Windows プラグインの開発には、ライ
センスの購入が必要になります。
詳しくは www.trolltech.com を参照して QImageFormatPlugin の情報を調べて
ください。
PERFORCE のパブリック・ディポにはサンプルのソースコードおよび QT ドキュ
メンテーションへのリンクがあります。ここには 3DS、Maya、Photoshop およ
び .tga ファイル用のコンパイル済みプラグインが含まれています。これらの
ファイルを入手するには、//public/perforce/utils/image-plugins/ を参照し
てください。
リリース 2008.1 でのバグ修正
----------------------------
#158823
Windows 環境においてディスク空き容量が少ないことが正しく報告されるよ
うになりました。Windows 環境での Qt4 使用時に、ログ・ファイルをロック
してもクラッシュしなくなりました。(Bug #30014)
#158381
P4Thumb は画像ファイルおよびログ記録機能を正しく処理するようになりま
した。空のディポに対して P4Thumb を起動してもクラッシュしなくなりまし
た。(Bug #29971)