Liquid Metal

Presets

Installation

npm i @paper-design/shaders-react

Code

import { LiquidMetal } from '@paper-design/shaders-react';

<LiquidMetal
  width={1280}
  height={720}
  image="https://shaders.paper.design/images/logos/diamond.svg"
  colorBack="#aaaaac"
  colorTint="#ffffff"
  shape="diamond"
  repetition={2}
  softness={0.1}
  shiftRed={0.3}
  shiftBlue={0.3}
  distortion={0.07}
  contour={0.4}
  angle={70}
  speed={1}
  scale={0.6}
  fit="contain"
/>

Shader Props

Name	Description	Type	Values
colorBack	Background color	`string`	Hex, RGB, or HSL color
colorTint	Overlay color (color burn blending used)	`string`	Hex, RGB, or HSL color
image	An optional image used as an effect mask. A transparent background is required.	`HTMLImageElement \| string`	Image object or URL
shape	The predefined shape used as an effect mask (none = the effect fills the canvas), needs no image	`enum`	\| `"none"` \| `"circle"` \| `"daisy"` \| `"diamond"` \| `"metaballs"`
repetition	Density of pattern stripes	`number`	1 to 10
softness	Color transition sharpness (0 = hard edge, 1 = smooth gradient)	`number`	0 to 1
shiftRed	R-channel dispersion	`number`	-1 to 1
shiftBlue	B-channel dispersion	`number`	-1 to 1
distortion	Noise distortion over the stripes pattern	`number`	0 to 1
contour	Strength of the distortion on the shape edges	`number`	0 to 1
angle	The direction of pattern animation (angle relative to the shape)	`number`	0 to 360

Common Props

Name	Description	Type	Values
speed	Controls how fast the animation runs. speed=0 stops the animation loop, and speed=1 defines frame prop as timestamp in milliseconds	`number`	—
frame	Starting point of the animation. When speed=1, this value is treated as start time in milliseconds (try large frame values to see the difference). When speed=0 frame fully defines the state of static shader	`number`	—
scale	Overall zoom level of the graphics	`number`	0.1 to 4
rotation	Overall rotation angle of the graphics	`number`	0 to 360
offsetX	Horizontal offset of the graphics center	`number`	-1 to 1
offsetY	Vertical offset of the graphics center	`number`	-1 to 1
width	CSS width style of the shader element	`number \| string`	—
height	CSS height style of the shader element	`number \| string`	—
fit	How to fit the rendered shader into the canvas dimensions	`enum`	\| `"contain"` \| `"cover"`
originX	Reference point for positioning world width in the canvas	`number`	0 to 1
originY	Reference point for positioning world height in the canvas	`number`	0 to 1
minPixelRatio	Minimum pixel ratio to use when rendering the shader (default is 2 for double resolution)	`number`	—
maxPixelCount	Maximum pixel count that the shader may process	`number`	—

Description

Futuristic liquid metal material applied to uploaded logo or abstract shape.