Stiva de editari XMP
Photo2Mac e nedistructiv: fiecare ajustare e un element din
EditStack, randat live de Core Image. Cand o salvare
scrie pixeli, Photo2Mac incorporeaza si EditStack-ul ca metadata XMP,
cu un marker care spune cum a fost scris fisierul. Markerul decide cum
se citeste inapoi: in modul care pastreaza originalul in fisier, stiva
e din nou editabila; in modul «salveaza ce vezi» e doar
un istoric al editarilor, niciodata aplicat a doua oara. Alte aplicatii
vad pixelii.
Mai jos e formatul pe disc, ca sa-l poti citi sau produce din alte
tool-uri.
Namespace
- URI:
http://ns.photo2mac.cremenescu.ro/1.0/
- Prefix:
p2m
- Proprietati:
p2m:editStack (un string UTF-8 cu JSON), p2m:saveMode, iar cu originalul inclus p2m:originalImage, p2m:originalType, p2m:originalSHA256
Aceeasi proprietate e scrisa in JPEG (APP1), PNG (iTXt
XML:com.adobe.xmp), HEIC (meta box) si TIFF (tag 700)
prin ImageIO de la Apple.
JSON-ul EditStack
{
"rotateDegrees": 0, // sens orar, pas 0.01°
"flipHorizontal": false,
"flipVertical": false,
"crop": { ... }, // optional: { x, y, width, height } normalizate 0..1
"cropBasisDegrees": 0, // rotirea la care a fost desenata decuparea
"adjustments": {
"brightness": 0.0, // -1 .. 1 -> CI -0.5 .. 0.5
"contrast": 0.0, // -1 .. 1 -> CI 0.5 .. 1.5
"saturation": 0.0, // -1 .. 1 -> CI 0.0 .. 2.0
"exposure": 0.0 // -3 .. 3 EV (CIExposureAdjust)
},
"resize": { ... } // optional: { width, height, keepsAspect }
}
Ordinea de randare e fixa:
flipH → flipV → rotate → crop → adjustments → resize —
geometria intai (ca crop sa lucreze pe cadrul rotit pe
care il vezi), apoi ajustarile de pixel, iar redimensionarea la final,
ca rezultatul sa fie reesantionat o singura data.
Se mai scrie: tag-uri standard
Ca sa vada orice reader XMP — Inspector-ul din Preview,
Metapho, Adobe Bridge, exiftool, mdls, Get Info
din Finder — ce s-a intamplat cu fisierul, langa
p2m:editStack se scriu si:
xmp:CreatorTool — ex. Photo2Mac 0.3.0
dc:description — rezumat in engleza al stivei
Amandoua sunt mereu in engleza, indiferent de
limba UI-ului Photo2Mac — metadata din fisier e citita de tool-uri
si oameni de pretutindeni, deci ramane locale-independent.
Exemplu: rotire + crop
Indreptare 2.5° in sens antiorar, apoi crop la 90%×80%
central:
{
"rotateDegrees": -2.5,
"flipHorizontal": false,
"flipVertical": false,
"crop": { "x": 0.05, "y": 0.10, "width": 0.90, "height": 0.80 },
"cropBasisDegrees": -2.5,
"adjustments": {
"brightness": 0, "contrast": 0, "saturation": 0, "exposure": 0
}
}
dc:description corespunzator:
Photo2Mac 0.3.0 — rotate -2.50°, crop 90%×80% at (5%, 10%)
Inspectare din linia de comanda
Cu exiftool:
# Toate campurile XMP, inclusiv p2m
exiftool -XMP:all -G photo.jpg
# Doar JSON-ul cu stiva de editari
exiftool -XMP-p2m:editStack -b photo.jpg | jq
# Rezumat human-readable
exiftool -XMP-dc:Description -CreatorTool photo.jpg
Referinta completa, inclusiv politica de stabilitate
(1.0/ din URI = versiunea de schema): docs/XMP.md din repo.
Intrebari frecvente
Photo2Mac este gratuit?
Da. Photo2Mac este gratuit si open source sub licenta
GPL-2.0-or-later. Nu exista tier platit, fara abonament, fara telemetrie: singura cerere de retea e verificarea zilnica de actualizari pe cremenescu.ro, care nu trimite nimic despre tine sau despre Mac si se opreste din Preferinte. Sursa si .dmg sunt ambele pe GitHub.
Ce inseamna «nedistructiv» aici?
Pixelii originali ai fisierului tau nu sunt atinsi pana cand nu apesi Save. Fiecare ajustare — decupare, rotire, oglindire, luminozitate, contrast, saturatie, expunere, redimensionare — traieste pe un EditStack randat live de Core Image. Ce face salvarea alegi in Preferinte: fisierul devine imaginea editata, originalul ramane neatins cu editarile intr-un fisier .p2m alaturi, sau fisierul editat poarta originalul in interior. In ultimele doua moduri, redeschiderea fisierului in Photo2Mac iti da editarile inapoi, ca sa le modifici.
Ce formate citeste si scrie Photo2Mac?
Deschide JPEG, PNG, HEIC, TIFF, WebP si AVIF; salveaza si exporta JPEG, PNG, HEIC si TIFF. Suportul RAW e pe roadmap. Metadata XMP e embedata in toate cele patru formate de output via ImageIO.
Functioneaza pe Mac-uri Apple Silicon?
Da. Fisierul .dmg e un build universal, pentru Mac-uri Apple Silicon si Intel, si necesita macOS 14 Sonoma sau mai nou.
Trebuie sa trec de un avertisment Gatekeeper ca s-o deschid?
Nu, din v0.3.0. Fisierul .dmg e semnat cu Developer ID si notarizat de Apple, deci se deschide normal. Versiunile pana la v0.2.1 erau semnate ad-hoc si aveau nevoie o data de:
xattr -dr com.apple.quarantine /Applications/Photo2Mac.app
Photo2Mac are nevoie de Homebrew sau alte dependinte?
Nu. Fisierul .dmg e self-contained (~2 MB) si depinde doar de framework-urile sistem Apple (Core Image, ImageIO, AppKit, SwiftUI). Trage in Applications si ruleaza.