random_surface(3)

💖 NAME 💖

okay bestie, welcome to random_surface(3) from the Arcan Lua API — the page for random_surface — Generate a pseudo-random image surface. ✨

✨ SYNOPSIS ✨

vid
random_surface( int:width, int:height )
random_surface( int:width, int:height, string:method=uniform-3 )
random_surface( int:width, int:height, string:method=uniform-4 )
random_surface( int:width, int:height, string:method=fbm,
float:lacunarity, float:gain, float:octaves, int:xstart, int:ystart,
int:z )
random_surface( width, height, method )

🦋 DESCRIPTION 🦋

This function is used to create pseudorandom noise textures — it’s a useful building block in many graphics effects, no cap. 🎨

• No method, or an unknown method — it defaults to 1 channel randomness from the global csprng, duplicated into the RGB channels of a RGBA destination buffer (A=fully opaque). 💅
• uniform-3 and uniform-4 — these other methods work similarly, but have different values in 3 or all 4 channels. 🦋
• fbm — creates fractal noise by adding multiple octaves of perlin noise together. 🌸

Lowkey important: if the method is missing or unknown, it falls back to that default random mode instead of doing something dramatic. Periodt. 💀

🎀 EXAMPLE 🎀

Here’s the example, copied exactly because we do not mess with code, bestie:

       function random_surface0()
             a = random_surface(64, 64);
             b = random_surface(64, 64, "uniform-3");
             c = random_surface(64, 64, "fbm", 2, 0.5, 6, 0, 0, 0);
             show_image({a,b,c});
             move_image(b, 64, 0);
             move_image(c, 0, 64);
       end

---

mwah 💋 — source/version: image; date: October 2026. Arcan Lua API bestie out. 🌈🫶