termcol: declare palette titles in extensible metadata hashes
[sheet.git] / termcol.plp
index 3fd9eceacf2ade51d94c0d3f532f851bb62446c1..686316cf8f8f1cb9b3cb6734913147991c001f9b 100644 (file)
+<(common.inc.plp)><:
+
+Html({
+       title => 'terminal colour cheat sheet',
+       version => '1.0',
+       description => [
+               "Index of all terminal/console colour codes,",
+               "with an example result of various environments.",
+       ],
+       keywords => [qw'
+               color code terminal console escape table xterm rxvt
+       '],
+       data => ['termcol.inc.pl'],
+       stylesheet => [qw'light dark'],
+});
+
+:>
+<h1>Terminal colours</h1>
+
+<p>
+<span title="ECMA-48">ANSI</span> (VT100, ISO-6429) 16-colour text palette
+as implemented by various systems and programs.
 <:
-use utf8;
-use strict;
-use warnings;
-use open IO => ':utf8';
-use List::Util 'min';
+print
+       !exists $get{v} ? 'Also see <a href="?v">8-bit legacy hardware</a> palettes.' :
+       'Also included are 8-bit legacy hardware palettes.';
+:>
+</p>
 
-our $VERSION = 'v1.0';
+<div class="section">
+<:
+use Shiar_Sheet::Colour '1.03';
+use List::Util qw( min max );
 
-$header{content_type} = 'text/html; charset=utf-8';
+my $palettes = do 'termcol.inc.pl';
+die "Cannot open palette data: $_\n" for $@ || $! || ();
 
-:><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
-<html>
+sub colcell {
+       my $name = shift // return "<td colspan=3>\n";
+       my $col = Shiar_Sheet::Colour->new(@_);
+       my $minhex = $col->rgb24;
+       my $css     = '#' . $col->rgb48;
+       my $inverse = '#' . sprintf('%X', $col->luminance/255 < .3 ? 12 : 0) x 3;
 
-<head>
-<title>terminal colour cheat sheet</title>
-<meta http-equiv="content-type" content="utf-8">
-<link rel="stylesheet" type="text/css" media="all" href="/base.css">
-</head>
+       my $sample = [ qw(#000 #FFF) ];
+       ($name, $sample) = @$name if ref $name eq 'ARRAY';
 
-<body>
-<h1>Terminal colours</h1>
+       my $out = sprintf('<td title="%s" style="%s">%s',
+               join(',', map { int } @$col),
+               "background:$css; color:$inverse; padding:0 1ex",
+               $name,
+       );
+       $out .= sprintf '<td style="%s"><code>%s</code>', "background:$_; color:$css", $minhex
+               for @$sample;
+       return "$out\n";
+}
 
-<table>
-<:
-sub luminance {
-       # perceived brightness (using ITU-R recommendation 601 luma co-efficients)
-       my ($r, $g, $b) = @_;
-       return $r*.299 + $g*.587 + $b*.114;
+if ($get{v}) {
+       my %reorder = (
+               arnegame => [ 0,5,9,12 , 3,6,10,13,1 , 4,7,8,11,14,15,2 ],
+               arnegame => [ 0,3,10,6,12,9,13,1 , 5,7,11,8,14,4,15,2 ],
+               c64 => [ 0,2,5,9,6,4,3,15 , 11,10,13,7,14,8,12,1 ],
+               msx2 => [ 0,6,2,10,4,13,7,14 , 1,8,3,11,5,9,12,15 ],
+               risc => [ 7,11,13,14,8,12,15,1, 6,5,10,9,4,3,2,0],
+               mac2 => [ 15,3,9,11,6,5,7,12 , 14,2,8,1,13,4,10,0 ],
+       );
+       $reorder{$_} = $reorder{msx2} for qw( msx1 arnejmp );
+       while (my ($name, $order) = each %reorder) {
+               for my $pal ( $palettes->{$name}) {
+                       $pal = [ map { $pal->[$_ + 1] =~ s/:|$/:$_/r } -1, @{$order} ];
+               }
+       }
 }
 
-sub colcell {
-       my $id = shift;
-       my @rgb = @_ >= 3 ? @_ : (map {hex} $_[0] =~ /(..)/g);
-       my $rgb24 = '';
-       $rgb24 .= sprintf '%X', min($_ / 17 + .5, 15) for @rgb[0..2];
-       my $rgb48 = '';
-       $rgb48 .= sprintf '%02X', $_ for @rgb[0..2];
-       my $inverse = sprintf('%X', luminance(@rgb)/255 < .3 ? 12 : 0) x 3;
-       return sprintf '<td style="%s; padding:0 1ex">%s<td style="%s">%s<td style="%s">%s',
-               "background:#$rgb48; color:#$inverse",
-               $id,
-               "background:#000; color:#$rgb48",
-               $rgb24,
-               "background:#FFF; color:#$rgb48",
-               $rgb24,
+my @termlist = qw( cga xterm tango app html xkcd );
+push @termlist, qw( c64 msx2 mac2 risc arnegame ) if exists $get{v};
+for my $term (@termlist) {
+       my ($info, @index) = @{ $palettes->{$term} };
+       my $caption = $info->{name} // $term;
+       $caption = sprintf('<%s %s>%s</%1$s>',
+               $info->{href} ? 'a' : 'span',
+               join(' ',
+                       map { sprintf '%s="%s"', $_, $info->{$_} }
+                       grep { defined $info->{$_} }
+                       qw( href title )
+               ),
+               $caption,
+       ) if $info->{href} or $info->{title};
+
+       print '<table>', "\n";
+       printf "<caption>%s</caption>\n", $caption;
+       for my $num (0 .. $#index) {
+               my ($rgb, $name) = split /:/, $index[$num], 3;
+               $name ||= $num;
+               $name = [ $name, ['#333'] ] if $term eq 'xkcd';
+               print '<tr>', colcell($name, $rgb);
+       }
+       print "</table>\n\n";
 }
 
-my %col = (
-       -name => [
-               qw/black maroon green olive  navy purple  cyan silver
-                  gray  red    lime  yellow blue fuchsia aqua white/,
-               qw/reset bold dim italic underline blink fastblink
-                  reverse hidden/,
-       ],
-       html => [
-               qw/000000 CCCCCC/,
-               qw/000000 800000 008000 808000 000080 800080 008080 C0C0C0
-                  808080 FF0000 00FF00 FFFF00 0000FF FF00FF 00FFFF FFFFFF/,
-       ],
-       cga => [
-               qw/000000 CCCCCC/,
-               qw/000000 AA0000 00AA00 AA5500 0000AA AA00AA 00AAAA AAAAAA
-                  555555 FF5555 55FF55 FFFF55 5555FF FF55FF 55FFFF FFFFFF/,
-       ],
-       xterm => [
-               qw/000000 CCCCCC/,
-               qw/000000 CC0000 00CC00 CCCC00 4682B4 CC00CC 00CCCC E5E5E5
-                  4C4C4C FF0000 00FF00 FFFF00 1E90FF FF00FF 00FFFF FFFFFF/,
-       ],
-       tango => [
-               qw/000000 CCCCCC/,
-               qw/2E3436 CC0000 4E9A06 C4A000 3465A4 75507B 06989A D3D7CF
-                  555753 EF2929 8AE234 FCE94F 729FCF AD7FA8 34E2E2 EEEEEC/,
-       ],
-);
-
-my @termlist = qw(html cga xterm tango);
-print '<tr>', (map {'<th colspan="3">'.$_} @termlist), "</tr>\n";
-for my $num (0 .. 15) {
-       printf('<tr>%s</tr>'."\n",
-               join('', map {
-                       my $rgb = $col{$_}[$num + 2];
-                       colcell($_ eq 'html' ? $col{-name}[$num] : $num, $rgb, $col{$_}[0])
-               } @termlist ),
-       );
+if (exists $get{v}) {
+       print "<table class=mapped>\n";
+       print "<caption>Amstrad CPC</caption>\n";
+       print coltable_hsv(3, sub {
+               $_[2] + 3 * ($_[0] + 3 * $_[1]),
+               map { $_ && $_ * 127 + 1 } @_
+       });
+       print "</table>\n\n";
 }
-:></table>
+:></div>
+
+<hr>
 
-<h2>88-colour space</h2>
-<table>
+<div class="section">
 <:
-for my $r (0 .. 3) {
-       print '<tr>';
-       for my $g (0 .. 3) {
-               for my $b (0 .. 3) {
-                       print colcell($r*4*4 + $g*4 + $b + 16, map {(0, 139, 205, 255)[$_]} $r, $g, $b);
+sub coltable_hsv {
+       my ($dim, $rgbval, $greyramp) = @_;
+
+       my $hmax = 2 * $dim * 3;  # each face of the rgb cube
+       my $vmax = $dim - 1;
+       my $smax = $dim - 1;
+       $rgbval ||= sub { join('', @_), map { int $_ * 255 / $vmax } @_ };
+       $greyramp ||= [];
+
+       my %greymap;  # name => value
+       my @colmap;  # saturation => value => hue => [name, r,g,b]
+       my $offset = 16 * ($dim > 3);
+
+       for my $r (0 .. $dim - 1) {
+               for my $g (0 .. $dim - 1) {
+                       for my $b (0 .. $dim - 1) {
+                               my @rgb = ($r, $g, $b);
+
+                               my $h = Shiar_Sheet::Colour->new(@rgb)->hue * $hmax;
+                               my $v = max(@rgb);
+                               my $s = abs(min(@rgb) - max(@rgb));
+
+                               if (!$s) {
+                                       my ($index, $l) = $rgbval->(@rgb);
+                                       $greymap{$index} = $l;
+                                       next;
+                               }
+
+                               $v = $vmax - $v;
+                               $s = $smax - $s - $v;
+
+                               $colmap[$s][$v][$h] = [ $rgbval->(@rgb) ];
+                       }
                }
        }
-       print "\n";
+
+       my $out = '';
+       $out .= sprintf '<colgroup span=%d>', 3 * @{$_} for @colmap;
+       my $huerow = $colmap[0][0]; # first {$_} map { @{$_} } @colmap;
+       for my $h (grep { $huerow->[$_] } 0 .. $#{$huerow}) {
+               $out .= '<tr>';
+               $out .= colcell(@$_) for map { $_->[$h] } map { @{$_} } @colmap;
+       }
+
+       $offset += $dim ** 3;
+       $greymap{$offset++} = $_ for @{$greyramp};
+
+       $out .= '<tbody>';
+       my $col = 0;
+       my $colbreak = scalar map { @$_ } @colmap;  # same width as hue rows
+       for my $num (sort { $greymap{$a} <=> $greymap{$b} } keys %greymap) {
+               $out .= '<tr>' unless $col++ % $colbreak;
+               $out .= colcell($num, ($greymap{$num}) x 3);
+       }
+
+       return $out;
+}
+
+{
+       print "<h2>88-colour space</h2>\n";
+       print "<table class=mapped>\n";
+       print coltable_hsv(4,
+               sub {
+                       $_[2] + 4 * ($_[1] + 4 * $_[0]) + 16,
+                       map { (0, 139, 205, 255)[$_] } @_
+               },
+               [map { ($_ + 2 + ($_>0)) * 255/11 } 0 .. 7],
+       );
+       print "</table>\n";
+}
+
+if ($ENV{PATH_INFO} =~ /256/) {
+       print "<h2>256-colour space</h2>\n";
+       print "<table class=mapped>\n";
+       print coltable_hsv(6,
+               sub {
+                       $_[2] + 6 * ($_[1] + 6 * $_[0]) + 16,
+                       map { $_ && $_*40 + 55 } @_
+               },
+               [ map { $_ * 10 + 8 } 0 .. 23 ],
+       );
+       print "</table>\n";
 }
-print "\n";
-print '<tr>', map { colcell(80, ($_) x 3) } 46, 92, 115, 139, 162, 185, 208, 231;
-:></table>
+:></div>
+<hr>