                                                                                          2025/11/28
----------------------------------------------------------------------------------------------------
ThumbnailCity Version 2.2.1(アルファ版) Readme
                                         Copyright (C) 2016, 2025, Akey/COMVIC, All Rights Reserved.
----------------------------------------------------------------------------------------------------
0. 前文
  本版はアルファ版ですでの、以下の制約があります。
  ・新規追加や改造した機能は仮実装ですので、正式リリースまでに変更する可能性があります。
  ・本バージョン系列(Version2.2)で実装する予定の機能を全て実装しているものではありません。
  ・従来バージョンから存在する機能も含めて不良が無いことは保証していません。

1. 機能
  ThumbnailCityは、Windowsのフォルダに表示される動画のサムネイルやプレビューを、好きな画像に指定する
  ためのソフトウェアです。

2. 用語/略語
  本ソフトウェアでは、用語及び略語を以下の意味で使用しています。
    ADS             代替データストリームの略 NTFS又はReFSで利用可能なファイルに付加するデータ領域
    ADSキャッシュ   動画のサムネイルをADSにキャッシュする機能
    VLC             VLCメディアプレイヤー
    WMP             Windows Media Player
    埋込み機能      動画ファイルにサムネイル画像及びサムネイルとブックマークの位置情報を埋込む機能
    サムネイル      フォルダ内に表示されるファイルに対応する画像
    シーン画像      プレビューの右側又は下側に表示される画像
    シーンシンボル  シーン画像に付加されるサムネイル又はブックマークであることを示すマーク
    ジャケット写真  動画ファイルにThumbnailCityで添付する静止画
    スプロケット    サムネイルの上下又は左右に付加されているフィルム端を表す孔
    フォルダ        OSが表示するファイル一覧やアプリのファイルダイアログ
    ブックマーク    サムネイルとは別に指定するファイルに対応する画像
    プレビュー      OSのフォルダで「ALT」+「P」キー押下により表示される表示領域
    ビューア        フォルダ, WMP, VLCから起動するThumbnailCityのアプリ

3. 版の違いについて
  ThumbnailCityには、シェアウェア版とフリーウェア版の二種類があります。
  ・シェアウェア版の試用期限はインストール時点から30日です。ライセンスキーを登録しないで試用期限を
    過ぎると、画像を指定する機能が使用不可能になります。
  ・フリーウェア版には試用期限はありませんが、いくつかの機能制限があります。詳細は、以下URLを参照
    ください。
    http://local.comvic.mydns.jp/thumbnailcity-difference-between-editions/

  両版共に、それぞれ32ビット版と64ビット版があります。使用しているOSのビットバージョンと同じ版を
  使用してください。

4. 動作環境
  Windows 10 x86又はx64版
  Windows 11 x64版

5. インストール
  (1) zip形式の配布ファイルを解凍すると、MSI形式のインストーラ, readme.txt, releaseNote.txt
      InstallWithLog.cmdが展開されます。
  (2) インストーラをダブルクリックにより実行し、画面の指示に従ってインストールしてください。
  (3) インストール完了後は、(1)で展開したファイルを削除しても問題ありません。
  (4) InstallWithLog.cmdは、ログファイルを生成してインストーラを起動します。通常は使用しないでくだ
      さい。

6. アンインストール
  ・Windows 8
    コントロールパネルの「プログラムと機能」を実行し、「プログラムのアンインストールまたは変更」
    画面から「ThumbnailCity」を選択してください。

  ・Windows 10, Windows 11
    設定の「アプリと機能」から「ThumbnailCity」を選択し、「アンインストール」を選択してください。

7. 使用方法
  動画ファイルのサムネイルやブックマークを、ビューア又はフォルダのプレビューから指定できます。
  サムネイルを指定するとフォルダに縮小画像として表示され、ブックマークを指定するとフォルダの
  プレビューに縮小画像として表示されます。フォルダのプレビューは「ALT」+「P」キーでON/OFFできます。

  7.1 ビューアから指定する場合
    (1) Windows 8及び10の場合は、フォルダ内の動画を右クリックして表示される「サムネイルを指定(T)」を
        選択してください。
        Windows 11の場合は、フォルダ内の動画を右クリックして表示される「その他のオプションを表示」を
        選択後、「サムネイルを指定(T)」を選択してください。
    (2) ビューアが表示されますので、シーンを移動させてサムネイルやブックマークを指定してください。
       「F1」でヘルプを表示できます。
    (3) ビューアに静止画ファイルをドラッグ・アンド・ドロップすることで、動画ファイルにジャケット
        写真を添付することができます。動画中のシーンと同じようにジャケット写真をサムネイルやブック
        マークに指定できます。
    (4) 「Emb」ボタン押下で、埋込み機能をON/OFFできます。埋込み機能をONにすると、サムネイル画像、
        サムネイルとブックマークの位置情報を動画ファイルに埋込むことができます。

  7.2 プレビューから指定する場合
    (1) フォルダで「ALT」+「P」キーを押してプレビューを表示してください。プレビューの下又は右半面に
        複数のシーン画像が表示されます。
    (2) シーン画像上で右クリックし、「この位置をサムネイルに設定/解除」又は「この位置をブックマーク
        に設定/解除」を選択することで、サムネイルやブックマークを指定又は解除できます。
    (3) 指定や解除を行っても、プレビューを他のファイルに切替えたり、プレビューを閉じるまでは、ファ
        イルには書き込まれません。ファイルに書き込まれる前にEsc押下によって更新した場合や「x」ボタン
        を押した場合は、指定や解除がキャンセルされます。
    (4) サムネイルに指定したシーン画像には黄色の◯、ブックマークに指定したシーン画像には紫色の△が
        表示されます。
    (5) 「Emb」ボタン押下で、埋込み機能をON/OFFできます。埋込み機能をONにすると、サムネイル画像、
        サムネイルとブックマークの位置情報を動画ファイルに埋込むことができます。
    (6) プレビューからジャケット写真を追加することはできません。

  7.3 WMPプラグイン
    WMPが再生中の位置でビューアを起動したり、WMPの再生位置をサムネイルやブックマークの位置に移動
    することができます。
    (1) WMPでALTキーを押下すると表示されるメニュから「ツール」->「プラグイン」->「ThumbnailCity WMP
        Plugin」を選択してください。プラグインのウィンドウが表示されます。
    (2) 動画に指定されているサムネイルとブックマークのシーンが一覧表示されます。アイコンをダブル
        クリックすると、WMPの再生位置がその位置に変更されます。
    (3) 「ビューアを起動」ボタンを押すと、WMPで再生中の位置でビューアが起動されます。ビューアで
        サムネイルを指定したり、ブックマークを指定できます。
    (4) ウィンドウ右上の×ボタン押下で終了します。
    (5) WMPプラグインから起動したビューアから埋込み機能は使用できません。

  7.4 VLCエクステンション
    VLCから再生中の位置でビューアを起動したり、VLCの再生位置をサムネイルやブックマークの位置に移動
    することができます。
    (1) VLCの「表示(I)」メニュから「ThumbnailCity」を選択してください。エクステンションのウィンドウ
        が表示されます。
    (2) 動画に指定されているサムネイルとブックマークの時間が一覧表示されます。一覧から時間を選択して
       「移動」を押すと、VLCの再生位置がその位置に変更されます。
    (3) 「ビューア起動」ボタンを押すと、VLCで再生中の位置でビューアが起動されます。ビューアでサムネ
        イルを指定したり、ブックマークを指定できます。
    (4) ウィンドウ右上の×ボタン押下で終了します。

  7.5 システム設定
    スタートメニュの「ThumbnailCity」フォルダから「システム設定」を起動できます。設定可能な項目の
    説明は、ダイアログ右上の「？」ボタンからWeb上のHELPを参照してください。

  7.6 補足説明
    (1) 埋込み機能を使用するとサムネイル等の情報を動画ファイル自体に書込みます。使用しない場合はADS
        に書込みます。埋込み機能を使用すると書込みに時間が掛かりますが、ADSが利用できないメディア
        でもサムネイル等の情報を保持できます。
    (2) スプロケットをThumbnailCityで管理している場合、埋込み機能を使用して指定したサムネイルはスプ
        ロケットが水色に、使用していない場合は橙色になります。

8. 注意事項
  (1) 埋込み機能を使用しない場合は、以下の制限があります。
    (a) 動画ファイルを格納するメディアが、NTFS又はReFSでフォーマットされている必要があります。
    (b) 上記以外のメディアに格納されている動画のシーンを指定することはできません。 
    (c) 上記以外のメディアに動画をコピーした場合、コピー先ファイルにはシーンの情報やジャケット写真が
        コピーされません。
    (d) 上記以外のメディアに動画を移動した場合、シーンの情報やジャケット写真が失われます。 
  (2) サムネイルやブックマークを指定及び表示するためには、Media Foundation、Direct Show又はVLCで
      動画を再生できる環境になっていることが必要です。
  (3) セキュリティソフトのリアルタイム保護機能等により、本ソフトウェアがウイルス等として誤判定され、
      本ソフトウェアの動作が制限されることがあります。その場合は、セキュリティソフト側で本ソフトウェ
      アを例外として指定する必要があります。
    (a) 例外として指定する対象は、ThumbnailCityのインストール先フォルダ下の拡張子がexe又はdllのファ
        イル全てです。
    (b) 例外として指定する機能は、ファイアーウォール機能(外部との通信を遮断する機能)ではなく、挙動や
        振る舞いを監視する機能です。
  (4) libVLCで動画を再生する機能を利用する場合、VLCはインストーラーを使用してインストールされている
      必要があります。
  (5) libVLCで動画を再生する機能を利用する場合、Media FoundationやDirect Showよりも時間精度が粗くな
      り指定したフレームと異なるフレームがサムネイルやブックマークになることがあります。また、CPU
      使用率が高い場合やI/Oが多い場合に画像の生成が失敗する場合があります。
  (6) 無排他ファイルアクセスをOnにした状態でlibVLCで動画を再生する機能を利用する場合、WMV等の一部の
      形式の動画を正常にデコードできない場合があります。無排他ファイルアクセスをOffにすることで正常
      にデコードできる可能性がありますが、WMPで動画を再生中にWMP Pluginやビューアを正常に使用でき
      なくなる可能性があります。
  (7) 64bit OSでは32bitプロセスでlibVLCを使用して動画を再生する機能を使用できません。
  (8) ストアアプリ版のVLCから本ソフトウェアの機能を使用することはできません。 また、ストアアプリ版の
      VLCに同梱されているlibVLCを本ソフトウェアから使用することもできません。
  (9) SWFファイルのサムネイルやプレビューを表示するためには、Adobe Flash Playerプラグインが必要
      です。また、「システム設定」を使用してSWF拡張子の「サムネイル機能」及び「プレビュー機能」を
      ONに設定する必要があります。
 (10) DRM(Digital Rights Management)により保護されたファイルには、対応していません。 
 (11) サムネイルやブックマークを指定すると、動画ファイルの最終更新日時が変更されます。埋込み機能を
      Onにしている場合は動画ファイル自体が変更されますが、Offにしている場合は動画ファイル自体は
      変更されません。
 (12) ADSキャッシュ機能を有効にしている状態で、動画ファイルのサムネイルが初めて表示される場合、
      ファイルの最終更新日時が変更される場合がありますが、動画ファイル自体は変更されません。
 (13) 複数のビューアやプレビューから同時にサムネイルやブックマークを指定した場合は、後から実行した
      方の指定が有効になります。
 (14) プレビューのシーン画像は、キーフレームを表示しているため、同じ画像が重複して表示されることが
      あります。
 (15) プレビューからVLCを起動する場合、VLC側の単一インスタンスで実行する設定は無視されます。
 (16) プレビューから埋込み機能を使用する場合、動画ファイルが格納されているメディアがNTFS又はReFSで
      フォーマットされている必要があります。
 (17) WMPプラグインから埋込み機能を使用することはできません。
      埋込み機能を使用する場合は、フォルダからビューアを起動してください。
 (18) 埋込み機能を使用した動画ファイルに、埋込み機能をOFFにしてサムネイルを指定した場合、指定した
      サムネイルと埋込まれたサムネイルが不一致になり、環境によって表示されるサムネイルが異なる
      場合があります。埋込み機能をONにして再指定することで不一致を解消できます。
 (19) 埋込み機能を使用してサムネイルを指定した動画のサムネイル指定を解除した場合、埋込まれた位置情報
      は削除されますが、サムネイル画像は削除されないため、埋込まれたサムネイル画像がフォルダ上に表示
      されます。
 (20) スプロケットをThumbnailCityで生成する機能は、他ソフトウェアとの相性によっては機能しない場合が
      あります。
 (21) スプロケットをThumbnailCityで生成した場合、WMP等のアプリ側でスプロケットを追加しているアプリ
      内で、スプロケットが二重に表示される場合があります。
 (22) ビューアのページ移動でキーフレーム移動モードを選択した場合、APIの仕様上の制限により、正確な
      キーフレーム位置に移動できないことがあります。

9. 免責事項
  (1) 本ソフトウェアは「現状有姿」で提供しています。
  (2) 本ソフトウェアをご使用になったことで損害を被られたとしても、作者は責任を負わないものとさせて
      頂きます。
  (3) 本ソフトウェアのサポートに、作者は義務を負わないものとさせて頂きます。

10. 連絡先
  改善要望や不具合の指摘は、以下のホームページまたはEmailアドレスまでお願いします。
  http://local.comvic.mydns.jp/
  mottei6@yahoo.co.jp

11. 不具合の指摘について
  不具合を指摘頂く際は、TcCollect.vbsを実行してログファイルを収集し、当方に提供お願いします。
  (1)インストール先ディレクトリ(通常はC:\Program Files\KwCOMVIC\ThumbCity)に格納されている
     TcCollect.vbsを、ダブルクリックにより実行してください。
  (2)ログファイルを圧縮したzipファイル(ThumbCityCorrect_yyyymmdd-hhmmss.zip)がデスクトップに生成
     されます。
  (3)zipファイルの生成に失敗したり、zipファイルの内容が無い場合は、セキュリティソフトにより
     TcCollect.vbsの実行が阻害されている可能性があります。一時的にセキュリティソフトのリアルタイム
     監視機能を停止させてから、TcCollect.vbsを実行してください。

12. そのほか
  (1)著作者の許可なく本ソフトウェアを再販、再配布、譲渡することを禁止します。
  (2)シェアウェア版のライセンスキーは、適正に管理してください。不当なライセンスキーの使用が認められ
     た場合、そのライセンスキーを失効にすることがあります。
  (3)予期しない障害が発生した場合、作者のサーバに情報を送信する許可を求めることがあります。送信を
     拒否することもできますが、この情報は本ソフトウェアの品質向上に役立つものですので、送信を許可
     して頂ければ幸いです。
  (4)変更履歴は同梱のreleaseNote.txtを参照ください。

[EndOfFile]
