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

רכיב ההתאמה לעומס (scaling) של קואורדינטות X.

scaleY

number

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

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

עדכון המתאר ברכיב דף יוביל לעדכון השדה הזה באופן מרומז 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.48 של "פורמטים של קובצי XML פתוחים ל-Office - יסודות ושפת הסימון", חלק 1 מתוך ECMA-376 מהדורה רביעית.

טיפוסים בני מנייה (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.

צל

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

אם השדות האלה לא מוגדרים, יכול להיות שהם יעברו בירושה מ-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_TextDescriptioningType" פשוט מקלידים בקטע 20.1.10.59 של "פורמטים של קובצי XML פתוחים ל-Office - יסודות ושפת הסימון", חלק 1 מתוך ECMA-376 מהדורה רביעית.

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

Placeholder

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

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

enum (Type)

סוג ה-placeholder.

index

integer

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

parentObjectId

string

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

סוג

הסוג של הצורה שמשמשת כ-placeholder.

רבים מסוגי ה-placeholder האלה תואמים למזהי placeholder בתקן ECMA-376. ניתן למצוא מידע נוסף על הצורות האלה בתיאור של "ST_PlaceholderType" מקלידים בסעיף 19.7.10 של "פורמטים של קובצי XML פתוחים ל-Office - יסודות ושפת סימון", חלק 1 מתוך ECMA-376 מהדורה רביעית.

טיפוסים בני מנייה (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

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

Recolor

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

ייצוג 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 את הדרגתיות של הבטון.