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.

אם השדות האלה לא מוגדרים, יכול להיות שהם יועברו בירושה מ-placeholder הורה, אם הוא קיים. אם אין הורה, השדות יאכלסו כברירת מחדל את הערך שמשמש לרכיבי דף חדשים שנוצרים בעורך של 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 – עקרונות בסיסיים ומסמך עזר בנושא שפת ה-Markup', חלק 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' של ST_PresetLineDashVal ב-ECMA-376.
LONG_DASH קו עם מקפים גדולים. תואם לערך 'lgDash' של ST_PresetLineDashVal ב-ECMA-376.
LONG_DASH_DOT קווים מקבילים גדולים לסירוגין עם נקודות. תואם לערך 'lgDashDot' של ST_PresetLineDashVal ב-ECMA-376.

צל

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

אם השדות האלה לא מוגדרים, יכול להיות שהם יועברו בירושה מ-placeholder הורה, אם הוא קיים. אם אין הורה, השדות יאכלסו כברירת מחדל את הערך שמשמש לרכיבי דף חדשים שנוצרים בעורך של 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)

המצב של נכס הצל.

עדכון הצל של רכיב בדף יגרום לעדכון של השדה הזה באופן משתמע לערך 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 – עקרונות והפניה לשפת ה-Markup', חלק 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

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

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

enum (Type)

סוג ה-placeholder.

index

integer

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

parentObjectId

string

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

סוג

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

רבים מסוגי ה-Placeholder האלה תואמים למזהי Placeholder מהתקן ECMA-376. מידע נוסף זמין בתיאור של הסוג ST_PlaceholderType בקטע 19.7.10 במאמר 'פורמטים של קבצים של Office Open XML – עקרונות בסיסיים ומסמך עזר בנושא שפת סימון', חלק 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 כדי לראות את שיפוע הספציפי.