Opus Motion ★ Star on GitHub

Image looks · handscroll-reveal

Handscroll reveal

A long ink-wash landscape pans right-to-left like an unrolling Chinese handscroll (procedural mountains, pines, a lone boat — or your images printed on the paper), then the camera pulls back to the whole scroll mounted on silk with wooden rollers on a dark table, and a vermilion seal stamps the end.

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

Handscroll reveal: three frames of the image effect, start, middle and end
Handscroll reveal — start, middle and end of the 11.0-second motion.

What Handscroll reveal is for

Timelines, histories, journeys, supply chains — any linear story shown as one continuous artwork.

  • scroll
  • handscroll
  • ink
  • ink-wash
  • chinese
  • landscape
  • pan
  • timeline
  • history
  • journey
  • seal
  • paper
  • mountains
  • reveal
  • east-asian

Details

Category
Image looks & photo effects
Length
11.0 s (330 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
medium
Transparent overlay
no
Seamless loop
no
Text props
title
Colour props
mountColor silkColor tableColor
Image props
images
Mood
paper, nature, night, photo
Roles
backdrop

Use Handscroll reveal in Remotion, React or HTML

Remotion project

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

# render an mp4 (run in the library folder)
node cli/mgl.mjs render handscroll-reveal --props '{"title":"RIVER OF HOURS","mountColor":"#C9A86333","silkColor":"#8A6D3B","tableColor":"#17120C","images":[]}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export handscroll-reveal --as mp4 --props '{"title":"RIVER OF HOURS","mountColor":"#C9A86333","silkColor":"#8A6D3B","tableColor":"#17120C","images":[]}'

React / Next.js

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

<MotionPlayer
  motion="handscroll-reveal"
  props={{
    title: 'RIVER OF HOURS',
    mountColor: '#C9A86333',
    silkColor: '#8A6D3B',
    tableColor: '#17120C',
    images: [],
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

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

<opus-motion motion="handscroll-reveal"
  props='{"title":"RIVER OF HOURS","mountColor":"#C9A86333","silkColor":"#8A6D3B","tableColor":"#17120C","images":[]}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "handscroll-reveal",
      "props": {
        "title": "RIVER OF HOURS",
        "mountColor": "#C9A86333",
        "silkColor": "#8A6D3B",
        "tableColor": "#17120C",
        "images": []
      }
    }
  ]
}

Handscroll reveal props

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

PropDefaultWhat it does
images[]optional public/ images, one per panel (printed into the scroll); empty slots paint procedural ink landscapes
panels4number of panels in the scroll
title"RIVER OF HOURS"vertical title column on the first panel
sealGlyph"印"character inside the vermilion seal
direction11 = pan right-to-left (classic), -1 = left-to-right
panSpeed7pan speed (≈ panel-widths per 10 s)
pullbackAt190frame the pull-back to the mounted scroll starts
mountColor"#C9A86333"sheen colour behind the mounted scroll
silkColor"#8A6D3B"silk mount colour
tableColor"#17120C"table / background colour
seed5landscape seed

Notes & credits

Technique sources:

  • lemo-opuscar styles/ink-wash (MIT, LemoLab) — STYLE.md §6/§8, DEMO.md ending