GMImage.SetSize
---------------

Sets the Width and height of a raw image

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

MBS( "GMImage.SetSize"; ImageRef; Size ) 

**MBS**( **"GMImage.SetSize";** /\* Sets the Width and height of a raw image \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$Size**) /\* The rectangle. A Geometry is specified as a width and height "100x200". With an optional offset "100x200+10+20". For percent values, add a percent on the end, for % values add a %: "100x200%!"e.g. "100x200" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| ImageRef | The image reference number. | 1 |
| Size | The rectangle. A Geometry is specified as a width and height "100x200". With an optional offset "100x200+10+20". For percent values, add a percent on the end, for % values add a %: "100x200%!" | "100x200" |

### Result

Returns "OK" on success.

### Description

Sets the Width and height of a raw image   
Width and height of a raw image (an image which does not support width and height information). Size may also be used to affect the image size read from a multi-resolution format (e.g. Photo CD, JBIG, or JPEG)  
  
To scale images, please use [GMImage.Scale](GMImageScale.md) function.  
If you set a size, that doesn't match the pixel cache size, you may later see an error "Pixel cache dimensions incompatible with image dimensions".  
### See also

- [GMImage.GetSize](GMImageGetSize.md)
- [GMImage.Scale](GMImageScale.md)
- [GMImage.SetMatte](GMImageSetMatte.md)
- [GMImage.SetPage](GMImageSetPage.md)
- [GMImage.SetQuiet](GMImageSetQuiet.md)
- [GMImage.SetScene](GMImageSetScene.md)
- [GMImage.SetType](GMImageSetType.md)
- [GMImage.SetView](GMImageSetView.md)
- [GMImage.SetXMP](GMImageSetXMP.md)
- [GMImage.Solarize](GMImageSolarize.md)

This function checks for a license.

Created 18th August 2014 , last changed 30th March 2023

  
[GMImage.SetScene](GMImageSetScene.md) - [GMImage.SetStrokeAntiAlias](GMImageSetStrokeAntiAlias.md)

[HTML Version](GMImageSetSize.shtml)