sleexyz / hylogen Goto Github PK

View Code? Open in Web Editor NEW

481.0 29.0 26.0 10.94 MB

GLSL embedded in Haskell

Home Page: https://hylogen.com

Haskell 6.62% Shell 0.01% Makefile 0.01% HTML 4.21% JavaScript 89.15%

hylogen's Introduction

H Y L O G E N

An embedding of GLSL in Haskell.

H Y L I D E

A live coding environment for writing shaders with Hylogen.

Demo Reel: hylogen.com
Hylogen -
Hylide -

Install

Build from source, using Stack:

Install stack
git clone https://github.com/sleexyz/hylogen.git
cd hylogen
stack build

This is the recommended method of using Hylogen, because using Stack you can share your projects and be confident that others will be using the same version of Hylogen as you. To install it to your system so it can be used anywhere, not just inside the hylogen folder, use stack install instead of stack build.

Hylogen can also be installed to your system using the Haskell Platform:

Install the Haskell Platform
cabal update && cabal install hylogen hylide

Example

Here's a simple Hylogen shader to be used with Hylide, saved as Example.hs (available in the examples/ directory):

module Example where
import Hylogen.WithHylide

output :: Program
output = toProgram color

color :: Vec4
color = vec4 (a, a, a, 1)
  where
    k = 20
    f = (*k) . sin . (/k)
    a = sum [ cos (x_ uvN * f time + x_ mouse )
            , sin (y_ uvN * f time + y_ mouse )
            ]

Run Hylide:

$ stack exec hylide Example.hs

If Hylide was installed using the haskell platform, you can omit stack exec:

$ hylide Example.hs

Now go to localhost:5678 in your browser. You'll see a live rendering of the corresponding generated GLSL:

void main() {
    float _7 = uvN.x;
    float _10 = (time / 20.0);
    float _9 = sin(_10);
    float _8 = (_9 * 20.0);
    float _6 = (_7 * _8);
    float _11 = mouse.x;
    float _5 = (_6 + _11);
    float _4 = cos(_5);
    float _3 = (0.0 + _4);
    float _15 = uvN.y;
    float _18 = (time / 20.0);
    float _17 = sin(_18);
    float _16 = (_17 * 20.0);
    float _14 = (_15 * _16);
    float _19 = mouse.y;
    float _13 = (_14 + _19);
    float _12 = sin(_13);
    float _2 = (_3 + _12);
    vec4 _1 = vec4(_2, _2, _2, 1.0);

    gl_FragColor = _1;
}

Hylide will recompile on changes to the Haskell source, sending generated GLSL to the WebGL client over websockets.

References

The_Force by Shawn Lawson. This was the initial inspiration for Hylide.
data-reify for type-safe observable sharing.

Conceived of at the Recurse Center :)

hylogen's People

Contributors

Stargazers

Watchers

hylogen's Issues

do performance comparison between pure glsl and hylogen for ray marching

Compare transpilation and compilation times for pure DSL vs monadic DSL

Monad DSL

A few things are inexpressible in the pure DSL:

rolled for loops: the cost of parsing unrolled loops grows linearly, so currently your compile times actually grow with higher iteration counts :(
custom uniforms
GLSL functions

In general we want to generate code that is concise as possible to minimize compile times of the generated GLSL