# StViewer (STellar image Viewer)

## 概要  
StViewer（以下、本アプリ）は多機能画像ビューアーアプリケーションです。  
主要な画像形式に対応するのはもちろん、.zipに圧縮された画像も表示することができます。  
.gifや.webpのアニメーション表示、.svg ベクター画像、JPEG XLやiPhoneの.heic、.avifにも対応しています。  

その他、GPU機能を駆使したアニメーションエフェクトや印刷機能(PDF出力)、テキスト抽出(OCR)、
カラーピックアップ、ゴーストウィンドウモード(透かしウィンドウ)など作者(SATOX)が思いついた機能を詰め込みました。  

## 動作環境  
- Windows 10 またはそれ以降（Windows11で動作確認しています）  
- 64bit OS (x64) のみ  
- .NET 8.0 Runtime (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)  


## 機能概要  
1. **日本語**、**英語** 対応
2. **対応ファイル形式**
    - 汎用・アーカイブ： .zip / .png / .jpg (.jpeg) / .bmp / .ico / .tif (.tiff) / .tga
    - アニメーション対応： .webp / .gif
    - 次世代・高効率： .webp / .avif / .heic (.heif) / .jxl / .jp2 (.jpf)
    - 専門・ベクター： .psd / .svg / .exr / .dng / .dds
    - フォルダ指定フォルダ内画像表示
3. **マウス操作**
    - 画像ファイル、zipファイルのドロップで画像を表示することができます
    - **マウスホイール** ： 次の画像・前の画像（Shiftキーで+10）
    - **Ctrl+マウスホイール** ： 画像ズーム
    - **マウス左ボタンダブルクリック** ： 次の画像（Ctrlキーで前の画像、Shiftキーで±10）
    - **マウス左ボタンドラッグ** ： フォルダ内・アーカイブ内で画像シーク（Shiftキーで±10）
    - **マウス右ボタンドラッグ** ： 拡大鏡表示
    - **マウス右＋左ボタン上下ドラッグ** ： 画像ズーム
    - **マウス中ボタンドラッグ** ： 画像パンニング
    - **マウス進むボタン** : 次のフォルダー、またはアーカイブ
    - **マウス戻るボタン** : 前のフォルダー、またはアーカイブ
    - HUDボタン
        - **HUD右ボタン** ： 次の画像
        - **HUD左ボタン** ： 前の画像
        - **HUD上ボタン** ： フォルダー、またはアーカイブの最初へ
        - **HUD下ボタン** ： フォルダー、またはアーカイブの最後へ
        - **HUDフォルダボタン** ： 内蔵ファイルビューアーの表示・非表示
        - **HUD最大化ボタン** ： フルスクリーンモード切り替え
        - **HUD閉じるボタン** ： 本アプリを閉じる
        - **HUDズームスライダー** ： ハンドルのドラッグでズーム率を変更できます
4. **ツールバー上ボタン操作**
    - ファイル選択ダイアログで画像を選択
    - 内蔵ファイルビューアーの表示・非表示
    - フォルダー、またはアーカイブの最初
    - 前のアーカイブ
    - 前のフォルダー
    - 前の画像
    - 次の画像
    - 次のフォルダー
    - 次のアーカイブ
    - フォルダー、またはアーカイブの最後
    - フィルター切り替え（ドロップダウン）
    - Aboutダイアログ表示（バージョン、ドキュメント参照）
5. **キー操作**  
    - **0～9（テンキー含む）** : アーカイブ、フォルダー内、アニメーション再生時、0%～90%位置にシーク
    - **テンキー＋** : アニメーションスキップフレーム数＋1
    - **テンキー－** : アニメーションスキップフレーム数－1
    - **テンキー．** : アニメーションスキップフレーム数のリセット
    - その他、右クリックメニューにショートカットキーが表示されます
6. **ファイルビューアー機能**
    - アプリ内蔵ファイラーでフォルダーやファイルを選択
    - フォルダー内画像サムネイルリスト表示
    - フォルダーパスのパンくずリスト機能
    - フォルダー内・ZIPファイル内の画像表示（Enterキー、またはマウス左ダブルクリックで表示）
    - マウスの戻るボタン、BSキーで上の階層に移動
7. **拡大鏡機能**
    - マウス右ドラッグでマウス位置を拡大表示した拡大鏡が表示されます
    - RGBのカラー値、WEBカラー、HSVの色相値が表示されます
8. **ループ設定機能**
    - フォルダー内でループ（グループ内前後で連続）
    - アーカイブ内でループ（グループ内前後で連続）
9. **自動回転機能**
    - 画面を最大限に表示するために自動回転
10. **左右反転機能**
    - 画像を左右反転して表示することができます
11. **エフェクト機能（🧪実験機能）** （*アニメーションエフェクト）
    - Grayscale（グレースケール）
    - Sepia（セピア）
    - Blur（ブラー）
    - High Contrast（ハイコントラスト）
    - Edge Detect（エッジ検出）
    - Surface Blur（サーフェイスブラー）
    - Pixelate（モザイク）
    - Retro Graphics（レトログラフィック）
    - Skin Smooth（美白フィルター）
    - Halftone（ハーフトーン）
    - Thermal（サーモグラフ）
    - *Glitch（色収差）
    - *Retro CRT（レトロテレビ）
    - *Kaleidoscope（万華鏡）
    - *Entropy Dissolve（粒子拡散）
    - *Manga FocusLines（まんが集中線）
    - *Water Ripple（水波紋）
    - *Night Vision（ナイトビジョン）
    - *Lovely Heart（ラブリーハート）
    - *God Ray（ゴッドレイ）
    - *Miniature（ミニチュア）
    - *Color Splash（特定色抽出）
    - *Rain（雨）
    - *Snow（雪）
    - *Cherry Blossom（桜）
    - *Neon Glow（ネオングロー）
    - *Old Film（古いフィルム）
    - *Swirm（渦巻き）
12. **トランジション機能**
    - 画像の切り替わりにトランジションエフェクトをかけることができます
    - Fade（フェード）
    - Slide（スライド）
    - Dissolve（ディゾルブ）
    - Glitch（グリッチ）
    - Ripple（リップル）
13. **フルスクリーン表示機能**
    - タイトルバーやタスクバーを非表示にして全画面表示
14. **最前面表示機能**
    - 最前面に表示することができます
15. **ズーム、パンニング機能**
    - スクリーンにフィットするスケール表示（デフォルト）
    - スケール率指定表示
16. **ドット表示機能**
    - 拡大によるボケが顕著な場合に自動でドット表示（Nearest Neighbor）
17. **HUD非表示機能**
    - 一部メッセージ表示を抑止します
18. **リアルタイムヒストグラム表示機能（🧪実験機能）**
    - 画像のヒストグラムを表示します
19. **Exif表示機能（🧪実験機能）**
    - JPEGのExif情報を表示します
20. **クリップボードから画像ペースト機能**
    - クリップボードにある画像（Bitmap）をペーストして表示可能
    - 一時的にテンポラリフォルダに保存され、本アプリ終了時に削除されます
21. **クリップボード画像コピー機能**
    - 画像（Bitmap）をクリップボードにコピー、他アプリに貼り付け可能
22. **色のピックアップ機能**
    - カーソル位置のカラーがWEB形式（テキスト）でコピー
    - アルファが無効の場合 #RRGGBB、有効の場合 #AARRGGBB 形式でコピーされます
23. **透明色設定機能**
    - 透過画像の背景をチェッカーボードパターンで表示します
    - 他に、白、黒、グレーなどが選択可能です
24. **背景ブラー表示（ブラーバックドロップ）機能**
    - 背景に画像をぼかして表示することができます
25. **背景色設定機能**
    - 背景色を選択して変更することができます
26. **ゴーストウィンドウ機能**
    - マウス操作が反映されない半透明ウィンドウモードにすることができます
    - ESCキー押下で解除することができます
27. **システムコンテキストメニュー表示機能**
    - 表示中のファイルのコンテキストメニューを表示することができます
28. **エクスプローラー機能**
    - 表示中のファイルをエクスプローラー選択表示することができます
29. **OCR機能**
    - 表示中の画像をOCRでテキスト抽出することができます
30. **印刷機能（PDF出力）（🧪実験機能）**
    - 表示中の画像を印刷することができます（印刷機能でPDF出力もできます）
    - 用紙サイズに合わせて最大表示されるように自動回転されます
31. **ファイル共有**
    - Windowsのファイル共有機能を帯び出すことができます
32. **フォルダー、ファイル関連付け機能**
    - 初回起動時のダイアログで対応ファイル形式の関連付けが可能です
    - Shiftキーを押しながら本アプリを終了することで関連付けの削除ができます
33. 画像コピー・ペースト機能
    - クリップボードへの画像コピー、クリップボードからのペーストに対応しています
34. **タスクバーの最近使ったファイルに対応**
    - 直接開いたファイルのみがタスクバーの「最近」に登録されます
34. **カーソル自動非表示機能**
    - ビューアー上でカーソルを静止すると非表示になります

## ファイル一覧
- StViewer.exe      ： 本アプリの実行ファイル
- StViewer.settings ： 本アプリの設定ファイル(実行ファイルを終了すると作成されます)
- Readme(JP).md     ： 本ドキュメント
- LICENSE.txt       ： ライセンステキストファイル

## 設定削除方法  
- 設定をリセットしたい場合は、設定ファイル `StViewer.settings` を削除してから本アプリを起動してください。

## ファイルの関連付け  
- 本アプリの初回起動時に、ファイルの関連付けを問い合わせるダイアログが表示されます。
    - 再びダイアログを表示させるには、アプリ設定保存ファイル `StViewer.settings` を削除してから起動してください。
    - ファイルの関連付けを行うと、対応ファイルの右クリックメニューに本アプリの起動メニューが表示されます。

## ファイルの関連付けの削除  
- **Shiftキーを押しながら本アプリを終了** することで関連付けを削除することができます。
- 本アプリを削除する前に、必ずこの操作を行ってください。

## サポート  
- 本アプリについて、不具合や要望があれば作者までお願いします。    
    - 作者： SATOX（さとっくす） (https://x.com/satoxpochi)  
    - サイト： https://satox.skr.jp/StViewer

## 更新履歴  
### Ver.1.3.9584 (2026-03-29)   
- 機能追加
    1. ファイルビューをサムネイル画像リストに刷新。
        - ファイルビューヘッダ部にフォルダーパスを表示。
        - サムネイルサイズ変更ボタンまたはマウスホイールでサムネイルサイズ変更可能。
        - ZIPファイル内の画像ファイルリスト表示に対応。
    2. ファイルビューにフォルダーパスのパンくずリスト表示機能追加。
         - パンくずリストの任意の階層をクリックしてその階層に移動できるようになります。
    3. ファイルビューにお気に入り機能を追加。
        - 任意のフォルダーをお気に入りに追加して素早く表示できるようになります。
        - デフォルトでは「デスクトップ」と「マイドキュメント」が追加されています。
    4. ファイルビュー右クリックメニューにフォルダ削除、ZIP内ファイル削除、エクスローラーで開く機能を追加。
    5. HUDにズームスライダーGUIを追加。
    6. アプリタイトルにカレントファイル名（ファイル名のみ）を表示するように。
    7. SVGのクリップボードへのコピーに対応。ビットマップとしてコピーされます。
    8. トランジション機能を追加。
        - なし、スライド、フェード、ディゾルブ、グリッチ、リップルの5種類から選択できます。一部はトランジションできません。
    9. エフェクトを3つ新規追加。ネオングロー、古いフィルム、渦巻きを追加。
    10. 簡易テキスト表示機能追加。テキストと思われるファイルを簡易表示します。
    11. 左右反転機能追加。 
- 仕様変更
    1. コマンドオプションやドラッグ＆ドロップでフォルダーが指定されたとき、ファイルビューを表示するように変更。
    2. ファイルビューのサイズを設定保持するように変更。
    3. 右マウスドラッグによるルーペ表示サイズを２倍に、拡大率を4倍から6倍に変更、HSV値表示を追加。
    4. 画像倍率フィットのショートカットキーを「F」に変更。
- 不具合修正  
    1. ツリービューのカレントフォルダーがスクロール表示されない(EnsureVisible)問題修正。
    2. アニメーション中にフォルダ移動するとアニメーションしたままになる不具合修正。
- その他
    1. 描画ライブラリを最新版に更新。最大10%程度の描画パフォーマンスが向上しています。
    2. 最適化により、瞬間最大2枚分の使用メモリを削減しました。
    3. ファイルビューアーのフォルダーツリーシェブロンの表示精度向上しました。

### Ver.1.1.9534 (2026-02-07)  
- 機能追加
    1. エフェクトを7つ新規追加
        - 水波紋、ナイトビジョン、ラブリーハート、ゴッドレイ、ミニチュア、特定色抽出、雨、雪、桜 エフェクト
    2. ファイル、アーカイブの並び順を設定できるように
        - 内部的な次/前の順序を「ファイル名順」「日付順」で切り替えられます。
- 仕様変更
    1. フォルダーの次/前移動時にループしていたのをアーカイブのループ設定を適用するように変更
- 不具合修正  
    1. 本アプリを複数同時に開き、同時に終了した際に例外ダイアログが表示される問題を修正
        - アプリ設定の保存は初回起動のものが対象となります。  

### Ver.1.0.9509 (2026-01-13)  
- 新規リリース  

## 免責事項  
Copyright (c) 2025-2026 SATOX All rights reserved.

本アプリ（StViewer）は「現状渡し」で提供され、動作の完全性や特定の目的への適合性について、作者（SATOX）はいかなる保証も行いません。

1. **損害への責任**: 本アプリの使用または使用不能によって生じた直接的・間接的な損害（データの消失、PCの故障、経済的損失等）について、作者は一切の責任を負いません。  
2. **禁止事項**: 本アプリの解析（リバースエンジニアリング）、改変、および作者の許可なく他のサイトやメディアへ転載・再配布することを禁じます。  
3. **著作権**: 本アプリに関する著作権および知的財産権は、作者に帰属します。  

## ライセンス 
本アプリは「LICENSE.txt」テキストに記載されているサードパーティ製ライブラリを使用しています。

有用なOSSを提供してくださっている皆様に感謝します。


[EOF]