ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/perl/background
(Generate patch)

Comparing rxvt-unicode/src/perl/background (file contents):
Revision 1.13 by root, Tue Jun 5 19:32:29 2012 UTC vs.
Revision 1.40 by root, Fri Jun 8 22:19:21 2012 UTC

1#! perl 1#! perl
2 2
3#:META:RESOURCE:$$:string:background expression 3#:META:X_RESOURCE:%.expr:string:background expression
4#:META:X_RESOURCE:%.border.:boolean:respect the terminal border
4 5
5our $EXPR = 'move load "/root/pix/das_fette_schwein.jpg", repeat_wrap, X, Y'; 6#TODO: once, rootalign
6$EXPR = '
7 rotate W, H, 50, 50, counter 1/59.95, repeat_mirror,
8 clip X, Y, W, H, repeat_mirror,
9 load "/root/pix/das_fette_schwein.jpg"
10';
11#$EXPR = 'blur root, 10, 10'
12#$EXPR = 'blur move (root, -x, -y), 5, 5'
13#resize load "/root/pix/das_fette_schwein.jpg", w, h
14 7
15use Safe; 8=head1 background - manage terminal background
16 9
10=head2 SYNOPSIS
11
12 urxvt --background-expr 'background expression'
13 --background-border
14
15=head2 DESCRIPTION
16
17This extension manages the terminal background by creating a picture that
18is behind the text, replacing the normal background colour.
19
20It does so by evaluating a Perl expression that I<calculates> the image on
21the fly, for example, by grabbing the root background or loading a file.
22
23While the full power of Perl is available, the operators have been design
24to be as simple as possible.
25
26For example, to load an image and scale it to the window size, you would
27use:
28
29 urxvt --background-expr 'scale load "/path/to/mybg.png"'
30
31Or specified as a X resource:
32
33 URxvt.background-expr: scale load "/path/to/mybg.png"
34
35=head2 THEORY OF OPERATION
36
37At startup, just before the window is mapped for the first time, the
38expression is evaluated and must yield an image. The image is then
39extended as necessary to cover the whole terminal window, and is set as a
40background pixmap.
41
42If the image contains an alpha channel, then it will be used as-is in
43visuals that support alpha channels (for example, for a compositing
44manager). In other visuals, the terminal background colour will be used to
45replace any transparency.
46
47When the expression relies, directly or indirectly, on the window size,
48position, the root pixmap, or a timer, then it will be remembered. If not,
49then it will be removed.
50
51If any of the parameters that the expression relies on changes (when the
52window is moved or resized, its position or size changes; when the root
53pixmap is replaced by another one the root background changes; or when the
54timer elapses), then the expression will be evaluated again.
55
56For example, an expression such as C<scale load "$HOME/mybg.png"> scales the
57image to the window size, so it relies on the window size and will
58be reevaluated each time it is changed, but not when it moves for
59example. That ensures that the picture always fills the terminal, even
60after it's size changes.
61
62=head3 EXPRESSIONS
63
64Expressions are normal Perl expressions, in fact, they are Perl blocks -
65which means you could use multiple lines and statements:
66
67 again 3600;
68 if (localtime now)[6]) {
69 return scale load "$HOME/weekday.png";
70 } else {
71 return scale load "$HOME/sunday.png";
72 }
73
74This expression gets evaluated once per hour. It will set F<sunday.png> as
75background on Sundays, and F<weekday.png> on all other days.
76
77Fortunately, we expect that most expressions will be much simpler, with
78little Perl knowledge needed.
79
80Basically, you always start with a function that "generates" an image
81object, such as C<load>, which loads an image from disk, or C<root>, which
82returns the root window background image:
83
84 load "$HOME/mypic.png"
85
86The path is usually specified as a quoted string (the exact rules can be
87found in the L<perlop> manpage). The F<$HOME> at the beginning of the
88string is expanded to the home directory.
89
90Then you prepend one or more modifiers or filtering expressions, such as
91C<scale>:
92
93 scale load "$HOME/mypic.png"
94
95Just like a mathematical expression with functions, you should read these
96expressions from right to left, as the C<load> is evaluated first, and
97its result becomes the argument to the C<scale> function.
98
99Many operators also allow some parameters preceding the input image
100that modify its behaviour. For example, C<scale> without any additional
101arguments scales the image to size of the terminal window. If you specify
102an additional argument, it uses it as a percentage:
103
104 scale 200, load "$HOME/mypic.png"
105
106This enlarges the image by a factor of 2 (200%). As you can see, C<scale>
107has now two arguments, the C<200> and the C<load> expression, while
108C<load> only has one argument. Arguments are separated from each other by
109commas.
110
111Scale also accepts two arguments, which are then separate factors for both
112horizontal and vertical dimensions. For example, this halves the image
113width and doubles the image height:
114
115 scale 50, 200, load "$HOME/mypic.png"
116
117Other effects than scalign are also readily available, for exmaple, you can
118tile the image to fill the whole window, instead of resizing it:
119
120 tile load "$HOME/mypic.png"
121
122In fact, images returned by C<load> are in C<tile> mode by default, so the C<tile> operator
123is kind of superfluous.
124
125Another common effect is to mirror the image, so that the same edges touch:
126
127 mirror load "$HOME/mypic.png"
128
129This is also a typical background expression:
130
131 rootalign root
132
133It first takes a snapshot of the screen background image, and then
134moves it to the upper left corner of the screen - the result is
135pseudo-transparency, as the image seems to be static while the window is
136moved around.
137
138=head3 CYCLES AND CACHING
139
140As has been mentioned before, the expression might be evaluated multiple
141times. Each time the expression is reevaluated, a new cycle is said to
142have begun. Many operators cache their results till the next cycle.
143
144For example, the C<load> operator keeps a copy of the image. If it is
145asked to load the same image on the next cycle it will not load it again,
146but return the cached copy.
147
148This only works for one cycle though, so as long as you load the same
149image every time, it will always be cached, but when you load a different
150image, it will forget about the first one.
151
152This allows you to either speed things up by keeping multiple images in
153memory, or comserve memory by loading images more often.
154
155For example, you can keep two images in memory and use a random one like
156this:
157
158 my $img1 = load "img1.png";
159 my $img2 = load "img2.png";
160 (0.5 > rand) ? $img1 : $img2
161
162Since both images are "loaded" every time the expression is evaluated,
163they are always kept in memory. Contrast this version:
164
165 my $path1 = "img1.png";
166 my $path2 = "img2.png";
167 load ((0.5 > rand) ? $path1 : $path2)
168
169Here, a path is selected randomly, and load is only called for one image,
170so keeps only one image in memory. If, on the next evaluation, luck
171decides to use the other path, then it will have to load that image again.
172
173=head2 REFERENCE
174
175=head3 COMMAND LINE SWITCHES
176
177=over 4
178
179=item --background-expr perl-expression
180
181Specifies the Perl expression to evaluate.
182
183=item --background-border
184
185By default, the expression creates an image that fills the full window,
186overwriting borders and any other areas, such as the scrollbar.
187
188Specifying this flag changes the behaviour, so that the image only
189replaces the background of the character area.
190
191=back
192
193=cut
194
195our $HOME;
17our ($bgdsl_self, $old, $new); 196our ($self, $old, $new);
18our ($l, $t, $w, $h); 197our ($x, $y, $w, $h);
19 198
20# enforce at leats this time between updates 199# enforce at least this interval between updates
21our $MIN_INTERVAL = 1/100; 200our $MIN_INTERVAL = 1/100;
22 201
23{ 202{
24 package urxvt::bgdsl; # background language 203 package urxvt::bgdsl; # background language
25 204
26 *repeat_black = \&urxvt::RepeatNone; #TODO wtf 205=head2 PROVIDERS/GENERATORS
27 *repeat_wrap = \&urxvt::RepeatNormal; 206
28 *repeat_pad = \&urxvt::RepeatPad; 207These functions provide an image, by loading it from disk, grabbing it
29 *repeat_mirror = \&urxvt::RepeatReflect; 208from the root screen or by simply generating it. They are used as starting
209points to get an image you can play with.
210
211=over 4
212
213=item load $path
214
215Loads the image at the given C<$path>. The image is set to plane tiling
216mode.
217
218Loaded images will be cached for one cycle.
219
220=cut
30 221
31 sub load($) { 222 sub load($) {
32 my ($path) = @_; 223 my ($path) = @_;
33 224
34 $new->{load}{$path} = $old->{load}{$path} || $bgdsl_self->new_img_from_file ($path); 225 $new->{load}{$path} = $old->{load}{$path} || $self->new_img_from_file ($path);
35 } 226 }
227
228=item root
229
230Returns the root window pixmap, that is, hopefully, the background image
231of your screen. The image is set to extend mode.
232
233This function makes your expression root sensitive, that means it will be
234reevaluated when the bg image changes.
235
236=cut
36 237
37 sub root() { 238 sub root() {
38 $new->{rootpmap_sensitive} = 1; 239 $new->{rootpmap_sensitive} = 1;
39 die "root op not supported, exg, we need you"; 240 die "root op not supported, exg, we need you";
40 } 241 }
41 242
243=item solid $colour
244
245=item solid $width, $height, $colour
246
247Creates a new image and completely fills it with the given colour. The
248image is set to tiling mode.
249
250If C<$width> and C<$height> are omitted, it creates a 1x1 image, which is
251useful for solid backgrounds or for use in filtering effects.
252
253=cut
254
255 sub solid($$;$) {
256 my $colour = pop;
257
258 my $img = $self->new_img (urxvt::PictStandardARGB32, $_[0] || 1, $_[1] || 1);
259 $img->fill ($colour);
260 $img
261 }
262
263=back
264
265=head2 VARIABLES
266
267The following functions provide variable data such as the terminal
268window dimensions. Most of them make your expression sensitive to some
269events, for example using C<TW> (terminal width) means your expression is
270evaluated again when the terminal is resized.
271
272=over 4
273
274=item TX
275
276=item TY
277
278Return the X and Y coordinates of the terminal window (the terminal
279window is the full window by default, and the character area only when in
280border-respect mode).
281
282Using these functions make your expression sensitive to window moves.
283
284These functions are mainly useful to align images to the root window.
285
286Example: load an image and align it so it looks as if anchored to the
287background.
288
289 move -TX, -TY, load "mybg.png"
290
291=item TW
292
293Return the width (C<TW>) and height (C<TH>) of the terminal window (the
294terminal window is the full window by default, and the character area only
295when in border-respect mode).
296
297Using these functions make your expression sensitive to window resizes.
298
299These functions are mainly useful to scale images, or to clip images to
300the window size to conserve memory.
301
302Example: take the screen background, clip it to the window size, blur it a
303bit, align it to the window position and use it as background.
304
305 clip move -TX, -TY, blur 5, root
306
307=cut
308
309 sub TX() { $new->{position_sensitive} = 1; $x }
310 sub TY() { $new->{position_sensitive} = 1; $y }
311 sub TW() { $new->{size_sensitive} = 1; $w }
312 sub TH() { $new->{size_sensitive} = 1; $h }
313
314=item now
315
316Returns the current time as (fractional) seconds since the epoch.
317
318Using this expression does I<not> make your expression sensitive to time,
319but the next two functions do.
320
321=item again $seconds
322
323When this function is used the expression will be reevaluated again in
324C<$seconds> seconds.
325
326Example: load some image and rotate it according to the time of day (as if it were
327the hour pointer of a clock). Update this image every minute.
328
329 again 60; rotate TW, TH, 50, 50, (now % 86400) * -720 / 86400, scale load "myclock.png"
330
331=item counter $seconds
332
333Like C<again>, but also returns an increasing counter value, starting at
3340, which might be useful for some simple animation effects.
335
336=cut
337
338 sub now() { urxvt::NOW }
339
340 sub again($) {
341 $new->{again} = $_[0];
342 }
343
344 sub counter($) {
345 $new->{again} = $_[0];
346 $self->{counter} + 0
347 }
348
349=back
350
351=head2 TILING MODES
352
353The following operators modify the tiling mode of an image, that is, the
354way that pixels outside the image area are painted when the image is used.
355
356=over 4
357
358=item tile $img
359
360Tiles the whole plane with the image and returns this new image - or in
361other words, it returns a copy of the image in plane tiling mode.
362
363Example: load an image and tile it over the background, without
364resizing. The C<tile> call is superfluous because C<load> already defaults
365to tiling mode.
366
367 tile load "mybg.png"
368
369=item mirror $img
370
371Similar to tile, but reflects the image each time it uses a new copy, so
372that top edges always touch top edges, right edges always touch right
373edges and so on (with normal tiling, left edges always touch right edges
374and top always touch bottom edges).
375
376Example: load an image and mirror it over the background, avoiding sharp
377edges at the image borders at the expense of mirroring the image itself
378
379 mirror load "mybg.png"
380
381=item pad $img
382
383Takes an image and modifies it so that all pixels outside the image area
384become transparent. This mode is most useful when you want to place an
385image over another image or the background colour while leaving all
386background pixels outside the image unchanged.
387
388Example: load an image and display it in the upper left corner. The rest
389of the space is left "empty" (transparent or wahtever your compisotr does
390in alpha mode, else background colour).
391
392 pad load "mybg.png"
393
394=item extend $img
395
396Extends the image over the whole plane, using the closest pixel in the
397area outside the image. This mode is mostly useful when you more complex
398filtering operations and want the pixels outside the image to have the
399same values as the pixels near the edge.
400
401Example: just for curiosity, how does this pixel extension stuff work?
402
403 extend move 50, 50, load "mybg.png"
404
405=cut
406
407 sub pad($) {
408 my $img = $_[0]->clone;
409 $img->repeat_mode (urxvt::RepeatNone);
410 $img
411 }
412
413 sub tile($) {
414 my $img = $_[0]->clone;
415 $img->repeat_mode (urxvt::RepeatNormal);
416 $img
417 }
418
419 sub mirror($) {
420 my $img = $_[0]->clone;
421 $img->repeat_mode (urxvt::RepeatReflect);
422 $img
423 }
424
425 sub extend($) {
426 my $img = $_[0]->clone;
427 $img->repeat_mode (urxvt::RepeatPad);
428 $img
429 }
430
431=back
432
433=head2 PIXEL OPERATORS
434
435The following operators modify the image pixels in various ways.
436
437=over 4
438
439=item clone $img
440
441Returns an exact copy of the image.
442
443=cut
444
42# sub clone($) { 445 sub clone($) {
43# $_[0]->clone 446 $_[0]->clone
44# } 447 }
45 448
449=item clip $img
450
451=item clip $width, $height, $img
452
453=item clip $x, $y, $width, $height, $img
454
455Clips an image to the given rectangle. If the rectangle is outside the
456image area (e.g. when C<$x> or C<$y> are negative) or the rectangle is
457larger than the image, then the tiling mode defines how the extra pixels
458will be filled.
459
460If C<$x> an C<$y> are missing, then C<0> is assumed for both.
461
462If C<$width> and C<$height> are missing, then the window size will be
463assumed.
464
465Example: load an image, blur it, and clip it to the window size to save
466memory.
467
468 clip blur 10, load "mybg.png"
469
470=cut
471
46 sub clip($$$$$;$) { 472 sub clip($;$$;$$) {
47 my $img = pop; 473 my $img = pop;
474 my $h = pop || TH;
475 my $w = pop || TW;
48 $img->sub_rect ($_[0], $_[1], $_[2], $_[3], $_[4]) 476 $img->sub_rect ($_[0], $_[1], $w, $h)
477 }
478
479=item scale $img
480
481=item scale $size_percent, $img
482
483=item scale $width_percent, $height_percent, $img
484
485Scales the image by the given percentages in horizontal
486(C<$width_percent>) and vertical (C<$height_percent>) direction.
487
488If only one percentage is give, it is used for both directions.
489
490If no percentages are given, scales the image to the window size without
491keeping aspect.
492
493=item resize $width, $height, $img
494
495Resizes the image to exactly C<$width> times C<$height> pixels.
496
497=cut
498
499#TODO: maximise, maximise_fill?
500
501 sub scale($;$;$) {
502 my $img = pop;
503
504 @_ == 2 ? $img->scale ($_[0] * $img->w * 0.01, $_[1] * $img->h * 0.01)
505 : @_ ? $img->scale ($_[0] * $img->w * 0.01, $_[0] * $img->h * 0.01)
506 : $img->scale (TW, TH)
49 } 507 }
50 508
51 sub resize($$$) { 509 sub resize($$$) {
52 my $img = pop; 510 my $img = pop;
53 $img->scale ($_[0], $_[1]) 511 $img->scale ($_[0], $_[1])
54 } 512 }
55 513
56 # TODO: ugly 514=item move $dx, $dy, $img
515
516Moves the image by C<$dx> pixels in the horizontal, and C<$dy> pixels in
517the vertical.
518
519Example: move the image right by 20 pixels and down by 30.
520
521 move 20, 30, ...
522
523=item rootalign $img
524
525Moves the image so that it appears glued to the screen as opposed to the
526window. This gives the illusion of a larger area behind the window. It is
527exactly equivalent to C<move -TX, -TY>, that is, it moves the image to the
528top left of the screen.
529
530Example: load a background image, put it in mirror mode and root align it.
531
532 rootalign mirror load "mybg.png"
533
534Example: take the screen background and align it, giving the illusion of
535transparency as long as the window isn't in front of other windows.
536
537 rootalign root
538
539=cut
540
57 sub move($$;$) { 541 sub move($$;$) {
542 my $img = pop->clone;
543 $img->move ($_[0], $_[1]);
544 $img
545 }
546
547 sub rootalign($) {
548 move -TX, -TY, $_[0]
549 }
550
551=item contrast $factor, $img
552
553=item contrast $r, $g, $b, $img
554
555=item contrast $r, $g, $b, $a, $img
556
557Adjusts the I<contrast> of an image.
558
559#TODO#
560
561=item brightness $factor, $img
562
563=item brightness $r, $g, $b, $img
564
565=item brightness $r, $g, $b, $a, $img
566
567Adjusts the brightness of an image.
568
569=cut
570
571 sub contrast($$;$$;$) {
58 my $img = pop; 572 my $img = pop;
59 $img->sub_rect ( 573 my ($r, $g, $b, $a) = @_;
60 $_[0], $_[1],
61 $img->w, $img->h,
62 $_[2],
63 )
64 }
65 574
575 ($g, $b) = ($r, $r) if @_ < 4;
576 $a = 1 if @_ < 5;
577
578 $img = $img->clone;
579 $img->contrast ($r, $g, $b, $a);
580 $img
581 }
582
583 sub brightness($$;$$;$) {
584 my $img = pop;
585 my ($r, $g, $b, $a) = @_;
586
587 ($g, $b) = ($r, $r) if @_ < 4;
588 $a = 1 if @_ < 5;
589
590 $img = $img->clone;
591 $img->brightness ($r, $g, $b, $a);
592 $img
593 }
594
595=item blur $radius, $img
596
597=item blur $radius_horz, $radius_vert, $img
598
599Gaussian-blurs the image with (roughly) C<$radius> pixel radius. The radii
600can also be specified separately.
601
602Blurring is often I<very> slow, at least compared or other
603operators. Larger blur radii are slower than smaller ones, too, so if you
604don't want to freeze your screen for long times, start experimenting with
605low values for radius (<5).
606
607=cut
608
609 sub blur($$;$) {
610 my $img = pop;
611 $img->blur ($_[0], @_ >= 2 ? $_[1] : $_[0])
612 }
613
614=item rotate $new_width, $new_height, $center_x, $center_y, $degrees
615
616Rotates the image by C<$degrees> degrees, counter-clockwise, around the
617pointer at C<$center_x> and C<$center_y> (specified as percentage of image
618width/height), generating a new image with width C<$new_width> and height
619C<$new_height>.
620
621#TODO# new width, height, maybe more operators?
622
623Example: rotate the image by 90 degrees
624
625=cut
626
66 sub rotate($$$$$$;$) { 627 sub rotate($$$$$$) {
67 my $img = pop; 628 my $img = pop;
68 $img->rotate ( 629 $img->rotate (
69 $_[0], 630 $_[0],
70 $_[1], 631 $_[1],
71 $_[2] * $img->w * .01, 632 $_[2] * $img->w * .01,
72 $_[3] * $img->h * .01, 633 $_[3] * $img->h * .01,
73 $_[4] * (3.14159265 / 180), 634 $_[4] * (3.14159265 / 180),
74 $_[5],
75 ) 635 )
76 } 636 }
77 637
78 sub blur($$$) { 638=back
79 my ($rh, $rv, $img) = @_;
80 639
81 $img->blur ($rh, $rv); 640=cut
82 }
83 641
84 sub contrast($$;$$;$) {
85 my $img = pop;
86 my ($r, $g, $b, $a) = @_;
87
88 ($g, $b) = ($r, $r) if @_ < 4;
89 $a = 1 if @_ < 5;
90
91 $img = $img->clone;
92 $img->contrast ($r, $g, $b, $a);
93 $img
94 }
95
96 sub brightness($$;$$;$) {
97 my $img = pop;
98 my ($r, $g, $b, $a) = @_;
99
100 ($g, $b) = ($r, $r) if @_ < 4;
101 $a = 1 if @_ < 5;
102
103 $img = $img->clone;
104 $img->brightness ($r, $g, $b, $a);
105 $img
106 }
107
108 sub X() { $new->{position_sensitive} = 1; $l }
109 sub Y() { $new->{position_sensitive} = 1; $t }
110 sub W() { $new->{size_sensitive} = 1; $w }
111 sub H() { $new->{size_sensitive} = 1; $h }
112
113 sub now() { urxvt::NOW }
114
115 sub again($) {
116 $new->{again} = $_[0];
117 }
118
119 sub counter($) {
120 $new->{again} = $_[0];
121 $bgdsl_self->{counter} + 0
122 }
123} 642}
124 643
125sub parse_expr { 644sub parse_expr {
126 my $expr = eval "sub {\npackage urxvt::bgdsl;\n#line 0 'background expression'\n$_[0]\n}"; 645 my $expr = eval "sub {\npackage urxvt::bgdsl;\n#line 0 'background expression'\n$_[0]\n}";
127 die if $@; 646 die if $@;
136 $self->recalculate; 655 $self->recalculate;
137} 656}
138 657
139# evaluate the current bg expression 658# evaluate the current bg expression
140sub recalculate { 659sub recalculate {
141 my ($self) = @_; 660 my ($arg_self) = @_;
142 661
143 # rate limit evaluation 662 # rate limit evaluation
144 663
145 if ($self->{next_refresh} > urxvt::NOW) { 664 if ($arg_self->{next_refresh} > urxvt::NOW) {
146 $self->{next_refresh_timer} = urxvt::timer->new->after ($self->{next_refresh} - urxvt::NOW)->cb (sub { 665 $arg_self->{next_refresh_timer} = urxvt::timer->new->after ($arg_self->{next_refresh} - urxvt::NOW)->cb (sub {
147 $self->recalculate; 666 $arg_self->recalculate;
148 }); 667 });
149 return; 668 return;
150 } 669 }
151 670
152 $self->{next_refresh} = urxvt::NOW + $MIN_INTERVAL; 671 $arg_self->{next_refresh} = urxvt::NOW + $MIN_INTERVAL;
153 672
154 # set environment to evaluate user expression 673 # set environment to evaluate user expression
155 674
156 local $bgdsl_self = $self; 675 local $self = $arg_self;
157 676
677 local $HOME = $ENV{HOME};
158 local $old = $self->{state}; 678 local $old = $self->{state};
159 local $new = my $state = $self->{state} = {}; 679 local $new = my $state = $self->{state} = {};
160 680
161 ($l, $t, $w, $h) = 681 ($x, $y, $w, $h) =
162 $self->get_geometry; 682 $self->background_geometry ($self->{border});
163 683
164 # evaluate user expression 684 # evaluate user expression
165 685
166 my $img = eval { $self->{expr}->() }; 686 my $img = eval { $self->{expr}->() };
167 warn $@ if $@;#d# 687 warn $@ if $@;#d#
688 die if !UNIVERSAL::isa $img, "urxvt::img";
689
690 $state->{size_sensitive} = 1
691 if $img->repeat_mode != urxvt::RepeatNormal;
168 692
169 # if the expression is sensitive to external events, prepare reevaluation then 693 # if the expression is sensitive to external events, prepare reevaluation then
170 694
171 my $repeat; 695 my $repeat;
172 696
173 if (my $again = $state->{again}) { 697 if (my $again = $state->{again}) {
174 $repeat = 1; 698 $repeat = 1;
699 my $self = $self;
175 $state->{timer} = $again == $old->{again} 700 $state->{timer} = $again == $old->{again}
176 ? $old->{timer} 701 ? $old->{timer}
177 : urxvt::timer->new->after ($again)->interval ($again)->cb (sub { 702 : urxvt::timer->new->after ($again)->interval ($again)->cb (sub {
178 ++$self->{counter}; 703 ++$self->{counter};
179 $self->recalculate 704 $self->recalculate
208 unless ($repeat) { 733 unless ($repeat) {
209 delete $self->{state}; 734 delete $self->{state};
210 delete $self->{expr}; 735 delete $self->{expr};
211 } 736 }
212 737
213 # prepare and set background pixmap 738 # set background pixmap
214 739
215 $img = $img->sub_rect (0, 0, $w, $h)
216 if $img->w != $w || $img->h != $h;
217
218 $self->set_background ($img); 740 $self->set_background ($img, $self->{border});
219 $self->scr_recolour (0); 741 $self->scr_recolour (0);
220 $self->want_refresh; 742 $self->want_refresh;
221} 743}
222 744
223sub on_start { 745sub on_start {
224 my ($self) = @_; 746 my ($self) = @_;
225 747
748 my $expr = $self->x_resource ("background.expr")
749 or return;
750
226 $self->set_expr (parse_expr $EXPR); 751 $self->set_expr (parse_expr $expr);
752 $self->{border} = $self->x_resource_boolean ("background.border");
227 753
228 () 754 ()
229} 755}
230 756

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines