Other

تحويل أفين

تستخدم 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 للإحداثيات على شكل X.

scaleY

number

يُستخدم العنصر "Y" لتغيير حجم العنصر.

shearX

number

عنصر قص الإحداثيات X.

shearY

number

عنصر اقتصاص Y للتنسيق.

translateX

number

عنصر الترجمة س.

translateY

number

العنصر Y لتنسيق الترجمة

unit

enum (Unit)

الوحدات لعناصر الترجمة.

ألوان مُعتِمة

قيمة موضوعة ذات ألوان ثابتة.

تمثيل 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.

نوع اللون

أنواع ألوان المظاهر.

PageProperties تحتوي على ColorScheme التي تحدد تعيين أنواع ألوان المظاهر هذه للألوان الخرسانية.

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

حالة الولاية

الحالات المحتملة لأحد المواقع.

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

ملء خالص

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

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

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

ملء Outline

ملء المخطط.

تمثيل 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 من الإصدار 4MA6 من ECMA-376.

عمليات التعداد
DASH_STYLE_UNSPECIFIED نمط الشرطة غير محدد.
SOLID خط متصل يتطابق مع قيمة SOMA-376 ECMA-376 ST_PresetLineDashVal. هذا هو نمط الشرطة التلقائي.
DOT خط منقط يتطابق مع قيمة ECMA-376 ST_PresetLineDashVal التي تشير إلى "نقطة".
DASH خط متقطع يتطابق مع قيمة ECMA-376 ST_PresetLineDashVal التي تخص "الشرطة".
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. وفي هذه الحالة، سيتم تجاهل أي حقول ظل أخرى تم ضبطها في الطلب نفسه.

Type

أنواع الظلال.

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

موضع مستطيل

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

عمليات التعداد
RECTANGLE_POSITION_UNSPECIFIED غير محدد
TOP_LEFT نحو أعلى اليسار
TOP_CENTER أعلى الوسط.
TOP_RIGHT نحو أعلى اليمين
LEFT_CENTER في الوسط.
CENTER الوسط.
RIGHT_CENTER أوسط اليمين.
BOTTOM_LEFT نحو أسفل اليسار
BOTTOM_CENTER في الوسط
BOTTOM_RIGHT نحو أسفل اليمين

محاذاة المحتوى

أنواع محاذاة المحتوى.

مشتق من مجموعة فرعية من قيم النوع البسيط "ST_TextAnchoringType" في القسم 20.1.10.59 من "تنسيقات ملفات XML المفتوحة على Office - المراجع الأساسية ولغة الترميز"، الجزء 1 من الإصدار 4MA6 من 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

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

Type

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

تتوافق العديد من أنواع العناصر النائبة هذه مع أرقام تعريف العناصر النائبة من معيار ECMA-376. ويمكن العثور على مزيد من المعلومات عن تلك الأشكال في وصف النوع "ST_PlaceholderType" في القسم 19.7.10 من "تنسيقات ملفات XML المفتوحة على Office - المراجع الأساسية ولغة الترميز الترميزية"، الجزء 1 من الإصدار 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 صورة الشريحة.

خصائص الصورة

سمات 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)

ظل الصورة. في حال عدم ضبط هذه السياسة، لن يكون للصورة ظل. هذا الموقع للقراءة فقط.

خصائص الاقتصاص

خصائص الاقتصاص لعنصر محاط في حاوية. على سبيل المثال، 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 الحالية للصفحة. هذا الموقع للقراءة فقط.

إيقاف اللون

لون وموضع في سوار متدرج.

تمثيل 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 للاطّلاع على التدرّج الخرساني.