التحوّلات وعناصر الصفحة

يصف هذا الدليل المفاهيم الأساسية المستخدمة في تحويل عناصر الصفحة (أي نقلها وتدويرها وتغيير حجمها والقص)، مع التركيز بشكل خاص على التحويل المترابط الأساسي وعملياته.

لمزيد من المعلومات حول كيفية استخدام التحويلات الترابطية لتحقيق نتائج محددة، راجع دليل أشكال الحجم والموضع.

يتم التحكّم في الحجم المرئي لعنصر الصفحة وموضعه من خلال خاصيتَين: size (الحجم) وconversion. يصف الحجم الحجم المثالي أو المضمن لعنصر الصفحة الذي يتم إنشاؤه. يحدد التحويل مصفوفة تحويل مترابط ثنائي الأبعاد يحدد كيفية تحويل كائن بحجمه المدمج للحصول على مظهره المرئي النهائي.

عند تحديد عنصر صفحة في واجهة مستخدم العروض التقديمية وتغيير حجمه المرئي باستخدام مقابض التعديل، يتم تحديث مصفوفة التحويل هذه في الواقع. يؤدي نقل العنصر عبر الصفحة أو تدويره أيضًا إلى تحديث مصفوفة تحويل العنصر.

استخدام واجهة مستخدم "العروض التقديمية من Google" للبدء

تعتبر صيغة المصفوفة التي تستخدمها لتحويل عناصر الصفحة وتغيير حجمها فعّالة جدًا، ولكنها قد تكون شاقًا في البداية؛ يصف معظم هذه الصفحة هذه العمليات الحسابية. ومع ذلك، يمكنك تبسيط مواصفات التحويلات والأحجام باستخدام النهج التالي:

1. إنشاء عناصر الصفحة باستخدام واجهة مستخدم العروض التقديمية.
2. اضبط حجم عناصر الصفحة هذه على النحو المطلوب، مع الاستمرار في استخدام واجهة مستخدم "العروض التقديمية من Google".
3. اقرأ حجم هذه العناصر وتحويلها باستخدام طريقة get.

قد يكون ذلك كافيًا لمساعدتك على البدء. يوضّح الجزء المتبقي من هذا الدليل العمليات الحسابية للتحويل التي يمكنك استخدامها لمعالجة عناصر الصفحة بالتفصيل.

مصفوفات تحويل أفين

تُستخدم مصفوفات التحويل التقاربي الثنائي الأبعاد بشكل شائع من خلال مكتبات الرسوميات للتحكم في مقياس العناصر وتدويرها وقصها وانعكاسها وترجمتها. في واجهة برمجة تطبيقات العروض التقديمية، يتم تمثيل تحويل عنصر الصفحة كمصفوفة 3×3:

$$A=\begin{bmatrix} scale\_x & shear\_x & translate\_x\\ shear\_y & scale\_y & translate\_y\\ 0 & 0 & 1 \end{bmatrix}$$

المعلمات المستخدمة في التحويل هي:

translate_x	تحدّد معلَمات الترجمة الموضع (X وY) للزاوية العلوية اليسرى لعنصر الصفحة، مقارنةً بالزاوية العلوية اليسرى من الصفحة. عليك تحديد الموضع النسبي باستخدام الوحدات لإحدى النقاط (pt) أو الوحدات المترية باللغة الإنجليزية (EMU).
translate_y
scale_x	تتحكّم معلَمات المقياس في حجم عنصر الصفحة عند عرضه. هذه هي عوامل ضرب بدون وحدة. على سبيل المثال، تزيد القيمة scale_x التي تبلغ 1.5 من عرض العنصر بمقدار %50.
scale_y
shear_x	تتميز معلَمات القص أيضًا بأنها غير موحدة وتتحكّم في درجة إمالة عنصر الصفحة. يمكن استخدام مَعلمتَي المقياس والقص معًا لتدوير عنصر الصفحة.
shear_y

يمكنك العثور على العديد من الأمثلة على الويب التي توضح كيفية تأثير مصفوفات التحويل الثنائي الأبعاد على عرض الكائنات الرسومية.

ترتبط مصفوفة التحويل بالمجموعة أو الصفحة التي تتضمن العنصر. على سبيل المثال، إذا قمت بتدوير مجموعة تحتوي على مستطيل، تعكس قيم حقول transform الخاصة بالمجموعة الدوران، لكن قيم حقل transform الخاصة بالمستطيل لا تعكس ذلك.

حساب الحجم المرئي

لتحديد الحجم المرئي (المعروض) لعنصر صفحة، يجب مراعاة كل من خصائص الحجم والتحويل معًا. لا يمكنك تحديد العنصر الذي يكون أكبر من عنصري الصفحة من خلال مقارنة خصائص الحجم فقط: يجب تعيين حدود العنصر باستخدام مصفوفة التحويل وحساب الحجم المعروض.

تعيين نقطة

لتعيين نقطة معينة باستخدام مصفوفة التحويل، قم بتحويل النقطة (س، ص) إلى متجه [س، ص، 1] ثم قم بإجراء ضرب المصفوفة. لنأخذ في الاعتبار ربط نقطة p:

\[p' = Ap\]

يصبح هذا الإجراء:

$$\begin{bmatrix} x'\\ y'\\ 1 \end{bmatrix} =\begin{bmatrix} scale\_x & shear\_x & translate\_x\\ shear\_y & scale\_y & translate\_y\\ 0 & 0 & 1 \end{bmatrix} \begin{bmatrix} x\\ y\\ 1 \end{bmatrix}$$

وبالتالي تكون إحداثيات النقطة الجديدة p' على النحو التالي:

$$x' = (scale\_x \times x) + (shear\_x \times y) + translate\_x\\ y' = (scale\_y \times y) + (shear\_y \times x) + translate\_y$$

حساب الحدود

لتحديد الحجم المعروض لمربع إحاطة العنصر بعد التحويل الذي يتم قصه وقياسه، استخدم:

$$width' = (scale\_x \times width) + (shear\_x \times height)\\ height' = (scale\_y \times height) + (shear\_y \times width)$$

لمزيد من المعلومات حول كيفية استخدام التحويلات الترابطية لتحقيق نتائج محددة، راجع دليل أشكال الحجم والموضع.

القيود

لا تتوافق بعض حقول تغيير الحجم وتحديد الموضع مع بعض أنواع عناصر الصفحة. يلخّص الجدول التالي مدى توافق عناصر صفحات معيّنة مع حقول تحديد الحجم وتحديد الموضع.

الحقل	شكل	حملة فيديو	جدول
الترجمة	✔	✔	✔
المقياس	✔	✔	لا**
سماع	✔	لا	لا

** لتعديل أبعاد الصفوف والأعمدة في الجدول، استخدِم UpdateTableRowPropertiesRequest وUpdateTableColumnPropertiesRequest.

قد تعرض جميع حقول تغيير الحجم وتحديد الموضع نتائج غير متوقعة في حال قص عنصر الصفحة. تخضع جميع القيود للتغيير. للحصول على أحدث المعلومات، يُرجى الاطّلاع على Google Slides API.