﻿━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【タイトル / Title】TyranoPicChecker
【Version】2.00
【ファイル / File】TyranoPicChecker.zip
【著 作 者 / Author】（Lyrical Limited）朋美姫 / Tomomi Hime
【連 絡 先 / Website】ホームページ / Official Website
https://lyricallimited.blog.jp/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

《はじめに / Introduction》

【日本語】

　朋美姫のアプリ「TyranoPicChecker」をダウンロードしていただき、
　誠にありがとうございます！

　TyranoPicCheckerは、ティラノスクリプトでゲーム制作を行う方向けの
　画像ファイル確認支援ツールです。

　TyranoScriptプロジェクトのscenarioフォルダにある.ksファイルを調べ、
　コメントアウトされていない部分に記述されている画像ファイル名を抽出し、
　プロジェクト内に該当する画像が存在するかを確認します。

　また、同じファイル名の画像が複数のフォルダに存在する場合も検出できます。
　画像の入れ忘れや、同名画像による意図しない参照を確認する際にご利用ください。

　本ツールは開発時の確認を簡単にすることを目的としています。
　TyranoScriptのすべての構文や実行時の画像参照処理を完全に再現するものでは
　ありません。最終的な判断はゲーム制作者ご自身で行ってください。


【English】

　Thank you very much for downloading "TyranoPicChecker,"
　an application by Tomomi Hime.

　TyranoPicChecker is an image-file checking utility designed to assist
　developers creating games with TyranoScript.

　It scans .ks files in the scenario folder of a TyranoScript project,
　extracts image file names found in non-commented portions of the scripts,
　and checks whether matching image files exist within the project.

　It can also detect cases where files with the same image name exist
　in multiple folders. This is useful for finding missing images and
　identifying potentially confusing duplicate file names.

　This application is intended as a development aid. It does not attempt
　to reproduce every TyranoScript syntax rule or all runtime image-resolution
　behavior exactly. Final verification should be performed by the game developer.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《主な機能 / Main Features》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　・TyranoScriptプロジェクトフォルダをGUIから選択
　・scenarioフォルダ内の.ksファイルをチェック
　・スクリプト内の画像ファイル名を検出
　・コメントアウトされた記述をチェック対象から除外
　・プロジェクト内に画像ファイルが存在するか確認
　・不足している画像を「不足画像」タブに一覧表示
　・同名画像が複数フォルダに存在する場合、
　　「同名画像」タブに一覧表示
　・チェック結果をレポートファイルとして保存
　・「レポートを開く」ボタンからレポートを表示
　・前回選択したプロジェクトフォルダを記憶
　・日本語 / English の表示切り替え
　・選択した言語設定を記憶
　・処理状況をプログレスバーとステータスで表示


【English】

　- Select a TyranoScript project folder from the GUI.
　- Scan .ks files in the scenario folder.
　- Detect image file names referenced in scripts.
　- Ignore references found in commented-out portions.
　- Check whether corresponding image files exist in the project.
　- Display missing images in the "Missing Images" tab.
　- Display duplicate image names found in multiple folders in the
　　"Duplicate Names" tab.
　- Save check results to a report file.
　- Open the generated report with the "Open Report" button.
　- Remember the previously selected project folder.
　- Switch the user interface between Japanese and English.
　- Remember the selected interface language.
　- Display progress and status while checking.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《インストール方法 / Installation》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　1. 「TyranoPicChecker.zip」を任意の場所に解凍してください。
　2. 解凍された「TyranoPicChecker.exe」を実行してください。
　3. 本バージョンでは、チェック対象のTyranoScriptプロジェクトを
　　 アプリ画面の「参照...」ボタンから選択できます。

　TyranoPicChecker.exeをゲームプロジェクト内へコピーする必要はありません。


【English】

　1. Extract "TyranoPicChecker.zip" to any folder.
　2. Run "TyranoPicChecker.exe".
　3. In Version 2.00, the TyranoScript project to be checked can be
　　 selected using the "Browse..." button in the application.

　You do not need to copy TyranoPicChecker.exe into the game project folder.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《アンインストール方法 / Uninstallation》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　TyranoPicCheckerを配置したフォルダを削除してください。

　本ツールは、前回選択したプロジェクトフォルダや言語など、
　操作を便利にするための小さな設定情報をユーザー環境に保存する場合があります。


【English】

　Delete the folder containing TyranoPicChecker.

　The application may save small user-specific settings, such as the
　previously selected project folder and interface language, for convenience.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《使い方 / How to Use》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　1. 「TyranoPicChecker.exe」を起動します。

　2. 画面上部の「TyranoScript プロジェクトフォルダ」に、
　　 チェックしたいプロジェクトのフォルダを指定します。

　　 「参照...」ボタンからフォルダを選択できます。

　3. 選択したフォルダ内に「scenario」フォルダがあることを確認します。

　　 例：

　　 MyGame/
　　　 ├─ scenario/
　　　 │   ├─ scene1.ks
　　　 │   ├─ scene2.ks
　　　 │   └─ ...
　　　 ├─ bgimage/
　　　 ├─ fgimage/
　　　 ├─ image/
　　　 └─ ...

　4. 「画像チェック開始」ボタンを押します。

　5. scenarioフォルダ内の.ksファイルを解析し、
　　 画像ファイル名を検出します。

　6. 検出した画像について、プロジェクト内に同名の画像ファイルが
　　 存在するか確認します。

　7. チェック終了後、画面に以下の情報が表示されます。

　　 ・処理した.ksファイル数
　　 ・存在した画像数
　　 ・不足画像数

　8. 詳細は各タブで確認できます。

　　「ログ」
　　　処理状況やレポートの保存先などを表示します。

　　「不足画像」
　　　プロジェクト内で見つからなかった画像を表示します。

　　　主な項目：
　　　　・シナリオ
　　　　・行
　　　　・不足画像

　　「同名画像」
　　　同じファイル名の画像が複数のフォルダに存在する場合に表示します。

　　　主な項目：
　　　　・シナリオ
　　　　・行
　　　　・画像名
　　　　・個数
　　　　・保存場所

　9. 「レポートを開く」を押すと、生成されたチェック結果を確認できます。


【English】

　1. Start "TyranoPicChecker.exe".

　2. In "TyranoScript Project Folder", specify the project folder
　　 that you want to check.

　　 You can select it using the "Browse..." button.

　3. Make sure that the selected project contains a "scenario" folder.

　　 Example:

　　 MyGame/
　　　 ├─ scenario/
　　　 │   ├─ scene1.ks
　　　 │   ├─ scene2.ks
　　　 │   └─ ...
　　　 ├─ bgimage/
　　　 ├─ fgimage/
　　　 ├─ image/
　　　 └─ ...

　4. Click "Start Image Check".

　5. TyranoPicChecker scans the .ks files in the scenario folder
　　 and detects image file names.

　6. For each detected image name, the application checks whether
　　 an image with that name exists in the project.

　7. When the check is complete, the application displays:

　　 - Number of processed .ks files
　　 - Number of existing images
　　 - Number of missing images

　8. Detailed results are available in the tabs.

　　"Log"
　　　Displays processing information and the report location.

　　"Missing Images"
　　　Lists image references for which a matching file could not be found.

　　　Main columns:
　　　　- Scenario
　　　　- Line
　　　　- Missing Image

　　"Duplicate Names"
　　　Lists image names that exist in more than one folder.

　　　Main columns:
　　　　- Scenario
　　　　- Line
　　　　- Image Name
　　　　- Count
　　　　- Locations

　9. Click "Open Report" to view the generated report.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《日本語 / English の切り替え》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　画面右上の「言語」プルダウンから、

　　 日本語
　　 English

　を選択できます。

　選択すると、フォームタイトル、ボタン、ラベル、タブ、
　一覧の列名、ステータス、メッセージなどが切り替わります。

　選択した言語は保存され、次回起動時にも使用されます。


【English】

　Use the "Language" drop-down menu in the upper-right corner to select:

　　 日本語
　　 English

　The window title, buttons, labels, tabs, list columns, status text,
　and messages are switched to the selected language.

　The selected language is remembered for the next launch.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《画像チェックの考え方 / How Image Checking Works》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　本ツールは、開発中に「必要な画像がプロジェクト内に存在するか」を
　手軽に確認することを目的としています。

　.ksファイル内のコメントアウトされていない部分に画像ファイル名が
　記述されている場合、その画像を使用候補として扱います。

　そのため、TyranoScriptのタグや命令を完全に解析する方式ではありません。

　たとえば、実際には実行されない記述や、特殊なスクリプト処理によって
　生成された文字列などについては、実際のゲーム実行時の結果と
　異なる場合があります。

　「不足画像」に表示された項目は、
　削除してよい画像や必ず不足している画像を断定するものではありません。
　制作者が確認するための候補一覧としてご利用ください。


【English】

　This tool is designed to provide a simple way to check whether images
　that appear to be required by the project actually exist.

　When an image file name appears in a non-commented portion of a .ks file,
　TyranoPicChecker treats it as a possible image reference.

　It does not perform a complete interpretation of every TyranoScript
　tag or command.

　Therefore, references in code that is not actually executed, or file
　names dynamically constructed by special script logic, may produce
　results that differ from the behavior of the running game.

　Items shown under "Missing Images" should be treated as candidates
　for review by the developer, rather than as absolute proof of an error.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《同名画像について / Duplicate Image Names》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　同じ画像ファイル名が複数のフォルダに存在すると、
　どの画像を意図しているのか分かりにくくなる場合があります。

　TyranoPicCheckerでは、このような画像を「同名画像」タブに表示します。

　「保存場所」欄を確認することで、同じ名前の画像がどのフォルダに
　存在しているか確認できます。

　同名画像が存在すること自体をエラーとは判断しません。
　意図した配置であるかを確認するための情報としてご利用ください。


【English】

　If images with the same file name exist in multiple folders,
　it may become difficult to determine which image was intended.

　TyranoPicChecker lists such cases in the "Duplicate Names" tab.

　The "Locations" column shows the folders in which matching files
　were found.

　Duplicate names are not automatically considered errors.
　The list is provided so that developers can verify whether the
　file placement is intentional.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《レポート / Report》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　チェック結果はレポートファイルとして保存されます。

　チェック完了後、「レポートを開く」ボタンが有効になります。
　ボタンを押すと、生成されたレポートを確認できます。

　レポートにはチェック結果の概要や不足画像などの情報が記録されます。


【English】

　Check results are saved to a report file.

　After the check is complete, the "Open Report" button becomes available.
　Click it to view the generated report.

　The report contains a summary of the check and information such as
　missing image references.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《注意事項 / Notes》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　・本ツールはゲーム開発を支援するためのチェックツールです。
　　TyranoScript本体の動作を完全に再現するものではありません。

　・不足画像として表示された項目が、必ずゲーム上のエラーになるとは
　　限りません。最終的には制作者が内容を確認してください。

　・同名画像はエラーではありません。
　　複数フォルダに同じ名前の画像が存在することを知らせるための機能です。

　・プロジェクトを変更する前に、必要に応じてバックアップを作成してください。

　・本ツールはフリーソフトですが、著作権は
　　朋美姫（Lyrical Limited）に帰属します。

　・再配布はご遠慮ください。
　　紹介・共有する場合は公式ホームページへのリンクをご利用ください。

　・バグ報告やご質問は、公式ホームページよりご連絡ください。

　　https://lyricallimited.blog.jp/


【English】

　- This application is a development support tool and does not
　　completely reproduce the behavior of the TyranoScript engine.

　- An item listed under "Missing Images" does not necessarily mean
　　that the game will produce an error. Developers should review
　　the results and make the final determination.

　- Duplicate image names are not treated as errors. The feature is
　　intended to notify developers that identically named files exist
　　in multiple folders.

　- Create backups when appropriate before making changes to your project.

　- This application is freeware, but copyright belongs to
　　Tomomi Hime (Lyrical Limited).

　- Redistribution is prohibited.
　　When introducing or sharing this application, please link to the
　　official website.

　- For bug reports or questions, please contact us through the
　　official website:

　　https://lyricallimited.blog.jp/


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《バージョンアップ履歴 / Version History》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2025/06/26  Version 1.00
　【日本語】
　TyranoPicChecker 初版公開。

　【English】
　Initial release of TyranoPicChecker.


2025/08/05  Version 1.01
　【日本語】
　タグの種類に限定せず、.png / .jpg の画像ファイル名を抽出する方式に変更。
　変数検出を廃止し、プロジェクトフォルダ内のサブフォルダを検索する方式に更新。

　【English】
　Changed image detection to extract .png / .jpg file names without
　restricting detection to specific tags.
　Removed variable detection and updated image searching across
　subfolders in the project.


2026/09/28  Version 2.00
　【日本語】
　・GUIを刷新。
　・TyranoScriptプロジェクトフォルダを画面から選択可能に変更。
　・前回選択したプロジェクトフォルダの記憶機能を追加。
　・不足画像を専用タブで一覧表示。
　・同じファイル名が複数フォルダに存在する画像を
　　「同名画像」タブで確認できる機能を追加。
　・処理状況、画像数、不足画像数を画面上に表示。
　・レポートをGUIから開く機能を追加。
　・日本語 / English の表示切り替え機能を追加。
　・選択した言語を記憶する機能を追加。
　・アプリケーションアイコンを追加。

　【English】
　- Redesigned the graphical user interface.
　- Added project-folder selection from the application window.
　- Added memory of the previously selected project folder.
　- Added a dedicated tab for missing images.
　- Added a "Duplicate Names" tab for image file names found
　　in multiple folders.
　- Added on-screen progress, image counts, and missing-image counts.
　- Added the ability to open the generated report from the GUI.
　- Added Japanese / English interface switching.
　- Added memory of the selected interface language.
　- Added an application icon.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《謝辞 / Acknowledgments》
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【日本語】

　本ツールの開発にあたり、
　ティラノスクリプトコミュニティの皆様のご意見を
　参考にさせていただきました。

　ご利用いただくすべてのゲームクリエイターの皆様に
　感謝申し上げます。


【English】

　We would like to thank the TyranoScript community for the ideas
　and feedback that helped guide the development of this tool.

　We also sincerely thank all game creators who use TyranoPicChecker.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TyranoPicChecker Version 2.00
Copyright (C) Lyrical Limited / Tomomi Hime
https://lyricallimited.blog.jp/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
