nexoniarz/YAPF
Watch
1
0
Fork
You've already forked YAPF
 0
mirror of https://github.com/Nexoniarz/YAPF.git synced 2026-11-03 04:54:26 +00:00
Code Issues Projects Releases Packages Wiki Activity
YAPF/extensions/blender/README.md
Claude fdbd0a6b8f
 Python binding and Blender read YAPF 2 
yapf.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
2026-10-11 09:57:52 +00:00

1.9 KiB
Raw Permalink Blame History

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, 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

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.