#cad #geometry #2d #design

arcs

An extensible framework for creating 2D CAD applications using the Entity-Component-System pattern

3 releases (breaking)

0.3.0 Feb 28, 2020
0.2.0 Jan 16, 2020
0.1.0 Jan 8, 2020

#17 in #design

MIT/Apache

115KB
2.5K SLoC

A Rust CAD System

Build Status Docs.rs Badge Crates.io Crates.io

(API Docs for master/WebAssembly Demo)

An extensible framework for creating 2D CAD applications, written in Rust and based on an Entity-Component-System architecture.

If you want a high-level understanding of how this project is implemented and the way things are designed, you may want to check out A Thought Experiment: Using the ECS Pattern Outside of Game Engines.

Project Goals and Milestones

I've broken the direction of this project up into a handful of milestones, each containing a list of related features or concepts.

  • Milestone: MVP

    • Geometry primitives (Arc, Point, Line, etc.)
    • Basic styling component (e.g. LineStyle with a colour and stroke width)
    • All drawing objects are attached to a Layer
    • Drawing objects have a BoundingBox which gets recalculated whenever something changes
    • Render drawing objects on a canvas
    • Example showing all of the above and rendering a simple drawing (render_to_image.rs)
  • Milestone: Online demo

    • Render correctly to a HTML5 <canvas>
    • Interactive tools for creating drawing objects:
      • Point
      • Line
      • Arc
    • Move items between layers
    • Selectively show/hide layers
    • Viewport panning
    • Zoom Viewport in/out
  • Milestone: Required by Real-World Applications (see Michael-F-Bryan/rustmatic#38)

    • Robust undo/redo mechanism
  • Wish List

    • Z-levels so objects can be drawn on top of each other
    • Entities can be tagged with a name to give them semantic meaning
    • Approximation algorithm
    • Translation algorithm
    • Uniform scale algorithm
    • Scaling algorithm without maintaining aspect ratio
    • Calculate the length of a geometric primitive
    • B-Splines
    • Interpolated splines
    • Bézier curves
    • Elliptical sections
    • Closest point algorithm for all geometric primitives

Building the WebAssembly Demo

If you want to run the WebAssembly demo locally you'll first need a copy of the code.

$ git clone https://github.com/Michael-F-Bryan/arcs

You'll also need the wasm-pack program. We'll use this to build the demo.

$ cargo install --force wasm-pack
    Updating crates.io index
  Installing wasm-pack v0.8.1
  Downloaded cc v1.0.50
  ...
  Compiling wasm-pack v0.8.1
    Finished release [optimized] target(s) in 2m 20s
   Installed /home/michael/.cargo/bin/wasm-pack

Now we can build the demo.

$ cd arcs/demo
$ wasm-pack build --target web
[INFO]: Checking for the Wasm target...
[INFO]: Compiling to Wasm...
   Compiling arcs-demo v0.1.0 (/home/michael/Documents/arcs/demo)
    Finished release [optimized] target(s) in 8.19s
:-) [WARN]: origin crate has no README
[INFO]: Installing wasm-bindgen...
[INFO]: :-) Done in 8.37s
[INFO]: :-) Your wasm pkg is ready to publish at ./pkg.
$ ls pkg
arcs_demo.d.ts arcs_demo.js arcs_demo_bg.d.ts arcs_demo_bg.wasm
package.json README.md

Now the demo is compiled, it can be served from disk.

$ python3 -m http.server
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...
127.0.0.1 - - [10/Jan/2020 18:31:35] "GET / HTTP/1.1" 200 -
127.0.0.1 - - [10/Jan/2020 18:31:35] "GET /pkg/arcs_demo.js HTTP/1.1" 200 -
127.0.0.1 - - [10/Jan/2020 18:31:35] "GET /pkg/arcs_demo_bg.wasm HTTP/1.1" 200 -

License

This project is licensed under either of

at your option.

It is recommended to always use cargo-crev to verify the trustworthiness of each of your dependencies, including this one.

Contribution

The easiest way to start contributing is to check the issue tracker and look for an easy issue to tackle. Alternatively the wishlist contains a list of features we'd like to implement, although these may require more effort or experience.

We're always keen to help mentor contributors!

The intent of this crate is to be free of soundness bugs. The developers will do their best to avoid them, and welcome help in analyzing and fixing them.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~6MB
~116K SLoC