# Shapes

addShape(): every ShapeType, plus fills, outlines, shadows and rounded corners.

```csharp
using NetCorePpt;                  // PptxGen, Slide
using NetCorePpt.CoreInterfaces;   // option objects: TextProps* / ShapeProps / ImageProps / TableProps / HAlign / VAlign ...
using NetCorePpt.CoreEnums;        // ShapeType, ChartType, MediaType, ShadowType, BulletType, DashType, SCHEME_COLORS ...
using TableRow = System.Collections.Generic.List<NetCorePpt.CoreInterfaces.TableCell>;
```

Almost 200 shape types can be added to Slides — the values live in the `ShapeType` enum in `NetCorePpt.CoreEnums` (`ShapeType.rect`, `ShapeType.roundRect`, …).

## Usage

**PptxGenJS · typescript**

```typescript
// Shapes without text
slide.addShape(pres.ShapeType.rect, { fill: { color: "FF0000" } });
slide.addShape(pres.ShapeType.ellipse, {
  fill: { type: "solid", color: "0088CC" },
});
slide.addShape(pres.ShapeType.line, { line: { color: "FF0000", width: 1 } });

// Shapes with text
slide.addText("ShapeType.rect", {
  shape: pres.ShapeType.rect,
  fill: { color: "FF0000" },
});
slide.addText("ShapeType.ellipse", {
  shape: pres.ShapeType.ellipse,
  fill: { color: "FF0000" },
});
slide.addText("ShapeType.line", {
  shape: pres.ShapeType.line,
  line: { color: "FF0000", width: 1, dashType: "lgDash" },
});
```

**NetCorePpt · C#**

```csharp
// Shape names are the same - `pres.ShapeType.rect` becomes `ShapeType.rect`
// (or `pptx.shapeType.rect` if you prefer the instance form).

// Shapes without text
slide.addShape(ShapeType.rect, new ShapeProps { fill = new ShapeFillProps { color = "FF0000" } });
slide.addShape(ShapeType.ellipse, new ShapeProps { fill = new ShapeFillProps { type = ShapeFillType.solid, color = "0088CC" } });
slide.addShape(ShapeType.line, new ShapeProps { line = new ShapeLineProps { color = "FF0000", width = 1 } });

// Shapes with text
slide.addText("ShapeType.rect", new TextPropsOptions { shape = ShapeType.rect, fill = new ShapeFillProps { color = "FF0000" } });
slide.addText("ShapeType.ellipse", new TextPropsOptions { shape = ShapeType.ellipse, fill = new ShapeFillProps { color = "FF0000" } });
slide.addText("ShapeType.line", new TextPropsOptions
{
    shape = ShapeType.line,
    line = new ShapeLineProps { color = "FF0000", width = 1, dashType = DashType.lgDash },
});
```

## Properties

### Position/Size Props ( PositionProps )

| Name | Type | Default | Description | Possible Values |
| --- | --- | --- | --- | --- |
| `x` | number | `1.0` | hor location (inches) | 0-n |
| `x` | string |  | hor location (percent) | 'n%'. (Ex: `{x:'50%'}` middle of the Slide) |
| `y` | number | `1.0` | ver location (inches) | 0-n |
| `y` | string |  | ver location (percent) | 'n%'. (Ex: `{y:'50%'}` middle of the Slide) |
| `w` | number | `1.0` | width (inches) | 0-n |
| `w` | string |  | width (percent) | 'n%'. (Ex: `{w:'50%'}` 50% the Slide width) |
| `h` | number | `1.0` | height (inches) | 0-n |
| `h` | string |  | height (percent) | 'n%'. (Ex: `{h:'50%'}` 50% the Slide height) |

### Shape Props ( ShapeProps )

| Name | Type | Description | Possible Values |
| --- | --- | --- | --- |
| `align` | string | alignment | `left` or `center` or `right`. Default: `left` |
| `fill` | [ShapeFillProps](types.md#fill-props-shapefillprops) | fill props | Fill color/transparency props |
| `flipH` | boolean | flip Horizontal | `true` or `false` |
| `flipV` | boolean | flip Vertical | `true` or `false` |
| `hyperlink` | [HyperlinkProps](types.md#hyperlink-props-hyperlinkprops) | hyperlink props | (see type link) |
| `line` | [ShapeLineProps](types.md#shape-line-props-shapelineprops) | border line props | (see type link) |
| `rectRadius` | number | rounding radius | 0 to 1. (Ex: 0.5. Only for `pptx.shapes.ROUNDED_RECTANGLE`) |
| `rotate` | number | rotation (degrees) | -360 to 360. Default: `0` |
| `shadow` | [ShadowProps](types.md#shadow-props-shadowprops) | shadow props | (see type link) |
| objectName | string | optional shape name | Ex: "Customer Network Diagram 99" |

## Examples

![Shapes with Text Demo](../assets/images/ex-shape-slide-da6d30f411b3140efc58bef6b275c2b5.png)

## Samples

Runnable C# samples: see the [Usage Examples](/examples_docs/) section of this site.