OpenCores
URL https://opencores.org/ocsvn/or1k/or1k/trunk

Subversion Repositories or1k

[/] [or1k/] [trunk/] [insight/] [tk/] [doc/] [GetPixmap.3] - Blame information for rev 1765

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 578 markom
'\"
2
'\" Copyright (c) 1990 The Regents of the University of California.
3
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
4
'\"
5
'\" See the file "license.terms" for information on usage and redistribution
6
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
7
'\"
8
'\" RCS: @(#) $Id: GetPixmap.3,v 1.1.1.1 2002-01-16 10:25:48 markom Exp $
9
'\"
10
.so man.macros
11
.TH Tk_GetPixmap 3 4.0 Tk "Tk Library Procedures"
12
.BS
13
.SH NAME
14
Tk_GetPixmap, Tk_FreePixmap \- allocate and free pixmaps
15
.SH SYNOPSIS
16
.nf
17
\fB#include \fR
18
.sp
19
Pixmap
20
\fBTk_GetPixmap(\fIdisplay, d, width, height, depth\fB)\fR
21
.sp
22
\fBTk_FreePixmap(\fIdisplay, pixmap\fB)\fR
23
.SH ARGUMENTS
24
.AS "Drawable" *pixelPtr
25
.AP Display *display in
26
X display for the pixmap.
27
.AP Drawable d in
28
Pixmap or window where the new pixmap will be used for drawing.
29
.AP "int" width in
30
Width of pixmap.
31
.AP "int" height in
32
Height of pixmap.
33
.AP "int" depth in
34
Number of bits per pixel in pixmap.
35
.AP Pixmap pixmap in
36
Pixmap to destroy.
37
.BE
38
 
39
.SH DESCRIPTION
40
.PP
41
These procedures are identical to the Xlib procedures \fBXCreatePixmap\fR
42
and \fBXFreePixmap\fR, except that they have extra code to manage X
43
resource identifiers so that identifiers for deleted pixmaps can be
44
reused in the future.
45
It is important for Tk applications to use these procedures rather
46
than \fBXCreatePixmap\fR and \fBXFreePixmap\fR;  otherwise long-running
47
applications may run out of resource identifiers.
48
.PP
49
\fBTk_GetPixmap\fR creates a pixmap suitable for drawing in \fId\fR,
50
with dimensions given by \fIwidth\fR, \fIheight\fR, and \fIdepth\fR,
51
and returns its identifier.
52
\fBTk_FreePixmap\fR destroys the pixmap given by \fIpixmap\fR and makes
53
its resource identifier available for reuse.
54
 
55
.SH KEYWORDS
56
pixmap, resource identifier

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.