termcol: declare palette titles in extensible metadata hashes
[sheet.git] / termcol.plp
index b018685f9794fc3207cc329821b8d938ad2a5da2..686316cf8f8f1cb9b3cb6734913147991c001f9b 100644 (file)
@@ -2,7 +2,7 @@
 
 Html({
        title => 'terminal colour cheat sheet',
-       version => 'v1.0',
+       version => '1.0',
        description => [
                "Index of all terminal/console colour codes,",
                "with an example result of various environments.",
@@ -10,18 +10,33 @@ Html({
        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.
+<:
+print
+       !exists $get{v} ? 'Also see <a href="?v">8-bit legacy hardware</a> palettes.' :
+       'Also included are 8-bit legacy hardware palettes.';
+:>
+</p>
+
 <div class="section">
 <:
-use Shiar_Sheet::Colour;
+use Shiar_Sheet::Colour '1.03';
+use List::Util qw( min max );
+
+my $palettes = do 'termcol.inc.pl';
+die "Cannot open palette data: $_\n" for $@ || $! || ();
 
 sub colcell {
-       my $name = shift;
+       my $name = shift // return "<td colspan=3>\n";
        my $col = Shiar_Sheet::Colour->new(@_);
        my $minhex = $col->rgb24;
        my $css     = '#' . $col->rgb48;
@@ -35,120 +50,152 @@ sub colcell {
                "background:$css; color:$inverse; padding:0 1ex",
                $name,
        );
-       $out .= sprintf '<td style="%s">%s', "background:$_; color:$css", $minhex
+       $out .= sprintf '<td style="%s"><code>%s</code>', "background:$_; color:$css", $minhex
                for @$sample;
        return "$out\n";
 }
 
-my %col = (
-       -html => [
-               sprintf('<a title="%s" href="%s">html</a>',
-                       'HTML keywords (inherited by CSSā‰„2.1 and SVG), mostly identical to X11',
-                       'http://www.w3.org/TR/css3-color/#html4',
-               ),
-               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/,
-       ],
-       -xkcd => [
-               sprintf('<a title="%s" href="%s">xkcd</a>',
-                       'human averages in xkcd survey results',
-                       'http://blog.xkcd.com/2010/05/03/color-survey-results/',
+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} ];
+               }
+       }
+}
+
+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 )
                ),
-               qw/black  maroon green  olive  navy   purple teal   silver
-                  grey   red    lime   yellow blue  fuchsia cyan   white/,
-       ],
-       xkcd => [
-               0,0,
-               qw/000000 650021 15b01a 6e750e 01153e 7e1e9c 029386 c5c9c7
-                  929591 e50000 aaff32 ffff14 0343df ed0dd9 00ffff ffffff/,
-       ],
-);
+               $caption,
+       ) if $info->{href} or $info->{title};
 
-for my $term (qw/cga xterm tango html xkcd/) {
        print '<table>', "\n";
-       printf "<caption>%s</caption>\n", $col{"-$term"}[0] || $term;
-       for my $num (0 .. 15) {
-               my $rgb = $col{$term}[$num + 2];
-               my $name = $col{"-$term"}[$num + 1] || $num;
+       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";
 }
+
+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";
+}
 :></div>
 
 <hr>
 
 <div class="section">
-<h2>88-colour space</h2>
 <:
-for my $r (0 .. 3) {
-       print '<table>';
-       for my $g (0 .. 3) {
-               print '<tr>';
-               for my $b (0 .. 3) {
-                       my $index = $r*4*4 + $g*4 + $b + 16;
-                       print colcell($index, 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 "</table>\n";
-}
-print "\n";
 
-print '<table><tr>';
-print colcell(80+$_, (($_ + 2 + ($_>0)) * 255/11) x 3) for 0 .. 7;
-print "</table>\n\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;
+       }
 
-:></div>
-<: if ($ENV{PATH_INFO} =~ /256/) { :>
-<hr>
+       $offset += $dim ** 3;
+       $greymap{$offset++} = $_ for @{$greyramp};
 
-<div class="section">
-<h2>256-colour space</h2>
-<:
-for my $r (0 .. 5) {
-       print '<table>';
-       for my $g (0 .. 5) {
-               print '<tr>';
-               for my $b (0 .. 5) {
-                       my $index = $r*6*6 + $g*6 + $b + 16;
-                       print colcell($index, map { $_ && $_*40 + 55 } $r, $g, $b);
-               }
+       $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);
        }
-       print "</table>\n";
+
+       return $out;
 }
-print "\n";
 
-for my $row (0, 12) {
-       print '<table><tr>';
-       print colcell(232+$_, ($_*10 + 8) x 3) for $row .. $row+11;
+{
+       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";
 }
-print "\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";
+}
 :></div>
-<: } :>
 <hr>