Michael Johnsonקובץ PSD עשוי להיפתח בעורך ובכל זאת להיראות אחרת: ההבדל עשוי לגעת במסכה, בטקסט, באפקט של שכבה או בסדר השכבות. דרך אחת לבדוק את התוצאה היא להשוות את הקומפוזיציה שנבנתה מחדש לתמונה השטוחה המוטמעת בקובץ ה־PSD עצמו. PhotoCraft v0.7.0, שיצאה ב־11 באוקטובר 2026, מספקת הזדמנות לבחון את שיטת ההנדסה הזאת דרך דוגמה של עורך גרפי בקוד פתוח שנכתב ב־Rust.
הגרסה מפרטת שינויים במברשות, בבחירה, במסכות, בייבוא OpenRaster ובחלקים נוספים של העורך. עבור מפתחים, מעניינת במיוחד התיעוד שפרסם הפרויקט: הוא מתאר בדיקות ייבוא PSD, השוואה בין מרכיבים ואוסף קבצים המשמש לבדיקות שניתן לשחזר.
קובצי PSD מכילים תמונת ייחוס להשוואה
קובץ PSD רב־שכבתי מכיל את מבנה השכבות ואת התמונה השטוחה של המסמך. PhotoCraft מרנדרת את השכבות ואז משווה את התוצאה לקומפוזיציה המוטמעת הזאת. בדיקה כזו בוחנת עד כמה התוכנה משחזרת את מראה המסמך בטיפול בטקסט, בהתאמות, באפקטים ובתכונות אחרות של הפורמט.
תיאור הארכיטקטורה של PhotoCraft מכנה את הגישה הזאת „אורקל הקומפוזיטור”. תיעוד הבדיקות מונה שלושה אוספי PSD: 256 קבצים שנוצרו בידי הצוות ב־Photoshop, 170 קבצים מאוספי psd-tools ו־ag-psd, וכן אוסף נפרד של psd-tools ובו 309 קבצים. האוספים מורדים בגרסאות קבועות ונבדקים באמצעות סכומי ביקורת.
למפתחי פורמטים כדאי להפריד בין בדיקות לפי השאלה שעליה הן משיבות. בדיקת ניתוח המבנה מראה אם הצליח לקרוא את המסמך; בדיקת פתיחה ושמירה מראה אם הנתונים נשמרו; והשוואת הקומפוזיציה בודקת עד כמה התוצאה החזותית שוחזרה בנאמנות. בתיעוד PhotoCraft מפורטות גם בדיקות ליציבות הבתים בקבצים שלא השתנו וגם השוואות לקומפוזיציה המוטמעת ב־PSD.
מרכיב ה־CPU משמש מימוש ייחוס
הפרויקט מתאר את מרכיב ה־CPU כנתיב ייחוס לייצוא ולבדיקות; מרכיב ה־GPU, המבוסס על wgpu, מבצע את אותה תוכנית פעולות עבור משטח העבודה. לפי תיעוד הארכיטקטורה, התוצאות מושוות בסבילות של עד 1/255 עבור פלט של 8 סיביות, ובדיקת CPU/GPU רצה ב־CI, בין היתר באמצעות מתאם גרפי תוכנתי.
נדרש GPU עבור משטח עבודה אינטראקטיבי, אך הזמינות של הנתיב החומרתי תלויה במסמך ובסביבה. המדריך מציין שמסמכים מרובי־ערוצים ואזורים החורגים ממגבלת המרקם מעובדים באמצעות מרכיב ה־CPU; במקרה של אובדן התקן ה־GPU גם משטח העבודה עובר ל־CPU. אלה תנאים מוגדרים למעבר בין הנתיבים, ולא טענה בדבר מהירות אחידה בכל התקן.
התבנית הכללית ישימה גם למערכות חישוב אחרות: להחזיק מימוש ייחוס שניתן לבדוק לצד נתיב ממוטב, ולהריץ את שניהם על אותם קלטים. במסד נתונים זה עשוי להיות מפרש פשוט לצד מנוע ממוטב, ובעיבוד מדיה — נתיב תוכנתי לצד האצה חומרתית. השוואה חושפת פערים בתוצאות; היא נעשית ניתנת לשחזור כשמקבעים את הקלטים ואת הקריטריון להבדל המותר.
כך הופכים את השיטה לבדיקות מעשיות
- בנו אוסף קטן ומגוון. כללו קבצים עם מסכות, טקסט, קבוצות, שקיפות, אפקטים ומצבי צבע. תעדו את מקור הקבצים ואת גרסאות האוסף כדי שהרצות עתידיות ישתמשו באותם קלטים.
- בחרו תמונת ייחוס וסבילות. עבור PSD אפשר להשוות את התוצאה לקומפוזיציה השטוחה המוטמעת. הגדירו את השגיאה המותרת ובדקו בנפרד מידות, פרופיל צבע וערוץ אלפא, אם הם חשובים ליישום שלכם.
- הפרידו בין ייבוא, שמירה ורינדור. בדיקות נפרדות יכולות לבחון ניתוח של שכבות, פתיחה מחדש אחרי שמירה והתאמת התמונה לתמונת הייחוס. כך קל יותר לזהות באיזה שלב נוצרה השגיאה.
- הריצו את אותם מקרי בדיקה דרך מנועים שונים. השוו בין תוצאות CPU ו־GPU באותם מסמכים, כולל בדיקות בגבולות האריחים ועם אפקטים. שמרו את הקלט ואת ההבדל החזותי כדי שאפשר יהיה לשחזר נסיגה.
- תעדו את תנאי מדידת הביצועים. ציינו את ממדי המסמך, מספר השכבות, החומרה ומצב המטמון. בתיעוד PhotoCraft מופיעות פקודות לבדיקות נפרדות ולהשוואת מרכיבים; המדידות המוצגות בו מתייחסות לתצורות ולתרחישים מסוימים.
מדריך הפיתוח של PhotoCraft מתאר פקודות לבדיקת אוספי PSD, הבדלים חזותיים והתנהגותם של נתיבי קומפוזיציה שונים. הוא יכול לשמש נקודת פתיחה קונקרטית ללימוד תשתית הבדיקות של העורך; יש לקרוא את נתוני הביצועים בתיעוד לצד הקלטים ותצורת החומרה המצוינים בו.
מה אפשר ללמוד מהדוגמה של PhotoCraft
גרסת PhotoCraft v0.7.0 משלבת שינויים בעורך עצמו, ואילו תיעוד הפרויקט חושף נוהג הנדסי נפרד: שימוש בקובצי PSD לייחוס בבדיקת הקומפוזיציה ובמימוש CPU להשוואה לנתיב ה־GPU. למפתחי עורכים, ממירים וכלים אחרים לעבודה עם קבצים מורכבים, המסקנה מועילה ופשוטה: בדקו קריאה, שמירה ותוצאה חזותית בנפרד, והשוו מימושים מואצים לגרסת ייחוס באמצעות קלטים קבועים. כך תאימות וביצועים הופכים לתכונות שניתן לבדוק בתוכנה.