This repository has been archived on 2023-03-25. You can view files and clone it, but cannot push or open issues or pull requests.
mightyscape-1.1-deprecated/extensions/fablabchemnitz/papercraft/openjscad/node_modules/@jscad/io/README.md

74 lines
2.2 KiB
Markdown
Raw Normal View History

## io
## input output formats handling for the jscad project
[![npm version](https://badge.fury.io/js/%40jscad%2Fio.svg)](https://badge.fury.io/js/%40jscad%2Fio)
## Overview
This package is a metapackage and includes all the input/output format handling for the jscad projects, and can also be used separately.
### Inputs / deserializers
ie: file data => jscad code (that can be evaluated to CSG/CAG)
> note : currently serializers & deserializers are NOT symetrical as deserializers
do not generate CSG/CAG objects
Following formats are supported as inputs
- [AMF](https://github.com/jscad/io/blob/master/packages/amf-deserializer)
- [gcode](https://github.com/jscad/io/blob/master/packages/gcode-deserializer)
- [JSON](https://github.com/jscad/io/blob/master/packages/json-deserializer)
- [OBJ](https://github.com/jscad/io/blob/master/packages/obj-deserializer)
- [STL (binary, ASCII)](https://github.com/jscad/io/blob/master/packages/stl-deserializer)
- [SVG](https://github.com/jscad/io/blob/master/packages/svg-deserializer)
### Outputs/ serializers
ie: CSG/CAG => blob
Following formats are supported as outputs
- [AMF](https://github.com/jscad/io/blob/master/packages/amf-serializer)
- [DXF](https://github.com/jscad/io/blob/master/packages/dxf-serializer)
- [JSON](https://github.com/jscad/io/blob/master/packages/json-serializer)
- [STL (binary, ASCII)](https://github.com/jscad/io/blob/master/packages/stl-serializer)
- [SVG](https://github.com/jscad/io/blob/master/packages/svg-serializer)
- [X3D](https://github.com/jscad/io/blob/master/packages/x3d-serializer)
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Contribute](#contribute)
- [License](#license)
## Installation
```
npm install @jscad/io
```
## Usage
- as Node module :
```
const io = require('@jscad/io')
```
## Contribute
For questions about the API, please contact the [User Group](https://plus.google.com/communities/114958480887231067224)
PRs accepted.
Small Note: If editing this README, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.
## License
[The MIT License (MIT)](https://github.com/jscad/io/blob/master/LICENSE)
(unless specified otherwise)