# FThreeDChartBuilder

- Human documentation: [https://docs.univer.ai/reference/facade/three-d-chart-builder](https://docs.univer.ai/reference/facade/three-d-chart-builder)

- Agent Markdown: [https://docs.univer.ai/reference/facade/three-d-chart-builder.md](https://docs.univer.ai/reference/facade/three-d-chart-builder.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.1.0`

- Source: [facade/three-d-chart-builder.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/facade/three-d-chart-builder.mdx)

---

Authored 3D configuration; clear preserves the chart dimension and independent depth axis.

## Inheritance

Extends [`FChartBuilderBase`](https://docs.univer.ai/reference/facade/chart-builder-base.md). Its inherited members are available on this object.

## Setup

Register [`@univerjs-pro/engine-chart`](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/engine-chart.md) or a preset that includes it. In plugin mode, import `@univerjs-pro/engine-chart/facade`. Additional methods below require their listed plugin packages. See [Facade setup](https://docs.univer.ai/guides/sheets/getting-started/facade.md).

## `@univerjs-pro/engine-chart`

### `FThreeDChartBuilder.clearThreeD`

Clears the authored 3D settings without changing the chart type or depth axis.

```typescript
clearThreeD(): this
```

**Returns**

This builder for chaining.

**Examples**

```ts
builder.clearThreeD()
```

**Package:** [`@univerjs-pro/engine-chart`](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/engine-chart.md) · [Type definitions](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/facade/f-three-d-chart-builder.d.ts)

### `FThreeDChartBuilder.setThreeD`

Sets the authored 3D view and layout options.
For axis-based charts, set `rightAngleAxes` to `false` to apply `perspective`.

```typescript
setThreeD(value: DeepNullish<IChart3DStyle>): this
```

**Parameters**

* `value` — Required. The 3D view and layout options.

**Returns**

This builder for chaining.

**Examples**

```ts
builder.setThreeD({
  view: { rotX: 15, rotY: 20, rightAngleAxes: false, perspective: 30 },
  gapDepth: 150,
})
```

**Types:** [`DeepNullish`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/types.d.ts) · [`IChart3DStyle`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/types.d.ts)

**Package:** [`@univerjs-pro/engine-chart`](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/engine-chart.md) · [Type definitions](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/facade/f-three-d-chart-builder.d.ts)