BallEngine
Help

Backgrounds & Parallax

Every control in the Background panel: the Pristine, Obsidian and Custom looks, animated background effects, the 156-effect Parallax Engine, image and video backdrops and the repeating text pattern.

Where the Background Controls Live

Open the Arts tab and expand the Background panel. It has two tabs at the top: Environment Canvas (the base colour and an optional animated effect) and Parallax Engine (a moving layer drawn on top of the base, for depth and atmosphere). The two tabs draw on separate layers, so you can use both at once.

Environment Canvas is available on every plan, including Free. Parallax Engine is available on every plan, including Free. If a tab ever shows a lock and an Unlock button, the tab bar itself stays usable so you can always switch back.

These controls draw on the flat 2D canvas. In a 3D mode the Arts tab shows a note saying so, and the backdrop is set in the 3D tab instead (Scene & Platform, then Background). See "3D Scene, Lighting & Materials".

Atmosphere: Pristine, Obsidian or Custom

The Atmosphere row is the quickest way to set the whole mood. It has three buttons and a Surprise button that rolls a random animated background with random colours.

ButtonWhat it doesNotes
PristineA clean white background. Also switches the Studio to its light look.Turns the animated background off.
ObsidianA near-black background (#09090b). Also switches the Studio to its dark look.Default. Turns the animated background off.
CustomTurns the animated background on and shows the effect grid and colour controls.Pick an effect and colours below.
SurprisePicks a random effect, three random colours, a random speed, opacity and detail, and turns animation on.Press it again for another roll.

Animated Background and Effects

The Animated Background switch is off by default, because a full-screen animated background has to be repainted every frame. Turn it on (or press Custom) to choose one of the effects below. Your choice is highlighted in the grid.

GroupEffectWhat you see
GeometricSolidOne flat colour (Primary).
GeometricLinear GradientA straight blend between your colours.
GeometricRadial GradientA blend that spreads out from the centre.
GeometricVignetteA dark falloff towards the edges of the frame.
DynamicMesh GradientSoft colour blobs that drift and blend.
DynamicPlasmaFlowing, liquid colour fields.
DynamicAurora BaseSlow northern-light style bands.
AtmosphericStarfieldMoving stars.
AtmosphericDeep SpaceA dark space scene with depth.
AtmosphericScanlineRetro screen lines.
AtmosphericNoise GrainFilm-style grain.
AtmosphericMatrix CodeFalling code characters.

Tip

  • Older projects may name a background effect that has since been merged into another one. They still load and show the replacement, so nothing ever goes blank.

Background Colours and Motion

Once Custom is on, these controls shape the effect you picked.

ControlWhat it doesRange / defaultTip
PrimaryThe main base colour of the effect.Colour. Default #09090bThis is the one colour Solid uses.
SecondaryThe second colour, used by gradients and multi-tone effects.Colour. Default #09090bSet it clearly different from Primary to see a gradient.
AccentA third colour for the more complex effects.Colour. Default #09090bA small bright accent adds depth.
Background OpacityHow solid the effect is. Lower values let the canvas colour underneath show through.0 to 1. Default 1Around 0.6 keeps a busy effect in the background.
Animation SpeedHow fast the effect moves.0 to 5. Default 0.80 freezes it.
Detail ComplexityHow much fine detail the effect draws.0.1 to 5. Default 2Higher detail costs more to preview.
Canvas Ambient ColorThe colour of the canvas outside the arena, under everything else.Colour. Default #09090bAlways visible, even with the animated background off.

The Parallax Engine

Parallax is a moving layer drawn over the base background. Turn on Enable Parallax, pick a Style Category, then click an effect. There are 156 effects. Randomize (top right of the tab) picks a random effect and random settings for it, and jumps to that effect's category.

CategoryEffectsExamples
All156Every effect in one list.
Core3Grid World, Particle Field, Watermark (repeating text, see below).
Nature27Ocean Waves, Lava Flow, Falling Leaves, Snow Flurry, Cherry Blossom, Fire Embers, Thunder Storm, Sun Beams.
Cosmic33Starry Night (default), Nebula Drift, Spiral Galaxy, Wormhole, Meteor Shower, Aurora Borealis, Black Hole Singularity.
Cyber34Matrix Rain, Circuit Board, Retro Grid, Cyber Punk City, DNA Helix, Radar Sweep, Neural Network.
Abstract32Sacred Geometry, Kaleidoscope Mirror, Fractal Mandalas, Mandelbrot Set, Voronoi Cells, Penrose Tiling, Hypnotic Spirals.
Artistic22Oil Painting, Stained Glass, Watercolor, Pop Art, VHS Glitch, Synthwave Grid, Vapor Wave, Marble Texture.
Media5Image Overlay, Scrolling Image, Video Backdrop, Video Texture, Media Mosaic (your own image or video, see below).

Parallax Controls

These sliders appear under the effect grid while parallax is on. The first four are the ones you will use most; the rest sit in the Advanced Settings box.

ControlWhat it doesRange / defaultTip
IntensityStrength of the depth effect.0 to 1. Default 0.5
SpeedHow fast the layers flow.0 to 5. Default 10 holds the layer still.
LayersHow many depth layers are drawn.1 to 10. Default 3Each layer adds preview cost; a cost dot next to the slider shows how heavy it is.
OpacityOverall transparency of the parallax layer.0 to 1. Default 0.5Keep it lower behind a busy simulation.
BlurSoftens the layer, like a shallow depth of field.0 to 20. Default 0A little blur pushes it behind the action.
ScaleSize of the shapes and textures.0.1 to 5. Default 1
ComplexityDetail of the pattern.0.1 to 5. Default 1
RotationRotates the whole layer, in degrees.-180 to 180. Default 0
DensityHow packed or repeated the pattern is.0.1 to 3. Default 1
Zoom Inf.How much the camera zoom affects the parallax depth.0 to 1. Default 0.5Matters when you use camera zoom.
Bright / Contr. / Satur.Brightness, contrast and saturation of the layer.0 to 2 each. Default 1Drop Satur. to make a colourful effect sit quietly.
Auto X / Auto YA constant drift sideways or up and down.-2 to 2. Default 0Negative values drift the other way.
Glow EffectAdds a bloom to bright parts. Shows Glow Rad. and Glow Opac. when on.Off by default. Glow Rad. 0 to 100 (20), Glow Opac. 0 to 1 (0.5)Glow makes each layer more expensive.
Color ModeTheme Adaptive follows the effect's own colours and your light or dark look. Custom Color tints it with one colour. Rainbow Cycle shifts through hues.Default Theme AdaptiveCustom shows a Custom Color picker.

Image and Video Backdrops

To put your own picture or clip behind the simulation, open Parallax Engine, choose the Media category and pick one of its five effects. A Media Content Configuration box appears.

Image Overlay, Scrolling Image and Media Mosaic use the Image URL. Video Backdrop and Video Texture use the Video URL. Paste a direct link to the file itself (a PNG or JPG for images, an MP4 for video), not a link to a web page that shows it.

ControlWhat it doesOptions / default
Image URLDirect link to a PNG or JPG.Text field.
Video URLDirect link to an MP4.Text field.
Fitting ModeHow the media fills the frame.Cover (Fill), default; Contain (Best Fit); Stretch; Tile (Repeat).
Media OpacityHow solid the media is.0 to 1. Default 1

Tip

  • Lower Media Opacity (around 0.4 to 0.6) keeps the balls readable on top of a detailed photo.
  • Some sites block their files from being shown elsewhere. If your link does not appear in the preview, host the file somewhere that allows direct links, then do a short test export to confirm it shows in the video.
  • The uploaded images in Ball Studio (Custom Image) are for the ball and for 3D textures and backgrounds. The 2D backdrop here always uses a link.

Repeating Text Pattern (Watermark effect)

The Watermark effect in the Core category fills the background with your own text, repeated in a tilted grid that slowly scrolls. It is a background decoration drawn behind the simulation. It is not the export watermark: that one is set in the Video tab (see "Titles, Counters, HUD & Branding").

ControlWhat it doesRange / default
Watermark TextThe text that repeats.Default "HYPNOTIC"
Font FamilyInter, Space Grotesk, JetBrains Mono, Outfit or Playfair Display.Default Inter
Font WeightThin, Normal, Bold or Black.Default Black
ColorText colour.Default white
Use Ball ColorUses the ball colour instead of Color.Off
OpacityHow visible the text is.0 to 1. Default 0.1
Font SizeSize of each word.10 to 200. Default 40
DensityGrid spacing.0.1 to 2. Default 0.5
SpeedScroll speed.0 to 10. Default 0.5
Repeat X / Repeat YHow many times the text repeats across and down.1 to 50. Default 5
AngleTilt of the grid in degrees.-180 to 180. Default -45
Shadow Color, Shadow Blur, Shadow X, Shadow YA drop shadow behind the text.Blur 0 to 50 (0), offsets -50 to 50 (0)

Tip

  • Your channel handle at an Opacity of about 0.05 to 0.1 makes a subtle branded texture that survives re-uploads and crops.

More from BallEngine

Guides, plans and answers for making your videos.