Other

AffineTransform

يستخدِم AffineTransform مصفوفة 3×3 مع صف آخر ضمني من [ 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)

لون أحمر أخضر أزرق معتم

themeColor

enum (ThemeColorType)

لون مظهر غير شفاف

RgbColor

لون أحمر أخضر أزرق

تمثيل 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 الذي يحدّد تعيينًا لأنواع ألوان المظهر هذه إلى ألوان محدّدة.

عمليات التعداد
THEME_COLOR_TYPE_UNSPECIFIED لون المظهر غير محدَّد. يجب عدم استخدام هذه القيمة.
DARK1 يمثّل أول لون داكن.
LIGHT1 يمثّل أول لون خفيف.
DARK2 يمثّل اللون الداكن الثاني.
LIGHT2 يمثّل لون الإضاءة الثاني.
ACCENT1 يمثّل لون التمييز الأول.
ACCENT2 يمثّل اللون الثانوي للتمييز.
ACCENT3 يمثّل اللون الثالث للتمييز.
ACCENT4 يمثّل لون التمييز الرابع.
ACCENT5 يمثّل لون التمييز الخامس.
ACCENT6 يمثّل لون التمييز السادس.
TEXT1 يمثّل لون النص الأول.
BACKGROUND1 يمثّل لون الخلفية الأول.
TEXT2 يمثّل لون النص الثاني.
BACKGROUND2 يمثّل لون الخلفية الثاني.

PropertyState

الحالات المحتملة لموقع جغرافي

عمليات التعداد
RENDERED إذا كانت حالة السمة هي RENDERED (معروضة)، يكون للعنصر السمة المقابلة عند عرضه على صفحة. إذا كان العنصر شكل عنصر نائب كما يحدّده الحقل placeholder ، وكان يرث من شكل عنصر نائب، قد لا يتم ضبط الحقل المقابل، ما يعني أنّ قيمة السمة يتم اكتسابها من عنصر نائب رئيسي. إذا لم يكتسب العنصر القيمة، سيحتوي الحقل على القيمة المعروضة. هذه هي القيمة الافتراضية.
NOT_RENDERED إذا كانت حالة الموقع هي NOT_RENDERED، يعني ذلك أنّ العنصر لا يتضمّن الموقع المقابل عند عرضه على صفحة. ومع ذلك، قد يظلّ الحقل مضبوطًا ليتم اكتسابه من الأشكال الفرعية. لإزالة خاصيّة من عنصر معروض، اضبط propertyState على NOT_RENDERED.
INHERIT إذا كانت حالة السمة هي INHERIT، ستستخدم حالة السمة قيمة الحقل corrispondente propertyState في الشكل الرئيسي. لن تحصل العناصر التي لا تكتسِب سمات على حالة خاصية INHERIT مطلقًا.

SolidFill

تعبئة بلون واحد يتم ملء الصفحة أو عنصر الصفحة بالكامل بقيمة اللون المحدّدة.

إذا لم يتم ضبط أي حقل، قد يتم اكتساب قيمته من عنصر نائب رئيسي إذا كان متوفّرًا.

تمثيل JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
الحقول
color

object (OpaqueColor)

قيمة لون التعبئة الصلبة

alpha

number

جزء من color الذي يجب تطبيقه على البكسل. وهذا يعني أنّ لون البكسل النهائي يتم تحديده من خلال المعادلة التالية:

لون البكسل = ألفا * (اللون) + (1.0 - ألفا) * (لون الخلفية)

وهذا يعني أنّ القيمة 1.0 تتوافق مع لون صلب، في حين تتوافق القيمة 0.0 مع لون شفاف تمامًا.

المخطَّط

مخطّط محتوى PageElement

إذا لم يتم ضبط هذه الحقول، قد يتم اكتسابها من عنصر نائب رئيسي إذا كان متوفّرًا. إذا لم يكن هناك عنصر رئيسي، ستتم ضبط الحقول تلقائيًا على القيمة المستخدَمة لعناصر الصفحة الجديدة التي تم إنشاؤها في محرِّر "العروض التقديمية من Google"، والتي قد تعتمد على نوع عنصر الصفحة.

تمثيل 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 - أساسيات ومرجع لغة الترميز"، الجزء 1 من ECMA-376 الطبعة الخامسة.

عمليات التعداد
DASH_STYLE_UNSPECIFIED نمط الشرطة غير محدّد.
SOLID خطّ متصل تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "solid". هذا هو نمط الفاصل التلقائي.
DOT خط منقط تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "dot".
DASH خط متقطّع تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "dash".
DASH_DOT الخطوط المقطوعة والنقاط المتبادلة تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "dashDot".
LONG_DASH خط يتضمّن شرطات كبيرة تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "lgDash".
LONG_DASH_DOT تبديل بين شرطات كبيرة ونقاط تتوافق مع قيمة ECMA-376 ST_PresetLineDashVal‏ "lgDashDot".

ظل

سمات الظل لعنصر الصفحة

إذا لم يتم ضبط هذه الحقول، قد يتم اكتسابها من عنصر نائب رئيسي إذا كان متوفّرًا. إذا لم يكن هناك عنصر رئيسي، ستتم ضبط الحقول تلقائيًا على القيمة المستخدَمة لعناصر الصفحة الجديدة التي تم إنشاؤها في محرِّر "العروض التقديمية من Google"، والتي قد تعتمد على نوع عنصر الصفحة.

تمثيل 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. في هذه الحالة، سيتم تجاهل أي حقول ظلّ أخرى تم ضبطها في الطلب نفسه.

النوع

أنواع الظلال

عمليات التعداد
SHADOW_TYPE_UNSPECIFIED نوع الظل غير محدَّد.
OUTER الظل الخارجي

RectanglePosition

يحدِّد مواضع المرجع في مستطيل.

عمليات التعداد
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 - أساسيات ومرجع لغة الترميز"، الجزء 1 من ECMA-376 الطبعة الخامسة.

عمليات التعداد
CONTENT_ALIGNMENT_UNSPECIFIED محاذاة محتوى غير محدّدة يتم اكتساب محاذاة المحتوى من العنصر الرئيسي إذا كان متوفّرًا.
CONTENT_ALIGNMENT_UNSUPPORTED محاذاة محتوى غير متوافقة
TOP محاذاة تُحاذا المحتوى مع أعلى حامل المحتوى يتوافق مع ECMA-376 ST_TextAnchoringType 't'.
MIDDLE هو محاذاة تُحاذا المحتوى في منتصف حامل المحتوى. يتوافق مع ECMA-376 ST_TextAnchoringType 'ctr'.
BOTTOM محاذاة تُحاذا المحتوى مع أسفل حامل المحتوى يتوافق مع ECMA-376 ST_TextAnchoringType 'b'.

عنصر نائب

معلومات العنصر النائب التي تحدّد شكل العنصر النائب بشكل فريد

تمثيل JSON
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
الحقول
type

enum (Type)

نوع العنصر النائب

index

integer

فهرس العنصر النائب إذا كانت أنواع العناصر النائبة نفسها متوفّرة في الصفحة نفسها، ستكون لها قيم فهرسة مختلفة.

parentObjectId

string

معرّف العنصر للعنصر النائب الرئيسي لهذه الشكل في حال عدم ضبطه، لن يكون شكل العنصر النائب الرئيسي متوفّرًا، وبالتالي لن يكتسب الشكل سمات من أي شكل آخر.

النوع

نوع شكل العنصر النائب

تتوافق العديد من أنواع العناصر النائبة هذه مع معرّفات العناصر النائبة من معيار ECMA-376. لمزيد من المعلومات، يُرجى الاطّلاع على وصف النوع ST_PlaceholderType في القسم 19.7.10 من "تنسيقات ملفات Office Open XML - أساسيات ومرجع لغة الترميز"، الجزء 1 من الإصدار 5 من ECMA-376.

عمليات التعداد
NONE القيمة التلقائية، تشير إلى أنّها ليست عنصر نائب
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]، حيث يشير الصفر إلى عدم وجود تأثير ويشير الرقم 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.

يتم تمثيل خصائص الاقتصاص من خلال Offsets (الموضع) لأربع حواف تحدّد مستطيل الاقتصاص. يتم قياس العناصر المُحوَّلة كنسبة مئوية من الحواف المقابلة للشكل المستطيل الأصلي للعنصر باتجاه الداخل، وذلك بالنسبة إلى السمات الأصلية للعنصر.

  • إذا كان الإزاحة في النطاق (0, 1)، يتم وضع الحافة المقابلة لمستطيل الاقتصاص داخل المستطيل الحدودي الأصلي للجسم.
  • إذا كانت الإزاحة سالبة أو أكبر من 1، يتم وضع الحافة المقابلة لمستطيل الاقتصاص خارج المستطيل الحدودي الأصلي للجسم.
  • إذا كانت الحافة اليسرى لمستطيل الاقتصاص على يسار الحافة اليمنى، سيتم قلب الجسم أفقيًا.
  • إذا كانت الحافة العلوية لمستطيل الاقتصاص أسفل الحافة السفلية، سيتم قلب الجسم عموديًا.
  • إذا كانت جميع العناصر المُعدَّلة ودرجة الدوران تساوي 0، لن يتم اقتصاص الجسم.

بعد الاقتصاص، سيتم تمديد المحتوى في مستطيل الاقتصاص ليلائم الحاوية.

تمثيل JSON
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
الحقول
leftOffset

number

يحدِّد هذا المَعلمة الحافة اليسرى لمستطيل الاقتصاص الذي يقع على يسار الحافة اليسرى للمستطيل الحدودي الأصلي، وذلك نسبةً إلى العرض الأصلي للعنصر.

rightOffset

number

يحدِّد هذا المَعلمة الحافة اليمنى لمستطيل الاقتصاص الذي يقع على يمين الحافة اليمنى للمستطيل الحدودي الأصلي، وذلك نسبةً إلى العرض الأصلي للعنصر.

topOffset

number

يحدِّد ال offset الحافة العلوية لمستطيل الاقتصاص الذي يقع أسفل الحافة العلوية للمستطيل الحدودي الأصلي، وذلك بالنسبة إلى الارتفاع الأصلي للعنصر.

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].

الاسم

أسماء تأثيرات إعادة التلوين

عمليات التعداد
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 لمعرفة تدرج اللون.