kinetograph.

A carousel ring where every card turns to face the screen.

$npx kinetograph add grid-face-screen
Source

It steps one card at a time with a rest between steps, while the camera lifts and closes in.

Props

Every prop has a default, so the component renders as it is. Change any of them in Studio or in code.

  • photos

    list

    Photo file names inside public/photos, in order. Items take them in turn and repeat when there are more items than photos.

  • caption

    string = "Face screen"

    Small line at the bottom left. Empty for none.

  • showHud

    boolean = true

    Show the caption and the counter.

  • aperture

    number = 0

    Depth of field: blur, in px, of a card one focus distance away from the focus plane. 0 keeps everything sharp.

  • drift

    number = 1

    Handheld drift on the camera, as a multiple of the default (about 0.4 degrees and 6 px). 0 for a locked-off camera.

  • radius

    number = 14

    Corner radius of the cards, px.

  • colors.ground

    colour

    Frame edge.

  • colors.ground2

    colour

    Frame centre, slightly lighter.

  • colors.ink

    colour

    Caption type.

  • colors.edge

    colour

    Hairline round every card, or 'none' (the default) for clean edges.

  • count

    integer = 16

    Cards on the ring.

  • radius3d

    number = 1250

    Radius of the ring, world px.

  • cardWidth

    number = 330

    Card width, world px.

  • cardHeight

    number = 420

    Card height, world px.

  • steps

    integer = 3

    How many cards the ring advances, one at a time with a hold between.

  • stepFrames

    integer = 40

    Frames each step takes.

  • holdFrames

    integer = 22

    Frames the ring rests between steps.

  • lift

    number = 12

    Degrees the camera looks down on the ring at the high point.

  • distance

    number = 3200

    Eye distance at the start; it closes in by about a quarter.

  • motionBlur

    number = 0

    Camera motion blur shutter in frames, used while the ring or the camera moves fast. 0 turns it off.

  • tiltCards

    number = 0

    Degrees each card leans back from the screen plane (0 faces the screen exactly).

Compositions

  • GridFaceScreen