--- rxvt-unicode/src/perl/background	2012/06/05 14:04:58	1.7
+++ rxvt-unicode/src/perl/background	2012/06/05 22:46:50	1.15
@@ -1,11 +1,15 @@
 #! perl
 
+#:META:RESOURCE:$$:string:background expression
+#:META:RESOURCE:$$-enable:boolean:some boolean
+
 our $EXPR = 'move load "/root/pix/das_fette_schwein.jpg", repeat_wrap, X, Y';
 $EXPR = '
-   rotate W, H, 50, 50, counter 1/60, repeat_mirror,
+   rotate W, H, 50, 50, counter 1/59.95, repeat_mirror,
    clip X, Y, W, H, repeat_mirror,
    load "/root/pix/das_fette_schwein.jpg"
 ';
+$EXPR = 'solid "red"';
 #$EXPR = 'blur root, 10, 10'
 #$EXPR = 'blur move (root, -x, -y), 5, 5'
 #resize load "/root/pix/das_fette_schwein.jpg", w, h
@@ -15,6 +19,9 @@
 our ($bgdsl_self, $old, $new);
 our ($l, $t, $w, $h);
 
+# enforce at leats this time between updates
+our $MIN_INTERVAL = 1/100;
+
 {
    package urxvt::bgdsl; # background language
 
@@ -23,6 +30,14 @@
    *repeat_pad    = \&urxvt::RepeatPad;
    *repeat_mirror = \&urxvt::RepeatReflect;
 
+=head2 PROVIDERS/GENERATORS
+
+=over 4
+
+=item load $path
+
+=cut
+
    sub load($) {
       my ($path) = @_;
 
@@ -30,9 +45,24 @@
    }
 
    sub root() {
+      $new->{rootpmap_sensitive} = 1;
       die "root op not supported, exg, we need you";
    }
 
+   sub solid($;$$) {
+      my $img = $bgdsl_self->new_img (urxvt::PictStandardARGB32, $_[1] || 1, $_[2] || 1);
+      $img->fill ($_[0]);
+      $img
+   }
+
+=back
+
+=head2 OPERATORS
+
+=over 4
+
+=cut
+
 #   sub clone($) {
 #      $_[0]->clone
 #   }
@@ -72,9 +102,7 @@
    sub blur($$$) {
       my ($rh, $rv, $img) = @_;
 
-      $img = $img->clone;
       $img->blur ($rh, $rv);
-      $img
    }
 
    sub contrast($$;$$;$) {
@@ -116,6 +144,11 @@
       $new->{again} = $_[0];
       $bgdsl_self->{counter} + 0
    }
+
+=back
+
+=cut
+
 }
 
 sub parse_expr {
@@ -136,7 +169,18 @@
 sub recalculate {
    my ($self) = @_;
 
-   #TODO: rate limit calls
+   # rate limit evaluation
+
+   if ($self->{next_refresh} > urxvt::NOW) {
+      $self->{next_refresh_timer} = urxvt::timer->new->after ($self->{next_refresh} - urxvt::NOW)->cb (sub {
+         $self->recalculate;
+      });
+      return;
+   }
+
+   $self->{next_refresh} = urxvt::NOW + $MIN_INTERVAL;
+
+   # set environment to evaluate user expression
 
    local $bgdsl_self = $self;
 
@@ -146,8 +190,13 @@
    ($l, $t, $w, $h) =
       $self->get_geometry;
 
+   # evaluate user expression
+
    my $img = eval { $self->{expr}->() };
    warn $@ if $@;#d#
+   die if !UNIVERSAL::isa $img, "urxvt::img";
+
+   # if the expression is sensitive to external events, prepare reevaluation then
 
    my $repeat;
 
@@ -175,6 +224,15 @@
       $self->disable ("size_change");
    }
 
+   if (delete $state->{rootpmap_sensitive}) {
+      $repeat = 1;
+      $self->enable (rootpmap_change => sub { $_[0]->recalculate });
+   } else {
+      $self->disable ("rootpmap_change");
+   }
+
+   # clear stuff we no longer need
+
    %$old = ();
 
    unless ($repeat) {
@@ -182,6 +240,8 @@
       delete $self->{expr};
    }
 
+   # prepare and set background pixmap
+
    $img = $img->sub_rect (0, 0, $w, $h)
       if $img->w != $w || $img->h != $h;