https://github.com/ruby-processing/filters4ruby-processing
Translation of Filters4Processing to ruby-processing
https://github.com/ruby-processing/filters4ruby-processing
Last synced: 8 months ago
JSON representation
Translation of Filters4Processing to ruby-processing
- Host: GitHub
- URL: https://github.com/ruby-processing/filters4ruby-processing
- Owner: ruby-processing
- License: other
- Created: 2015-05-28T21:36:33.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-08-17T13:55:16.000Z (over 8 years ago)
- Last Synced: 2025-02-17T12:45:41.187Z (11 months ago)
- Language: GLSL
- Homepage: https://github.com/ruby-processing/filters4ruby-processing/wiki
- Size: 1.64 MB
- Stars: 3
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
filters4ruby-processing
==================
A port of [Filters4Processing][] to ruby-processing
A growing collection of pixel shaders ported to Processing to be used with the `filter()` function. Most of these shaders come from the excellent [Shadertoy](https://www.shadertoy.com) by Iñigo Quilez.
### To run / watch shader sketches
NB: since ruby-processing-2.6.11 glsl files are also _watched_, so you can edit the shader of the sketch running in
watch mode, and it will automatically reload when you save your changes...
```bash
# autorun all sketches
cd filters4ruby-processing
rake # assume rake and processing and ruby-processing installed
```
Run / Watch individual sketches as follows
```bash
rp5 --nojruby run/watch sketch.rb # Need to use jruby-complete
```
to avoid need for `--nojruby` flag in `.rp5rc` add following (if pure yaml)
```yaml
JRUBY: 'false'
```
or if you used our configRP5.pde tool (emits json)
```json
{
"JRUBY": "false",
....
}
```
NB: delete line, or change back to 'true' when you need to use gems....
This is a java/jruby permission thing, and beyond our control
## Filters
### Barrel Blur Chroma
### Barrel & Pincushion
### Bicubic Filter
### Bilateral Filter (denoise)
### Contrast, Saturation, Brightness
### Dithering
### Edge filter
## Usage
This is a minimal example showing how to import shader file in ruby-processing and use it as a filter.
*Note: Some shaders require additional uniforms. For details, refer to the example sketches included.*
```ruby
attr_reader :my_filter, :my_image
def setup
size(512, 512, P2D)
# import an image object
@my_image = load_image('texture.jpg')
# load a shader object
@my_filter = load_shader('shader.glsl')
# pass the window size to the shader
my_filter.set('sketchSize', width.to_f, height.to_f)
end
def draw
background(0)
# Draw the image on the scene
image(my_image, 0, 0)
# Applies the shader to everything that has already been drawn
return if mouse_pressed?
filter(my_filter)
end
```
## Notes about porting filters from Shadertoy
Shadertoy and Processing both have their own quirks when it comes to shader programming. We need to make some changes in order to make Shadertoy code work with Processing/ruby-processing. See [wiki](https://github.com/ruby-processing/filters4ruby-processing/wiki/Translating-shaders-for-processing) which you are welcome to edit if you know better
Now go dig for some [shaders](https://www.shadertoy.com/results?query=filter) and help us extend the library of filters available for Processing/ruby-processing!
*Note: It is possible to port other types of shaders, but this repository focuses on filters.*
## Acknowledgments
Port to processing by Raphaël de Courville.
Thanks to all the Shadertoy contributors for their hard work. This collection wouldn't exist without them. Thanks to Andrés Colubri for his work on the Processing Shader API.
## License
All shaders from Shadertoy belong to there respective authors. Unless otherwise specified in the shader file, they are licensed under Creative Commons ([CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/deed.en_US))
## Tools
[Syntax highlighting for glsl in vim](https://github.com/beyondmarc/glsl.vim)
[Filters4Processing]:https://github.com/SableRaf/Filters4Processing