GetPixmap.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" Copyright (c) 1990 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.
- '"
- '" RCS: @(#) $Id: GetPixmap.3,v 1.2 1998/09/14 18:22:50 stanton Exp $
- '"
- .so man.macros
- .TH Tk_GetPixmap 3 4.0 Tk "Tk Library Procedures"
- .BS
- .SH NAME
- Tk_GetPixmap, Tk_FreePixmap - allocate and free pixmaps
- .SH SYNOPSIS
- .nf
- fB#include <tk.h>fR
- .sp
- Pixmap
- fBTk_GetPixmap(fIdisplay, d, width, height, depthfB)fR
- .sp
- fBTk_FreePixmap(fIdisplay, pixmapfB)fR
- .SH ARGUMENTS
- .AS "Drawable" *pixelPtr
- .AP Display *display in
- X display for the pixmap.
- .AP Drawable d in
- Pixmap or window where the new pixmap will be used for drawing.
- .AP "int" width in
- Width of pixmap.
- .AP "int" height in
- Height of pixmap.
- .AP "int" depth in
- Number of bits per pixel in pixmap.
- .AP Pixmap pixmap in
- Pixmap to destroy.
- .BE
- .SH DESCRIPTION
- .PP
- These procedures are identical to the Xlib procedures fBXCreatePixmapfR
- and fBXFreePixmapfR, except that they have extra code to manage X
- resource identifiers so that identifiers for deleted pixmaps can be
- reused in the future.
- It is important for Tk applications to use these procedures rather
- than fBXCreatePixmapfR and fBXFreePixmapfR; otherwise long-running
- applications may run out of resource identifiers.
- .PP
- fBTk_GetPixmapfR creates a pixmap suitable for drawing in fIdfR,
- with dimensions given by fIwidthfR, fIheightfR, and fIdepthfR,
- and returns its identifier.
- fBTk_FreePixmapfR destroys the pixmap given by fIpixmapfR and makes
- its resource identifier available for reuse.
- .SH KEYWORDS
- pixmap, resource identifier