YAPF/extensions/photoshop/README.md
Claude a6c032d824
Extensions read YAPF 2; Nix package
- KDE thumbnailer: texture loader, decodes only the mip it needs; GPU
  blocks, 16-bit and float via the new yapf_tex_to_rgba8. Tested through
  KDE's plugin loader with KF6 from nixpkgs.
- Photoshop: shows the tool's error message; HDR textures open as 32-bit
  (.hdr), 16-bit stays 16-bit; 16-bit documents save as 16-bit.
- CLI: 16-bit PNG export, readable conversion errors.
- default.nix: yapf tool, library, header, MIME type and thumbnailer
  (absolute store path); runs the test suite.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DVrVthWN8GsmgHGUhhsCYm
2026-10-11 09:57:52 +00:00

1.8 KiB
Raw Blame History

YAPF for Photoshop

Two scripts that appear under File → Scripts:

  • Open YAPF — opens one or more .yapf files as documents.
  • Save as YAPF — saves the visible image of the active document (a flattened 8-bit copy; your document is not changed), keeping transparency, with an optional mip chain.

They convert through the yapf command-line tool, so Photoshop needs no native plugin.

Install

  1. Download yapf-<your platform>.zip from the Releases (or build the tool: make → build/yapf).
  2. Copy Open YAPF.jsx, Save as YAPF.jsx, yapf_common.jsxinc and yapf / yapf.exe into Photoshop's scripts folder:
    • Windows: C:\Program Files\Adobe\Adobe Photoshop <version>\Presets\Scripts
    • macOS: /Applications/Adobe Photoshop <version>/Presets/Scripts
  3. Restart Photoshop. The scripts are under File → Scripts; you can give them keyboard shortcuts in Edit → Keyboard Shortcuts or record them in Actions.

Instead of copying yapf next to the scripts you can put it on your PATH.

What opens how

Every YAPF file the yapf tool reads (version 1 and 2): 8-bit images open as 8-bit documents, 16-bit textures as 16-bit documents, half / float and BC6H HDR textures as 32-bit documents (through Radiance .hdr), other GPU blocks (BC1–BC7) decoded to 8-bit. Cubes, arrays and animations open their first image. When a file cannot be opened, the alert shows the tool's reason (for example a damaged file). Saving keeps 8 or 16 bits per channel.

Status

The scripts are written for Photoshop CC's ExtendScript and are not yet tested inside Photoshop (the converter itself is fully tested). A native format plugin (.8bi / .plugin, so .yapf shows up directly in the Open and Save dialogs) needs Adobe's Photoshop SDK and is planned.