Material
Materials can be written inline on a track or saved as assets in assets/<namespace>/kinesis/materials/<path>.json and referenced by id.
object
Section titled “object”A material, inline or as an asset.
| Field | Type | Default | Description |
|---|---|---|---|
parent |
string | A material asset to start from; fields here override it. | |
texture |
string | Texture id. kinesis:soft style ids resolve to textures/fx/<name>.png; full paths ending in .png are used as is. Each track type picks a sensible default. |
|
frames |
vector | [1,1,0] |
Flipbook layout as [columns, rows]. Particles pick frames by life, randomly, or at fps. |
fps |
number | 0 |
Flipbook speed in frames per second; 0 plays over life. |
blend |
"add" | "alpha" | "cutout" | "opaque" |
"add" |
How the material combines with the scene. |
color |
color | "#ffffff" |
Tint multiplied with the texture. |
alpha |
number | 1 |
Opacity multiplier. |
glow |
number | 0 |
How strongly the material feeds Kinesis’s bloom. 1 is a clear glow; values above 2 bloom heavily. |
gradient |
color | "#ffffff" |
Gradient map: replaces colour by looking this gradient up with gradient_by. |
gradient_by |
"luma" | "alpha" | "life" | "u" | "v" | "fresnel" |
"luma" |
What drives the gradient map. |
scroll |
vector | [0,0,0] |
Texture scroll speed as [u, v] per second. |
noise |
noise | Animated noise. | |
dissolve |
dissolve | Noise-driven erosion. | |
fresnel |
fresnel | Rim lighting for meshes and models. | |
shading |
shading | Lights meshes, ribbons and model layers like solid, wet or translucent surfaces. | |
soft |
number | 0 |
Fades the material out over this many blocks where it meets the world, hiding hard intersections. |
distortion |
number | 0 |
Turns the material into heat haze: the scene behind is warped by this much. Colour is ignored. |
lit |
boolean | false |
Darken with the world light level. |
cull |
boolean | false |
Hide back faces. |
depth_test |
boolean | true |
Hide behind world geometry. |
shader |
string | A custom core shader, assets/<ns>/shaders/core/<path>.json, using the Kinesis vertex format. |
|
uniforms |
uniforms | Extra float uniforms for a custom shader: name to number or expression. |
Animated noise on the material.
| Field | Type | Default | Description |
|---|---|---|---|
scale |
number | 2 |
Noise frequency across the texture. |
scroll |
vector | [0,-0.5,0] |
Noise scroll speed as [u, v] per second. |
strength |
number | 0.5 |
How much the noise breaks up the alpha. |
distort |
number | 0 |
How much the noise warps the texture lookup. |
dissolve
Section titled “dissolve”Erodes the material through noise.
| Field | Type | Default | Description |
|---|---|---|---|
amount |
number | 0 |
0 is whole, 1 is gone. Animate it with a curve or t. |
edge |
number | 0.08 |
Width of the burning edge. |
edge_color |
color | "#ff7a1a" |
Colour of the burning edge; values above 1 glow. |
scale |
number | 3 |
Noise frequency. |
fresnel
Section titled “fresnel”Brightens or fades surfaces seen edge-on.
| Field | Type | Default | Description |
|---|---|---|---|
power |
number | 3 |
Sharpness of the rim. |
strength |
number | 1 |
Brightness of the rim. |
color |
color | "#ffffff" |
Rim colour. |
fade |
boolean | false |
Fade the centre out instead of adding a rim (hologram look). |
Uniforms
Section titled “Uniforms”With a custom shader, Kinesis fills the same uniforms as its own effect program (Tint, MatParams, Frames, NoiseA, NoiseB, DissolveA, DissolveColor, FresnelA, FresnelColor, GradientMode, Depth) plus any named under uniforms.
