===============================================================
 Splayer 1.3.4
 連番画像ビューワー / Image sequence viewer
 fuzzlet
===============================================================

レンダリングした連番静止画をパラパラ再生して確認するための
ビューワーです。色調整をかけたまま再生できます。

対応形式 : PNG / JPEG / TIFF / EXR / BMP / TGA / HDR
音声には対応していません（画像連番のみ）。


===============================================================
 1. 動作環境
===============================================================

Windows : Windows 10 / 11 （64bit）
macOS   : macOS 26 以降 / Apple Silicon（M1以降）

インストーラーはありません。ファイルを置くだけで動きます。

  macOS   : Splayer.app だけをアプリケーションフォルダに移動
  Windows : Splayer.exe を好きな場所に置く

macOSは、この置き方をしておくと次の版も同じ名前で上書きされる
ので、常に1つだけ保たれます。


===============================================================
 2. インストールと初回起動
===============================================================

--- Windows ---------------------------------------------------

Splayer.exe を好きな場所に置いて、ダブルクリックしてください。

署名を付けていないため、初回だけ警告が出ます。

  1. 「WindowsによってPCが保護されました」と表示される
  2. 「詳細情報」をクリック
  3. 「実行」をクリック

2回目以降は出ません。

--- macOS -----------------------------------------------------

zipを展開したら、中の Splayer.app だけをアプリケーション
フォルダに移動してください。フォルダごとではありません。

すでに入っている場合は「置き換える」を選んでください。
古い版を別に残すと、Finderの「このアプリケーションで開く」に
Splayerが複数並び、どれが使われるか分からなくなります。

Apple の公証を受けていないため、初回だけ警告が出ます。

  1. Splayer.app をダブルクリックする（一度はねられます）
  2. システム設定 →「プライバシーとセキュリティ」を開く
  3. 下の方に出ている「このまま開く」を押す

2回目以降は不要です。

※ USBメモリなど、ネット経由でない方法で受け取った場合は
   この警告は出ません。そのまま起動できます。


===============================================================
 3. 起動する
===============================================================

起動するとファイル選択が開きます。連番のうち「どれか1枚」を
選んでください。同じフォルダの連番を自動で検出します。

  例) shot_0001.png を選ぶ
      → shot_0001〜shot_0120.png をひとまとまりとして認識

ファイルを選ばずにキャンセルすると、そのまま終了します。


===============================================================
 4. 起動画面の設定
===============================================================

ファイルを選ぶと、読み込み方を決める小さな画面が出ます。

  Input Type   Sequence = 連番として読む
               Single   = その1枚だけ読む

  Size         1 / 0.5 / 0.25
               解像度を縮めて読み込みます。メモリを減らせます。

  Step         1 / 2 / 3
               コマを間引きます。2なら1枚おき。

  In / Out     読み込む範囲。右の (0001) はファイル名の番号です。
               数値の上を左右にドラッグしても変えられます。

  Total        実際に読み込むコマ数

  Estimated RAM  必要なメモリの目安

「Accept」または Enter で再生画面に進みます。

--- Estimated RAM について ------------------------------------

ここに出る数字は「展開後」のメモリ量です。ファイルサイズでは
ありません。

JPEGやPNGは圧縮されているので、ファイルが合計90MBでも、再生
するために展開すると1GBを超えることがあります。数字が大きく
感じられたらそのためです。

搭載メモリに対して大きすぎる場合は、Size を 0.5 にする、
Step を 2 にする、In / Out で範囲を狭める、のいずれかで
減らせます。


===============================================================
 5. 再生画面の使い方
===============================================================

--- 再生 ------------------------------------------------------

  LOOP / ONCE   繰り返し再生 ↔ 1回だけ。押すたび切り替わり
  |<            先頭（IN）へ
  <             1コマ戻る
  ▶ / ■         再生 / 停止
  >             1コマ進む
  >|            末尾（OUT）へ
  FPS           再生速度。1〜120から選択

  CURRENT       現在のコマ番号。直接入力して Enter で移動。
                左右にドラッグすると送り／戻しができます

--- シークバー ------------------------------------------------

  バーの上をドラッグ    再生位置を移動
  左端の黄色い印を掴む  IN（再生開始位置）を変更
  右端の黄色い印を掴む  OUT（再生終了位置）を変更

--- 表示 ------------------------------------------------------

  FIT           ウィンドウに収まるサイズにする
  1:1           ピクセル等倍にする
                （ウィンドウより大きくてもはみ出して等倍）
  -  /  +       段階的に縮小 / 拡大
                等倍でないとき、該当するボタンが水色に光ります

  マウスホイール    拡大・縮小
  中ボタンドラッグ  表示位置の移動（はみ出しているとき）

--- 色調整 ----------------------------------------------------

  HUE   色相      SAT  彩度      BRIG  明度
  CONT  コントラスト          GAMA  ガンマ

  それぞれの数字の上を左右にドラッグすると変わります。
  ダブルクリックで初期値に戻ります。

  右隣の RGB を切り替えると、R / G / B / A の単独表示に
  なります。アルファの確認などに使えます。


===============================================================
 6. キーボード・マウス操作
===============================================================

  スペース          再生 / 停止
  ←  →              1コマ戻る / 進む
  Shift + ←  →      10コマ戻る / 進む
  Home              先頭（IN）へ
  End               末尾（OUT）へ
  F                 ウィンドウに合わせる（FIT）
  Ctrl(⌘) + Q       終了

  画像をダブルクリック  再生 / 停止
  中ボタンドラッグ      表示位置の移動
  ホイール              拡大・縮小

  ウィンドウにファイルをドラッグ＆ドロップしても開けます。


===============================================================
 7. 1周目は速度が一定になりません
===============================================================

再生を始めると、1周目は画像を読み込みながら進むため、指定した
FPSより遅くなったり、ばらついたりします。この間はFPSの選択欄が
グレーになります。

1周目が終わると読み込みが済んだ状態になり、2周目から指定の
速度で滑らかに再生されます。FPSもそこで選べるようになります。

重い連番ほど1周目に時間がかかります。急ぐ場合は起動画面で
Size を 0.5 にしてください。


===============================================================
 8. 使用条件
===============================================================

本ソフトウェアの著作権は fuzzlet に帰属します。
個人・業務を問わず無償でご使用いただけます。

配布物一式をそのままの形であれば、自由に共有していただけます。
以下はご遠慮ください。

  ・改変したものの配布
  ・有償での販売、および有償製品への同梱
  ・作者表示の削除・変更

同梱の LICENSE.txt に同じ内容を記載しています。

本ソフトウェアは現状のまま提供されます。使用によって生じた
損害について、作者は責任を負いかねます。

--- 使用しているオープンソースについて ------------------------

同梱の THIRD-PARTY-NOTICES.md に、使用しているオープンソース
ライブラリとそのライセンスを記載しています。これらは上記とは
別に、それぞれのライセンスが適用されます。


===============================================================
 9. English quick reference
===============================================================

A viewer for rendered image sequences (PNG / JPEG / TIFF / EXR).
No audio. Windows 10/11, or macOS 26+ on Apple Silicon.

First launch: the app is unsigned, so Windows shows SmartScreen
("More info" -> "Run anyway") and macOS blocks it once (System
Settings -> Privacy & Security -> "Open Anyway").

Pick any one frame of a sequence and the rest is detected. The
startup dialog sets input type, downscale, frame step and range.
"Estimated RAM" is the decoded size in memory, not the file size,
which is why it can be far larger than the files on disk.

  Space          play / pause
  Left / Right   step one frame (Shift: ten)
  Home / End     jump to IN / OUT
  F              fit to window
  Ctrl(Cmd)+Q    quit

  Double click   play / pause
  Middle drag    pan
  Wheel          zoom

FIT fits the window; 1:1 is actual pixel size even where that
overflows it. Drag the HUE / SAT / BRIG / CONT / GAMA readouts to
adjust colour, and double-click one to reset it. The RGB selector
isolates a single channel.

The first pass through a sequence runs while frames are still
loading, so it is uneven and the FPS selector stays disabled.
From the second pass onward it plays at the chosen rate.

Terms: (c) 2026 fuzzlet. Free to use, personally or at work. You
may pass the package on as it is; please do not redistribute
modified copies, sell it or bundle it into anything sold, or
remove the attribution. Provided as is, without warranty. See
LICENSE.txt, and THIRD-PARTY-NOTICES.md for the open source
components, which carry their own licences.


===============================================================
 不具合・ご要望があれば教えてください。
 If you run into anything, please let us know.
===============================================================
