mirror of
https://github.com/Nexoniarz/YAPF.git
synced 2026-11-03 13:04:26 +00:00
fdbd0a6b8fyapf.load_texture / decode_texture expose every surface and the texture description; rgba_float() for display (blocks decoded, 16-bit / float kept). Blender imports 16-bit / HDR as float images packed as EXR, decodes GPU blocks, follows the normal-map convention (DirectX flip, Z rebuilt for XY normals). Errors say why. Tested in Blender 4.4.3. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DVrVthWN8GsmgHGUhhsCYm
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# YAPF for Blender
|
||
|
||
Import and export `.yapf` images in **Blender 4.2 or later** (tested with
|
||
Blender 5.1).
|
||
|
||
- **File → Import → YAPF Image (.yapf)** — optionally as a **plane** with a
|
||
material that shows the image.
|
||
- **Image Editor → Image → Open YAPF… / Save as YAPF…** (with mipmaps option).
|
||
- **Drag and drop** `.yapf` files into the 3D Viewport (creates a plane), the
|
||
Image Editor or a node editor.
|
||
|
||
Blender cannot read `.yapf` on its own, so imported images are **packed into
|
||
the .blend** and survive saving and reopening.
|
||
|
||
Every YAPF file opens, version 1 and 2: 8-bit images; GPU blocks (BC1–BC7,
|
||
BC6H) decoded; 16-bit, half and float textures as **float images** (HDR
|
||
values above 1 are kept, packed as EXR); for cubes, arrays and animations
|
||
the first image. Normal maps follow Blender's OpenGL convention: DirectX
|
||
normals get their green flipped, and X/Y-only normals (such as BC5) get Z
|
||
rebuilt. Version 2 files need the bundled native library; the pure-Python
|
||
fallback reads version 1 only. Tested in Blender 4.4.3 (nixpkgs).
|
||
|
||
## Install
|
||
|
||
1. Get `yapf_image-blender.zip` from the
|
||
[Releases](https://github.com/Nexoniarz/YAPF/releases), or build it (below).
|
||
2. Blender → **Edit → Preferences → Get Extensions → ⌄ → Install from Disk…**
|
||
and pick the zip.
|
||
|
||
The zip contains the native YAPF library for Windows, macOS and Linux (x64
|
||
and ARM64). Tested in Blender 5.1 on Linux; the Windows library is tested
|
||
outside Blender, and the macOS libraries are cross-compiled and **not yet run
|
||
on a Mac**. If no library matches your system, the extension still
|
||
**imports** using a pure-Python decoder (numpy, bundled with Blender), but
|
||
cannot export.
|
||
|
||
## Build the zip
|
||
|
||
```sh
|
||
python3 extensions/blender/build.py # library for this machine only
|
||
tools/build_release.sh # all platforms (needs zig)
|
||
```
|
||
|
||
Both write `dist/yapf_image-blender.zip`.
|