空中写真クリッピングツール.exe README.txt
========================================

【1. ソフトの概要】
本ソフトは、空中写真指標位置取得ツール（空中写真指標位置取得ツール.exe）
から出力された CSV を利用して、画像の回転補正およびクリップ処理を行う
Windows 用アプリケーションです。

主な用途：
・指標抽出済み画像の切り出し
・主点と回転角に基づく画像の回転補正
・指標点に基づく対象領域の自動クロップ
・切り出し画像の一括生成
・確認用デバッグ画像の出力


【2. このソフトが前提とする入力データ】
本ソフトは、以下のような CSV を入力として想定しています。

入力元：
・空中写真指標位置取得ツール（空中写真指標位置取得ツール.exe）

想定するCSVファイル名の例：
・output_coordinates_manual.csv
・output_coordinates_auto.csv

このCSVには、少なくとも以下の情報が含まれている必要があります。
・ファイル名
・4点座標
・補正後主点X
・補正後主点Y
・補正値
・マーカータイプ

本ソフトは上記の情報を使って、
画像ごとに回転補正とクロップ処理を行います。

注意：
本ソフト単体では座標抽出は行いません。
必ず先に、空中写真指標位置取得ツール側で CSV を作成してください。


【3. 動作環境】
推奨環境：
・Windows 10 / 11
・64bit環境
・メモリ 8GB以上推奨

注意：
・非常に大きな画像では処理に時間がかかることがあります
・大容量画像も扱えますが、PC性能により動作速度は異なります
・出力画像は JPG 形式で保存されます


【4. 入力データの準備】
処理前に、以下を用意してください。

(1) 入力画像フォルダ
・元画像が入っているフォルダ
・CSV の「ファイル名」列と実際の画像ファイル名が一致している必要があります

(2) CSVファイル
・画像指標抽出ツールで出力したCSV
・UTF-8 または Shift-JIS の CSV に対応しています

本ソフトは CSV 内の各行について、
同じ名前の画像ファイルを入力フォルダ内から探して処理します。


【5. 起動方法】
実行ファイルをダブルクリックして起動してください。

例：
空中写真クリッピングツール.exe

初回起動時、Windows Defender などにより警告が表示される場合があります。
その場合は以下を確認してください。

例：
「Windows によって PC が保護されました」
→「詳細情報」→「実行」


【6. 使い方】
1) 「入力フォルダ」を指定します
　→ 元画像が入っているフォルダを選択

2) 「CSVファイル」を指定します
　→ 画像指標抽出ツールで出力した CSV を選択

3) 「クロップ拡大率 (%)」を入力します
　→ 100 でぴったり
　→ 110 で 10% 拡大
　→ 120 で 20% 拡大

4) 必要に応じて「デバッグ画像を生成する」を ON/OFF します
　→ ON 推奨

5) 「実行」を押します

6) 処理完了後、出力フォルダを確認します


【7. 処理内容】
本ソフトは、CSV に記録された以下の情報を使用します。

・補正値
　→ 画像の回転角

・補正後主点X / 補正後主点Y
　→ 回転中心

・4点座標
　→ クロップ範囲の基準点

処理の流れ：
1. CSV読込
2. 画像読込
3. 主点を中心とした回転補正
4. 指標点の回転後座標の計算
5. 指標点の外接範囲からクロップ領域を決定
6. 拡大率を反映してクロップ
7. JPGで保存

出力画像は、入力フォルダ内の clip フォルダに保存されます。


【8. 座標形式について】
本ソフトは、CSV内の座標形式として以下の両方に対応しています。

■ 4辺の中点座標
・上(a)X, 上(a)Y
・右(b)X, 右(b)Y
・下(d)X, 下(d)Y
・左(c)X, 左(c)Y

■ 4隅の頂点座標
・左上(a)X, 左上(a)Y
・右上(b)X, 右上(b)Y
・左下(c)X, 左下(c)Y
・右下(d)X, 右下(d)Y

CSVの各行について、利用可能な形式を自動判定して処理します。


【9. 出力内容】
入力フォルダ内に以下が生成されます。

・clip
　→ 最終出力画像（JPG）

・debug_output
　→ デバッグ画像（デバッグ出力ON時のみ）

・image_processing.log
　→ 処理ログ

出力画像名：
・元画像と同じベース名の JPG で保存されます

例：
sample01.tif → clip\sample01.jpg


【10. デバッグ画像について】
「デバッグ画像を生成する」を ON にすると、処理確認用の画像が保存されます。

主な内容：
・元画像上の指標点
・主点位置
・クロップ後画像上の指標点
・クロップ範囲

初回利用時や、処理結果を確認したい場合は ON を推奨します。


【11. クロップ拡大率の目安】
・100
　→ 指標範囲にぴったり合わせる

・105 ～ 115
　→ 余裕を持たせた切り出し

・120 以上
　→ 広めに切り出す

推奨：
まずは 110 で試し、必要に応じて調整してください。


【12. 使用上の注意】
・CSV の「ファイル名」と実画像名が一致していない場合、その画像はスキップされます
・補正値または補正後主点X/Y が空欄の場合、その画像はスキップされます
・座標値が不正または空欄の場合、その画像はスキップされます
・クロップ範囲が無効な場合、その画像は出力されません
・出力画像形式は JPG 固定です
・元画像は変更されません

重要：
このソフトは、画像指標抽出ツール側で正しい座標・主点・回転角が求められていることを前提とします。
元CSVに誤りがある場合、切り出し結果もずれる可能性があります。


【13. よくあるトラブルと対処法】

■ 処理されない画像がある
・CSV のファイル名と、入力フォルダ内の画像名が一致しているか確認してください
・CSV に主点や補正値が入っているか確認してください

■ CSVを読み込めない
・UTF-8 または Shift-JIS の CSV か確認してください
・Excelで開いたままになっていないか確認してください

■ 出力画像がずれている
・元の指標抽出結果を確認してください
・補正後主点X / 補正後主点Y / 補正値 が正しいか確認してください
・デバッグ画像を ON にして確認してください

■ 出力フォルダが作られない
・入力フォルダへの書き込み権限があるか確認してください

■ 実行中に止まったように見える
・大きな画像では処理に時間がかかることがあります
・処理ログ表示欄と image_processing.log を確認してください


【14. 推奨運用手順】
1. 画像指標抽出ツールで CSV を出力
2. 本ソフトでその CSV を指定
3. クロップ拡大率 110 で試行
4. デバッグ画像で結果確認
5. 問題なければ本処理を実行


【15. 免責事項】
本ソフトは現状有姿で提供されます。
入力画像、CSV内容、利用環境等により、期待通りの結果が得られない場合があります。

本ソフトの利用により生じた直接・間接の損害について、
配布者は責任を負いません。
重要な研究・業務利用の前には、十分な検証を行ってください。


【16. バージョン情報】
ソフト名：
画像クリップツール

1.0

作成者名
国土地理院（地理地殻活動研究センター地理情報解析研究室）


========================================
以上
========================================
