--- rxvt-unicode/src/perl/background	2012/06/05 15:18:23	1.11
+++ 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/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,7 @@
 our ($bgdsl_self, $old, $new);
 our ($l, $t, $w, $h);
 
+# enforce at leats this time between updates
 our $MIN_INTERVAL = 1/100;
 
 {
@@ -25,6 +30,14 @@
    *repeat_pad    = \&urxvt::RepeatPad;
    *repeat_mirror = \&urxvt::RepeatReflect;
 
+=head2 PROVIDERS/GENERATORS
+
+=over 4
+
+=item load $path
+
+=cut
+
    sub load($) {
       my ($path) = @_;
 
@@ -36,6 +49,20 @@
       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
 #   }
@@ -117,6 +144,11 @@
       $new->{again} = $_[0];
       $bgdsl_self->{counter} + 0
    }
+
+=back
+
+=cut
+
 }
 
 sub parse_expr {
@@ -143,6 +175,7 @@
       $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;
@@ -161,6 +194,7 @@
 
    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