GMImage.AffineTransform
-----------------------

Transform image by specified affine (or free transform) matrix.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [GraphicsMagick](component_GraphicsMagick.md) | [16.2](newinversion162.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "GMImage.AffineTransform"; ImageRef { ; sx; sy; rx; ry; tx; ty } ) 

**MBS**( **"GMImage.AffineTransform";** /\* Transform image by specified affine (or free transform) matrix. \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$sx**; /\* Optional; The x scale factors.  
Default is 1.e.g. 1 \*/   
**$sy**; /\* Optional; The y scale factors.  
Default is 1.e.g. 1 \*/   
**$rx**; /\* Optional; The x rotate factors.e.g. 0 \*/   
**$ry**; /\* Optional; The y rotate factors.e.g. 0 \*/   
**$tx**; /\* Optional; The x translation value.e.g. 0 \*/   
**$ty**) /\* Optional; The y translation value.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| ImageRef | The image reference number. | 1 |  |
| sx | The x scale factors.   Default is 1. | 1 | Optional |
| sy | The y scale factors.   Default is 1. | 1 | Optional |
| rx | The x rotate factors. | 0 | Optional |
| ry | The y rotate factors. | 0 | Optional |
| tx | The x translation value. | 0 | Optional |
| ty | The y translation value. | 0 | Optional |

### Result

Returns OK or error.

### Description

Transform image by specified affine (or free transform) matrix.  
### See also

- [GMImage.Affine](GMImageAffine.md)

### Release notes

- **Version 16.2**
    - Added [GMImage.AffineTransform](https://www.mbsplugins.eu/GMImageAffineTransform.shtml) function.

### Blog Entries

- [MBS FileMaker Plugin 16.2 News](https://www.mbsplugins.de/archive/2026-05-20/MBS_FileMaker_Plugin_162_News/monkeybreadsoftware_blog_filemaker)
- [Neues MBS Plugin 16.2 für Claris FileMaker](https://www.mbsplugins.de/archive/2026-05-05/Neues_MBS_Plugin_162_für_Clar/monkeybreadsoftware_blog_filemaker)
- [MBS Plugin 16.2 for Claris FileMaker](https://www.mbsplugins.de/archive/2026-05-05/MBS_Plugin_162_for_Claris_File/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 16.2pr1](https://www.mbsplugins.de/archive/2026-04-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 30th March 2026 , last changed 10th April 2026

  
[GMImage.Affine](GMImageAffine.md) - [GMImage.Annotate](GMImageAnnotate.md)

[HTML Version](GMImageAffineTransform.shtml)