GMImage.PushClipPath
--------------------

Push (create) clip path definition with new name.

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

MBS( "GMImage.PushClipPath"; ImageRef; Name ) 

**MBS**( **"GMImage.PushClipPath";** /\* Push (create) clip path definition with new name. \*/  
**$ImageRef**; /\* The image reference number.e.g. 1 \*/   
**$Name**) /\* The name of the new clippath.e.g. "Clip1" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| ImageRef | The image reference number. | 1 |
| Name | The name of the new clippath. | "Clip1" |

### Result

Returns OK or error.

### Description

Push (create) clip path definition with new name.   
Clip patch definition consists of subsequent drawing commands, terminated by [GMImage.PopClipPath](GMImagePopClipPath.md).  
### See also

- [GMImage.ClipPath](GMImageClipPath.md)
- [GMImage.PopClipPath](GMImagePopClipPath.md)

This function checks for a license.

Created 18th August 2014 , last changed 18th August 2014

  
[GMImage.PurgeTemporaryFiles](GMImagePurgeTemporaryFiles.md) - [GMImage.Quantize](GMImageQuantize.md)

[HTML Version](GMImagePushClipPath.shtml)