kotlin

[github]

the k, in violet and pink, glinting now and then

logos 56×28 30 fps in colour or one ink 6.7 kB

use it

html

<script type="module" src="https://ascii.rest/ascii.js"></script>

<ascii-art piece="kotlin" options='{"shine":5}'></ascii-art>

No install and no build step. ascii.js defines the <ascii-art> tag, loads the piece from ascii.rest, plays it while it is on screen, and holds the first frame for anyone who prefers reduced motion. Add mono, <ascii-art piece="kotlin" mono>, for one ink.

react

// npm install github:bas3line/ascii
import { Ascii } from "ascii.rest/react";
import { kotlin } from "ascii.rest/pieces";

<Ascii piece={kotlin} options={{"shine":5}} />

A client component, so it works in the Next.js app router as it is. Pass the name instead, piece="kotlin", to fetch the piece only when it mounts. Add mono for one ink.

astro

---
// npm install github:bas3line/ascii
import Ascii from "ascii.rest/astro";
---

<Ascii piece="kotlin" options={{"shine":5}} />

Renders the first frame on the server, so the page is whole before any script runs, then plays the piece once it loads. Add mono for one ink.

typescript

// npm install github:bas3line/ascii
import { mount } from "ascii.rest";
import { kotlin } from "ascii.rest/pieces";

const el = document.querySelector<HTMLCanvasElement>("canvas")!;
const stop = mount(el, kotlin, {"shine":5});

mount plays a piece in a <pre>, or on a <canvas> for the coloured ones, and returns a function that stops it. Every piece, option and frame is typed. Mount it in a <pre> for one ink.

kotlin.ts

[js] [github]
/*
 * kotlin: the Kotlin logo, a K cut from a square, with a glint crossing it
 * every few seconds.
 *
 * Drawn from devicon's kotlin-original.svg (MIT): each cell holds the
 * character whose shape best matches the logo's edge through it, and 8 where
 * the logo is solid. On a canvas it takes the logo's colours, lifted on a dark
 * page where they would sink into it; in a <pre> it is one ink, from
 * kotlin-plain.svg. The logo is a trademark of its owner, shown here to name
 * the language.
 */
import type { Frame, Meta } from "../types.ts";

export interface KotlinOptions {
  [key: string]: unknown;
  /** Seconds between glints; 0 keeps the logo still. */
  shine: number;
}

export const meta = {
  name: "kotlin",
  category: "logos",
  note: "the k, in violet and pink, glinting now and then",
  cols: 56,
  rows: 28,
  fps: 30,
  options: { shine: 5 },
  // The logo's 5 colours for a light page, then for a dark one; each as drawn, then twice lighter for the glint.
  palette: [
    "#c01ae1", "#963df5", "#d124b1", "#ac2aec", "#db3683", "#d66aec",
    "#bb81f9", "#e171cc", "#c975f3", "#e87cae", "#ecbaf6", "#e0c5fc",
    "#f1bde8", "#e6bff9", "#f4c3da", "#c01ae1", "#963df5", "#d124b1",
    "#ac2aec", "#db3683", "#d66aec", "#bb81f9", "#e171cc", "#c975f3",
    "#e87cae", "#ecbaf6", "#e0c5fc", "#f1bde8", "#e6bff9", "#f4c3da",
  ],
} satisfies Meta<KotlinOptions>;

// In a <pre>, in the page's own colour.
const MONO = String.raw`

  88888888888888888888888888888888888888888888888888P"
  888888888888888888888888888888888888888888888888P"
  8888888888888888888888888888888888888888888888P"
  88888888888888888888888888888888888888888888P"
  888888888888888888888888888888888888888888P"
  8888888888888888888888888888888888888888P"
  88888888888888888888888888888888888888P"
  888888888888888888888888888888888888P"
  8888888888888888888888888888888888P"
  88888888888888888888888888888888P"
  888888888888888888888888888888P"
  8888888888888888888888888888P"
  88888888888888888888888888P"
  88888888888888888888888888q_
  8888888888888888888888888888q_
  888888888888888888888888888888q_
  88888888888888888888888888888888q_
  8888888888888888888888888888888888q_
  888888888888888888888888888888888888q_
  88888888888888888888888888888888888888q_
  8888888888888888888888888888888888888888q_
  888888888888888888888888888888888888888888q_
  88888888888888888888888888888888888888888888q_
  8888888888888888888888888888888888888888888888q_
  888888888888888888888888888888888888888888888888q_
  88888888888888888888888888888888888888888888888888q_

`;

// On a canvas, and the colour of each cell: an index into the logo's colours.
const ART = String.raw`

  88888888888888888888888888888888888888888888888888P"
  888888888888888888888888888888888888888888888888P"
  8888888888888888888888888888888888888888888888P"
  88888888888888888888888888888888888888888888P"
  888888888888888888888888888888888888888888P"
  8888888888888888888888888888888888888888P"
  88888888888888888888888888888888888888P"
  888888888888888888888888888888888888P"
  8888888888888888888888888888888888P"
  88888888888888888888888888888888P"
  888888888888888888888888888888P"
  8888888888888888888888888888P"
  88888888888888888888888888P"
  88888888888888888888888888q_
  8888888888888888888888888888q_
  888888888888888888888888888888q_
  88888888888888888888888888888888q_
  8888888888888888888888888888888888q_
  888888888888888888888888888888888888q_
  88888888888888888888888888888888888888q_
  8888888888888888888888888888888888888888q_
  888888888888888888888888888888888888888888q_
  88888888888888888888888888888888888888888888q_
  8888888888888888888888888888888888888888888888q_
  888888888888888888888888888888888888888888888888q_
  88888888888888888888888888888888888888888888888888q_

`;
const INK = String.raw`

  0000000000000222222222222222244444444444444444444444
  00000000000000022222222222222224444444444444444444
  000000000000000002222222222222222444444444444444
  0000000000000000000222222222222222244444444444
  00000000000000000000022222222222222224444444
  000000000000000000000002222222222222222444
  3300000000000000000000000222222222222222
  33330000000000000000000000022222222222
  333333000000000000000000000002222222
  3333333300000000000000000000000222
  33333333330000000000000000000000
  333333333333000000000000000000
  3333333333333300000000000000
  1333333333333333000000000000
  111333333333333333000000000000
  11111333333333333333000000000000
  1111111333333333333333000000000000
  111111111333333333333333000000000000
  11111111111333333333333333000000000000
  1111111111111333333333333333000000000000
  111111111111111333333333333333000000000000
  11111111111111111333333333333333000000000000
  1111111111111111111333333333333333000000000000
  111111111111111111111333333333333333000000000000
  11111111111111111111111333333333333333000000000000
  1111111111111111111111111333333333333333000000000000

`;

const START = 0.5; // seconds before the first glint
const PASS = 2; // seconds a glint takes to cross
const HALF = 5; // half its width, in cells
const LEAN = 0.9; // cells it shifts left a row down, so it leans like a slash
const SOLID = "8dbqpPYOo0"; // what the glint turns to slashes; thin edges keep their shape

const lines = (art: string) => art.slice(1, -1).split("\n").map((line) => line.padEnd(meta.cols));

export default function kotlin({ shine = meta.options.shine }: Partial<KotlinOptions> = {}): Frame {
  const { cols, rows } = meta;
  const mono = lines(MONO), art = lines(ART), ink = lines(INK);
  const n = meta.palette.length / 6;
  const every = shine > 0 ? Math.max(shine, PASS + 0.5) : 0;
  // The glint crosses the logo's ink, edge to edge, rather than the whole frame.
  let lo = Infinity, hi = -Infinity;
  for (const pic of [mono, art])
    pic.forEach((line, y) => {
      for (let x = 0; x < cols; x++) if (line[x] !== " ") (lo = Math.min(lo, x + LEAN * y)), (hi = Math.max(hi, x + LEAN * y));
    });
  const span = hi - lo + 2 * HALF;

  return (t, { paper = false, color } = {}) => {
    const pic = color ? art : mono;
    const since = t - START;
    const at = every && since >= 0 ? lo - HALF + (span * (since % every)) / PASS : -Infinity;
    const out: string[] = [];
    for (let y = 0; y < rows; y++) {
      let line = "";
      for (let x = 0; x < cols; x++) {
        let ch = pic[y][x];
        if (ch !== " ") {
          const d = Math.abs(x + LEAN * y - at);
          let k = d < HALF ? 1 - d / HALF : 0;
          k = k * k * (3 - 2 * k);
          if (k > 0.55 && SOLID.includes(ch)) ch = "/";
          if (color) color[y * cols + x] = (paper ? 0 : 3 * n) + (k > 0.6 ? 2 : k > 0.25 ? 1 : 0) * n + parseInt(ink[y][x], 36);
        }
        line += ch;
      }
      out.push(line);
    }
    return out.join("\n");
  };
}