FreeBSD Manual Pages
Tk_ImageChanged(3) Tk Library Procedures Tk_ImageChanged(3) ________________________________________________________________________________ NAME Tk_ImageChanged - notify widgets that image needs to be redrawn SYNOPSIS #include <tk.h> Tk_ImageChanged(model, x, y, width, height, imageWidth, imageHeight) ARGUMENTS Tk_ImageMaster model (in) Token for image, which was passed to image's createProc when the im- age was created. int x (in) X-coordinate of upper-left corner of region that needs redisplay (measured from upper-left corner of image). int y (in) Y-coordinate of upper-left corner of region that needs redisplay (measured from upper-left corner of image). int width (in) Width of region that needs to be redrawn, in pixels. int height (in) Height of region that needs to be redrawn, in pixels. int imageWidth (in) Current width of image, in pixels. int imageHeight (in) Current height of image, in pix- els. ________________________________________________________________________________ DESCRIPTION An image manager calls Tk_ImageChanged for an image whenever anything hap- pens that requires the image to be redrawn. As a result of calling Tk_Im- ageChanged, any widgets using the image are notified so that they can re- display themselves appropriately. The model argument identifies the image, and x, y, width, and height specify a rectangular region within the image that needs to be redrawn. imageWidth and imageHeight specify the image's (new) size. Tk_ImageModel is synonym for Tk_ImageMaster 2 An image manager should call Tk_ImageChanged during its createProc to spec- ify 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, Tk_ImageChanged should be called again with x, y, width, and height values that cover all the pixels that changed. If the size of the image should change, then Tk_ImageChanged must be called to indicate the new size, even if no pixels need to be redisplayed. SEE ALSO Tk_CreateImageType KEYWORDS images, redisplay, image size changes Tk 4.0 Tk_ImageChanged(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO | KEYWORDS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_ImageChanged.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>