Files
effectcraft/crates/psd/README.md
T
Brandon ThomasandClaude Opus 5.5 7b0a449c5f M13.6: PSD smart objects apply perspective quads and placed-layer warps
nonAffineTransform and the warp descriptor (named styles with bend / distortion, custom
envelope quilt meshes via ObAr meshPoints) are baked as placed over the placed bounds
(SourceLayer::placed), at up to 4x resolution.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-03 07:21:00 -04:00

2.0 KiB

effectcraft-psd

Reads Photoshop documents (.psd, and .psb large documents) for File ▸ Import (as footage, as a composition, or as a composition with layer sizes retained), and writes a minimal subset (used to generate test fixtures).

Implemented from Adobe's public Adobe Photoshop File Formats Specification (November 2019 edition): file header, colour mode data, image resources, layer and mask information (layer records, channel image data, layer mask data, additional layer information: luni, lsct/lsdk, lyid, iOpa, TySh, lfx2, SoCo, nvrt, brit, hue2, levl, expA, vmsk/vsms, Lr16/Lr32, smart objects: SoLd/SoLE/PlLd placement and lnk2/lnkD/lnk3/lnkE linked layer data with embedded files), the descriptor (action) structure, and the merged image data. Raw, RLE (PackBits) and ZIP (with and without prediction, inflated with miniz_oxide) compression; 1/8/16/32-bit; Bitmap, Grayscale, Indexed, RGB, CMYK (naive conversion) and Lab colour modes.

Text engine data (EngineData) is read best-effort for the font, size, fill colour and justification of the first style run. Smart objects import as footage of their embedded file (a Photoshop document's merged image, or an image) placed by the smart object's corner quad (position, scale, rotation). A non-affine quad (nonAffineTransform: perspective) or a placed layer warp (warp: the named styles with bend and horizontal / vertical distortion, and custom envelope warps whose quilt mesh of bicubic Bezier patches is read from meshPoints (ObAr) and quiltSliceX / quiltSliceY) is baked as placed over the placed bounds, at up to 4x the document resolution (placed). Custom meshes are evaluated exactly; the named styles' curves are not published, so they are clean-room geometric definitions matching each style by behaviour. Externally linked files fall back to the layer's rendered pixels. No Adobe code, sample files or assets were used; test fixtures are generated in-test by the writer in this crate (write).