File: ImgChanged.pod

package info (click to toggle)
perl-tk 1%3A804.036%2Bdfsg1-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 35,284 kB
  • sloc: ansic: 349,560; perl: 52,292; sh: 12,678; makefile: 5,700; asm: 3,565; ada: 1,681; pascal: 1,082; cpp: 1,006; yacc: 883; cs: 879
file content (87 lines) | stat: -rw-r--r-- 2,313 bytes parent folder | download | duplicates (14)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
#  Copyright (c) 1994 The Regents of the University of California.
#  Copyright (c) 1994-1996 Sun Microsystems, Inc.
#  See the file "license.terms" for information on usage and redistribution
#  of this file, and for a DISCLAIMER OF ALL WARRANTIES.
#
#

=head1 NAME

Tk_ImageChanged - notify widgets that image needs to be redrawn

=for category C Programming

=head1 SYNOPSIS

B<#include E<lt>tk.hE<gt>>

B<Tk_ImageChanged>(I<imageMaster, x, y, width, height, imageWidth, imageHeight>)

=head1 ARGUMENTS

=over 4

=item Tk_ImageMaster imageMaster (in)

Token for image, which was passed to image's I<createProc> when
the image was created.

=item int x (in)

X-coordinate of upper-left corner of region that needs redisplay (measured
from upper-left corner of image).

=item int y (in)

Y-coordinate of upper-left corner of region that needs redisplay (measured
from upper-left corner of image).

=item "int" width (in)

Width of region that needs to be redrawn, in pixels.

=item "int" height (in)

Height of region that needs to be redrawn, in pixels.

=item "int" imageWidth (in)

Current width of image, in pixels.

=item "int" imageHeight (in)

Current height of image, in pixels.

=back

=head1 DESCRIPTION

An image manager calls B<Tk_ImageChanged> for an image
whenever anything happens that requires the image to be redrawn.
As a result of calling B<Tk_ImageChanged>, any widgets using
the image are notified so that they can redisplay themselves
appropriately.
The I<imageMaster> argument identifies the image, and
I<x>, I<y>, I<width>, and I<height>
specify a rectangular region within the image that needs to
be redrawn.
I<imageWidth> and I<imageHeight> specify the image's (new) size.

An image manager should call B<Tk_ImageChanged> during
its I<createProc> to specify the image's initial size and to
force redisplay if there are existing instances for the image.
If any of the pixel values in the image should change later on,
B<Tk_ImageChanged> should be called again with I<x>, I<y>,
I<width>, and I<height> values that cover all the pixels
that changed.
If the size of the image should change, then B<Tk_ImageChanged>
must be called to indicate the new size, even if no pixels
need to be redisplayed.

=head1 SEE ALSO

L<Tk::CrtImgType>

=head1 KEYWORDS

images, redisplay, image size changes