Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ericyd/generative-art

Generative art made with Kotlin, Rust, Processing, and Shaders
https://github.com/ericyd/generative-art

Last synced: 22 days ago
JSON representation

Generative art made with Kotlin, Rust, Processing, and Shaders

Awesome Lists containing this project

README 

        
# Generative Art

Built with [Nannou][], [Processing][], and [OpenRNDR][]



## Where can I see the finished products without running the code?



Please see [my personal site](https://ericyd.github.io/generative-art) or [my instagram](https://www.instagram.com/ericydauenhauer/)



## Broken links? 😱



Did you follow a link from Instagram or elsewhere and get a 404???



**TLDR**: replace `master` or `main` in the URL with `5f072452563a05ea9fa4e895336504654df5f971` and it should work.



**Not too long, did read**: Originally I was planning to only write code using [Nannou][].



Then I wanted to explore shaders and didn't like how low-level I had to get with Nannou. So I explored [Processing][] (the classic). It's aight, but something about it didn't sing to me. I wanted something else. Also, I like Kotlin and when I learned about [OpenRNDR][] it seemed like a cool framework to explore.



I always wanted a single repo for my art, not spread out by language or framework. I had to reorganize code that was once very distinctly a [Rust][]-only project into a format that could logically support multiple frameworks and languages. Obviously this is a weird way to structure a repo, but for creative coding purposes I think it's suitable. So now I have art separated by framework. Any files at the top level are there because they have to be (I'm looking at you [Gradle][] 🙄), but the actual art code is nested. The downside of this was effectively a "breaking change" to the organization of the repo, and many links attached to my [Instagram][] posts will not work. Questions or comments? Reach out with an issue in this repo or on my [Instagram][]!



## OpenRNDR (Kotlin) sketches ([/openrndr](./openrndr))



OpenRNDR is my favorite generative art framework. But, I know nothing about JVM development.

If this repo gets messed up, best bet is to copy the [openrndr-template](https://github.com/openrndr/openrndr-template) and just start fresh.

I don't know anything about Gradle and I don't want to.



The only way this will work is if you download IntelliJ Community Edition (or Ultimate if you're fancy) and let it do all the work for you.

I have no idea what commands to run to set up the repo manually, nor do I care to find out.



### Running a sketch



As recommended by the [OpenRNDR][] project, IntelliJ CE makes it much easier. I mean, heck, they built Kotlin so why wouldn't they have first-class Kotlin support?? If you're using IntelliJ, you can run any sketch with the "Run" icon next to the `main()` function in the sketch.



## Nannou (Rust) sketches ([/nannou](./nannou))



Since these are all sketches made with [Nannou][], it is much more convenient to structure them around "examples" rather than creating individual repos, submodules, or directories for each one. Also, it ensures that they all work with the same dependencies, which would be nice for any future lookers.



### Running a sketch



```

cd nannou

cargo run --release --example name_of_example

```



Where `name_of_example` corresponds to the filename (minus the `.rs` extension) of the example you want to run.



**Notes**

* the `--release` flag is technically optional, but it is _soooooooo_ much faster with it that you'll definitely want to use it by default.

* any examples prepended with "xp_" are intended as "exploratory" sketches - not intended as final output

* If any examples look hella weird, try reseting to nannou 0.13.1 and see if it works better



```bash

git reset c6f0676ddb8bf3fad3b087eb32059cd607edeb2e

```



### Formatting



I ❤️ auto-formatting (also props to [rustfmt][], it is such a great and fast formatter)



```bash

cargo fmt

```



## Processing sketches ([/processing](./processing))



Originally I was planning on only using Rust. Then I realized I was interested in learning to use shaders. It turns out, Rust + Shaders = Nightmare. Yes, it's very much possible but holy crap it's a lot of work for not a lot of gain. Conversely, there are a billion tools out there that make shaders easy to use and Processing is a great candidate.



### Running a sketch



I personally like the Processing CLI because I dislike the Processing editor, so I run my sketches with



```

processing-java --sketch=`pwd`/processing/sketch_name --run

```



## "Homegrow SVG"



I started writing a simple SVG lib called [SalamiVG](https://github.com/ericyd/salamivg) and I'm using it to make some art. It's been really fun!



In order to run these sketches, you need to clone SalamiVG locally and `npm link` it:



```shell

# clone this repo

git clone [email protected]:ericyd/generative-art

# clone salamivg as a sibling

git clone [email protected]:ericyd/salamivg

cd salamivg

npm i

npm link

cd ../generative-art

npm i

# I don't think this next line is necessary...

npm link @salamivg/core

```



[Nannou]: https://nannou.cc/

[Processing]: https://processing.org/

[OpenRNDR]: https://openrndr.org/

[Instagram]: https://www.instagram.com/ericydauenhauer/

[Gradle]: https://www.baeldung.com/gradle

[Rust]: https://www.rust-lang.org/

[rustfmt]: https://github.com/rust-lang/rustfmt