outlinify/gerber-types-rs/README.md

1.8 KiB

Rust Gerber Library

Build status Crates.io

This crate implements the basic building blocks of Gerber X2 (compatible with Gerber RS-274X) code. It focusses on the low level types (to be used like an AST) and code generation and does not do any semantic checking.

For example, you can use an aperture without defining it. This will generate syntactically valid but semantially invalid Gerber code, but this module won't complain.

The plan is to write a high-level wrapper library on top of this. Early drafts are in progress but the design isn't fixed yet.

Current Gerber X2 spec: https://www.ucamco.com/files/downloads/file/81/the_gerber_file_format_specification.pdf

Example

You can find an example in the examples directory. It's still quite verbose, the goal is to make the API a bit more ergonomic in the future. (This library has a low-level focus though, so it will never get a high-level API. That is the task of other libraries.)

To generate Gerber code for that example:

$ cargo run --example polarities-apertures

License

Licensed under either of

at your option.