common: bump version to 1.11
[sheet.git] / termcol.plp
index 4de11c6..c510cd2 100644 (file)
@@ -1,27 +1,54 @@
 <(common.inc.plp)><:
 
 Html({
-       title => 'terminal colour cheat sheet',
-       version => '1.0',
-       description => [
+       title => ($Request ? 'terminal colour' : 'colour palettes') . ' cheat sheet',
+       version => '1.2',
+       description => [!$Request ? "Comparison of various colour palettes." : (
                "Index of all terminal/console colour codes,",
                "with an example result of various environments.",
-       ],
+       )],
        keywords => [qw'
-               color code terminal console escape table xterm rxvt
+               color colour code terminal console escape table xterm rxvt
+               ansi vt100 8bit 4bit cga ega vga rgb hsv game emulator display
        '],
+       data => ['termcol.inc.pl'],
        stylesheet => [qw'light dark'],
 });
 
+my @draw = map { [$_, s/\W+\z//] } grep { $_ } split m(/),
+       $get{img} // exists $get{img} && 'indi.png';
+
+my @termlist;
+push @termlist, split /\W+/, $Request || 'default';
+
+say "<h1>$_</h1>\n" for $Request ? 'Colour palettes' : 'Terminal colours';
+
+say '<p>';
+if ("@termlist" eq 'default') {
+       say '<span title="ECMA-48">ANSI</span> (VT100, ISO-6429) 16-colour text palette';
+       say 'as implemented by various systems and programs.';
+       say 'Also see <a href="/termcol/legacy">8-bit legacy hardware</a> palettes.';
+}
+elsif ("@termlist" eq 'legacy') {
+       say 'Colour palettes of various 8-bit legacy systems and retro games.';
+       say 'Also see <a href="/termcol">ANSI console</a> palettes.';
+}
+else {
+       say 'Comparison of requested colour palettes.';
+}
 :>
-<h1>Terminal colours</h1>
 
 <div class="section">
 <:
-use Shiar_Sheet::Colour '1.01';
+use Shiar_Sheet::Colour 1.04;
+use List::Util qw( min max );
+use POSIX qw( ceil );
+
+my $palettes = do 'termcol.inc.pl';
+die "Cannot open palette data: $_\n" for $@ || $! || ();
 
 sub colcell {
-       my $name = shift;
+       my $name = shift // return "<td>\n";
        my $col = Shiar_Sheet::Colour->new(@_);
        my $minhex = $col->rgb24;
        my $css     = '#' . $col->rgb48;
@@ -32,185 +59,213 @@ sub colcell {
 
        my $out = sprintf('<td title="%s" style="%s">%s',
                join(',', map { int } @$col),
-               "background:$css; color:$inverse; padding:0 1ex",
+               "background:$css; color:$inverse",
                $name,
        );
-       $out .= sprintf '<td style="%s"><code>%s</code>', "background:$_; color:$css", $minhex
-               for @$sample;
+       $out .= sprintf('<samp style="%s"><small>%s</small></samp>',
+               "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/000000:black 800000:maroon  008000:green 808000:olive
-                  000080:navy  800080:purple  008080:cyan  C0C0C0:silver
-                  808080:gray  FF0000:red     00FF00:lime  FFFF00:yellow
-                  0000FF:blue  FF00FF:fuchsia 00FFFF:aqua  FFFFFF:white /,
-       ],
-       cga => [
-               undef,  # linux console, kde?
-               qw/000000 AA0000 00AA00 AA5500 0000AA AA00AA 00AAAA AAAAAA
-                  555555 FF5555 55FF55 FFFF55 5555FF FF55FF 55FFFF FFFFFF/,
-#              qw/reset bold dim italic underline blink fastblink reverse hidden/,
-       ],
-       xterm => [
-               undef,  # rxvt except for blues
-               qw/000000 CC0000 00CC00 CCCC00 4682B4 CC00CC 00CCCC E5E5E5
-                  4C4C4C FF0000 00FF00 FFFF00 1E90FF FF00FF 00FFFF FFFFFF/,
-       ],
-       tango => [
-               undef,  # default Gnome theme
-               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/',
-               ),
-               qw/000000:black 650021:maroon  15b01a:green 6e750e:olive
-                  01153e:navy  7e1e9c:purple  029386:teal  c5c9c7:silver
-                  929591:grey  e50000:red     aaff32:lime  ffff14:yellow
-                  0343df:blue  ed0dd9:fuchsia 00ffff:cyan  ffffff:white /,
-       ],
-       android => [
-               sprintf('<a href="%s" title="%s">android</a>',
-                       'http://developer.android.com/guide/practices/ui_guidelines/icon_design.html',
-                       'recommended colour palette for Android icons',
-               ),
-               qw/FFFFFF:white   BFBFBF:light   808080:medium  404040:dark
-                  000000:black   6699FF:blue1   3366CC:blue2   003399:blue3
-                  99CC33:green1  00CC00:green2  669933:green3  FFCC00:orange1
-                  FF9900:orange2 FF6600:orange3 CC0000:red /,
-       ],
-       app => [
-               'Term.app',
-               qw/000000 C23621 25BC24 ADAD27 492EE1 D338D3 33BBC8 CBCCCD
-                  818383 FC391F 31E722 EAEC23 5833FF F935F8 14F0F0 E9EBEB /,
-       ],
-       putty => [
-               'PuTTY',
-               qw/000000 BB0000 00BB00 BBBB00 0000BB BB00BB 00BBBB BBBBBB
-                  555555 FF5555 55FF55 FFFF55 5555FF FF55FF 55FFFF FFFFFF /,
-       ],
-       slutty => [
-               sprintf('<a href="%s" title="%s">SluTTY</a>',
-                       'http://www.npjh.com/slutty.html',
-                       'PuTTY fork with light colour scheme',
+sub img_egapal {
+       my ($palette, $imgfile, $reindex) = @_;
+       return eval {
+               require Imager;
+               require MIME::Base64;
+
+               my @imgpal = map { Imager::Color->new(ref $_ ? @$_ : $_) } @{$palette};
+               state $imgcache = {};
+               my $img = $imgcache->{$imgfile}
+                       //= Imager->new(file => "data/palimage/$imgfile")
+                       or die Imager->errstr.$/;
+
+               do {
+                       if ($reindex) {
+                               $img->to_paletted({
+                                       make_colors => 'none',
+                                       colors => \@imgpal,
+                                       translate => 'closest',
+                               });
+                       }
+                       else {
+                               @{[ $img->getcolors ]} == @imgpal
+                                       or die "incompatible palette size\n";
+                               $img->setcolors(colors => \@imgpal);
+                               $img;
+                       }
+               }->write(data => \my $imgdata, type => 'png');
+               return sprintf '<img src="data:image/png;base64,%s">',
+                       MIME::Base64::encode_base64($imgdata);
+       } || $@;
+}
+
+sub coltable {
+       my ($term) = @_;
+       my $info = $palettes->{$term};
+
+       if (ref $info eq 'ARRAY') {
+               coltable($_) for @{$info};
+               return;
+       }
+
+       if (ref $info eq 'CODE') {
+               coltable($_) for $info->($palettes);
+               return;
+       }
+
+       ref $info eq 'HASH' or return;
+       my $order = $get{order} && $get{order}.'order';
+       my $reorder = $info->{$order} // $palettes->{ $info->{parent} }->{$order};
+
+       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/000000 9C1D1D 6C9446 AC9A47 335786 8F6496 486768 E0DCDC
-                  2F2F2F CD5757 8FC35B D1C45E 5C81A9 BC95B7 76CBCB EEEEEC /,
-       ],
-       mac2 => [
-               'MacII',
-               qw/FFFFFF FBF305 FF6403 DD0907 F20884 4700A5 0000D3 02ABEA
-                  1FB714 006412 562C05 90713A C0C0C0 808080 404040 000000 /,
-       ],
-       risc => [
-               'RISC',  # v2/3
-               qw/FFFFFF DDDDDD BBBBBB 999999 777777 555555 333333 000000
-                  004499 EEEE00 00CC00 DD0000 EEEEBB 558800 FFBB00 00BBFF /,
-       ],
-       c64 => [
-               'C=64',  # commodore 64/128
-               map {
-                       # 5-bit luma ± 2-bit colour angle
-                       my ($y, $neg, $hue) = split /(-)|\+/;
-
-                       # convert to yuv
-                       my ($u, $v) = (0, 0);
-                       if (defined $hue) {
-                               my $RAD = 3.14159;
-                               $hue *= $RAD / 8;
-                               $hue += $RAD if $neg;
-                               $u = cos $hue;
-                               $v = sin $hue;
+               $caption,
+       ) if $info->{href} or $info->{title};
+
+       if ($info->{table} or $info->{rgbmap}) {
+               say '<table class="color mapped">';
+               say sprintf '<caption>%s</caption>', $caption;
+
+               print coltable_hsv(@{$_}) for $info->{rgbmap} || ();
+
+               if (my $table = $info->{table}) {
+                       $table = [ @{$table}[@{$reorder}] ] if $reorder;
+
+                       for my $row (@$table) {
+                               if (!$row) {
+                                       say '<tbody>';
+                                       next;
+                               }
+                               print '<tr>';
+                               print colcell(ref $_ ? @$_ : $_ ? reverse split /:/ : undef) for @$row;
                        }
 
-                       # convert to rgb
-                       $y *= 255 / 32;
-                       $_ = $_ * 127.5 + 128 for $u, $v;
-                       Shiar_Sheet::Colour->newyuv($y, $u, $v)->rgb48;
+                       if (@draw) {
+                               my $width = scalar @{ $table->[0] };
+                               my @imgpal = map {
+                                       [ ref $_ ? @{$_}[1 .. 3] : map {hex} /(..)(..)(..)/ ]
+                               } map { @{$_} } @{$table};
+                               for (@draw) {
+                                       print "<tr><td colspan=$width>", img_egapal(\@imgpal, @{$_});
+                               }
+                       }
                }
-               qw/ 0    32  10+5 20-5 12+2 16-2 8+0  24-0
-                   12+6 8+7 16+5 10   15   24-2 15+0 20 /,
-       ],
-       msx => [
-               'MSX',
-               map { s{([0-7])}{sprintf '%02X', $1 / 7 * 255}egr }
-               qw/ 000 000 161 373 117 237 511 267
-                   711 733 661 663 141 625 555 777 /,
-       ],
-);
-
-for my $term (qw/cga xterm tango app html xkcd/) {
-       print '<table>', "\n";
-       printf "<caption>%s</caption>\n", $col{$term}[0] || $term;
-       for my $num (1 .. $#{ $col{$term} }) {
-               my ($rgb, $name) = split /:/, $col{$term}[$num], 2;
-               $name ||= $num - 1;
-               $name = [ $name, ['#333'] ] if $term eq 'xkcd';
-               print '<tr>', colcell($name, $rgb);
+
+               say "</table>\n";
        }
-       print "</table>\n\n";
-}
-:></div>
 
-<hr>
+       if (my $palette = $info->{list}) {
+               my $colours = colorder($palette, $reorder);
 
-<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);
+               my $rows = 8;
+               my $columns = ceil(@{$palette} / $rows);
+
+               say '<table class=color>';
+               say sprintf '<caption>%s</caption>', $caption;
+               for my $row (0 .. $rows - 1) {
+                       print '<tr>';
+                       for my $col (0 .. $columns - 1) {
+                               my $num = $row + $col * $rows;
+                               my ($rgb, $name) = split /:/, $colours->[$num], 3;
+                               $name //= $rgb && $num;
+                               $name = [ $name, [] ] if $term =~ /^msx/ and !$name;  # no bg for transparency
+                               $name = [ $name, ['#333'] ] if $term eq 'xkcd';
+                               print colcell($name, $rgb);
+                       }
+               }
+
+               for (@draw) {
+                       my $imgpal = colorder($palette,
+                               $info->{ansiorder} // $palettes->{ $info->{parent} }->{ansiorder}
+                       );
+                       print "<tr><td colspan=$columns>", img_egapal($imgpal, @{$_});
                }
+               say "</table>\n";
        }
-       print "</table>\n";
 }
-print "\n";
 
-print '<table><tr>';
-print colcell(80+$_, (($_ + 2 + ($_>0)) * 255/11) x 3) for 0 .. 7;
-print "</table>\n\n";
+sub colorder {
+       my ($palette, $reorder) = @_;
+       return [ map { $palette->[$_] =~ s/:(?![^:])|$/:$_/r } @{$reorder} ]
+               if $reorder;
+       return $palette;
+}
 
-:></div>
-<: if ($ENV{PATH_INFO} =~ /256/) { :>
-<hr>
+sub coltable_hsv {
+       my ($dim, $rgbval, $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);
+       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 } @_ };
+
+       my @greymap = @{$greyramp || []};  # [name, r, g=l, b]
+       my @colmap;  # saturation => value => hue => [name, r,g,b]
+
+       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, $s, $v) = Shiar_Sheet::Colour->new(@rgb)->hsv;
+
+                               if (!$s) {
+                                       if (@greymap) {
+                                               push @greymap, [ $rgbval->(@rgb) ];
+                                               next;
+                                       }
+
+                                       $h = 1;  # greyscale hue
+                                       $s = $smax - $v + 1;  # spread brightness over saturation groups
+                                       $v &&= $smax  # highest saturation
+                                               or $v = $s = 1;  # black at initial column
+                               }
+
+                               $h *= $hmax;
+                               $v = $vmax - $v;
+                               $s = $smax - $s - $v;
+
+                               $colmap[$s][$v][$h] = [ $rgbval->(@rgb) ];
+                       }
                }
        }
-       print "</table>\n";
-}
-print "\n";
 
-       print '<table>';
-for my $row (0, 12) {
-       print '<tr>';
-       print colcell(232+$_, ($_*10 + 8) x 3) for $row .. $row+11;
+       my $out = '';
+       $out .= sprintf '<colgroup span=%d>', scalar @{$_} 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 { reverse @{$_} } @colmap;
+       }
+
+       if (@greymap) {
+               $out .= '<tbody>';
+               my $col = 0;
+               my $colbreak = scalar map { @$_ } @colmap;  # same width as hue rows
+               for my $cell (sort { $a->[1] <=> $b->[1] || $a->[0] <=> $b->[0] } @greymap) {
+                       $out .= '<tr>' unless $col++ % $colbreak;
+                       $out .= colcell(@{$cell});
+               }
+       }
+
+       if (@draw) {
+               my @palette = map { [ @{$_}[1 .. 3] ] } @greymap, map {@$_} map {@$_} @colmap;
+               my $tablespan = scalar map { @$_ } @colmap;
+               my $imgdata = img_egapal(\@palette, @{ $draw[0] });
+               $out .= "<tr><td colspan=$tablespan>$imgdata";
+       }
+
+       return $out;
 }
-       print "</table>\n";
-print "\n";
 
+coltable($_) for @termlist;
 :></div>
-<: } :>
 <hr>