Class AffineTransformBuilder
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداةإنشاءالتحويلاتالتناسبية
أداة إنشاء لكائنات AffineTransform الإعداد التلقائي هو تحويل الهوية.
اتصل برقم AffineTransformBuilder#build() للحصول على عنصر AffineTransform.
const transform =
SlidesApp.newAffineTransformBuilder().setScaleX(2.0).setShearY(1.1).build();
// The resulting transform matrix is
// [ 2.0 0.0 0.0 ]
// [ 1.1 1.0 0.0 ]
// [ 0 0 1 ]
}
مستندات تفصيلية
setScaleX(scaleX)
تُستخدَم لضبط عنصر تكبير/تصغير الإحداثيات X وعرض المنشئ.
المعلمات
| الاسم | النوع | الوصف |
scaleX | Number | |
الإرجاع
AffineTransformBuilder
setScaleY(scaleY)
تضبط عنصر تكبير الإحداثيات Y وتُرجع المنشئ.
المعلمات
| الاسم | النوع | الوصف |
scaleY | Number | |
الإرجاع
AffineTransformBuilder
setShearX(shearX)
تُستخدَم لضبط عنصر القص في الإحداثي X وعرض المنشئ.
المعلمات
| الاسم | النوع | الوصف |
shearX | Number | |
الإرجاع
AffineTransformBuilder
setShearY(shearY)
تُستخدَم لضبط عنصر القص في الإحداثي Y وعرض المنشئ.
المعلمات
| الاسم | النوع | الوصف |
shearY | Number | |
الإرجاع
AffineTransformBuilder
تُستخدَم لضبط عنصر الترجمة في الإحداثيات X بالنقاط، وعرض المنشئ.
المعلمات
| الاسم | النوع | الوصف |
translateX | Number | |
الإرجاع
AffineTransformBuilder
setTranslateY(translateY)
تُستخدَم لضبط عنصر الترجمة للإحداثي Y بالنقاط، وعرض المنشئ.
المعلمات
| الاسم | النوع | الوصف |
translateY | Number | |
الإرجاع
AffineTransformBuilder
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eAffineTransformBuilder\u003c/code\u003e helps create custom transformations for objects in Google Slides, like scaling or shearing.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to set scaling, shearing, and translation values for the X and Y coordinates.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ebuild()\u003c/code\u003e method finalizes the transformation and returns an \u003ccode\u003eAffineTransform\u003c/code\u003e object, ready to be applied.\u003c/p\u003e\n"],["\u003cp\u003eThis builder uses a fluent interface, allowing you to chain methods together for concise transformation definitions.\u003c/p\u003e\n"]]],["`AffineTransformBuilder` constructs `AffineTransform` objects, defaulting to the identity transform. It uses methods like `setScaleX`, `setScaleY`, `setShearX`, `setShearY`, `setTranslateX`, and `setTranslateY` to modify the transformation elements. Each 'set' method takes a number parameter, and returns the builder. The `build()` method creates the `AffineTransform` object with the specified elements.\n"],null,["# Class AffineTransformBuilder\n\nAffineTransformBuilder\n\nA builder for [AffineTransform](/apps-script/reference/slides/affine-transform) objects. Defaults to the identity transform.\n\nCall `Affine``Transform``Builder#build()` to get the [AffineTransform](/apps-script/reference/slides/affine-transform) object.\n\n```text\nconst transform =\n SlidesApp.newAffineTransformBuilder().setScaleX(2.0).setShearY(1.1).build();\n\n// The resulting transform matrix is\n// [ 2.0 0.0 0.0 ]\n// [ 1.1 1.0 0.0 ]\n// [ 0 0 1 ]\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|-------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| [build()](#build()) | [AffineTransform](/apps-script/reference/slides/affine-transform) | Creates an [AffineTransform](/apps-script/reference/slides/affine-transform) object initialized with the elements set in the builder. |\n| [setScaleX(scaleX)](#setScaleX(Number)) | [AffineTransformBuilder](#) | Sets the X coordinate scaling element and returns the builder. |\n| [setScaleY(scaleY)](#setScaleY(Number)) | [AffineTransformBuilder](#) | Sets the Y coordinate scaling element and returns the builder. |\n| [setShearX(shearX)](#setShearX(Number)) | [AffineTransformBuilder](#) | Sets the X coordinate shearing element and returns the builder. |\n| [setShearY(shearY)](#setShearY(Number)) | [AffineTransformBuilder](#) | Sets the Y coordinate shearing element and returns the builder. |\n| [setTranslateX(translateX)](#setTranslateX(Number)) | [AffineTransformBuilder](#) | Sets the X coordinate translation element in points, and returns the builder. |\n| [setTranslateY(translateY)](#setTranslateY(Number)) | [AffineTransformBuilder](#) | Sets the Y coordinate translation element in points, and returns the builder. |\n\nDetailed documentation\n----------------------\n\n### `build()`\n\nCreates an [AffineTransform](/apps-script/reference/slides/affine-transform) object initialized with the elements set in the builder.\n\n#### Return\n\n\n[AffineTransform](/apps-script/reference/slides/affine-transform)\n\n*** ** * ** ***\n\n### `set``Scale``X(scaleX)`\n\nSets the X coordinate scaling element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `scaleX` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Scale``Y(scaleY)`\n\nSets the Y coordinate scaling element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `scaleY` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Shear``X(shearX)`\n\nSets the X coordinate shearing element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `shearX` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Shear``Y(shearY)`\n\nSets the Y coordinate shearing element and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|----------|-------------|\n| `shearY` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Translate``X(translateX)`\n\nSets the X coordinate translation element in points, and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|----------|-------------|\n| `translateX` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)\n\n*** ** * ** ***\n\n### `set``Translate``Y(translateY)`\n\nSets the Y coordinate translation element in points, and returns the builder.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------|----------|-------------|\n| `translateY` | `Number` | |\n\n#### Return\n\n\n[AffineTransformBuilder](#)"]]
