# FAxisThreeDChartBuilder

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

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

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.1.0`

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

---

Axis-based 3D charts expose primary axes and series styling, without secondary axes or trendlines.

## Inheritance

Extends [`FThreeDChartBuilder`](https://docs.univer.ai/reference/facade/three-d-chart-builder.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`

### `FAxisThreeDChartBuilder.clearAllSeriesOverrides`

```typescript
clearAllSeriesOverrides(): this
```

**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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.clearAllSeriesStyle`

```typescript
clearAllSeriesStyle(): this
```

**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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.clearDepthAxis`

Clears the depth-axis configuration without removing the 3D chart view.

```typescript
clearDepthAxis(): this
```

**Returns**

This builder for chaining.

**Examples**

```ts
builder.clearDepthAxis()
```

**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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.clearSeries`

```typescript
clearSeries(selector: ChartPublicSeriesSelector): this
```

**Parameters**

* `selector` — Required.

**Types:** [`ChartPublicSeriesSelector`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/configuration/cartesian-series.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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.clearXAxis`

```typescript
clearXAxis(target?: ChartAxisTarget): this
```

**Parameters**

* `target` — Optional.

**Types:** [`ChartAxisTarget`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/configuration/axes.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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.clearYAxis`

```typescript
clearYAxis(target?: ChartAxisTarget): this
```

**Parameters**

* `target` — Optional.

**Types:** [`ChartAxisTarget`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/configuration/axes.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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.setAllSeriesStyle`

```typescript
setAllSeriesStyle(value: DeepNullish<Pick<IChartSeriesStyleSpec, 'color' | 'fillOpacity' | 'border' | 'label'>>): this
```

**Parameters**

* `value` — Required.

**Types:** [`DeepNullish`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/types.d.ts) · [`Pick`](https://unpkg.com/@typescript/typescript-darwin-arm64/lib/lib.es5.d.ts) · [`IChartSeriesStyleSpec`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/chart-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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.setDepthAxis`

Sets the categorical series-depth axis style; it has no numeric min, max, or format.

```typescript
setDepthAxis(value: DeepNullish<IChartDepthAxisSpec>): this
```

**Parameters**

* `value` — Required. The depth-axis title, direction, line, tick, label, or grid-line style.

**Returns**

This builder for chaining.

**Examples**

```ts
builder.setDepthAxis({ title: 'Region', label: { visible: true } })
```

**Types:** [`DeepNullish`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/types.d.ts) · [`IChartDepthAxisSpec`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/chart-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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.setSeries`

```typescript
setSeries(selector: ChartPublicSeriesSelector, value: DeepNullish<Pick<IChartSeriesPatch, 'color' | 'fillOpacity' | 'border' | 'label'> & { dataPoints?: Record<number, Pick<IChartSeriesDataPointStyleSpec, 'color' | 'fillOpacity'>>; }>): this
```

**Parameters**

* `selector` — Required.
* `value` — Required.

**Types:** [`ChartPublicSeriesSelector`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/configuration/cartesian-series.d.ts) · [`DeepNullish`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/types.d.ts) · [`Pick`](https://unpkg.com/@typescript/typescript-darwin-arm64/lib/lib.es5.d.ts) · [`IChartSeriesPatch`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/chart-types.d.ts) · [`Record`](https://unpkg.com/@typescript/typescript-darwin-arm64/lib/lib.es5.d.ts) · [`IChartSeriesDataPointStyleSpec`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/chart-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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.setXAxis`

```typescript
setXAxis(value: IChartAxisSpec): this
```

**Parameters**

* `value` — Required.

**Types:** [`IChartAxisSpec`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/chart-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-axis-three-d-chart-builder.d.ts)

### `FAxisThreeDChartBuilder.setYAxis`

```typescript
setYAxis(value: IChartAxisSpec): this
```

**Parameters**

* `value` — Required.

**Types:** [`IChartAxisSpec`](https://unpkg.com/@univerjs-pro/engine-chart/lib/types/chart-builder/chart-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-axis-three-d-chart-builder.d.ts)