| … | |
… | |
| 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 | #:META:X_RESOURCE:%.interval:seconds:minimum time between updates |
| 6 | |
6 | |
| 7 | =head1 NAME |
7 | =head1 NAME |
| 8 | |
8 | |
| 9 | background - manage terminal background |
9 | background - manage terminal background |
| 10 | |
10 | |
| 11 | =head1 SYNOPSIS |
11 | =head1 SYNOPSIS |
| 12 | |
12 | |
| 13 | urxvt --background-expr 'background expression' |
13 | urxvt --background-expr 'background expression' |
| 14 | --background-border |
14 | --background-border |
| … | |
… | |
| 613 | Clips an image to the given rectangle. If the rectangle is outside the |
613 | Clips an image to the given rectangle. If the rectangle is outside the |
| 614 | image area (e.g. when C<$x> or C<$y> are negative) or the rectangle is |
614 | image area (e.g. when C<$x> or C<$y> are negative) or the rectangle is |
| 615 | larger than the image, then the tiling mode defines how the extra pixels |
615 | larger than the image, then the tiling mode defines how the extra pixels |
| 616 | will be filled. |
616 | will be filled. |
| 617 | |
617 | |
| 618 | If C<$x> an C<$y> are missing, then C<0> is assumed for both. |
618 | If C<$x> and C<$y> are missing, then C<0> is assumed for both. |
| 619 | |
619 | |
| 620 | If C<$width> and C<$height> are missing, then the window size will be |
620 | If C<$width> and C<$height> are missing, then the window size will be |
| 621 | assumed. |
621 | assumed. |
| 622 | |
622 | |
| 623 | Example: load an image, blur it, and clip it to the window size to save |
623 | Example: load an image, blur it, and clip it to the window size to save |
| … | |
… | |
| 641 | =item scale $width_factor, $height_factor, $img |
641 | =item scale $width_factor, $height_factor, $img |
| 642 | |
642 | |
| 643 | Scales the image by the given factors in horizontal |
643 | Scales the image by the given factors in horizontal |
| 644 | (C<$width>) and vertical (C<$height>) direction. |
644 | (C<$width>) and vertical (C<$height>) direction. |
| 645 | |
645 | |
| 646 | If only one factor is give, it is used for both directions. |
646 | If only one factor is given, it is used for both directions. |
| 647 | |
647 | |
| 648 | If no factors are given, scales the image to the window size without |
648 | If no factors are given, scales the image to the window size without |
| 649 | keeping aspect. |
649 | keeping aspect. |
| 650 | |
650 | |
| 651 | =item resize $width, $height, $img |
651 | =item resize $width, $height, $img |
| … | |
… | |
| 776 | =item rotate $center_x, $center_y, $degrees, $img |
776 | =item rotate $center_x, $center_y, $degrees, $img |
| 777 | |
777 | |
| 778 | Rotates the image clockwise by C<$degrees> degrees, around the point at |
778 | Rotates the image clockwise by C<$degrees> degrees, around the point at |
| 779 | C<$center_x> and C<$center_y> (specified as factor of image width/height). |
779 | C<$center_x> and C<$center_y> (specified as factor of image width/height). |
| 780 | |
780 | |
| 781 | Example: rotate the image by 90 degrees around it's center. |
781 | Example: rotate the image by 90 degrees around its center. |
| 782 | |
782 | |
| 783 | rotate 0.5, 0.5, 90, keep { load "$HOME/mybg.png" } |
783 | rotate 0.5, 0.5, 90, keep { load "$HOME/mybg.png" } |
| 784 | |
784 | |
| 785 | =cut |
785 | =cut |
| 786 | |
786 | |
| … | |
… | |
| 885 | $img |
885 | $img |
| 886 | } |
886 | } |
| 887 | |
887 | |
| 888 | =item muladd $mul, $add, $img # EXPERIMENTAL |
888 | =item muladd $mul, $add, $img # EXPERIMENTAL |
| 889 | |
889 | |
| 890 | First multipliesthe pixels by C<$mul>, then adds C<$add>. This cna be used |
890 | First multiplies the pixels by C<$mul>, then adds C<$add>. This can be used |
| 891 | to implement brightness and contrast at the same time, with a wider value |
891 | to implement brightness and contrast at the same time, with a wider value |
| 892 | range than contrast and brightness operators. |
892 | range than contrast and brightness operators. |
| 893 | |
893 | |
| 894 | Due to numerous bugs in XRender implementations, it can also introduce a |
894 | Due to numerous bugs in XRender implementations, it can also introduce a |
| 895 | number of visual artifacts. |
895 | number of visual artifacts. |
