Other

AffineTransform

הפונקציה AffineTransform משתמשת במטריצה בגודל 3x3 עם שורה אחרונה משתמעת של [ 0 0 1 ] כדי להמיר קואורדינטות של מקור (x,y) לקואורדינטות של יעד (x', y') בהתאם ל: 

 [ x']   [  scaleX  shearX  translateX  ] [ x ]
 [ y'] = [  shearY  scaleY  translateY  ] [ y ]
 [ 1 ]   [      0       0         1     ] [ 1 ]

אחרי הטרנספורמציה, 

 x' = scaleX * x + shearX * y + translateX;
 y' = scaleY * y + shearY * x + translateY;

לכן, ההודעה הזו מורכבת מששת רכיבי המטריצה האלה.

ייצוג ב-JSON 
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
שדות
scaleX

number

רכיב קביעת קנה המידה של קואורדינטת ה-X.

scaleY

number

רכיב קביעת קנה המידה של קואורדינטת ה-Y.

shearX

number

קואורדינטת ה-X של אלמנט הגזירה.

shearY

number

רכיב הגזירה של קואורדינטת ה-Y.

translateX

number

רכיב התרגום של קואורדינטת X.

translateY

number

רכיב התרגום של קואורדינטת Y.

unit

enum (Unit)

היחידות של רכיבי התרגום.

OpaqueColor

ערך של צבע אחיד שאפשר להגדיר כנושא.

ייצוג ב-JSON 
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (RgbColor)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג ערך הצבע. ‫kind יכול להיות רק אחד מהבאים:
rgbColor

object (RgbColor)

צבע RGB אטום.

themeColor

enum (ThemeColorType)

צבע עיצוב אטום.

RgbColor

צבע RGB.

ייצוג ב-JSON 
{
  "red": number,
  "green": number,
  "blue": number
}
שדות
red

number

הרכיב האדום של הצבע, מ-0.0 עד 1.0.

green

number

הרכיב הירוק של הצבע, מ-0.0 עד 1.0.

blue

number

הרכיב הכחול של הצבע, מ-0.0 עד 1.0.

ThemeColorType

סוגי צבעי העיצוב.

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

טיפוסים בני מנייה (enum)
THEME_COLOR_TYPE_UNSPECIFIED צבע עיצוב לא מוגדר. אין להשתמש בערך הזה.
DARK1 מייצג את הצבע הכהה הראשון.
LIGHT1 מייצג את הצבע הבהיר הראשון.
DARK2 מייצג את הצבע הכהה השני.
LIGHT2 מייצג את צבע האור השני.
ACCENT1 מייצג את הצבע המשני הראשון.
ACCENT2 מייצג את הצבע המשני.
ACCENT3 מייצג את הצבע המשני השלישי.
ACCENT4 מייצג את הצבע המשני הרביעי.
ACCENT5 מייצג את הצבע המשני החמישי.
ACCENT6 מייצג את הצבע המשני השישי.
TEXT1 מייצג את צבע הטקסט הראשון.
BACKGROUND1 מייצג את צבע הרקע הראשון.
TEXT2 מייצג את צבע הטקסט השני.
BACKGROUND2 מייצג את צבע הרקע השני.

PropertyState

הסטטוסים האפשריים של נכס.

טיפוסים בני מנייה (enum)
RENDERED אם המצב של נכס הוא RENDERED, אז לאלמנט יש את הנכס המתאים כשהוא מוצג בדף. אם הרכיב הוא צורה של placeholder כפי שנקבע על ידי השדה placeholder, והוא מקבל בירושה מצורה של placeholder, יכול להיות שהשדה המתאים לא מוגדר, כלומר ערך המאפיין מתקבל בירושה מ-placeholder אב. אם הרכיב לא עובר בירושה, השדה יכיל את הערך שעבר עיבוד. זהו ערך ברירת המחדל.
NOT_RENDERED אם המצב של מאפיין הוא NOT_RENDERED, אז לרכיב אין את המאפיין המתאים כשהוא מוצג בדף. עם זאת, יכול להיות שהשדה עדיין מוגדר כך שצורות צאצא יוכלו לרשת אותו. כדי להסיר מאלמנט שעבר רינדור מאפיין, מגדירים את propertyState שלו ל-NOT_RENDERED.
INHERIT אם המצב של מאפיין הוא INHERIT, המצב של המאפיין משתמש בערך של השדה propertyState המתאים בצורה של רכיב האב. לעולם לא יהיה לרכיבים שלא עוברים בירושה מצב מאפיין INHERIT.

SolidFill

מילוי בצבע אחיד. הדף או רכיב הדף מלאים לגמרי בערך הצבע שצוין.

אם לא מוגדר ערך בשדה מסוים, יכול להיות שהערך שלו יועבר מה-placeholder ברמת ההורה, אם קיים כזה.

ייצוג ב-JSON 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
שדות
color

object (OpaqueColor)

ערך הצבע של המילוי האחיד.

alpha

number

השבר של הערך הזה color שצריך להחיל על הפיקסל. כלומר, הצבע הסופי של הפיקסל מוגדר על ידי המשוואה:

צבע הפיקסל = אלפא * (צבע) + (1.0 – אלפא) * (צבע הרקע)

כלומר, ערך של 1.0 מתאים לצבע אחיד, ואילו ערך של 0.0 מתאים לצבע שקוף לחלוטין.

מתאר

מתאר של PageElement.

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

ייצוג ב-JSON 
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
שדות
outlineFill

object (OutlineFill)

הצבע של המילוי של המתאר.

weight

object (Dimension)

עובי קו המתאר.

dashStyle

enum (DashStyle)

סגנון הקו המקווקו של המתאר.

propertyState

enum (PropertyState)

מצב המאפיין של התרשים.

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

OutlineFill

הצבע של המילוי של המתאר.

ייצוג ב-JSON 
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג המילוי של המתאר. ‫kind יכול להיות רק אחד מהבאים:
solidFill

object (SolidFill)

מילוי בצבע אחיד.

DashStyle

סוגי המקפים שבהם אפשר לעבד גיאומטריה ליניארית. הערכים האלה מבוססים על הסוג הפשוט ST_PresetLineDashVal שמתואר בקטע 20.1.10.49 של Office Open XML File Formats - Fundamentals and Markup Language Reference, חלק 1 של ECMA-376 מהדורה 5.

טיפוסים בני מנייה (enum)
DASH_STYLE_UNSPECIFIED סגנון קו מקווקו לא מוגדר.
SOLID קו רצוף. תואם לערך 'solid' של ECMA-376 ST_PresetLineDashVal. זהו סגנון המקף שמוגדר כברירת מחדל.
DOT קו מקווקו. תואם לערך 'dot' של ECMA-376 ST_PresetLineDashVal.
DASH קו מקווקו. תואם לערך 'dash' של ECMA-376 ST_PresetLineDashVal.
DASH_DOT מקפים ונקודות מתחלפים. תואם לערך dashDot של ECMA-376 ST_PresetLineDashVal.
LONG_DASH קו עם מקפים גדולים. תואם לערך 'lgDash' של ECMA-376 ST_PresetLineDashVal.
LONG_DASH_DOT מקפים גדולים ונקודות מתחלפים. תואם לערך 'lgDashDot' של ECMA-376 ST_PresetLineDashVal.

צל

מאפייני הצל של רכיב בדף.

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

ייצוג ב-JSON 
{
  "type": enum (Type),
  "transform": {
    object (AffineTransform)
  },
  "alignment": enum (RectanglePosition),
  "blurRadius": {
    object (Dimension)
  },
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "rotateWithShape": boolean,
  "propertyState": enum (PropertyState)
}
שדות
type

enum (Type)

סוג הצל. הנכס הזה הוא לקריאה בלבד.

transform

object (AffineTransform)

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

alignment

enum (RectanglePosition)

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

blurRadius

object (Dimension)

רדיוס הטשטוש של הצל. ככל שהרדיוס גדול יותר, כך הצל נעשה מפוזר יותר.

color

object (OpaqueColor)

ערך הצבע של הצללית.

alpha

number

ערך האלפא של צבע הצל, מ-0.0 עד 1.0.

rotateWithShape

boolean

האם הצל צריך להסתובב עם הצורה. הנכס הזה הוא לקריאה בלבד.

propertyState

enum (PropertyState)

מצב מאפיין ה-shadow.

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

סוג

סוגי הצללים.

טיפוסים בני מנייה (enum)
SHADOW_TYPE_UNSPECIFIED סוג הצל לא צוין.
OUTER צל חיצוני.

RectanglePosition

המאפיין הזה מגדיר מיקומי הפניה במלבן.

טיפוסים בני מנייה (enum)
RECTANGLE_POSITION_UNSPECIFIED לא צוין.
TOP_LEFT ימין למעלה.
TOP_CENTER המרכז למעלה.
TOP_RIGHT בפינה השמאלית העליונה.
LEFT_CENTER שמאל מרכז.
CENTER מרכז.
RIGHT_CENTER ימין מרכז.
BOTTOM_LEFT צד ימין למטה.
BOTTOM_CENTER המרכז למטה.
BOTTOM_RIGHT שמאל למטה.

ContentAlignment

סוגי ההתאמה של התוכן.

הערכים נגזרים מקבוצת משנה של הערכים של הסוג הפשוט ST_TextAnchoringType בקטע 20.1.10.60 של Office Open XML File Formats - Fundamentals and Markup Language Reference, חלק 1 של ECMA-376 מהדורה 5.

טיפוסים בני מנייה (enum)
CONTENT_ALIGNMENT_UNSPECIFIED יישור תוכן לא מוגדר. אם קיים תוכן ברמה העליונה, יישור התוכן מועבר בירושה מהרמה העליונה.
CONTENT_ALIGNMENT_UNSUPPORTED יישור תוכן שלא נתמך.
TOP הגדרה ליישור התוכן לחלק העליון של מאגר התוכן. תואם ל-ECMA-376 ST_TextAnchoringType ‏ 't'.
MIDDLE הגדרה ליישור התוכן לאמצע של מאגר התוכן. תואם ל-ECMA-376 ST_TextAnchoringType ‏ 'ctr'.
BOTTOM הגדרה ליישור התוכן לחלק התחתון של מאגר התוכן. תואם ל-ECMA-376 ST_TextAnchoringType ‏ 'b'.

Placeholder

פרטי הפלייסהולדר שמזהים באופן ייחודי צורת פלייסהולדר.

ייצוג ב-JSON 
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
שדות
type

enum (Type)

סוג הפלייסהולדר.

index

integer

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

parentObjectId

string

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

סוג

הסוג של צורת placeholder.

הרבה מסוגי ה-Placeholder האלה תואמים למזהי Placeholder מתקן ECMA-376. מידע נוסף זמין בתיאור של הסוג ST_PlaceholderType בקטע 19.7.10 של Office Open XML File Formats - Fundamentals and Markup Language Reference, חלק 1 של ECMA-376 מהדורה 5.

טיפוסים בני מנייה (enum)
NONE ערך ברירת המחדל, מציין שזה לא placeholder.
BODY הטקסט של גוף הקובץ.
CHART תרשים או גרף.
CLIP_ART תמונה של קליפ ארט.
CENTERED_TITLE הכותרת ממורכזת.
DIAGRAM תרשים.
DATE_AND_TIME תאריך ושעה.
FOOTER טקסט לכותרת התחתונה.
HEADER טקסט הכותרת.
MEDIA מולטימדיה.
OBJECT כל סוג תוכן.
PICTURE תמונה.
SLIDE_NUMBER מספר השקף.
SUBTITLE כותרת משנה.
TABLE טבלה.
TITLE כותרת השקף.
SLIDE_IMAGE תמונה של שקף.

ImageProperties

המאפיינים של התג Image.

ייצוג ב-JSON 
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
שדות
cropProperties

object (CropProperties)

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

transparency

number

אפקט השקיפות של התמונה. הערך צריך להיות בטווח [0.0, 1.0], כאשר 0 מציין שאין השפעה ו-1 מציין שקיפות מלאה. הנכס הזה הוא לקריאה בלבד.

brightness

number

אפקט הבהירות של התמונה. הערך צריך להיות בטווח [‎-1.0, 1.0], כאשר 0 מציין שאין השפעה. הנכס הזה הוא לקריאה בלבד.

contrast

number

אפקט הניגודיות של התמונה. הערך צריך להיות בטווח [‎-1.0, 1.0], כאשר 0 מציין שאין השפעה. הנכס הזה הוא לקריאה בלבד.

recolor

object (Recolor)

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

outline

object (Outline)

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

shadow

object (Shadow)

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

CropProperties

מאפייני החיתוך של אובייקט שמוקף במאגר. לדוגמה, Image.

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

  • אם ההיסט נמצא במרווח (0, 1), הקצה המתאים של מלבן החיתוך ממוקם בתוך מלבן התוחם המקורי של האובייקט.
  • אם ההיסט שלילי או גדול מ-1, הקצה המתאים של מלבן החיתוך ממוקם מחוץ למלבן התוחם המקורי של האובייקט.
  • אם הקצה השמאלי של מלבן החיתוך נמצא בצד ימין של הקצה הימני שלו, האובייקט יתהפך אופקית.
  • אם הקצה העליון של מלבן החיתוך נמצא מתחת לקצה התחתון שלו, האובייקט יתהפך אנכית.
  • אם כל ההיסטים וזווית הסיבוב הם 0, האובייקט לא ייחתך.

אחרי החיתוך, התוכן בתוך מלבן החיתוך יימתח כדי להתאים למאגר שלו.

ייצוג ב-JSON 
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
שדות
leftOffset

number

ההיסט מציין את הקצה השמאלי של מלבן החיתוך שנמצא מימין לקצה השמאלי של מלבן התוחם המקורי, ביחס לרוחב המקורי של האובייקט.

rightOffset

number

ההיסט מציין את הקצה הימני של מלבן החיתוך שנמצא משמאל לקצה הימני של מלבן התוחם המקורי, ביחס לרוחב המקורי של האובייקט.

topOffset

number

ההיסט מציין את הקצה העליון של מלבן החיתוך שנמצא מתחת לקצה העליון של מלבן התוחם המקורי, ביחס לגובה המקורי של האובייקט.

bottomOffset

number

ההיסט מציין את הקצה התחתון של מלבן החיתוך שנמצא מעל הקצה התחתון של מלבן התוחם המקורי, ביחס לגובה המקורי של האובייקט.

angle

number

זווית הסיבוב של חלון החיתוך סביב המרכז שלו, ברדיאנים. זווית הסיבוב מוחלת אחרי ההיסט.

צביעה מחדש

אפקט של צביעה מחדש שהוחל על תמונה.

ייצוג ב-JSON 
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
שדות
recolorStops[]

object (ColorStop)

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

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

name

enum (Name)

השם של אפקט שינוי הצבע.

השם נקבע על סמך recolorStops על ידי התאמת הגוון לצבעים בcolor scheme הנוכחי של הדף. הנכס הזה הוא לקריאה בלבד.

ColorStop

צבע ומיקום בפס של מעבר צבעים.

ייצוג ב-JSON 
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
שדות
color

object (OpaqueColor)

הצבע של נקודת העצירה של המעבר ההדרגתי.

alpha

number

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

position

number

המיקום היחסי של נקודת העצירה של הצבע בפס הגרדיאנט, שנמדד באחוזים. הערך צריך להיות בטווח [0.0, 1.0].

שם

השמות של אפקטי הצביעה מחדש.

טיפוסים בני מנייה (enum)
NONE ללא אפקט של צביעה מחדש. ערך ברירת המחדל.
LIGHT1 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע הראשון שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT2 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע השני שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT3 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע השלישי שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT4 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע הרביעי שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT5 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע החמישי שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT6 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע השישי שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT7 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע השביעי שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT8 אפקט צביעה מחדש שמבהיר את התמונה באמצעות הצבע השמיני שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT9 אפקט צביעה מחדש שמבהיר את התמונה באמצעות הצבע התשיעי שזמין בדף מתוך ערכת הצבעים שלו.
LIGHT10 אפקט שינוי צבע שמבהיר את התמונה באמצעות הצבע העשירי שזמין בדף מתוך ערכת הצבעים שלו.
DARK1 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע הראשון שזמין בדף מתוך ערכת הצבעים שלו.
DARK2 אפקט צביעה מחדש שמכהה את התמונה באמצעות הצבע השני שזמין בדף מתוך ערכת הצבעים שלו.
DARK3 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע השלישי שזמין בדף מתוך ערכת הצבעים שלו.
DARK4 אפקט צביעה מחדש שמכהה את התמונה באמצעות הצבע הרביעי שזמין בדף מתוך ערכת הצבעים שלו.
DARK5 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע החמישי שזמין בדף מתוך ערכת הצבעים שלו.
DARK6 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע השישי שזמין בדף מתוך ערכת הצבעים שלו.
DARK7 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע השביעי שזמין בדף מתוך ערכת הצבעים שלו.
DARK8 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע השמיני שזמין בדף מתוך ערכת הצבעים שלו.
DARK9 אפקט צביעה מחדש שמכהה את התמונה באמצעות הצבע התשיעי שזמין בדף מתוך ערכת הצבעים שלו.
DARK10 אפקט שינוי צבע שמכהה את התמונה באמצעות הצבע העשירי שזמין בדף מתוך ערכת הצבעים שלו.
GRAYSCALE אפקט של צביעה מחדש שצובע מחדש את התמונה בגווני אפור.
NEGATIVE אפקט של צביעה מחדש שצובע מחדש את התמונה בגווני אפור הפוכים.
SEPIA אפקט של צביעה מחדש שצובע מחדש את התמונה בצבע ספיה.
CUSTOM אפקט צביעה מחדש בהתאמה אישית. דוגמה קונקרטית של מעבר צבעים מופיעה במאמר בנושא recolorStops.