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.39 by root, Fri Jun 8 22:19:03 2012 UTC vs.
Revision 1.49 by root, Sun Jun 10 15:29:18 2012 UTC

1#! perl 1#! perl
2 2
3#:META:X_RESOURCE:%.expr:string:background expression 3#:META:X_RESOURCE:%.expr:string:background expression
4#:META:X_RESOURCE:%.border.:boolean:respect the terminal border 4#:META:X_RESOURCE:%.border:boolean:respect the terminal border
5#:META:X_RESOURCE:%.interval:seconds:minimum time between updates
5 6
6#TODO: once, rootalign 7#TODO: once, rootalign
7 8
9=head1 NAME
10
8=head1 background - manage terminal background 11 background - manage terminal background
9 12
10=head2 SYNOPSIS 13=head1 SYNOPSIS
11 14
12 urxvt --background-expr 'background expression' 15 urxvt --background-expr 'background expression'
13 --background-border 16 --background-border
17 --background-interval seconds
14 18
15=head2 DESCRIPTION 19=head1 DESCRIPTION
16 20
17This extension manages the terminal background by creating a picture that 21This extension manages the terminal background by creating a picture that
18is behind the text, replacing the normal background colour. 22is behind the text, replacing the normal background colour.
19 23
20It does so by evaluating a Perl expression that I<calculates> the image on 24It does so by evaluating a Perl expression that I<calculates> the image on
… …
30 34
31Or specified as a X resource: 35Or specified as a X resource:
32 36
33 URxvt.background-expr: scale load "/path/to/mybg.png" 37 URxvt.background-expr: scale load "/path/to/mybg.png"
34 38
35=head2 THEORY OF OPERATION 39=head1 THEORY OF OPERATION
36 40
37At startup, just before the window is mapped for the first time, the 41At startup, just before the window is mapped for the first time, the
38expression is evaluated and must yield an image. The image is then 42expression 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 43extended as necessary to cover the whole terminal window, and is set as a
40background pixmap. 44background pixmap.
… …
57image to the window size, so it relies on the window size and will 61image 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 62be reevaluated each time it is changed, but not when it moves for
59example. That ensures that the picture always fills the terminal, even 63example. That ensures that the picture always fills the terminal, even
60after it's size changes. 64after it's size changes.
61 65
62=head3 EXPRESSIONS 66=head2 EXPRESSIONS
63 67
64Expressions are normal Perl expressions, in fact, they are Perl blocks - 68Expressions are normal Perl expressions, in fact, they are Perl blocks -
65which means you could use multiple lines and statements: 69which means you could use multiple lines and statements:
66 70
67 again 3600; 71 again 3600;
… …
97its result becomes the argument to the C<scale> function. 101its result becomes the argument to the C<scale> function.
98 102
99Many operators also allow some parameters preceding the input image 103Many operators also allow some parameters preceding the input image
100that modify its behaviour. For example, C<scale> without any additional 104that modify its behaviour. For example, C<scale> without any additional
101arguments scales the image to size of the terminal window. If you specify 105arguments scales the image to size of the terminal window. If you specify
102an additional argument, it uses it as a percentage: 106an additional argument, it uses it as a scale factor (multiply by 100 to
107get a percentage):
103 108
104 scale 200, load "$HOME/mypic.png" 109 scale 2, load "$HOME/mypic.png"
105 110
106This enlarges the image by a factor of 2 (200%). As you can see, C<scale> 111This 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 112has 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 113C<load> only has one argument. Arguments are separated from each other by
109commas. 114commas.
110 115
111Scale also accepts two arguments, which are then separate factors for both 116Scale also accepts two arguments, which are then separate factors for both
112horizontal and vertical dimensions. For example, this halves the image 117horizontal and vertical dimensions. For example, this halves the image
113width and doubles the image height: 118width and doubles the image height:
114 119
115 scale 50, 200, load "$HOME/mypic.png" 120 scale 0.5, 2, load "$HOME/mypic.png"
116 121
117Other effects than scalign are also readily available, for exmaple, you can 122Other effects than scalign are also readily available, for exmaple, you can
118tile the image to fill the whole window, instead of resizing it: 123tile the image to fill the whole window, instead of resizing it:
119 124
120 tile load "$HOME/mypic.png" 125 tile load "$HOME/mypic.png"
… …
133It first takes a snapshot of the screen background image, and then 138It first takes a snapshot of the screen background image, and then
134moves it to the upper left corner of the screen - the result is 139moves 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 140pseudo-transparency, as the image seems to be static while the window is
136moved around. 141moved around.
137 142
138=head3 CYCLES AND CACHING 143=head2 CYCLES AND CACHING
139 144
140As has been mentioned before, the expression might be evaluated multiple 145As has been mentioned before, the expression might be evaluated multiple
141times. Each time the expression is reevaluated, a new cycle is said to 146times. Each time the expression is reevaluated, a new cycle is said to
142have begun. Many operators cache their results till the next cycle. 147have begun. Many operators cache their results till the next cycle.
143 148
… …
168 173
169Here, a path is selected randomly, and load is only called for one image, 174Here, 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 175so 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. 176decides to use the other path, then it will have to load that image again.
172 177
173=head2 REFERENCE 178=head1 REFERENCE
174 179
175=head3 COMMAND LINE SWITCHES 180=head2 COMMAND LINE SWITCHES
176 181
177=over 4 182=over 4
178 183
179=item --background-expr perl-expression 184=item --background-expr perl-expression
180 185
… …
186overwriting borders and any other areas, such as the scrollbar. 191overwriting borders and any other areas, such as the scrollbar.
187 192
188Specifying this flag changes the behaviour, so that the image only 193Specifying this flag changes the behaviour, so that the image only
189replaces the background of the character area. 194replaces the background of the character area.
190 195
196=item --background-interval seconds
197
198Since some operations in the underlying XRender extension can effetively
199freeze your X-server for prolonged time, this extension enforces a minimum
200time between updates, which is normally about 0.1 seconds.
201
202If you want to do updates more often, you can decrease this safety
203interval with this switch.
204
191=back 205=back
192 206
193=cut 207=cut
194 208
209our %_IMGCACHE;
195our $HOME; 210our $HOME;
196our ($self, $old, $new); 211our ($self, $old, $new);
197our ($x, $y, $w, $h); 212our ($x, $y, $w, $h);
198 213
199# enforce at least this interval between updates 214# enforce at least this interval between updates
200our $MIN_INTERVAL = 1/100; 215our $MIN_INTERVAL = 6/59.951;
201 216
202{ 217{
203 package urxvt::bgdsl; # background language 218 package urxvt::bgdsl; # background language
219
220 use List::Util qw(min max sum shuffle);
204 221
205=head2 PROVIDERS/GENERATORS 222=head2 PROVIDERS/GENERATORS
206 223
207These functions provide an image, by loading it from disk, grabbing it 224These functions provide an image, by loading it from disk, grabbing it
208from the root screen or by simply generating it. They are used as starting 225from the root screen or by simply generating it. They are used as starting
… …
245=item solid $width, $height, $colour 262=item solid $width, $height, $colour
246 263
247Creates a new image and completely fills it with the given colour. The 264Creates a new image and completely fills it with the given colour. The
248image is set to tiling mode. 265image is set to tiling mode.
249 266
250If <$width> and C<$height> are omitted, it creates a 1x1 image, which is 267If C<$width> and C<$height> are omitted, it creates a 1x1 image, which is
251useful for solid backgrounds or for use in filtering effects. 268useful for solid backgrounds or for use in filtering effects.
252 269
253=cut 270=cut
254 271
255 sub solid($$;$) { 272 sub solid($;$$) {
256 my $colour = pop; 273 my $colour = pop;
257 274
258 my $img = $self->new_img (urxvt::PictStandardARGB32, $_[0] || 1, $_[1] || 1); 275 my $img = $self->new_img (urxvt::PictStandardARGB32, $_[0] || 1, $_[1] || 1);
259 $img->fill ($colour); 276 $img->fill ($colour);
260 $img 277 $img
261 } 278 }
262 279
280=item clone $img
281
282Returns an exact copy of the image. This is useful if you want to have
283multiple copies of the same image to apply different effects to.
284
285=cut
286
287 sub clone($) {
288 $_[0]->clone
289 }
290
263=back 291=back
264 292
293=head2 TILING MODES
294
295The following operators modify the tiling mode of an image, that is, the
296way that pixels outside the image area are painted when the image is used.
297
298=over 4
299
300=item tile $img
301
302Tiles the whole plane with the image and returns this new image - or in
303other words, it returns a copy of the image in plane tiling mode.
304
305Example: load an image and tile it over the background, without
306resizing. The C<tile> call is superfluous because C<load> already defaults
307to tiling mode.
308
309 tile load "mybg.png"
310
311=item mirror $img
312
313Similar to tile, but reflects the image each time it uses a new copy, so
314that top edges always touch top edges, right edges always touch right
315edges and so on (with normal tiling, left edges always touch right edges
316and top always touch bottom edges).
317
318Example: load an image and mirror it over the background, avoiding sharp
319edges at the image borders at the expense of mirroring the image itself
320
321 mirror load "mybg.png"
322
323=item pad $img
324
325Takes an image and modifies it so that all pixels outside the image area
326become transparent. This mode is most useful when you want to place an
327image over another image or the background colour while leaving all
328background pixels outside the image unchanged.
329
330Example: load an image and display it in the upper left corner. The rest
331of the space is left "empty" (transparent or wahtever your compisotr does
332in alpha mode, else background colour).
333
334 pad load "mybg.png"
335
336=item extend $img
337
338Extends the image over the whole plane, using the closest pixel in the
339area outside the image. This mode is mostly useful when you more complex
340filtering operations and want the pixels outside the image to have the
341same values as the pixels near the edge.
342
343Example: just for curiosity, how does this pixel extension stuff work?
344
345 extend move 50, 50, load "mybg.png"
346
347=cut
348
349 sub pad($) {
350 my $img = $_[0]->clone;
351 $img->repeat_mode (urxvt::RepeatNone);
352 $img
353 }
354
355 sub tile($) {
356 my $img = $_[0]->clone;
357 $img->repeat_mode (urxvt::RepeatNormal);
358 $img
359 }
360
361 sub mirror($) {
362 my $img = $_[0]->clone;
363 $img->repeat_mode (urxvt::RepeatReflect);
364 $img
365 }
366
367 sub extend($) {
368 my $img = $_[0]->clone;
369 $img->repeat_mode (urxvt::RepeatPad);
370 $img
371 }
372
373=back
374
265=head2 VARIABLES 375=head2 VARIABLE VALUES
266 376
267The following functions provide variable data such as the terminal 377The following functions provide variable data such as the terminal window
378dimensions. They are not (Perl-) variables, they just return stuff that
268window dimensions. Most of them make your expression sensitive to some 379varies. Most of them make your expression sensitive to some events, for
269events, for example using C<TW> (terminal width) means your expression is 380example using C<TW> (terminal width) means your expression is evaluated
270evaluated again when the terminal is resized. 381again when the terminal is resized.
271 382
272=over 4 383=over 4
273 384
274=item TX 385=item TX
275 386
… …
346 $self->{counter} + 0 457 $self->{counter} + 0
347 } 458 }
348 459
349=back 460=back
350 461
351=head2 TILING MODES 462=head2 SHAPE CHANGING OPERATORS
352 463
353The following operators modify the tiling mode of an image, that is, the 464The following operators modify the shape, size or position of the image.
354way that pixels outside the image area are painted when the image is used.
355 465
356=over 4 466=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
445 sub clone($) {
446 $_[0]->clone
447 }
448 467
449=item clip $img 468=item clip $img
450 469
451=item clip $width, $height, $img 470=item clip $width, $height, $img
452 471
… …
476 $img->sub_rect ($_[0], $_[1], $w, $h) 495 $img->sub_rect ($_[0], $_[1], $w, $h)
477 } 496 }
478 497
479=item scale $img 498=item scale $img
480 499
481=item scale $size_percent, $img 500=item scale $size_factor, $img
482 501
483=item scale $width_percent, $height_percent, $img 502=item scale $width_factor, $height_factor, $img
484 503
485Scales the image by the given percentages in horizontal 504Scales the image by the given factors in horizontal
486(C<$width_percent>) and vertical (C<$height_percent>) direction. 505(C<$width>) and vertical (C<$height>) direction.
487 506
488If only one percentage is give, it is used for both directions. 507If only one factor is give, it is used for both directions.
489 508
490If no percentages are given, scales the image to the window size without 509If no factors are given, scales the image to the window size without
491keeping aspect. 510keeping aspect.
492 511
493=item resize $width, $height, $img 512=item resize $width, $height, $img
494 513
495Resizes the image to exactly C<$width> times C<$height> pixels. 514Resizes the image to exactly C<$width> times C<$height> pixels.
496 515
497=cut 516=item fit $img
498 517
499#TODO: maximise, maximise_fill? 518=item fit $width, $height, $img
519
520Fits the image into the given C<$width> and C<$height> without changing
521aspect, or the terminal size. That means it will be shrunk or grown until
522the whole image fits into the given area, possibly leaving borders.
523
524=item cover $img
525
526=item cover $width, $height, $img
527
528Similar to C<fit>, but shrinks or grows until all of the area is covered
529by the image, so instead of potentially leaving borders, it will cut off
530image data that doesn't fit.
531
532=cut
500 533
501 sub scale($;$;$) { 534 sub scale($;$;$) {
502 my $img = pop; 535 my $img = pop;
503 536
504 @_ == 2 ? $img->scale ($_[0] * $img->w * 0.01, $_[1] * $img->h * 0.01) 537 @_ == 2 ? $img->scale ($_[0] * $img->w, $_[1] * $img->h)
505 : @_ ? $img->scale ($_[0] * $img->w * 0.01, $_[0] * $img->h * 0.01) 538 : @_ ? $img->scale ($_[0] * $img->w, $_[0] * $img->h)
506 : $img->scale (TW, TH) 539 : $img->scale (TW, TH)
507 } 540 }
508 541
509 sub resize($$$) { 542 sub resize($$$) {
510 my $img = pop; 543 my $img = pop;
511 $img->scale ($_[0], $_[1]) 544 $img->scale ($_[0], $_[1])
545 }
546
547 sub fit($;$$) {
548 my $img = pop;
549 my $w = ($_[0] || TW) / $img->w;
550 my $h = ($_[1] || TH) / $img->h;
551 scale +(min $w, $h), $img
552 }
553
554 sub cover($;$$) {
555 my $img = pop;
556 my $w = ($_[0] || TW) / $img->w;
557 my $h = ($_[1] || TH) / $img->h;
558 scale +(max $w, $h), $img
512 } 559 }
513 560
514=item move $dx, $dy, $img 561=item move $dx, $dy, $img
515 562
516Moves the image by C<$dx> pixels in the horizontal, and C<$dy> pixels in 563Moves the image by C<$dx> pixels in the horizontal, and C<$dy> pixels in
517the vertical. 564the vertical.
518 565
519Example: move the image right by 20 pixels and down by 30. 566Example: move the image right by 20 pixels and down by 30.
520 567
521 move 20, 30, ... 568 move 20, 30, ...
569
570=item align $xalign, $yalign, $img
571
572Aligns the image according to a factor - C<0> means the image is moved to
573the left or top edge (for C<$xalign> or C<$yalign>), C<0.5> means it is
574exactly centered and C<1> means it touches the right or bottom edge.
575
576Example: remove any visible border around an image, center it vertically but move
577it to the right hand side.
578
579 align 1, 0.5, pad $img
580
581=item center $img
582
583=item center $width, $height, $img
584
585Centers the image, i.e. the center of the image is moved to the center of
586the terminal window (or the box specified by C<$width> and C<$height> if
587given).
588
589Example: load an image and center it.
590
591 center pad load "mybg.png"
522 592
523=item rootalign $img 593=item rootalign $img
524 594
525Moves the image so that it appears glued to the screen as opposed to the 595Moves 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 596window. This gives the illusion of a larger area behind the window. It is
… …
532 rootalign mirror load "mybg.png" 602 rootalign mirror load "mybg.png"
533 603
534Example: take the screen background and align it, giving the illusion of 604Example: take the screen background and align it, giving the illusion of
535transparency as long as the window isn't in front of other windows. 605transparency as long as the window isn't in front of other windows.
536 606
537 rootalign root 607 rootalign root
538 608
539=cut 609=cut
540 610
541 sub move($$;$) { 611 sub move($$;$) {
542 my $img = pop->clone; 612 my $img = pop->clone;
543 $img->move ($_[0], $_[1]); 613 $img->move ($_[0], $_[1]);
544 $img 614 $img
545 } 615 }
546 616
617 sub align($;$$) {
618 my $img = pop;
619
620 move $_[0] * (TW - $img->w),
621 $_[1] * (TH - $img->h),
622 $img
623 }
624
625 sub center($;$$) {
626 my $img = pop;
627 my $w = $_[0] || TW;
628 my $h = $_[1] || TH;
629
630 move 0.5 * ($w - $img->w), 0.5 * ($h - $img->h), $img
631 }
632
547 sub rootalign($) { 633 sub rootalign($) {
548 move -TX, -TY, $_[0] 634 move -TX, -TY, $_[0]
549 } 635 }
550 636
637=back
638
639=head2 COLOUR MODIFICATIONS
640
641The following operators change the pixels of the image.
642
643=over 4
644
551=item contrast $factor, $img 645=item contrast $factor, $img
552 646
553=item contrast $r, $g, $b, $img 647=item contrast $r, $g, $b, $img
554 648
555=item contrast $r, $g, $b, $a, $img 649=item contrast $r, $g, $b, $a, $img
556 650
557Adjusts the I<contrast> of an image. 651Adjusts the I<contrast> of an image.
558 652
559#TODO# 653The first form applies a single C<$factor> to red, green and blue, the
654second form applies separate factors to each colour channel, and the last
655form includes the alpha channel.
560 656
657Values from 0 to 1 lower the contrast, values higher than 1 increase the
658contrast.
659
660Due to limitations in the underlying XRender extension, lowering contrast
661also reduces brightness, while increasing contrast currently also
662increases brightness.
663
561=item brightness $factor, $img 664=item brightness $bias, $img
562 665
563=item brightness $r, $g, $b, $img 666=item brightness $r, $g, $b, $img
564 667
565=item brightness $r, $g, $b, $a, $img 668=item brightness $r, $g, $b, $a, $img
566 669
567Adjusts the brightness of an image. 670Adjusts the brightness of an image.
568 671
672The first form applies a single C<$bias> to red, green and blue, the
673second form applies separate biases to each colour channel, and the last
674form includes the alpha channel.
675
676Values less than 0 reduce brightness, while values larger than 0 increase
677it. Useful range is from -1 to 1 - the former results in a black, the
678latter in a white picture.
679
680Due to idiosynchrasies in the underlying XRender extension, biases less
681than zero can be I<very> slow.
682
569=cut 683=cut
570 684
571 sub contrast($$;$$;$) { 685 sub contrast($$;$$;$) {
572 my $img = pop; 686 my $img = pop;
573 my ($r, $g, $b, $a) = @_; 687 my ($r, $g, $b, $a) = @_;
574 688
575 ($g, $b) = ($r, $r) if @_ < 4; 689 ($g, $b) = ($r, $r) if @_ < 3;
576 $a = 1 if @_ < 5; 690 $a = 1 if @_ < 4;
577 691
578 $img = $img->clone; 692 $img = $img->clone;
579 $img->contrast ($r, $g, $b, $a); 693 $img->contrast ($r, $g, $b, $a);
580 $img 694 $img
581 } 695 }
582 696
583 sub brightness($$;$$;$) { 697 sub brightness($$;$$;$) {
584 my $img = pop; 698 my $img = pop;
585 my ($r, $g, $b, $a) = @_; 699 my ($r, $g, $b, $a) = @_;
586 700
587 ($g, $b) = ($r, $r) if @_ < 4; 701 ($g, $b) = ($r, $r) if @_ < 3;
588 $a = 1 if @_ < 5; 702 $a = 1 if @_ < 4;
589 703
590 $img = $img->clone; 704 $img = $img->clone;
591 $img->brightness ($r, $g, $b, $a); 705 $img->brightness ($r, $g, $b, $a);
592 $img 706 $img
593 } 707 }
… …
612 } 726 }
613 727
614=item rotate $new_width, $new_height, $center_x, $center_y, $degrees 728=item rotate $new_width, $new_height, $center_x, $center_y, $degrees
615 729
616Rotates the image by C<$degrees> degrees, counter-clockwise, around the 730Rotates the image by C<$degrees> degrees, counter-clockwise, around the
617pointer at C<$center_x> and C<$center_y> (specified as percentage of image 731pointer at C<$center_x> and C<$center_y> (specified as factor of image
618width/height), generating a new image with width C<$new_width> and height 732width/height), generating a new image with width C<$new_width> and height
619C<$new_height>. 733C<$new_height>.
620 734
621#TODO# new width, height, maybe more operators? 735#TODO# new width, height, maybe more operators?
622 736
… …
627 sub rotate($$$$$$) { 741 sub rotate($$$$$$) {
628 my $img = pop; 742 my $img = pop;
629 $img->rotate ( 743 $img->rotate (
630 $_[0], 744 $_[0],
631 $_[1], 745 $_[1],
632 $_[2] * $img->w * .01, 746 $_[2] * $img->w,
633 $_[3] * $img->h * .01, 747 $_[3] * $img->h,
634 $_[4] * (3.14159265 / 180), 748 $_[4] * (3.14159265 / 180),
635 ) 749 )
636 } 750 }
637 751
638=back 752=back
… …
683 797
684 # evaluate user expression 798 # evaluate user expression
685 799
686 my $img = eval { $self->{expr}->() }; 800 my $img = eval { $self->{expr}->() };
687 warn $@ if $@;#d# 801 warn $@ if $@;#d#
688 die if !UNIVERSAL::isa $img, "urxvt::img"; 802 die "background-expr did not return an image.\n" if !UNIVERSAL::isa $img, "urxvt::img";
689 803
690 $state->{size_sensitive} = 1 804 $state->{size_sensitive} = 1
691 if $img->repeat_mode != urxvt::RepeatNormal; 805 if $img->repeat_mode != urxvt::RepeatNormal;
692 806
693 # if the expression is sensitive to external events, prepare reevaluation then 807 # if the expression is sensitive to external events, prepare reevaluation then
… …
743} 857}
744 858
745sub on_start { 859sub on_start {
746 my ($self) = @_; 860 my ($self) = @_;
747 861
748 my $expr = $self->x_resource ("background.expr") 862 my $expr = $self->x_resource ("%.expr")
749 or return; 863 or return;
750 864
865 $self->has_render
866 or die "background extension needs RENDER extension 0.10 or higher, ignoring background-expr.\n";
867
751 $self->set_expr (parse_expr $expr); 868 $self->set_expr (parse_expr $expr);
752 $self->{border} = $self->x_resource_boolean ("background.border"); 869 $self->{border} = $self->x_resource_boolean ("%.border");
870
871 $MIN_INTERVAL = $self->x_resource ("%.interval");
753 872
754 () 873 ()
755} 874}
756 875

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines