com.krab.lazy

Class ShaderReloader

java.lang.Object

com.krab.lazy.ShaderReloader

public class ShaderReloader
extends java.lang.Object

Utility class for live-coding shaders Takes a string path to the shader and re-compiles it when needed using the shader file's last modified time. Saving the shader file in your text editor is needed to actually recompile it and display the results.

Method Summary

Modifier and Type	Method and Description
static void	filter(java.lang.String fragPath) Re-compiles the shader if needed and then applies it as a processing filter() on the main canvas.
static void	filter(java.lang.String fragPath, processing.core.PGraphics pg) Re-compiles the shader if needed and then applies it as a processing filter() on the parameter canvas.
static void	filter(java.lang.String fragPath, java.lang.String vertPath, processing.core.PGraphics pg) Re-compiles the shader if needed and then applies it as a processing filter() on the parameter canvas.
static processing.opengl.PShader	getShader(java.lang.String fragPath) Gets the current snapshot of a vertex + fragment shader for uniform setting purposes.
static processing.opengl.PShader	getShader(java.lang.String fragPath, java.lang.String vertPath) Gets the current snapshot of a vertex + fragment shader for uniform setting purposes.
static void	setApplet(processing.core.PApplet applet) Sets the PApplet reference for the ShaderReloader to use when compiling a shader.
static void	shader(java.lang.String fragPath) Re-compiles the shader if needed and then applies it as a processing shader() on the main canvas.
static void	shader(java.lang.String fragPath, processing.core.PGraphics pg) Re-compiles the shader if needed and then applies it as a processing shader() on the parameter canvas.
static void	shader(java.lang.String fragPath, java.lang.String vertPath) Re-compiles the shader if needed and then applies it as a processing shader() on the main canvas.
static void	shader(java.lang.String fragPath, java.lang.String vertPath, processing.core.PGraphics pg) Re-compiles the shader if needed and then applies it as a processing shader() on the parameter canvas.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setApplet

public static void setApplet(processing.core.PApplet applet)

Sets the PApplet reference for the ShaderReloader to use when compiling a shader. Meant to be used in setup() like this: `ShaderReloader.setApplet(this);` Calling this function is not needed if you initialize LazyGui first, since `new LazyGui(this)` also sets the PApplet for the purposes of ShaderReloader.

Parameters:

applet - the PApplet instance to use

getShader

public static processing.opengl.PShader getShader(java.lang.String fragPath)

Gets the current snapshot of a vertex + fragment shader for uniform setting purposes. Only attempts to compile the first time it's called during lazy initialization, then it relies on the user calling ShaderReloader.filter() or ShaderReloader.shader() to attempt to re-compile.

Parameters:

fragPath - path to the shader, either absolute or relative from the data folder

Returns:

PShader to set uniforms on

getShader

public static processing.opengl.PShader getShader(java.lang.String fragPath,
                                                  java.lang.String vertPath)

Gets the current snapshot of a vertex + fragment shader for uniform setting purposes. Only attempts to compile at lazy initialization time, it relies on the user calling ShaderReloader.filter() or ShaderReloader.shader() to attempt to re-compile.

Parameters:

fragPath - path to the fragment shader, either absolute or relative from the data folder

vertPath - path to the vertex shader, either absolute or relative from the data folder

Returns:

PShader to set uniforms on

filter

public static void filter(java.lang.String fragPath)

Re-compiles the shader if needed and then applies it as a processing filter() on the main canvas.

Parameters:

fragPath - path to fragment shader

filter

public static void filter(java.lang.String fragPath,
                          processing.core.PGraphics pg)

Re-compiles the shader if needed and then applies it as a processing filter() on the parameter canvas.

Parameters:

fragPath - path to fragment shader

pg - canvas to apply the filter on

filter

public static void filter(java.lang.String fragPath,
                          java.lang.String vertPath,
                          processing.core.PGraphics pg)

Re-compiles the shader if needed and then applies it as a processing filter() on the parameter canvas.

Parameters:

fragPath - path to fragment shader

vertPath - path to fragment shader

pg - canvas to apply the filter on

shader

public static void shader(java.lang.String fragPath)

Re-compiles the shader if needed and then applies it as a processing shader() on the main canvas.

Parameters:

fragPath - path to fragment shader

shader

public static void shader(java.lang.String fragPath,
                          java.lang.String vertPath)

Re-compiles the shader if needed and then applies it as a processing shader() on the main canvas.

Parameters:

fragPath - path to fragment shader

vertPath - path to vertex shader

shader

public static void shader(java.lang.String fragPath,
                          processing.core.PGraphics pg)

Re-compiles the shader if needed and then applies it as a processing shader() on the parameter canvas.

Parameters:

fragPath - path to fragment shader

pg - canvas to apply the shader on

shader

public static void shader(java.lang.String fragPath,
                          java.lang.String vertPath,
                          processing.core.PGraphics pg)

Re-compiles the shader if needed and then applies it as a processing shader() on the parameter canvas.

Parameters:

fragPath - path to fragment shader

vertPath - path to fragment shader

pg - canvas to apply the shader on