README.md

bitfolly

Because these bits are acting unwise.

Bitfolly is a livecoding tool for creating visuals using bitwise operations, inspired by bytebeats and bitfield patterns.

Usage and examples

Bitfolly programs are essentially a javascript shader that is compiled to run on the GPU by gpu.js

Each program is run for every pixel on the screen. The coordinates for the current pixel can be accessed via the x and y variables.

Additionally, there is a t variable that is constantly increasing, which can be used to animated your creations.

Here's an example of a bitfolly program:

(x&y^t/20)%100

To run a program in the editor, press "Ctrl-Enter" or click the ▶️ icon in the top right corner.

Most javascript expressions can be used, for example, the javascript ternary operator:

(t%1000>500?x|y:x^y)%255

Or javascript Math functions:

(x^y&Math.sin(t/300)*255)%255

Additional features include:

• audioreactivity via the a array, at audio-based incrementor
• feedback via the previous frame p texture.

let p0 = p[x&y][y^x]
p0 *= 255
c[0] = Math.tan(x^y^at/3) + 0.96 * p0[0]
c[1] = Math.tan(x^y^at/5) + 0.96 * p0[1]
c[2] = Math.tan(x^y^at/7) + 0.96 * p0[2]

Vim mode can also be enabled by adding the v=1 query param to the URL

Using in Hydra

Import the global bundle and create a bitfolly object. To get the audio reactive variables you need to pass it a function that returns Hydra's a.fft array. Then just call the update function and initialize a Hydra source with bitfolly's canvas.

await import("https://emptyfla.sh/bitfolly/bundle-global.js")
window.bitfolly = window.bitfolly || new Bitfolly(() => a.fft)
bitfolly.update("(x&y^t/30)%255")
s0.init({
    src: bitfolly.canvas
})
src(o0)
    .diff(osc(1, 1, 1)
        .modulate(src(s0), 10), .1)
    .modulateScale(src(s0), [.01, -.01].fast(.3).smooth())
    .modulateRotate(src(s0), [.02,-.02].fast(.7).smooth())
    .out()