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

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

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

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

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

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

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

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

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

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

يتم استخدام مصفوفات التحويل التقارب الثنائي الأبعاد بشكل شائع بواسطة الرسومات المكتبات للتحكم في المقياس والتدوير والقص والانعكاس والترجمة عناصر. في Slides API، يتم تمثيل تحويل عنصر الصفحة كمصفوفة 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 والحقول غير ذلك.

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

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

تعيين نقطة

لتعيين نقطة معينة باستخدام مصفوفة التحويل، يجب تحويل النقطة (س، ص) في الخط المتجه [x, y, 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.