# @jscad/x3d-serializer

> X3D Serializer for JSCAD

Latest version **2.4.13** (published 2026-02-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @jscad/x3d-serializer
pnpm add @jscad/x3d-serializer
yarn add @jscad/x3d-serializer
bun add @jscad/x3d-serializer
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 2.4.13 |
| Published | 2026-02-22 |
| First published | 2017-05-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 36.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3242 |
| Maintainers | z3dev, mister-jscad, simon_clark, platypii |
| Keywords | openjscad, jscad, export, serializer, x3d |

## Links

- npm: https://www.npmjs.com/package/@jscad/x3d-serializer
- Repository: https://github.com/jscad/OpenJSCAD.org
- Homepage: https://openjscad.xyz/
- Issues: https://github.com/jscad/OpenJSCAD.org/issues
- npm.io page: https://npm.io/package/@jscad/x3d-serializer

## Dependencies (3)

- [onml](https://npm.io/package/onml.md) 1.3.0
- [@jscad/modeling](https://npm.io/package/@jscad/modeling.md) 2.13.0
- [@jscad/array-utils](https://npm.io/package/@jscad/array-utils.md) 2.1.4

## Recent versions

- 2.4.13 (latest) — 2026-02-22
- 3.0.7-alpha.0 (alpha) — 2026-08-02
- 1.0.0-alpha.f58d6f4e (pre-V2) — 2018-11-25
- 3.0.6-alpha.0 — 2026-06-28
- 3.0.5-alpha.0 — 2026-05-16
- 3.0.4-alpha.0 — 2026-04-12
- 2.4.12 — 2026-02-11
- 3.0.3-alpha.0 — 2026-01-18
- 2.4.11 — 2025-09-20
- 3.0.2-alpha.0 — 2025-09-06
- 3.0.1-alpha.0 — 2025-01-03
- 2.4.10 — 2024-12-29
- 2.4.9 — 2024-11-10
- 2.4.8 — 2024-10-06
- 2.4.7 — 2024-06-02
- … 49 more at https://npm.io/package/@jscad/x3d-serializer/versions

## README

# @jscad/x3d-serializer

> Serializer of JSCAD geometries to X3D shapes

[![NPM version](https://badge.fury.io/js/%40jscad%2Fx3d-serializer.svg)](https://www.npmjs.com/package/@jscad/x3d-serializer)
[![NPM downloads](https://img.shields.io/npm/dw/@jscad/x3d-serializer)](https://www.npmjs.com/package/@jscad/x3d-serializer)
[![Build Status](https://travis-ci.org/jscad/OpenJSCAD.org.svg?branch=master)](https://travis-ci.org/jscad/OpenJSCAD.org)
[![Stability](https://img.shields.io/badge/stability-stable-success)](https://github.com/emersion/stability-badges#stable)
[![License](https://img.shields.io/github/license/jscad/OpenJSCAD.org)](https://github.com/jscad/OpenJSCAD.org/blob/master/LICENSE)

[![User Group](https://img.shields.io/badge/maintained%20by-user%20group-blue)](https://openjscad.nodebb.com/)
[![Lerna](https://img.shields.io/badge/maintained%20with-lerna-blue)](https://lerna.js.org/)
[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-blue)](https://standardjs.com)

[![Backers](https://img.shields.io/opencollective/backers/openjscad)](https://opencollective.com/openjscad)
[![Sponsors](https://img.shields.io/opencollective/sponsors/openjscad)](https://opencollective.com/openjscad)

<a href="https://opencollective.com/openjscad"><img src="https://opencollective.com/openjscad/donate/button.png?color=blue" alt="Open Collective"></a>

## Overview

This serializer outputs a 'blobable' array of data from one or more JSCAD geometries.
The array of data can either be used to create a Blob (`new Blob(blobable)`), or converted to a Node.js buffer.

The serialization of the following geometries are possible.
- serialization of 3D geometries (geom3) to X3D IndexedTriangleSet (a unique mesh containing coordinates)
- serialization of 2D geometries (geom2) to X3D Polyline2D
- serialization of 2D paths (path2) to X3D Polyline2D

The id attribute is used as the DEF name for the generated X3D shape when found on a geometry.  
Material (color) is added to X3D shapes when found on a geometry.

All shapes are wrapped in a rotation transform to align the positive Z direction of JSCAD with the vertical up direction in X3D.

## Table of Contents

- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)

## Installation

```
npm install @jscad/x3d-serializer
```

## Usage

```javascript
const x3dSerializer = require('@jscad/x3d-serializer')

const rawData = x3dSerializer.serialize({unit: 'inch'}, geometry)

//in browser (with browserify etc)
const blob = new Blob(rawData)

```

## Contributing

The various JSCAD packages and all source code are part of the JSCAD Organization, and maintained by a group of volunteers.
We welcome and encourage anyone to pitch in but please take a moment to read the following guidelines.

* If you want to submit a bug report please make sure to follow the [Reporting Issues](https://github.com/jscad/OpenJSCAD.org/wiki/Reporting-Issues) guide. Bug reports are accepted as [Issues](https://github.com/jscad/OpenJSCAD.org/issues/) via GitHub.

* If you want to submit a change or a patch, please read the [Contributing Guide](../../CONTRIBUTING.md). New contributions are accepted as [Pull Requests](https://github.com/jscad/OpenJSCAD.org/pulls/) via GitHub.

* We only accept bug reports and pull requests on **GitHub**.

* If you have a question about how to use JSCAD, then please start a conversation at the [JSCAD User Group](https://openjscad.xyz/forum.html). You might find the answer in the [JSCAD User Guide](https://openjscad.xyz/guide.html).

* If you have a change or new feature in mind, please start a conversation with the [Core Developers](https://openjscad.xyz/forum.html) and start contributing changes.

Small Note: If editing this README, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.

## License

[The MIT License (MIT)](../../LICENSE)
(unless specified otherwise)

---
_Source: https://npm.io/package/@jscad/x3d-serializer · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._