通讯编程

开发平台：
Visual C++

CanvPsY.3：源码内容
							'"
'" 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: CanvPsY.3,v 1.5 2000/07/25 21:14:34 jenglish Exp $
'" 
.so man.macros
.TH Tk_CanvasPs 3 4.0 Tk "Tk Library Procedures"
.BS
.SH NAME
Tk_CanvasPsY, Tk_CanvasPsBitmap, Tk_CanvasPsColor, Tk_CanvasPsFont, Tk_CanvasPsPath, Tk_CanvasPsStipple - utility procedures for generating Postscript for canvases
.SH SYNOPSIS
.nf
fB#include <tk.h>fR
.sp
double
fBTk_CanvasPsYfR(fIcanvas, canvasYfR)
.sp
int
fBTk_CanvasPsBitmapfR(fIinterp, canvas, bitmap, x, y, width, heightfR)
.sp
int
fBTk_CanvasPsColorfR(fIinterp, canvas, colorPtrfR)
.sp
int
fBTk_CanvasPsFontfR(fIinterp, canvas, tkFontfR)
.sp
fBTk_CanvasPsPathfR(fIinterp, canvas, coordPtr, numPointsfR)
.sp
int
fBTk_CanvasPsStipplefR(fIinterp, canvas, bitmapfR)
.SH ARGUMENTS
.AS "unsigned int" "numPoints"
.AP Tk_Canvas canvas in
A token that identifies a canvas widget for which Postscript is
being generated.
.AP double canvasY in
Y-coordinate in the space of the canvas.
.AP Tcl_Interp *interp in/out
A Tcl interpreter;  Postscript is appended to its result, or the
result may be replaced with an error message.
.AP Pixmap bitmap in
Bitmap to use for generating Postscript.
.AP int x in
X-coordinate within fIbitmapfR of left edge of region to output.
.AP int y in
Y-coordinate within fIbitmapfR of top edge of region to output.
.AP "int" width in
Width of region of bitmap to output, in pixels.
.AP "int" height in
Height of region of bitmap to output, in pixels.
.AP XColor *colorPtr in
Information about color value to set in Postscript.
.AP Tk_Font tkFont in
Font for which Postscript is to be generated.
.AP double *coordPtr in
Pointer to an array of coordinates for one or more
points specified in canvas coordinates.
The order of values in fIcoordPtrfR is x1, y1, x2, y2, x3, y3,
and so on.
.AP int numPoints in
Number of points at fIcoordPtrfR.
.BE
.SH DESCRIPTION
.PP
These procedures are called by canvas type managers to carry out
common functions related to generating Postscript.
Most of the procedures take a fIcanvasfR argument, which
refers to a canvas widget for which Postscript is being
generated.
.PP
fBTk_CanvasPsYfR takes as argument a y-coordinate in the space of
a canvas and returns the value that should be used for that point
in the Postscript currently being generated for fIcanvasfR.
Y coordinates require transformation because Postscript uses an
origin at the lower-left corner whereas X uses an origin at the
upper-left corner.
Canvas x coordinates can be used directly in Postscript without
transformation.
.PP
fBTk_CanvasPsBitmapfR generates Postscript to describe a region
of a bitmap.
The Postscript is generated in proper image data format for Postscript,
i.e., as data between angle brackets, one bit per pixel.
The Postscript is appended to fIinterp->resultfR and TCL_OK is returned
unless an error occurs, in which case TCL_ERROR is returned and
fIinterp->resultfR is overwritten with an error message.
.PP
fBTk_CanvasPsColorfR generates Postscript to set the current color
to correspond to its fIcolorPtrfR argument, taking into account any
color map specified in the fBpostscriptfR command.
It appends the Postscript to fIinterp->resultfR and returns
TCL_OK unless an error occurs, in which case TCL_ERROR is returned and
fIinterp->resultfR is overwritten with an error message.
.PP
fBTk_CanvasPsFontfR generates Postscript that sets the current font
to match fItkFontfR as closely as possible.
fBTk_CanvasPsFontfR takes into account any font map specified
in the fBpostscriptfR command, and it does
the best it can at mapping X fonts to Postscript fonts.
It appends the Postscript to fIinterp->resultfR and returns TCL_OK
unless an error occurs, in which case TCL_ERROR is returned and
fIinterp->resultfR is overwritten with an error message.
.PP
fBTk_CanvasPsPathfR generates Postscript to set the current path
to the set of points given by fIcoordPtrfR and fInumPointsfR.
It appends the resulting Postscript to fIinterp->resultfR.
.PP
fBTk_CanvasPsStipplefR generates Postscript that will fill the
current path in stippled fashion.
It uses fIbitmapfR as the stipple pattern and the current Postscript
color;  ones in the stipple bitmap are drawn in the current color, and
zeroes are not drawn at all.
The Postscript is appended to fIinterp->resultfR and TCL_OK is
returned, unless an error occurs, in which case TCL_ERROR is returned and
fIinterp->resultfR is overwritten with an error message.
.SH KEYWORDS
bitmap, canvas, color, font, path, Postscript, stipple

						