# createEllipsePath

```ts
import { createEllipsePath, Path } from "@pibbl/core";
```

[`EllipsePathOptions`](/reference/types/elements-components/#ellipsepathoptions) is accepted by `createEllipsePath(options): Path2D`, which creates a fresh path
from nonnegative numeric radii, optional center, and finite radian rotation.
It is pure and has no render lifecycle.

```tsx
<Path
  style={{
    d: createEllipsePath({ radiusX: 64, radiusY: 30, rotation: 0.4 }),
    fill: "#38bdf8",
  }}
/>
```

See the [Ellipse live example](/playground/#/examples/drawing/ellipse).

## API details from source

<span id="api-createEllipsePath"></span>

Creates a Canvas Path2D for ellipse geometry from validated options.

```ts
createEllipsePath: (options: Readonly<EllipsePathOptions>) => Path2D
```

Related API: [createEllipsePath](/reference/functions/create-ellipse-path/), [EllipsePathOptions](/reference/types/elements-components/#ellipsepathoptions).

### Parameters

- **`options`** — Ellipse center, radii, and rotation. See [EllipsePathOptions](/reference/types/elements-components/#ellipsepathoptions).

### Returns

A native Canvas path containing the ellipse.

### See also

[EllipsePathOptions](/reference/types/elements-components/#ellipsepathoptions)

[View source — packages/core/src/lib/geometry/ellipse.ts:29](/source/packages/core/src/lib/geometry/ellipse-ts/#L29)

## Implementation guidance for agents

Read the [Drawing, layout, and effects companion](/agents/topics/layout/) for ownership, adaptation, failure modes, and verification. [Agent start](/agents/) provides the version-selection workflow.

## Complete minimal examples

- [Circular path factories](/minimal-examples/paths/circular-factories/): Create circle, ellipse, arc, and wedge Path2D shapes. [Plain source](/minimal/paths/circular-factories.ts)
## Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.