שינוי גודל ומיקום הרכיבים בדף

במדריך הזה נסביר איך לשנות את הגודל והמיקום של רכיבי הדף באמצעות טרנספורמציות affine. למידע תיאורטי על טרנספורמציות אליפטיות, תוכלו לעיין במדריך הקונספטואלי בנושא טרנספורמציות.

טרנספורמציה של רכיבים

באמצעות Slides API אפשר לשנות את המיקום והגודל של רכיבים בדף. כדי לעשות זאת, קודם צריך לקבוע איזה סוג טרנספורמציה צריך להחיל, ואז להחיל את הטרנספורמציה באמצעות השיטה presentations.batchUpdate שמכילה רכיב אחד או יותר מסוג UpdatePageElementTransformRequest.

אפשר לבצע טרנספורמציות באחת משתי applyModes:

  • טרנספורמציות ABSOLUTE מחליפות את מטריצת הטרנספורמציה הקיימת של האלמנט. פרמטרים שתשמטו מהבקשה לעדכון הטרנספורמציה יוגדרו לאפס.

  • מכפילים את הטרנספורמציות של RELATIVE במטריית הטרנספורמציה הקיימת של הרכיב (סדר המכפלה חשוב):

$$A' = BA$$

טרנספורמציות יחסיות מעבירות או משנות את קנה המידה של רכיב הדף מהמיקום הנוכחי שלו. לדוגמה, העברת צורה 100 פיקסלים שמאלה או סיבוב שלה ב-40 מעלות. טרנספורמציות אבסולוטיות מבטלות את המידע הקיים על המיקום והגודל. לדוגמה, העברת צורה למרכז הדף או שינוי הגודל שלה לרוחב ספציפי.

בדרך כלל אפשר לבטא טרנספורמציות מורכבות כרצף של טרנספורמציות פשוטות יותר. לרוב, חישוב מראש של טרנספורמציה – שילוב של כמה טרנספורמציות באמצעות כפל מטריצות – יכול לצמצם את התקורה.

בחלק מהפעולות, צריך לדעת מהם הפרמטרים הקיימים של הטרנספורמציה של האלמנט. אם אין לכם את הערכים האלה, תוכלו לאחזר אותם באמצעות הבקשה presentations.pages.get.

תרגום

העברה היא פשוט פעולת ההעברה של רכיב דף למיקום חדש באותו דף. בתרגומים מוחלטים, הרכיב מועבר לנקודה ספציפית, ובתרגומים יחסיים הוא מועבר למרחק ספציפי.

מטריצת טרנספורמציה בסיסית של תרגום נראית כך:

$$T=\begin{bmatrix} 1 & 0 & translate\_x\\ 0 & 1 & translate\_y\\ 0 & 0 & 1 \end{bmatrix}$$

כשמשתמשים ב-UpdatePageElementTransformRequest כדי לתרגם רכיב (בלי לשנות את הגודל, הטיה או הכיוון שלו), אפשר להשתמש באחת מהמבנים הבאים של AffineTransform:

// Absolute translation:
{
  'transform': {
    'scaleX':  current scaleX value,
    'scaleY':  current scaleY value,
    'shearX':  current shearX value,
    'shearY':  current shearY value,
    'translateX': X coordinate to move to,
    'translateY': Y coordinate to move to,
    'unit': 'EMU' // or 'PT'
  }
}

// Relative translation (scaling must also be provided to avoid a matrix multiplication error):
{
  'transform': {
    'scaleX':  1,
    'scaleY':  1,
    'translateX': X coordinate to move by,
    'translateY': Y coordinate to move by,
    'unit': 'EMU' // or 'PT'
  }
}

שינוי קנה מידה

שינוי קנה מידה הוא פעולה של מתיחה או כיווץ של רכיב לאורך המאפיין X ו/או Y כדי לשנות את הגודל שלו. מטריצת שינוי בסיסית של שינוי קנה מידה היא בפורמט:

$$S=\begin{bmatrix} scale\_x & 0 & 0\\ 0 & scale\_y & 0\\ 0 & 0 & 1 \end{bmatrix}$$

אפשר להשתמש בפורמט המטריצה הזה ישירות כטרנספורמציה של RELATIVE כדי לשנות את הגודל של רכיב, אבל זה יכול להשפיע גם על ההזזה וההטיה של הרכיב ברינדור. כדי לשנות את קנה המידה של האובייקט בלי להשפיע על הזזת הציר או על התרגום שלו, עוברים למסגרת העזר שלו.

סיבוב

טרנספורמציות של סיבוב מסובבות רכיב בדף סביב נקודה, באמצעות הפרמטרים של שינוי קנה המידה וההזזה. המטריצה הבסיסית של טרנספורמציית הסיבוב היא בפורמט הבא, כאשר זווית הסיבוב (ברדיאנים) נמדדת מכיוון ציר X, בתנועה נגד כיוון השעון:

$$R=\begin{bmatrix} cos(\theta) & sin(\theta) & 0\\ -sin(\theta) & cos(\theta) & 0\\ 0 & 0 & 1 \end{bmatrix}$$

בדומה לשינוי קנה המידה, אפשר להשתמש בטופס המטריצה הזה ישירות כטרנספורמציה RELATIVE כדי לסובב רכיב, אבל הפעולה הזו גורמת לסיבוב הרכיב סביב המקור של הדף. כדי לסובב את האלמנט סביב מרכזו או סביב נקודה אחרת, עוברים למערכת העזר הזו.

השתקפות

השתקפות משקפת רכיב לאורך קו או ציר ספציפיים. המטריצה הבסיסית של טרנספורמציית ההשתקפות של ציר ה-x וציר ה-y היא בפורמטים הבאים:

$$F_x=\begin{bmatrix} 1 & 0 & 0\\ 0 & -1 & 0\\ 0 & 0 & 1\\ \end{bmatrix}\qquad\qquad F_y=\begin{bmatrix} -1 & 0 & 0\\ 0 & 1 & 0\\ 0 & 0 & 1\\ \end{bmatrix}$$

בדומה לשינוי קנה המידה, אפשר להשתמש בפורמט המטריצה הזה ישירות כטרנספורמציה של RELATIVE כדי לשקף רכיב, אבל הפעולה הזו גורמת לתרגום של הרכיב גם כן. כדי לשקף את הרכיב ללא תרגום, צריך לעבור למערכת הייחוס שלו.

מסגרות עזר של רכיבים

החלת טרנספורמציה בסיסית של שינוי קנה מידה, השתקפות או סיבוב ישירות על רכיב בדף יוצרת טרנספורמציה במסגרת העזר של הדף. לדוגמה, בזווית יסודית, הרכיב מסתובב סביב מקור הדף (הפינה הימנית העליונה). עם זאת, אפשר לפעול במסגרת העזר של הרכיב עצמו, למשל כדי לסובב רכיב סביב נקודת המרכז שלו.

כדי לבצע טרנספורמציה של רכיב בתוך מסגרת העזר שלו, צריך להקיף אותו בשתי תרגומים אחרים: תרגום מקדים T1 שנעביר את מרכז הרכיב למקור הדף, ותרגום עוקב T2 שיעביר את הרכיב בחזרה למיקום המקורי שלו. אפשר לבטא את הפעולה המלאה כמכפלת מטריצות:

$$A' = T2 \times B \times T1 \times A$$

אפשר גם לעבור למסגרות עזר אחרות, על ידי תרגום של נקודות שונות למקור במקום זאת. הנקודות האלה הופכות למרכז של מסגרת העזרה החדשה.

אפשר לבצע כל אחד מהטרנספורמציות האלה בנפרד כבקשות טרנספורמציה של RELATIVE ברצף. באופן אידיאלי, כדאי לחשב מראש את A' שלמעלה באמצעות כפל מטריצות ולהחיל את התוצאה כטרנספורמציה יחידה של ABSOLUTE. לחלופין, אפשר לחשב מראש את המכפלה T2 * B * T1 ולהחיל אותה כטרנספורמציה יחידה של RELATIVE. שתי השיטות האלה יעילות יותר מבחינת פעולות ה-API, בהשוואה לשליחת בקשות הטרנספורמציה בנפרד.

מגבלות

חלק משדות הגודל והמיקום לא תואמים לסוגים מסוימים של רכיבי דף. בטבלה הבאה מפורט סיכום של התאימות של אלמנטים מסוימים בדף לשדות של הגדרת הגודל והמיקום.

שדה צורה וידאו טבלה
תרגום ✔ ✔ ✔
התאמה לעומס (scale) ✔ ✔ לא**
שינוי כיוון ✔ לא לא

** כדי לעדכן את המאפיינים של השורות והעמודות בטבלה, משתמשים ב-UpdateTableRowPropertiesRequest וב-UpdateTableColumnPropertiesRequest.

אם יש שינוי בזווית של רכיב בדף, כל השדות של הגודל והמיקום עשויים להניב תוצאות בלתי צפויות. כל המגבלות עשויות להשתנות. מידע עדכני זמין במאמר Google Slides API.

יכול להיות ש-Slides API יבצע רפגורמציה של הערכים

כשיוצרים רכיב דף, אפשר לציין גודל וטרנספורמציה שיספקו תוצאה חזותית מסוימת. עם זאת, ה-API עשוי להחליף את הערכים שסיפקתם בערכים אחרים שיוצרים את אותו מראה חזותי. באופן כללי, אם כותבים גודל באמצעות ה-API, אין ערובה לכך שהגודל שיוחזר יהיה זהה. עם זאת, אם מביאים בחשבון את הטרנספורמציה, התוצאות אמורות להיות זהות.