Class AffineTransform
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
AffineTransform
מטריצת 3x3 שמשמשת להמרת קואורדינטות המקור (x1, y1) לקואורדינטות היעד (x2, y2) בהתאם להכפלת מטריצות:
[ x2 ] [ scaleX shearX translateX ] [ x1 ]
[ y2 ] = [ shearY scaleY translateY ] [ y1 ]
[ 1 ] [ 0 0 1 ] [ 1 ]
אחרי הטרנספורמציה,
x2 = scaleX * x1 + shearX * y1 + translateX;
y2 = scaleY * y1 + shearY * x1 + translateY;
מסמכים מפורטים
getScaleX()
הפונקציה מקבלת את רכיב הגודל של קואורדינטת X.
חזרה
Number
getScaleY()
הפונקציה מקבלת את רכיב הגודל של קואורדינטת Y.
חזרה
Number
getShearX()
הפונקציה מקבלת את רכיב הכיוון של קואורדינטת X.
חזרה
Number
getShearY()
הפונקציה מקבלת את רכיב ההחלפה של קואורדינטת Y.
חזרה
Number
getTranslateX()
הפונקציה מקבלת את רכיב התרגום של קואורדינטת X בנקודות.
חזרה
Number
getTranslateY()
הפונקציה מקבלת את רכיב התרגום של קואורדינטת Y בנקודות.
חזרה
Number
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eAffineTransform uses a 3x3 matrix to transform 2D coordinates on a presentation slide.\u003c/p\u003e\n"],["\u003cp\u003eIt allows for scaling, shearing, and translation operations on objects using x and y coordinates.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetScaleX()\u003c/code\u003e, \u003ccode\u003egetScaleY()\u003c/code\u003e, \u003ccode\u003egetShearX()\u003c/code\u003e, \u003ccode\u003egetShearY()\u003c/code\u003e, \u003ccode\u003egetTranslateX()\u003c/code\u003e, and \u003ccode\u003egetTranslateY()\u003c/code\u003e methods provide access to individual transformation elements.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etoBuilder()\u003c/code\u003e can be utilized for creating a new transform based on an existing one using the AffineTransformBuilder.\u003c/p\u003e\n"]]],["AffineTransform uses a 3x3 matrix to convert source coordinates (x1, y1) to destination coordinates (x2, y2) via matrix multiplication, resulting in x2 = scaleX * x1 + shearX * y1 + translateX and y2 = scaleY * y1 + shearY * x1 + translateY. It provides methods to get scaling elements (getScaleX, getY), shearing elements (getShearX, getY), and translation elements (getTranslateX, getY). A toBuilder method is available to return an AffineTransformBuilder.\n"],null,["# Class AffineTransform\n\nAffineTransform\n\nA 3x3 matrix used to transform source coordinates (x1, y1) into destination coordinates (x2, y2)\naccording to matrix multiplication:\n\n```text\n[ x2 ] [ scaleX shearX translateX ] [ x1 ]\n[ y2 ] = [ shearY scaleY translateY ] [ y1 ]\n[ 1 ] [ 0 0 1 ] [ 1 ]\n```\n\nAfter transformation,\n\n```text\nx2 = scaleX * x1 + shearX * y1 + translateX;\ny2 = scaleY * y1 + shearY * x1 + translateY;\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------|----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|\n| [getScaleX()](#getScaleX()) | `Number` | Gets the X coordinate scaling element. |\n| [getScaleY()](#getScaleY()) | `Number` | Gets the Y coordinate scaling element. |\n| [getShearX()](#getShearX()) | `Number` | Gets the X coordinate shearing element. |\n| [getShearY()](#getShearY()) | `Number` | Gets the Y coordinate shearing element. |\n| [getTranslateX()](#getTranslateX()) | `Number` | Gets the X coordinate translation element in points. |\n| [getTranslateY()](#getTranslateY()) | `Number` | Gets the Y coordinate translation element in points. |\n| [toBuilder()](#toBuilder()) | [AffineTransformBuilder](/apps-script/reference/slides/affine-transform-builder) | Returns a new [AffineTransformBuilder](/apps-script/reference/slides/affine-transform-builder) based on this transform. |\n\nDetailed documentation\n----------------------\n\n### `get``Scale``X()`\n\nGets the X coordinate scaling element.\n\n#### Return\n\n\n`Number`\n\n*** ** * ** ***\n\n### `get``Scale``Y()`\n\nGets the Y coordinate scaling element.\n\n#### Return\n\n\n`Number`\n\n*** ** * ** ***\n\n### `get``Shear``X()`\n\nGets the X coordinate shearing element.\n\n#### Return\n\n\n`Number`\n\n*** ** * ** ***\n\n### `get``Shear``Y()`\n\nGets the Y coordinate shearing element.\n\n#### Return\n\n\n`Number`\n\n*** ** * ** ***\n\n### `get``Translate``X()`\n\nGets the X coordinate translation element in points.\n\n#### Return\n\n\n`Number`\n\n*** ** * ** ***\n\n### `get``Translate``Y()`\n\nGets the Y coordinate translation element in points.\n\n#### Return\n\n\n`Number`\n\n*** ** * ** ***\n\n### `to``Builder()`\n\nReturns a new [AffineTransformBuilder](/apps-script/reference/slides/affine-transform-builder) based on this transform.\n\n#### Return\n\n\n[AffineTransformBuilder](/apps-script/reference/slides/affine-transform-builder)"]]
