# Circle

A Circle object is a convenience object representing a special Surface object. The "Surface" object is used for polygons, while the "Circle" object creates circular surfaces.

**Example Syntax:**

```
...
<O T="Circle">
...
...
</O>
```

**Example:**

* Segmenting the Circle object into multiple parts.
* Assigning a 2nd radius to the Circle object to form an ellipse.
* Creating circle object as much as the defined anlge is covered
* Creating a 3D object by assigning thickness to the Circle object.
* Subtracting the volume of the cylinder created using T="Circle" object from a rectangular prism.

```xml
<O N="CircleObject1" T="Project" Category="3D Geometric Objects" TransAlignRule="Right">
 <!-- created by ParamML Examples on 01.02.2023 -->
 <O N="Ci1" T="Circle" Radius="20" Y="50" Segments="10" />
 <O N="Ci2" T="Circle" Radius="20" Y="100" Radius2="10" />
 <O N="Ci3" T="Circle" Radius="20" Y="150" StartAngle="0" EndAngle="11*PI/6" />
 <O N="Ci4" T="Circle" Radius="20" Y="200" Thickness="30" />
 <O N="CutoutEx" T="Surface" Thickness="15">
 <O T="Point" X="-20" Y="-20" />
 <O T="Point" X="-20" Y="20" />
 <O T="Point" X="20" Y="20" />
 <O T="Point" X="20" Y="-20" />
 <O N="CutoutCi5" T="Circle" Radius="10" IsCutout="Yes" />
 </O>
</O>
```

![](https://openbrim.atlassian.net/wiki/download/attachments/2158034997/image-20230201-110710.png?api=v2) To view this example in the library, see (<https://openbrim.org/platform/?application=inc&author=ParamML_Examples_OpenBrIM+Platform&obj=objidqiw5pkz9z35n2csh2lhea>)

**Parameters of Circle Object:**

| # | Label       | Mandatory | Name and Type Attributes | Default Description and Value Attributes                             | Other Attributes                       |
| - | ----------- | --------- | ------------------------ | -------------------------------------------------------------------- | -------------------------------------- |
| 1 | Radius      | Yes       | N="Radius"               | D="Radius: The radius of the circle." V="5"                          | Role="Input" UT="Length" UC="Section"  |
| 2 | Radius2     | Yes       | N="Radius2"              | D="Radius: The second radius along Y axis for ellipse." V="5"        | Role="Input" UT="Length" UC="Section"  |
| 3 | Start Angle | No        | N="StartAngle"           | D="Start Angle: the start angle for semi-circle." V="0"              | Role="Input" UT="Angle" UC="Section"   |
| 4 | End Angle   | No        | N="EndAngle"             | D="End Angle: the end angle for semi-circle." V="PI\*2"              | Role="Input" UT="Angle" UC="Section"   |
| 5 | Segments    | No        | N="Segments"             | D="Segments: Number of segments used to draw the object." V="36"     | Role="Input" UT="None" UC="Coordinate" |
| 6 | Thickness   | No        | N="Thickness"            | D="Thickness: The thickness of the circle. (optional)" V="2"         | Role="Input" UT="Length" UC="Section"  |
| 7 | Cutout      | No        | N="IsCutout"             | D="Cutout: Does this circle represent a cutout? \[Yes=1/No=0]" V="0" | Role="Input"                           |