Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dy/wavefont

Typeface for rendering waveform/data
https://github.com/dy/wavefont

afdko barchart chart datavis font opentype spectrum typeface unicode-table variable-fonts waveform

Last synced: 5 days ago
JSON representation

Typeface for rendering waveform/data

Host: GitHub
URL: https://github.com/dy/wavefont
Owner: dy
License: ofl-1.1
Created: 2016-08-23T03:06:00.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-05-19T12:57:58.000Z (8 months ago)
Last Synced: 2024-05-23T07:50:27.703Z (8 months ago)
Topics: afdko, barchart, chart, datavis, font, opentype, spectrum, typeface, unicode-table, variable-fonts, waveform
Language: HTML
Homepage: https://dy.github.io/wavefont/scripts/
Size: 10 MB
Stars: 379
Watchers: 11
Forks: 5
Open Issues: 2
Metadata Files:
- Readme: readme.md
- Authors: AUTHORS.txt

Awesome Lists containing this project

my-awesome-list - wavefont

README

        # wavefont [![build](https://github.com/dy/wavefont/actions/workflows/build.yaml/badge.svg)](https://github.com/dy/wavefont/actions/workflows/build.yaml)

A typeface for rendering vertical bars data: waveforms, spectrums, diagrams, histograms, columns etc.



[**Playground**](https://dy.github.io/wavefont/scripts)  •  [**Google fonts**](https://fonts.google.com/specimen/Wavefont/tester)  •  [**V-fonts**](https://v-fonts.com/fonts/wavefont)  •  

[**Wavearea**](https://dy.github.io/wavearea?src=https://cdn.freesound.org/previews/147/147582_1728127-lq.mp3)

## Usage

Place [_Wavefont[ROND,YELA,wght].woff2_](./fonts/variable/Wavefont[ROND,YELA,wght].woff2) into your project directory and use this code:

```html

@font-face {

	font-family: wavefont;

	font-display: block;

	src: url(./Wavefont[ROND,YELA,wght].woff2) format('woff2');

}

.wavefont {

	--wght: 400;

	font-family: wavefont;

	font-variation-settings: 'wght' var(--wght), 'ROND' 30, 'YELA' 0;

}

abcdefghijklmnopqrstuvwwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ

// Set values programmatically (more precise)

waveform.textContent = Array.from({length: 100}, (_,i) => String.fromCharCode(0x100 + i)).join('')

```

## Ranges

Wavefont bars correspond to values from 0 to 100, assigned to different characters:

* 0-9 chars are for simplified manual input with step 10 (bar height = number).

* a-zA-Z for manual input with step 2, softened at edges a and Z (bar height = number of letter).

* U+0100-017F for 0..127 values with step 1 (`char = String.fromCharCode(0x100 + value)`).

## Variable axes

Tag | Range | Default | Meaning

---|---|---|---

`wght` | _1_-_1000_ | 400 | Bar width, or boldness.

`ROND` | _0_-_100_ | 100 | Border radius, or roundness (percent).

`YELA` | _-100_-_100_ | -100 | Alignment: bottom, center or top.

To adjust axes via CSS:

```css

.wavefont {

  font-variation-settings: 'wght' var(--wght, 40), 'ROND' var(--rond, 0), 'YELA' var(--align, 0);

  letter-spacing: 1ch; /* 1ch unit === 1 bar width */

}

```

## Features

* Ranges, values and width is compatible with [linefont](https://github.com/dy/linefont), so fonts can be switched preserving visual coherency.

* Visible charcodes fall under _marking characters_ unicode category, ie. recognized as word by regexp and can be selected with Ctrl + → or double click. Eg. waveform segments separated by ` ` or `-` are selectable by double click.

* Characters outside of visible ranges are clipped to _0_, eg. ` `, `\t` etc.

* `-–._*` map to _1_ value, `|` maps to max value, `▁▂▃▄▅▆▇█` map to corresponding bars.

* Accent acute  ́ (U+0301) shifts bar 1-step up, circumflex accent  ̂ (U+0302) 10-steps up. Eg. `\u0101\u0302\u0302\u0301\u0301\u0301` shifts 23 steps up.

* Accent grave  ̀ (U+0300) shifts bar 1-step down, caron  ̌ (U+030C) shifts 10 steps down, eg. `\u0101\u030c\u0300\u0300\u0300` shifts 13 steps down.

* Caret span is -20..120, so line-height = 1.4 is minimal non-overlapping selection.

## JS package

Optional wavefont package exposes a function that calculates string from values for your convenience.

```js

import wf from 'wavefont'

// get characters for values from 0..127 range

wf(0, 1, 50, 99, 127, ...) // ĀāĲţŤ...

```

## Building

`make build`

* [Tests](https://dy.github.io/wavefont/out/fontbakery/fontbakery-report)

* [Glyphs](https://dy.github.io/wavefont/out/proof/glyphs)

* [Text](https://dy.github.io/wavefont/out/proof/text)

* [Waterfall](https://dy.github.io/wavefont/out/proof/waterfall)

## See also

* [linefont](https://github.com/dy/linefont) − font-face for rendering linear data.

## References

* [Google Fonts guide](https://googlefonts.github.io/gf-guide/variable.html#most-common-axes).

* [Unified font object spec](https://unifiedfontobject.org/versions/ufo3) − unified human-readable format for storing font data.

* [Feature file spec](https://adobe-type-tools.github.io/afdko/OpenTypeFeatureFileSpecification.html#6.h) − defining opentype font features.

* [Adobe-variable-font-prototype](https://github.com/adobe-fonts/adobe-variable-font-prototype) − example variable font.

* [Designspace XML spec](https://github.com/fonttools/fonttools/tree/main/Doc/source/designspaceLib#document-xml-structure) − human-readable format for describing variable fonts.

* [Adobe Blank](https://github.com/adobe-fonts/adobe-blank-vf) − blank characters variable font.

* [Sparks](https://github.com/aftertheflood/sparks) – alternative font with similar purpose.

🕉