Other

AffineTransform

تستخدم AffineTransform مصفوفة 3×3 مع صف أخير ضمني [ 0 0 1 ] لتحويل إحداثيات المصدر (س، ص) إلى إحداثيات وجهة (س'، ص') وفقًا لما يلي:

 [ 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

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

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

لون النموذج اللوني أحمر أخضر أزرق (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 تحدد تعيينًا لأنواع ألوان المظهر هذه إلى ألوان ملموسة.

عمليات التعداد
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 هي NOT_RENDERED، لن يكون للعنصر الخاصية المعنية عند عرضه على صفحة. ومع ذلك، ربما لا يزال يمكن تعيين الحقل بحيث يمكن اكتسابه بواسطة الأشكال الفرعية. لإزالة خاصية من عنصر معروض، اضبط الخاصية PropertyState على NOT_RENDERED.
INHERIT إذا كانت حالة الموقع هي INHERIT، تستخدم حالة الخاصية القيمة المقابلة propertyState على الشكل الأصلي. لن تظهر حالة الخاصية INHERIT للعناصر التي لا تكتسبها أبدًا.

SolidFill

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

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

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

object (OpaqueColor)

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

alpha

number

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

pixel color = alpha * (color) + (1.0 - alpha) * (لون الخلفية)

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

أحرف مُحاطة بخطوط

مخطط تفصيلي PageElement

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

تمثيل 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 من "تنسيقات ملفات 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_DOT الشُرط والنقاط البديلة. يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal، وهي "dashDot".
LONG_DASH خط بشرطات كبيرة. يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal "lgDash".
LONG_DASH_DOT التبديل بين الشرطات والنقاط الكبيرة. يتوافق مع قيمة ECMA-376 ST_PresetLineDashVal، وهي "lgDashDot".

الظل

خصائص الظل لعنصر الصفحة.

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

تمثيل 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.59 من "تنسيقات ملف 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 من 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]، حيث تعني القيمة 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].

الاسم

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

عمليات التعداد
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 للحصول على تدرّج الخرسانة.