DynaPDF.CircleAnnot
-------------------

Draws a circle annotation on the current open page.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [DynaPDF](component_DynaPDF.md) | [5.0](newinversion50.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "DynaPDF.CircleAnnot"; PDF; PosX; PosY; Width; Height; LineWidth; FillColor; StrokeColor; ColorSpace ) 

**MBS**( **"DynaPDF.CircleAnnot";** /\* Draws a circle annotation on the current open page. \*/  
**$PDF**; /\* The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). \*/   
**$PosX**; /\* X-coordinate of the annotatione.g. 100 \*/   
**$PosY**; /\* Y-coordinate of the annotatione.g. 100 \*/   
**$Width**; /\* Width of the annotatione.g. 100 \*/   
**$Height**; /\* Height of the annotatione.g. 100 \*/   
**$LineWidth**; /\* Line width of the circle or ellipsee.g. 2 \*/   
**$FillColor**; /\* Fill color for circle.  
See [DynaPDF.RGB](DynaPDFRGB.md) function for RGB colors.e.g. 200 \*/   
**$StrokeColor**; /\* Stroke color for circle.  
See [DynaPDF.RGB](DynaPDFRGB.md) function for RGB colors.e.g. 255 \*/   
**$ColorSpace**) /\* Color space of the fill and stroke colors.e.g. "RGB" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| PDF | The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). | $pdf |
| PosX | X-coordinate of the annotation | 100 |
| PosY | Y-coordinate of the annotation | 100 |
| Width | Width of the annotation | 100 |
| Height | Height of the annotation | 100 |
| LineWidth | Line width of the circle or ellipse | 2 |
| FillColor | Fill color for circle.   See [DynaPDF.RGB](DynaPDFRGB.md) function for RGB colors. | 200 |
| StrokeColor | Stroke color for circle.   See [DynaPDF.RGB](DynaPDFRGB.md) function for RGB colors. | 255 |
| ColorSpace | Color space of the fill and stroke colors. | "RGB" |

### Result

Returns annotation handle or error.

### Description

Draws a circle annotation on the current open page.   
If the parameters Width and Height are equal the function draws a circle, an ellipse otherwise. If the annotation should be drawn without a border, set the parameter LineWidth zo zero or StrokeColor to the special constant NO\_COLOR (4294967281).  
If the interior should be transparent set FillColor to the special constant NO\_COLOR (4294967281).  
Although the line width can be set to any positive floating point value, Adobe’s Acrobat or Reader restrict the line width to 0 through 12 units. The line width should be restricted in the same way to avoid issues in Adobe viewer products.  
See also [CircleAnnot](https://www.monkeybreadsoftware.com/DynaPDF-Manual/CircleAnnot.shtml) function in DynaPDF manual.

### See also

- [DynaPDF.LineAnnot](DynaPDFLineAnnot.md)
- [DynaPDF.New](DynaPDFNew.md)
- [DynaPDF.RGB](DynaPDFRGB.md)
- [DynaPDF.SquareAnnot](DynaPDFSquareAnnot.md)

### Blog Entries

- [Unlocking the Power of PDFs in FileMaker with DynaPDF and the MBS FileMaker Plugin](https://www.mbsplugins.de/archive/2024-09-16/Unlocking_the_Power_of_PDFs_in/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 28th November 2014 , last changed 31st December 2020

  
[DynaPDF.CheckFieldNames](DynaPDFCheckFieldNames.md) - [DynaPDF.Clear](DynaPDFClear.md)

[HTML Version](DynaPDFCircleAnnot.shtml)