chiark / gitweb /
Move a lot of files into the utils tree
[reprap-play.git] / commitid.scad.pl
deleted file mode 100755 (executable)
index a0c33e4121c6deac5ca8c3ba6f199462748d0cc3..0000000000000000000000000000000000000000
+++ /dev/null
@@ -1,522 +0,0 @@
-#!/usr/bin/perl -w
-use strict;
-
-$SIG{__WARN__} = sub { die @_; };
-
-#  xxx much of the comment below is TODO
-#
-# Usage:
-#
-#   .../commitid.scad.pl [OPTION...] [STRING...] >commitid.scad.new \
-#     && mv -f commitid.scad.new commitid.scad
-#
-# Options:
-#
-#   --git    generate git commit indications, as shown below
-#            (this is the default if no strings are requested with -t)
-#
-#   --git=object
-#            generate git commit indication based on commit object only
-#            (ie avoid counting commits)
-#
-#   -i       do not generate `+' if git-untracked files are present
-#
-#   [-t[FORM]] TEXT
-#            generate a form FORM containing TEXT
-#            TEXT can contain newlines (final newline usually undesirable)
-#            if FORM not specified, generates Arg0 Arg1 Arg2 in sequence
-#            character set is SPC 0-9 a-f + *
-#
-# We generate a physical indication of which commit was used.
-#
-# We provide for scaling factors with dynamic variables:
-#    $Commitid_pixelsz        if not set, we use 0.8 } multiplied
-#    $Commitid_scale          if not set, we use 1.0 }  together
-#    $Commitid_depth          if not set, we use xy pixel size from above / 2
-#    $Commitid_depth_scale    if not set, we use 1.0 (multiplies depth above)
-#    $Commitid_max_best_scale if not set, we use 2.0 (max mult of xy in Best)
-#
-# For each form we have
-#
-#    module Commitid_Form_2D() { ... }
-#    module Commitid_Form() { ... }
-#    function Commitid_Form_sz()     => [ x, y ]
-#
-#  These have their origin in the bottom left corner.  The 3D model
-#  is a positive, has its origin halfway through, and is twice the
-#  depth in height, so it can be added or subtracted.
-#
-# And we provide
-#
-#   function Commitid_pixelsz()    // $Commitid_pixelsz * $Commitid_scale
-#   function Commitid_depth()      // see above
-#
-# We can generate these forms:
-#
-#  In each case:
-#    if tree is dirty, * is suffixed or prefixed to count or commitid
-#    if tree has untracked files, + is added
-#    (where it is added depends on the Form; in any case it does not
-#    change the size, but steals space from digits)
-#
-#   Small2 Small3 ... Small10:
-#       git rev-list --first-parent --count HEAD
-#       typically 3-4 characters but we allow for up to 6
-#       padded with zeroes; if too long we reduce mod 10^n
-#       eg if the count is 123456
-#            Small5    3456*
-#            Small8    _*123456    (where _ are spaces)
-#       the git objectid is included if it will fit
-#       unambiguously and usefully eg
-#            Small9    ab*123456
-#
-#   Small2S Small4S ... Small10S:
-#   Small3T Small9T:
-#       same but split into two lines (S) or three lines (T) eg
-#            Small4S  45     Small6T   _3
-#                     6*               45
-#                                      6*
-#
-#   Git2 Git3 ... Git10:
-#   Git4S Git6S ... Git10S:
-#   Git6T Git9T:
-#       git-rev-parse HEAD   (prefix of requested length)
-#       eg if the commitid is abcdef0123...
-#            Git5    abcd*
-
-#   Full4 Full6 ... Full20:
-#       git-rev-list --first-parent --count HEAD
-#       git-rev-parse HEAD
-#       (all on two lines)
-#       eg
-#            Full6    abcdef       Full8     abcdef01
-#                     23456*                 _123456*
-#
-#   Full6T Full9T ... Full30T
-#       as Full but commit is split over two lines
-#       for a 3-line message; eg
-#             Full9T    abc
-#                       de*
-#                       456
-#
-#   FontDemo
-#
-#   Arg0, Arg1, ...
-#       Strings passed on command line
-
-sub p { print @_ or die $!; }
-
-p <<'END';
-// *** AUTOGENERATED - DO NOT EDIT *** //
-function Commitid_pixelsz() =
-  ($Commitid_pixelsz       ? $Commitid_pixelsz       : 0.8) *
-  ($Commitid_scale         ? $Commitid_scale         : 1.0);
-function Commitid_depth() =
-  ($Commitid_depth         ? $Commitid_depth         : Commitid_pixelsz()/2) *
-  ($Commitid_depth_scale   ? $Commitid_depth_scale   : 1.0);
-function Commitid__scale() =
-  Commitid_pixelsz() / 0.2;
-END
-
-sub chrmodname ($) {
-    my ($chr) = @_;
-    my $chrx = sprintf '%#x', ord $chr;
-    return "Commitid__chr_$chrx";
-}
-
-our $gtm_demo_i = -1;
-our $gtm_demo_j;
-our @gtm_demo_o;
-
-sub gentextmodule_demo_start_batch () {
-    $gtm_demo_j = 0;
-    $gtm_demo_i++;
-}
-
-sub gentextmodule ($@) {
-    my ($form, @lines) = @_;
-    my $modb = "Commitid_$form";
-    p "module ${modb}_2D(){\n";
-    p " // |$_|\n" foreach @lines;
-    p " scale(Commitid__scale()){\n";
-    my $y = @lines;
-    my $cols = 1;
-    foreach my $line (@lines) {
-       $y--;
-       my $x = 0;
-       foreach my $chr (split //, $line) {
-           p sprintf "  translate([%d * 0.8, %d * 1.2]) %s();\n",
-               $x, $y, chrmodname $chr
-               if $chr =~ m/\S/;
-           $x++;
-       }
-       $cols = $x if $x > $cols;
-    }
-    p " }\n";
-    p "}\n";
-    p "module ${modb}(){\n";
-    p " d=Commitid_depth();\n";
-    p " translate([0,0,-d]) linear_extrude(height=d*2) ${modb}_2D();\n";
-    p "}\n";
-
-    p sprintf "function %s_sz() = Commitid__scale() * 0.1 * [ %d, %d ];\n",
-       $modb, 2 * ($cols * 4 - 1), 2 * (@lines * 6 - 1);
-
-    push @gtm_demo_o, <<END;
- translate([$gtm_demo_i * st[0], $gtm_demo_j * st[1]]) {
-  difference(){
-   color("blue") translate([-e,-e]) square(${modb}_sz() + 2*[e,e]);
-   square(${modb}_sz());
-  }
-  ${modb}_2D();
-}
-END
-    $gtm_demo_j++;
-}
-
-our @demo;
-
-sub parsefont () {
-    my %cellmap;
-    for (;;) {
-       $_ = <DATA> // die;
-       last if %cellmap && !m/\S/;
-       next unless m/\S/;
-       chomp;
-       s{^(.) }{};
-       $cellmap{$1} = $_;
-    }
-    my %chrpolys;
-    while (<DATA>) {
-       next unless m/\S/;
-       chomp;
-       my @chrs = split / /, $_;
-       <DATA> !~ m/\S/ or die;
-       foreach my $row (reverse 0..4) {
-           $_ = <DATA>;
-           chomp;
-           s{^}{ };
-           $_ .= ' ' x 8;
-           m{\S/\S} and die;
-           s{/(?=\s)}{L}g;
-           s{/(?=\S)}{r}g;
-           s{\\(?=\s)}{l}g;
-           s{\\(?=\S)}{R}g;
-           p "// $_\n";
-           foreach my $chr (@chrs) {
-               s{^ }{} or die "$chr $_ ?";
-               foreach my $col (0..2) {
-                   my @verts;
-                   if (s{^ }{}) {
-                   } elsif (s{^\S}{}) {
-                       my $f = $cellmap{$&};
-                       die unless $f;
-                       $f =~ s/\b\d/ sprintf '%05d', $col*2000 + $&*1025 /ge;
-                       $f =~ s/\d\b/ sprintf '%05d', $row*2000 + $&*1025 /ge;
-                       push @{ $chrpolys{$chr} }, [ split / /, $f ];
-                   } else {
-                       die "$_ ?";
-                   }
-               }
-           }
-           die "$_ ?" if m{\S};
-       }    
-    }
-
-    my $demo = '';
-    my $democols = 6;
-    foreach my $chr (sort keys %chrpolys) {
-       my $mod = chrmodname $chr;
-       p "module $mod () {\n";
-       foreach my $poly (@{ $chrpolys{$chr} }) {
-           p " polygon([";
-           my $delim = "";
-           foreach my $pt (@$poly) {
-               p $delim;
-               $pt =~ s{\d{5}}{$&,};
-               $pt =~ s{\b\d}{$&.}g;
-               p "[$pt]";
-               $delim = ',';
-           }
-           p "]);\n";
-       }
-       p "}\n";
-       $demo .= $chr;
-    }
-    @demo = reverse $demo =~ m{.{1,$democols}}go;
-}
-
-parsefont();
-
-our $do_git; # contains may chars 'c' (count) and/or 'o' (object)
-our $do_git_untracked = 1;
-our $argcounter;
-
-our @forms;
-
-sub rjustt ($$;$) { # right justify and truncate (ie, pad and truncate at left)
-                    # always includes prefix
-    my ($sz, $whole, $prefix) = @_;
-    $prefix //= '';
-    my $lw = length $whole;
-    my $spare = $sz - $lw - (length $prefix);
-    return
-       ($spare > 0 ? (' ' x $spare) : '').
-       $prefix.
-       substr($whole, ($spare < 0 ? -$spare : 0));
-}
-
-sub ljustt ($$;$) {
-    my ($sz, $whole, $suffix) = @_;
-    $suffix //= '';
-    $sz -= length $suffix;
-    return sprintf "%-${sz}.${sz}s%s", $whole, $suffix;
-}
-
-sub genform ($@) {
-    my ($form, @lines) = @_;
-    gentextmodule($form, @lines);
-    my $f = {
-       Form => $form,
-       Chars => (length join '', @lines),
-       Lines => (scalar @lines),
-       Ambiguous => ($form =~ m/Full/ && !grep { m/\W/ } @lines),
-    };
-    push @forms, $f;
-}
-
-sub genform_q ($$$) {
-    my ($form, $s, $lines) = @_;
-    $gtm_demo_j++;
-    my $l = length $s;
-    return if $l % $lines;
-    my $e = $l/$lines;
-    return if $e < 2;
-    $gtm_demo_j--;
-    genform($form, $s =~ m/.{$e}/g);
-}
-
-sub genform_plusq ($$) {
-    my ($form, $s) = @_;
-    genform($form, $s);
-    genform_q("${form}S", $s, 2);
-    genform_q("${form}T", $s, 3);
-}
-
-our @gcmd;
-
-sub gitrun_start () {
-    open F, "-|", @gcmd or die "$gcmd[0]: start: $!";
-}
-
-sub gitrun_done (;$) {
-    my ($errok) = @_;
-    $?=0; $!=0;
-    return if close F;
-    return if $errok;
-    die $! if $!;
-    die "@gcmd failed ($?)\n";
-}
-
-sub gitoutput (@) {
-    (@gcmd) = (qw(git), @_);
-    gitrun_start;
-    $_ = <F>;
-    gitrun_done;
-    defined or die "@gcmd produced no output";
-    chomp or die "@gcmd produced no final newline";
-    $_;
-}
-
-sub do_git () {
-    return unless $do_git;
-
-    @gcmd = qw(git status --porcelain);
-    push @gcmd, qw(--untracked=no) unless $do_git_untracked;
-
-    my $git_dirty = '';
-    gitrun_start;
-    while (<F>) {
-       if (m/^\?\?/ && $do_git_untracked) {
-           $git_dirty = '+';
-           next;
-       }
-       $git_dirty = '*';
-       last;
-    }
-    gitrun_done($git_dirty eq '*');
-
-    my $git_count;
-    my $git_object;
-
-    if ($do_git =~ m/c/) {
-       $git_count = gitoutput qw(rev-list --first-parent --count HEAD);
-    }
-    if ($do_git =~ m/o/) {
-       $git_object = gitoutput qw(rev-parse HEAD);
-    }
-
-    foreach my $sz (2..10) {
-       gentextmodule_demo_start_batch();
-
-       if (defined($git_count)) {
-           my $smallstr = rjustt($sz, $git_count, $git_dirty);
-           if (defined($git_object) && $sz >= length($git_count) + 3) {
-               $smallstr = $git_object;
-               $smallstr .= ($git_dirty || ' ');
-               $smallstr .= $git_count;
-               $smallstr = rjustt($sz, $smallstr);
-           }
-           genform_plusq("Small$sz", $smallstr);
-       }
-
-       genform_plusq("Git$sz", ljustt($sz, $git_object, $git_dirty))
-           if defined $git_object;
-
-       if (defined $git_count && defined $git_object) {
-           genform("Full".($sz*2),
-                   ljustt($sz, $git_object),
-                   rjustt($sz, $git_count, $git_dirty));
-
-           my $e = $sz;
-           genform("Full".($e*3)."T",
-                   ljustt($e*2, $git_object, $git_dirty)
-                   =~ m/.{$e}/g,
-                   rjustt($e, $git_count));
-       }
-    }
-}
-
-sub do_some_best ($$) {
-    my ($modname, $formre) = @_;
-    my $fullmodname = "Commitid_${modname}_2D";
-    p "module $fullmodname(max_sz) {\n";
-    p ' sc_max = $Commitid_max_best_scale ? $Commitid_max_best_scale : 2;'."\n";
-    my @do;
-    foreach my $f (
-        sort {
-           $b->{Chars} <=> $a->{Chars} or
-           $a->{Lines} <=> $b->{Chars}
-        }
-        grep {
-           $_->{Form} =~ m/$formre/ &&
-           !$_->{Ambiguous}
-       }
-        @forms
-    ) {
-       my $form = $f->{Form};
-       p " sz_$form = Commitid_${form}_sz();\n";
-       foreach my $rot (qw(0 1)) {
-           my $id = "${form}_r${rot}";
-           p " sc_$id = min(sc_max";
-           foreach my $xy (qw(0 1)) {
-               p ",max_sz[$xy]/sz_$form","[",(($xy xor $rot)+0),"]";
-           }
-           p ");\n";
-           push @do, " if (sc_$id >= 1.0) {\n";
-           push @do, "  scale(sc_$id)\n";
-           push @do, "   rotate(90) translate([0,-sz_$form"."[1]])\n" if $rot;
-           push @do, "   Commitid_${form}_2D();\n";
-           push @do, " } else";
-       }
-    }
-    push @do, <<END;
- {
-  echo("$fullmodname could not fit anything in", max_sz);
- }
-END
-    p $_ foreach @do;
-    p "}\n";
-}
-
-sub do_git_best () {
-    return unless $do_git;
-
-    # Auto-computer for `best fit'
-    #
-    # We have two best fit approaches: with count, and git-object-id-only
-    #
-    # For `with count', we only ever include the git object id if the
-    # result would be unambigous.  That means that at least one space
-    # or punctuation was generated.
-    #
-    # We sort the options by firstly number of characters
-    # (decreasing), and then by number of lines (increasing) and
-    # try each one both ways round.
-
-    do_some_best('BestCount', 'Small|Full') if $do_git =~ m/c/;
-    do_some_best('BestObjid', 'Git|Full') if $do_git =~ m/o/;
-}
-
-while (@ARGV) {
-    $_ = shift;
-    if (m/^--(no)?-git$/) {
-       $do_git = $1 ? '' : 'co';
-    } elsif (m/^---git=object$/) {
-       $do_git = 'o';
-    } elsif (m/^-i$/) {
-       $do_git_untracked = 0;
-    } elsif (m/^-t(.*)$/) {
-       my $form = $1;
-       die "bad usage: -t needs string argument\n";
-       $_ = shift;
-       gentextmodule($form, split /\n/, $_);
-       $argcounter //= 0;
-    } elsif (m/^[^-]/) {
-       gentextmodule("Arg$argcounter", $_);
-       $argcounter++;
-    } else {
-       die "bad usage: unknown option \`$_'\n";
-    }
-}
-
-$do_git //= defined($argcounter) ? '' : 'co';
-
-gentextmodule_demo_start_batch();
-gentextmodule('FontDemo', @demo);
-
-do_git();
-do_git_best();
-
-p "module Commitid_2DDemo(){\n";
-p " st = Commitid__scale() * [ 10, 5 ];\n";
-p " e  = Commitid_pixelsz();\n";
-p $_ foreach @gtm_demo_o;
-p "}\n";
-
-flush STDOUT or die $!;
-close STDOUT or die $!;
-
-__DATA__
-
-# 00 20 22 02
-l 00 20 02
-r 00 20 22
-L 00 22 02
-R 20 22 02
-> 00 20 22 02 11
-< 00 20 11 22 02
-
-0 1 2 3 4 5 6 7 8 9
-
-/#\  r  /#\ ##\ # # ### //  ### /#\ /#\
-# # /#    #   # # # #   #     # # # # #
-# #  #  /#/ ##< \## ##\ ##\  // >#< \##
-# #  #  #     #   #   # # #  #  # #   #
-\#/ /#\ ### ##/   # ##/ \#/  #  \#/ ##/
-
-a b c d e f
-
-    #         #     /##
-    #   /##   # /#\ #
-/## ##\ #   /## #r# ###
-# # # # #   # # #/  #
-\## ##/ \## \## \#/ #
-
-+ *
-
-    # #
- #  \#/
-### ###
- #  /#\
-    # #
new file mode 120000 (symlink)
index 0000000000000000000000000000000000000000..f19082c50ede34da7dc49f5cd2c648388d60343e
--- /dev/null
@@ -0,0 +1 @@
+diziet-utils/commitid.scad.pl
\ No newline at end of file