Opus Motion ★ Star on GitHub

Image looks · woodcut-carve

Woodcut carve (form-following knife cuts)

A picture turns into a white-line woodcut: thousands of separate knife cuts that wrap around forms (along the isophotes), wide where the image is bright and absent where it is dark, carved in live from highlights to shadows, then printed on paper with a ragged block edge, ink speckle and an optional copper colour plate glowing out of the brightest cuts. Default is a procedural moonlit-hills picture; pass `src` for any image.

A free, MIT-licensed image effect from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

Woodcut carve (form-following knife cuts): three frames of the image effect, start, middle and end
Woodcut carve (form-following knife cuts) — start, middle and end of the 8.0-second motion.

What Woodcut carve (form-following knife cuts) is for

A very crafted treatment for book trailers, folk / heritage brands, history explainers and editorial portraits: give it any still and it carves it live. Pairs with ken-burns for a push.

  • woodcut
  • engraving
  • print
  • linocut
  • carve
  • knife
  • image filter
  • relief
  • folk
  • heritage
  • black and white
  • paper
  • photo effect

Details

Category
Image looks & photo effects
Length
8.0 s (240 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
medium
Transparent overlay
no
Seamless loop
no
Text props
—
Colour props
ink paper plateColor
Image props
src
Mood
paper, photo, night
Roles
backdrop

Use Woodcut carve (form-following knife cuts) in Remotion, React or HTML

Remotion project

terminal
# copy this motion into your Remotion project
node cli/mgl.mjs add woodcut-carve --to ../my-app/src

# render an mp4 (run in the library folder)
node cli/mgl.mjs render woodcut-carve --props '{"ink":"#0F0E0D","paper":"#EFE8D8","plateColor":"#E0702B","src":""}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export woodcut-carve --as mp4 --props '{"ink":"#0F0E0D","paper":"#EFE8D8","plateColor":"#E0702B","src":""}'

React / Next.js

tsx
import {MotionPlayer} from 'opus-motion-library/web';

<MotionPlayer
  motion="woodcut-carve"
  props={{ink: '#0F0E0D', paper: '#EFE8D8', plateColor: '#E0702B', src: ''}}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

html
<script src="opus-motion.element.js" defer></script>

<opus-motion motion="woodcut-carve"
  props='{"ink":"#0F0E0D","paper":"#EFE8D8","plateColor":"#E0702B","src":""}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "woodcut-carve",
      "props": {
        "ink": "#0F0E0D",
        "paper": "#EFE8D8",
        "plateColor": "#E0702B",
        "src": ""
      }
    }
  ]
}

Woodcut carve (form-following knife cuts) props

17 parameters — change any of them to make the motion yours.

PropDefaultWhat it does
src""image path (public/ or URL); empty = built-in moonlit-hills picture
sp7.5spacing between cuts in px at 1080 (5 = fine, 10 = bold)
black0.12tone below which nothing is cut (0-1)
white1tone at which cuts reach full width (0-1)
gamma1tone curve before cutting
a00.45fallback cut angle in radians where the picture has no direction
reveal"light"carve order: 'light' (highlights first) | 'radial' | 'down'
startFrame14frame carving starts
durationFrames150frames carving takes
ink"#0F0E0D"block ink colour
paper"#EFE8D8"paper colour (also the colour of the cuts)
plateColor"#E0702B"colour plate printed in the brightest cuts ("" = none)
plateAbove0.8tone above which cuts take the colour plate (0-1)
plateFrames[150,205][from, to] frames the colour plate fades in
seed3randomness seed
margin0.05paper margin as a fraction of the short side
maxCuts4200cap on the number of cuts (performance)

Notes & credits

Technique sources:

  • lemo-opuscar styles/woodcut demo/engine filter.js, hatch.js, knife.js, print.js (MIT, LemoLab) — own SVG implementation