Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ianthehenry/bauble
a playground for making 3D art with lisp and math
https://github.com/ianthehenry/bauble
3d 3d-graphics art glsl graphics janet janet-lang lisp playground procedural-generation sdf sdfs shaders signed-distance-field signed-distance-functions wasm webassembly webgl
Last synced: about 1 month ago
JSON representation
a playground for making 3D art with lisp and math
- Host: GitHub
- URL: https://github.com/ianthehenry/bauble
- Owner: ianthehenry
- License: mit
- Created: 2022-07-30T05:49:10.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-13T23:14:38.000Z (about 1 month ago)
- Last Synced: 2024-08-14T01:48:22.935Z (about 1 month ago)
- Topics: 3d, 3d-graphics, art, glsl, graphics, janet, janet-lang, lisp, playground, procedural-generation, sdf, sdfs, shaders, signed-distance-field, signed-distance-functions, wasm, webassembly, webgl
- Language: Janet
- Homepage: https://bauble.studio
- Size: 2.37 MB
- Stars: 353
- Watchers: 6
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-repos - ianthehenry/bauble - a playground for making 3D art with lisp and math (Janet)
README
# [Bauble](https://bauble.studio)
Bauble is a toy for composing signed distance functions in a high-level language ([Janet](https://janet-lang.org/)), compiling them to [GLSL](https://www.khronos.org/opengl/wiki/OpenGL_Shading_Language), and rendering them via WebGL.
Bauble is still in its early days, but it's progressed to the point that you can do some pretty neat stuff with it. Try it out at , or watch this video introduction where I model an infinite number of hot air balloons:
[](https://www.youtube.com/watch?v=0-OtdjiR7dc&list=PLjT5GDnW_UMBS6ih0kG7jWB0n1SnotnEu)
For more examples, I sometimes tweet videos of Bauble's development:
- [bounding surfaces](https://twitter.com/ianthehenry/status/1567709580792315904)
- [instanced repetition](https://twitter.com/ianthehenry/status/1566583962989842432)
- [animation](https://twitter.com/ianthehenry/status/1566081717592502274)
- [procedural distortion](https://twitter.com/ianthehenry/status/1565575515016085504)
- [non-rigid deformations](https://twitter.com/ianthehenry/status/1559778903324954624)
- [announcement](https://twitter.com/ianthehenry/status/1559049547099254785)
- [surfaces](https://twitter.com/ianthehenry/status/1557881955156275200)
- [shapes](https://twitter.com/ianthehenry/status/1554729639183937536)
- [first ever demo](https://twitter.com/ianthehenry/status/1551422839307190272)
# Dependencies
Bauble requires at least Janet 1.29.1. It may work with newer versions of Janet, assuming that the image format is compatible, but it's better to [update the version of Janet that Bauble includes](build/janet/janet-version) to match your local version.
- [`emscripten`](https://emscripten.org/)
- [`redo`](https://github.com/apenwarr/redo)
- [`yarn`](https://yarnpkg.com/)
Afterwards, install JavaScript dependencies with:
```
$ yarn
$ (cd studio && yarn)
```
`bauble` is being developed alongside [`codemirror-lang-janet`](https://github.com/ianthehenry/codemirror-lang-janet). If you want to make changes to the grammar, clone that repo and run [`yalc publish`](https://github.com/wclr/yalc) from the root of it. Then run `yalc link codemirror-lang-janet` in this repository, and you'll be able to see your changes locally.
# Development
To build Bauble, all you have to do is run:
```
$ redo
```
To create a minified, optimized build, use:
```
$ BUILD_MODE=prod redo
```
Lint the JS with:
```
(cd studio/; yarn eslint .)
```
You can serve a local Bauble like this:
```
$ node_modules/.bin/alive-server public
```
# Known bugs
- [ ] Bauble will cast and calculate lights even for shaders that don't need lights, making it slower than it needs to be in the default RGB-normal shading view.