README.md

clumsy-graphics

a tool for rapidly developing animations where frames are described using svg elements à la react 🙃

example

tl;dr

./example-project/HelloRainbow.animation.tsx

import React from 'react'
import { AnimationModule } from 'clumsy-graphics'
import getColormap from 'colormap'

const HelloRainbowAnimationModule: AnimationModule = {
  moduleName: 'Hello-Rainbow',
  frameCount: 24,
  getFrameDescription: getHelloRainbowFrameDescription,
  frameSize: {
    width: 1024,
    height: 1024,
  },
  animationSettings: {
    frameRate: 9,
    constantRateFactor: 1,
  },
}

export default HelloRainbowAnimationModule

interface GetHelloRainbowFrameDescriptionApi {
  frameCount: number
  frameIndex: number
}

async function getHelloRainbowFrameDescription(
  api: GetHelloRainbowFrameDescriptionApi
) {
  const { frameCount, frameIndex } = api
  const rainbowColormap = getColormap({
    colormap: 'rainbow-soft',
    nshades: frameCount,
    format: 'hex',
    alpha: 1,
  })
  const mainFrameColor = rainbowColormap[frameIndex % frameCount]
  return (
    <svg viewBox={`0 0 100 100`}>
      <rect
        x={0}
        y={0}
        width={100}
        height={100}
        fill={'black'}
        stroke={mainFrameColor}
        strokeWidth={2}
      />
      <text
        x={5}
        y={9}
        style={{
          fontFamily: 'monospace',
          fontSize: 5,
          fontWeight: 600,
          fill: mainFrameColor,
        }}
      >
        Hello Rainbow
      </text>
      {new Array(frameCount).fill(null).map((_, squareIndex) => {
        const squareStamp = squareIndex / frameCount
        const squareRadius = 30 - 30 * squareStamp
        const squareLength = 2 * squareRadius
        return (
          <rect
            x={50 - squareRadius}
            y={50 - squareRadius}
            width={squareLength}
            height={squareLength}
            stroke={rainbowColormap[(squareIndex + frameIndex) % frameCount]}
            strokeWidth={0.5}
          />
        )
      })}
    </svg>
  )
}

develop and iterate on animation

yarn clumsy-graphics startDevelopment --animationModulePath=./example-project/HelloRainbow.animation.tsx

open browser at localhost:3000

./example-project/HelloRainbow.gif

installation

add package to project

yarn add clumsy-graphics

setup docker

install and run docker engine (the majority of clumsy-graphics runs within a container to simplify dependency management)

api

clumsy-graphics --animationModulePath=<SourceFilePath>

• animationModulePath: path to animation module export file

  • required

• clientServerPort: the port on the host machine to use for handling api, asset, and page requests

  • defaultValue = 3000

how-to

• run clumsy-graphics command

• open browser at localhost:3000

• begin making changes on the active animation module