gaussian_blur_generator 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c08daccf74b7ab85e80ee4ade6521684f0ffbe2276b7a8b465578be3aad3703
-  data.tar.gz: 783e49eb582aa2bdffc954bda03ffcc4a888e290b14f89614dfdc0b216518d96
+  metadata.gz: 3a61df5d564b01d8be690766f0b9835ce2b75eb63452c817c96fc2b06b5f2215
+  data.tar.gz: 496cacd091d5cbe948f751e642dd032aab9f2f69eeb9b9413ced6dfd237c9bec
 SHA512:
-  metadata.gz: a84070cf8fcc524d4da0be924258e278e444280edfb63bf45c9efcfae1efea02d12a5e7302042305ba9368ac95b80b60ab9f0a28f00c8d9592b87a9bd245ad32
-  data.tar.gz: ded31a9a5b06cb81647411e31cdbf1a393abddd0b6892466e87c6b982891950595a51c9a095cb94524d46f30f26d78e4c848786fde21120677a96fe8e5a9884a
+  metadata.gz: 52fb1a80021f74c23d87e806d2db9cf460e809898259565721b18bfee41e05cad80ef91cedbd566c69957db98fc390c32661b1186698dfa9d85f7234c23673d7
+  data.tar.gz: 93ca7a93587e5aca0fb303240d02dc2947569f06ff63b7b3d033c3cb3a2b483af29f48ccc30f01330f6a4ad92a80bd13b65603bded2c47cb907e56c27864b19e

data/README.md

@@ -10,22 +10,27 @@ Normally, a blur shader would require N^2 texture reads for a kernel of size N.
 By splitting the shader in two (horizontal, then vertical) and applying a linear
 sampling technique, we can reduce the number of texture reads to approximately
 N, vastly improving the performance of a Gaussian blur. This can be reduced even
-further by ignoring values at the edges of kernels that virtually no difference
+further by ignoring values at the edges of kernels that hardly make a difference
 to the output image.
 
 ### What is this gem?
 
 This gem applies the technique from the article but generates many different
-shaders with different kernel sizes. It writes these shaders to files in the
+shaders with varying sample sizes. It writes these shaders to files in the
 output directory, for example:
 
 - [output/blur/x/17.frag](output/blur/x/17.frag)
-- [output/blue/y/17.frag](output/blue/y/17.frag)
+- [output/blur/y/17.frag](output/blur/y/17.frag)
+
+These shaders sample the texture image 17 times per pixel. They are equivalent
+to a Gaussian blur kernel of size 33 (2N - 1). The largest pre-compiled shader
+samples 129 times which is equivalent to a Gaussiain blur of size 257. I could
+have generated more but my laptop ran out of RAM after ~12 hours.
 
 You can run `./bin/generate` yourself by cloning the repository or use one of
 the pre-generated shaders in the [`output/blur`](output/blur) directory. These
-have generated with an epsilon value of 0.05 which roughly corresponds to the
-article, but you can set this yourself if you'd like:
+have been generated with an epsilon value of 0.05 which roughly corresponds to
+the article, but you can set this yourself if you'd like:
 
 ```sh
 $ ./bin/generate 0.07
@@ -38,7 +43,7 @@ This would set the threshold a little higher than the default 0.05.
 1. Copy the x and y fragment shaders into your project for the kernel size you want.
 2. Compile a shader program for each of the fragment shaders
 3. Set `u_texture` to the input texture you want to blur
-4. Set `u_dimensions` to the pixel size of the output: `[width, height, 1/width, 1/height]`
+4. Set `u_scaling` base on the pixel size of the output: `[1/width, 1/height, width/height, height/width]`
 5. Draw your scene to a framebuffer/texture instead of directly to the screen
 6. Apply the first shader program, then draw to the screen with the second
 

data/lib/gaussian_blur_generator/glsl.rb

@@ -28,14 +28,14 @@ class GaussianBlurGenerator
       #endif
 
       uniform sampler2D u_texture;
-      uniform vec4 u_dimensions;
+      uniform vec4 u_scaling;
 
       // Generated by https://github.com/tuzz/gaussian_blur_generator
 
       void main() {
-        vec2 coords = gl_FragCoord.xy / u_dimensions.xy;
+        vec2 coords = gl_FragCoord.xy * u_scaling.xy;
 
-        float one_pixel = u_dimensions.#{axis == "x" ? "z" : "w"};
+        float one_pixel = u_scaling.#{axis};
         #{offsets.join("\n  ")}
 
         gl_FragColor = (

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gaussian_blur_generator
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Chris Patuzzo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-03 00:00:00.000000000 Z
+date: 2020-05-12 00:00:00.000000000 Z
 dependencies: []
 description: Generates fragment shaders that apply a Gaussian blur in an efficient
   manner.