+++ /dev/null
-#!/usr/bin/perl -w
-
-# commitid.scad.pl - a program for annotating solid models with commit info
-# Copyright (C)2016 Ian Jackson. See below. There is NO WARRANTY.
-
-
-# USAGE
-# =====
-#
-# .../commitid.scad.pl [OPTION...] [STRING...] >commitid.scad.new \
-# && mv -f commitid.scad.new commitid.scad
-#
-# Run without arguments, commitid.scad.pl will output an openscad file
-# which contains 2D and 3D models of the current git commit count and
-# commit object id (commit hash), useful for identifying printed
-# parts.
-#
-# See below for details. You probably want these two sections, as a
-# quick starting point:
-# General form of provided openscad modules
-# Autoscaling modules
-#
-# We can also generate models of short mainly-numeric strings
-# specified on the command line.
-#
-#
-# Options:
-#
-# --git Generate git commit indications, as shown below
-# (this is the default if no strings are requested with -t).
-# Ie, produce the `Autoscaling modules' and `Specific layouts'.
-#
-# --git=objid
-# Generate git commit indication based on commit object only
-# (ie avoid counting commits). Ie, do not generate `Small'
-# and `Full' layouts (and never select them for `Best').
-#
-# -i Do not generate `+' dirty indication if git-untracked files
-# are present (ie, missing .gitignore entries). The `*'
-# dirty tree indication (for modified files) cannot be disabled.
-#
-# [-t[LAYOUT]] TEXT
-# Generate a layout LAYOUT containing TEXT. TEXT can
-# contain newlines (a final newline usually undesirable, as
-# it will generate a blank line). If LAYOUT is not specified,
-# generates Arg0, Arg1, Arg2, etc., for successive such
-# TEXTs. The permissible character set in is TEXT is:
-# space 0-9 a-f + *
-#
-#
-# OPENSCAD INTERFACE
-# ==================
-#
-# Dynamic variables for configuration
-# -----------------------------------
-#
-# We honour the following variables to control various scaling factors:
-#
-# default value notes
-# $Commitid_pixelsz 0.8 \ multiplied together
-# $Commitid_scale 1.0 /
-# $Commitid_depth pixelsz/2 \ multiplied together
-# $Commitid_depth_scale 1.0 /
-# $Commitid_max_best_scale 2.0 limits XY scaling in *Best*
-#
-# FYI the font is nominally 3x5 pixels, with 1-pixel inter-line and
-# inter-character gaps. (It's not strictly speaking a 3x5 bitmap
-# font, size it contains partial pixels and diagonals.)
-#
-#
-# Non-`module'-specific functions
-# -------------------------------
-#
-# We provide the following functions (which depend on the config
-# variables, but not on anything else) and compute useful values:
-#
-# function Commitid_pixelsz() Actual size of each nominal pixel
-# function Commitid_depth() Depth to use (the amount characters
-# should be raised or sunken)
-#
-# General form of provided openscad modules
-# -----------------------------------------
-#
-# module Commitid_MODULE_2D(...) Collection of polygons forming characters
-# module Commitid_MODULE(...) The above, extruded up and down in Z
-# module Commitid_MODULE_M_2D(...) Mirror writing
-# module Commitid_MODULE_M(...) 3D mirror writing
-# function Commitid_MODULE_sz() A 2-vector giving the X,Y size
-#
-# Except for *Best* modules, the XY origin is in the bottom left
-# corner without any margin. Likewise Commitid_MODULE_sz does not
-# include any margin.
-#
-# For 3D versions, the model is 2*depth deep and the XY plane bisects
-# the model. This means it's convenient to either add or subtract from
-# a workpiece whose face is in the XY plane.
-#
-# The _M versions are provided to avoid doing inconvenient translation
-# and rotation to get the flipped version in the right place.
-#
-#
-# Autoscaling modules
-# -------------------
-#
-# These modules take a specification of the available XY space, and
-# select and generate a suitable specific identification layout:
-#
-# module Commitid_BestCount_2D (max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestCount (max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestCount_M_2D(max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestCount_M (max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestObjid_2D (max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestObjid (max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestObjid_M_2D(max_sz, margin=Commitid_pixelsz())
-# module Commitid_BestObjid_M (max_sz, margin=Commitid_pixelsz())
-#
-# max_sz should be [x,y].
-#
-# BestCount includes (as much as it can of) the git commit count,
-# ie the result of
-# git rev-list --first-parent --count HEAD
-# (and it may include some of the git revision ID too).
-#
-# BestObjid includes as much as it can of the git commit object hash,
-# and never includes any of the count.
-#
-# All of these will autoscale and autorotate the selected model, and
-# will include an internal margin of the specified size (by default,
-# one pixel around each edge). If no margin is needed, pass margin=0.
-#
-# There are no `function Commitid_Best*_sz'. If they existed they
-# would simply return max_sz.
-#
-#
-# Output format
-# -------------
-#
-# In general the output, although it may be over multiple lines,
-# is always in this order
-# git commit object id (hash)
-# dirty indicator
-# git commit count
-#
-# Not all layouts have all these parts. The commit object id may
-# sometimes be split over multiple lines, but the count will not be.
-# If both commit id and commit count appear they will be separated
-# by (at least) a newline, or a dirty indicator, or a space.
-#
-# The commit id is truncated to fit, from the right.
-#
-# The commit count is truncated from the _left_, leaving the least
-# significant decimal digits.
-#
-# The dirty indicator can be
-#
-# * meaning the working tree contains differences from HEAD
-#
-# + meaning the working tree contains untracked files
-# (ie files you have failed to `git add' and also failed
-# to add to gitignore). (But see the -i option.)
-#
-#
-# Specific layouts
-# ----------------
-#
-# If you want to control the exact layout (and make space for it in
-# your design), you can use these:
-#
-# module Commitid_LAYOUT_2D()
-# module Commitid_LAYOUT()
-# module Commitid_LAYOUT_M_2D()
-# module Commitid_LAYOUT_M()
-# function Commitid_LAYOUT_sz()
-#
-# Here LAYOUT is one of the following (giving for example, `module
-# Commitid_Full8_2D'). In the examples, we will assume that the tree
-# is dirty, the commit count is 123456, and the commit object id
-# starts abcdeffedbcaabcdef... In the examples `_' shows where a
-# space would be printed.
-#
-# Small2 Small3 ... Small10
-# A single line containing as much of the count will fit, eg:
-# Small5 3456*
-# Small8 _*123456
-# The objectid is included if more than one character of of it
-# will fit without makign the output ambiguous:
-# Small9 ab*123456
-#
-# Small2S Small4S ... Small10S
-# Small3T Small9T
-# Same as Small but split into two lines (S)
-# or three lines (T). Eg:
-# Small4S *4 Small6T _*
-# 56 34
-# 56
-# Git2 Git3 ... Git10
-# Git4S Git6S ... Git10S
-# Git6T Git9T
-# Just the commit object hash, in one, two (S) or three (T)
-# lines. E.g.:
-# Git5 abcd*
-#
-# Full4 Full6 ... Full20:
-# The commit object hash plus the commit count, on
-# separate lines, eg:
-# Full6 abcdef Full8 abcdeffe
-# *23456 _*123456
-#
-# Full6T Full9T ... Full30T
-# As Full but the commit object id is split over two lines
-# producing a 3-line layout, eg:
-# Full9T abc Full21T abcdeff
-# de* edbcaa*
-# 456 _123456
-#
-# Other LAYOUTs
-# -------------
-#
-# FontDemo
-#
-# A demonstration of the built-in 18-character font
-#
-# Arg0 Arg1, ...
-#
-# Strings passed on command line (without -t, or bare -t,
-# rather than with -tLAYOUT).
-#
-# LAYOUT
-#
-# Generated by passing -tLAYOUT on the command line.
-#
-
-
-# COPYRIGHT, LICENCE AND LACK-OF-WARRANTY INFORMATION
-# ===================================================
-#
-# This program is Free Software and a Free Cultural Work.
-#
-# You can redistribute it and/or modify it under the terms of the
-# GNU General Public License as published by the Free Software
-# Foundation, either version 3 of the License, or (at your option)
-# any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program. If not, see <http://www.gnu.org/licenses/>.
-#
-# Alternatively, at your option:
-#
-# This work is licensed under the Creative Commons
-# Attribution-ShareAlike 4.0 International License.
-#
-# There is NO WARRANTY.
-
-
-use strict;
-
-$SIG{__WARN__} = sub { die @_; };
-
-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 argl_formal (@) { join ', ', @_; }
-sub argl_actual (@) { join ',', map { m/=/ ? $` : $_ } @_; }
-
-sub gen3dmodule ($@) {
- my ($modb,$size,@argl) = (@_);
- $size ||= "${modb}_sz()";
- p "module ${modb}_M_2D(".argl_formal(@argl)."){\n";
- p " translate([${size}[0],0])\n";
- p " mirror([1,0,0])\n";
- p " ${modb}_2D(".argl_actual(@argl).");\n";
- p "};\n";
- foreach my $mir ('','_M') {
- my $mm = "${modb}${mir}";
- p "module ${mm}(".argl_formal(@argl)."){\n";
- p " d=Commitid_depth();\n";
- p " translate([0,0,-d]) linear_extrude(height=d*2)\n";
- p " ${mm}_2D(".argl_actual(@argl).");\n";
- p "}\n";
- }
-}
-
-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";
- gen3dmodule($modb,'');
-
- 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);
- }
- print STDERR join ' ', map { $_ // '?' }
- "-- commitid", $git_object, $git_dirty, $git_count, "--\n";
-
- foreach my $sz (2..10) {
- gentextmodule_demo_start_batch();
-
- if (defined($git_count)) {
- my $smallstr = rjustt($sz, $git_count, $git_dirty);
- my $forgitobj = $sz - length($git_count) - 1;
- if (defined($git_object) && $forgitobj >= 2) {
- $smallstr = ljustt($forgitobj, $git_object).
- ($git_dirty || ' ').
- $git_count;
- }
- 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";
- my @argl = qw(max_sz margin=Commitid_pixelsz());
- p "module $fullmodname(".argl_formal(@argl).") {\n";
- my $mbs = '$Commitid_max_best_scale';
- p " sc_max = $mbs ? $mbs : 2;\n";
- p " sz = max_sz - 2*[margin,margin];\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 ",sz[$xy]/sz_$form","[",(($xy xor $rot)+0),"]";
- }
- p ");\n";
- push @do, " if (sc_$id >= 1.0";
- push @do, " && sc_$id >= sc_${form}_r1" if !$rot;
- push @do, ") {\n";
- push @do, " translate([margin,margin]) 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";
-
- gen3dmodule "Commitid_$modname", 'max_sz', @argl;
-}
-
-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=objid$/i) {
- $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# ###
-# # # # # # # #/ #
-\## ##/ \## \## \#/ #
-
-+ *
-
- # #
- # \#/
-### ###
- # /#\
- # #