===============================================================================
  AllThumb  —  エクスプローラー用サムネイル拡張
  CROSSROAD LAB
===============================================================================

Photoshop・Illustrator・PDF・動画・カメラ RAW・HEIC など、Windows が標準では
絵を出せないファイルにもエクスプローラーでサムネイルを表示します。
Windows の拡張機能・ffmpeg・ImageMagick などを別に入れる必要はありません。
どの形式を表示するかは、付属の設定画面からチェックボックスで選べます。


-------------------------------------------------------------------------------
  導入のしかた
-------------------------------------------------------------------------------

  1. この ZIP をフォルダごと展開します。
     （ZIP の中から直接実行しないでください。ファイルが揃っている必要があります。
       特に AllThumbDecoder.exe・AllThumbSvg.exe と licenses フォルダは、
       動画・画像の表示に必要です）

  2. AllThumbConfig.exe をダブルクリックします。

  3. 「インストールしますか？」と聞かれるので［はい］を押します。

  4. 続けてエクスプローラーの再起動を確認されるので［はい］を押します。
     これでサムネイルが出るようになります。

  管理者権限は要りません。インストール先は次のとおりです。
      %LOCALAPPDATA%\Programs\AllThumb

  展開したフォルダは、インストール後は削除してかまいません。

  ■ 新しい版に更新するとき
    新しい版の ZIP を同じように展開して AllThumbConfig.exe を開くと、
    「AllThumb x.x.x がインストールされています。更新しますか？」と聞かれます。
    ［はい］を押せば、選んだ形式などの設定はそのままで新しい版に入れ替わります。
    （［適用］ボタンは設定を変えるだけで、版は入れ替わりません）


-------------------------------------------------------------------------------
  ※ 初回起動時に「Windows によって PC が保護されました」と出た場合
-------------------------------------------------------------------------------

  コード署名を行っていないため、ダウンロードした実行ファイルには
  SmartScreen の警告が出ます。続けるには次のようにします。

      ［詳細情報］をクリック → ［実行］

  警告を出さずに済ませたい場合は、展開する «前» に ZIP ファイルを右クリックし、
  ［プロパティ］→ 下部の「セキュリティ: 許可する」にチェック → ［OK］
  としてから展開してください。


-------------------------------------------------------------------------------
  設定のしかた
-------------------------------------------------------------------------------

  スタートメニューの「AllThumb 設定」から、いつでも設定画面を開けます。

  * 表示したい形式にチェックを入れて［適用］を押すだけです。
  * チェックを外した形式は Windows 標準の表示に戻ります。
  * 「現在の担当」の列で、その拡張子を今どのプログラムが担当しているか
    分かります（他のサムネイルツールと競合していないかの確認に使えます）。
  * ［ファイルを選んで確認］で、実際に作られるサムネイルを試せます。
    うまく出ないファイルの原因を調べるのに便利です。


-------------------------------------------------------------------------------
  対応している形式
-------------------------------------------------------------------------------

  すべて AllThumb だけで表示できます（ほかに入れるものはありません）。

      Photoshop      .psd .psb
      Illustrator    .ai .ait
      EPS/PostScript .eps .epsf .ps
      InDesign       .indd .indt
      PDF            .pdf
      動画           .mp4 .m4v .mov .mkv .webm .3gp .avi .wmv .mpg .mpeg
                     .mts .m2ts .m2t .ts .vob .flv .ogv .mxf
      カメラ RAW     .arw .srf .sr2 .cr2 .cr3 .crw .nef .nrw .orf .raf .rw2 .rwl
                     .pef .dng .srw .3fr .erf .kdc .dcr .mef .mos .mrw .x3f .iiq
      写真・Web      .heic .heif .hif .avif .webp
      編集ソフト・CG .tga .xcf（GIMP） .psp .pspimage（PaintShop Pro） .pcx .hdr .exr
                     .sgi .dpx .ppm .pgm .pbm .pnm .svg .svgz

      動画と画像は、同梱の読み取り部品（AllThumbDecoder.exe、SVG は AllThumbSvg.exe）が
      表示します。Windows の拡張機能も ffmpeg も ImageMagick も要りません。たとえば:
        * ソニーのカメラの XAVC S（H.264 の 10bit・4:2:2 を含む）、業務用カメラの MXF
        * 編集用の素材（ProRes・DNxHD、透明のあるエフェクト素材の PNG / Animation の .mov）
        * スマートフォンの HEVC、YouTube などで使われる WebM の AV1 / VP9 / VP8
        * AVCHD（.mts / .m2ts）、テレビ録画・HDV の MPEG-2、DVD の .vob
        * iPhone の写真（HEIC）、カメラの HEIF（10bit・HDR の PQ / HLG を含む）、AVIF・WebP
        * カメラ RAW（RAW の中に入っている、カメラが作った JPEG を取り出して表示します）
        * GIMP・PaintShop Pro（表示されているレイヤーを重ねて作ります）、OpenEXR などの CG の画像
      数十 GB の動画でも、読むのは «目次と絵 1 枚分» だけなので待たされません。

  次のものは、設定画面でチェックを入れると表示します（最初は Windows に任せています）。
      .jxr .wdp .dds（Windows に最初から入っている読み取り部品を使います）
      .rgb .pam .pfm .qoi

  ※ Windows の拡張機能（RAW 画像拡張機能など）や ImageMagick が入っている場合は、
    AllThumb で表示できなかったときの «保険» として自動で使います。

  ※ .jpg .png .gif .tif などは Windows 標準の表示で十分きれいなので、
    あえて対象にしていません。


-------------------------------------------------------------------------------
  アンインストール
-------------------------------------------------------------------------------

  Windows の［設定］→［アプリ］→［インストールされているアプリ］から
  「AllThumb」を選んでアンインストールしてください。

  設定画面の［アンインストール］ボタンからでも同じことができます。

  登録したレジストリと、コピーしたファイルをすべて取り除きます。
  他のサムネイルツールの設定には手を触れません。


-------------------------------------------------------------------------------
  うまく表示されないとき
-------------------------------------------------------------------------------

  1. 設定画面の［ファイルを選んで確認］でそのファイルを試してください。
     ここで画像が出れば AllThumb 側は正常です。エクスプローラーの
     サムネイルキャッシュが古いだけなので［エクスプローラー再起動］を押します。

  2. ここで失敗する場合は、ファイルが壊れているか、まだ対応していない
     種類の可能性があります（上の一覧を参照）。

  3. さらに詳しく調べるには、インストール先の AllThumb.ini で
     [general] の LogLevel を 3 にすると %TEMP%\AllThumb.log に記録が残ります。


-------------------------------------------------------------------------------
  安全性について
-------------------------------------------------------------------------------

  * サムネイルの生成は Windows の «分離プロセス»（COM サロゲート）で行われます。
    万一異常終了しても、エクスプローラー本体は巻き添えになりません。
  * 変更するのは HKEY_CURRENT_USER（自分のユーザー）と
    %LOCALAPPDATA%\Programs\AllThumb だけです。システム領域は触りません。
  * ネットワーク通信は一切行いません（同梱の読み取り部品にもネットワーク機能は
    入っていません）。
  * 読み取り部品 AllThumbDecoder.exe は、FFmpeg・dav1d・zlib から必要な部分だけを
    組み込んだもの、AllThumbSvg.exe は SVG を描く resvg を組み込んだものです。
    どちらもエクスプローラーの外の «別プロセス» で動き、時間切れ・メモリの上限で
    確実に止めます。部品はファイルを自分では開かず、AllThumb が渡した部分だけを読みます
    （SVG の中から別のファイルを読みに行くこともしません）。
    ライセンスは licenses フォルダにあります。
  * Windows の動画デコーダが固まる環境でも、止まった処理が積み上がらないように
    してあります（読めないと分かっている動画は、最初から Windows に渡しません）。


-------------------------------------------------------------------------------

  詳しい仕様          docs\README.md
  拡張のしかた        docs\EXTENDING.md
  変更履歴            docs\CHANGELOG.md
  ライセンス          LICENSE.txt  (MIT)
  同梱部品のライセンス  licenses\  （FFmpeg: LGPL 2.1 / dav1d: BSD / zlib /
                                    SVG の部品のライブラリ: licenses\svg\）

  ThumbTest.exe はコマンドラインでハンドラ単体を試すための診断ツールです。
  通常は使いません。
