הגדרת מאפייני חומר ותבניות לחומרי גימור
צרו חומרי גימור עם בסיס צבע או מרקם, נהלו תבניות חומר והעלו מרקמים שמתחברים נכון לחומרים.
חלון ה-Material Properties (משמש בעת יצירה/עריכה של חומרי גימור ב-SKUs) מאפשר למשתמש לבחור מאפיין בסיס של Color או Texture. אם נבחר Texture, יש להעלות תמונה בפועל - אחרת 'Please upload a texture file' חוסם את השמירה; מעבר חזרה ל-Color מנקה כל מפת מרקם שהועלתה בעת השמירה. העלאות מרקם נשמרות מיד עם הבחירה (כל העלאה יוצרת נכס מרקם), והמחוונים/שדות הקלט שולטים במאפיינים בסגנון PBR (חספוס, מתכתיות, העברה וכדומה; שדות מסוימים, כמו אלה התלויים בהעברה, מציגים מצייני מקום עד להגדרת ערכי ההפעלה). תקלה שכדאי להכיר: מתג ה-'lock aspect ratio' לרוחב/גובה המרקם נשמר ב-localStorage של הדפדפן לפי חומר - הוא אינו מסתנכרן בין מחשבים או משתמשים, ולכן מצב המתג עשוי להיות שונה בין מחשבים. Material Templates (פריסטים בעלי שם של מאפיינים אלה) מנוהלים בנפרד: שם התבנית הוא חובה ('Material Template name cannot be empty'), ניתן לעדכן או להוסיף תבניות, ופעולת שחזור מחזירה ערכים שנערכו לערכים השמורים בתבנית. התבניות חשובות ליצירה מרובה ב-CSV של SKUs של גימור/ליבת פנל, כאשר material_template_id חייב להפנות לתבנית קיימת מגיליון העזר.
✓ נבדק במוצר ב-18 באוקטובר 2026כאשר מאפיין הבסיס הוא Texture, עורך החומר מציע גם משבצות אופציונליות למפת bump ולמפת normal בנוסף למרקם הבסיס, כך שניתן להוסיף עומק מעל המרקם שהועלה.
✓ נבדק במוצר ב-18 באוקטובר 2026התבנית קובעת אילו מאפייני רינדור הגימור משתמש.
✓ נבדק במוצר ב-18 באוקטובר 2026כאשר חומר נוצר או מתעדכן (UI או enterprise API), ה-JSON של מאפייניו נבדק מול תבנית החומר המקושרת: התבנית מגדירה את קבוצת שמות המאפיינים המותרים בדיוק (צבע, אטימות, חספוס, מתכתיות, משבצות מפת מרקם וכדומה). כל מפתח שאינו מוגדר בתבנית גורם לשמירה להיכשל עם PROPERTY_KEY_MISMATCH_WITH_MATERIAL_TEMPLATE_PROPERTY. מפתחות חסרים אינם נבדקים — ניתן לשמור חומר עם תת-קבוצה בלבד של מאפייני התבנית ללא אזהרה. הכשל הקלאסי הוא לקוח שעושה שימוש חוזר במטען מאפיינים שנכתב עבור תבנית אחת תוך העברת material_template_id אחר: מפתחות שהיו תקפים בתבנית הישנה נדחים מול החדשה. מכניקות API שמכשילות אנשים גם כן: יש לשלוח את המאפיינים כאובייקט JSON מחרוזתי — מחרוזת שאינה ניתנת לפענוח נכשלת עם MATERIAL_CREATION_FAILURE (או MATERIAL_UPDATE_FAILURE), ושליחת מערך במקום אובייקט נכשלת עם INVALID_PARAMS. אם material_template_id אינו קיים כלל, השגיאה היא MATERIAL_TEMPLATE_NOT_FOUND. כאשר לקוח מדווח על אחת מהשגיאות הללו, יש לבקש ממנו למשוך את התבנית, לרשום את תוויות המאפיינים שלה ולצמצם את המטען בדיוק למפתחות אלה.
מרקמים מועלים כ-form-data עם שני שדות, file ו-name; הפורמטים הנתמכים הם jpeg, jpg ו-png. ההעלאה יוצרת רשומת תמונה ורשומת מרקם שמפנה אליה, והתגובה מחזירה את המרקם עם התמונה המוטמעת בו. הרשאות: העלאה דורשת הרשאות מנהל קטלוג בחנות או ביחידה העסקית, אך מעצבים מורשים במפורש גם כן — מעצב יכול להוסיף מרקמים מאפליקציית העיצוב גם ללא הרשאות ניהול קטלוג. כדי להשתמש במרקם בחומר, ה-id שלו נכנס למאפיין 'map' של החומר. רק מפת הבסיס הזו נבדקת בעת שמירת החומר: אם ה-id של המפה אינו מתאים למרקם קיים, השמירה נכשלת (MATERIAL_CREATION_FAILURE / MATERIAL_UPDATE_FAILURE), ובהצלחה התמונה של המרקם הופכת אוטומטית לדוגמת התצוגה של החומר. משבצות המפות האחרות — מפות normal, ambient occlusion, bump, metalness ו-roughness — מקבלות מזהי מרקם אך אינן נבדקות לקיום בעת השמירה, כך ש-id שגוי בהן נשמר ללא שגיאה ופשוט אינו נפתר מאוחר יותר. אם לקוח אומר שמפת ה-normal או ה-roughness שלו 'does nothing', יש לוודא שה-id מצביע על מרקם אמיתי לפני ניפוי שגיאות רינדור.