Color and looks

Vignette effect for video

Darken the corners to pull the eye to the middle of the frame.

Shown on Rafting on the Rogue River

Before · the same request without it
After · Darken the corners to pull the eye to the middle of the frame.

The entry

Add it to a clip's effects list. Entries run in the order you write them.

{
  "type": "vignette"
}

Settings

NameAcceptsDefaultWhat it does
amount0 to 1or keyframes0.60 to 1, how dark the corners get. 1 is black.
radius0 to 1or keyframes0.50 to 1, how much of the frame stays clear. Smaller closes in on the centre.

Run it

The whole request behind the render above. Paste it as it is, or swap the file for your own.

job.ts
import { createClient, outputUrl } from "@rendobar/sdk";


const rb = createClient({ apiKey: process.env.RENDOBAR_API_KEY });


const job = await rb.jobs.run({
  type: "compose",
  params: {
    schemaVersion: 1,
    output: {
      format: "mp4",
      resolution: {
        width: 960,
        height: 540
      }
    },
    timeline: {
      tracks: [
        {
          clips: [
            {
              asset: {
                type: "video",
                src: "https://cdn.rendobar.com/compose/showcase/media/river.mp4"
              },
              start: 0,
              effects: [
                {
                  type: "vignette"
                }
              ]
            }
          ]
        }
      ]
    }
  },
});


console.log(outputUrl(job));

Install with npm i @rendobar/sdk. jobs.run() submits and waits, so it returns the finished job in one call.

terminal
curl https://api.rendobar.com/jobs \
  -H "Authorization: Bearer $RENDOBAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"compose","params":{"schemaVersion":1,"output":{"format":"mp4","resolution":{"width":960,"height":540}},"timeline":{"tracks":[{"clips":[{"asset":{"type":"video","src":"https://cdn.rendobar.com/compose/showcase/media/river.mp4"},"start":0,"effects":[{"type":"vignette"}]}]}]}}}'

Returns immediately with a job id. Poll GET /jobs/{id} or register a webhook rather than blocking on the request.

Questions

What does the vignette effect do in compose?

Darken the corners to pull the eye to the middle of the frame. Darken the corners to pull the eye to the middle of the frame.

How do I add vignette to a video with an API?

Send a compose job to the Rendobar API with this entry in the timeline: {"type":"vignette"}. Add it to a clip's effects list. Entries run in the order you write them. The request on this page is complete and renders as shown.

What are the default settings for vignette?

Every setting has a default, so the type on its own is enough: amount 0.6 and radius 0.5. Set only the ones you want to change.

Footage and sound

More in the reference

Color A warm cinematic grade: the light pulled towards gold, contrast and color lifted a little, skin left believable. LUT A film grade from a LUT file: shadows toward teal, skin and highlights toward orange, the look a colourist hands over as a .cube. Looks The whole archive look in one word: sepia, grain, dust, scratches, projector flicker and a vignette together. Blur Knock the footage back so a title over it stays readable. Sharpen Crisp up footage that is slightly out of focus. Look at the rocks and the life jackets. Denoise Clean the grain a small sensor adds in the dark. Punched in so the grain is actually visible at this size, because at full width it is too fine to see.

See all 77 in the effects reference →