## Tcl9.0.3/Tk9.0.3 Documentation > Tk C API > CanvPsY

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tk_CanvasPsY, Tk_CanvasPsBitmap, Tk_CanvasPsColor, Tk_CanvasPsFont, Tk_CanvasPsPath, Tk_CanvasPsStipple — 画布の為のポストスクリプト生成の為の便益手続函数　 utility procedures for generating Postscript for canvases
  SYNOPSIS
    #include <tk.h>
    double
    Tk_CanvasPsY(canvas, canvasY)
    int
    Tk_CanvasPsBitmap(interp, canvas, bitmap, x, y, width, height)
    int
    Tk_CanvasPsColor(interp, canvas, colorPtr)
    int
    Tk_CanvasPsFont(interp, canvas, tkFont)
    Tk_CanvasPsPath(interp, canvas, coordPtr, numPoints)
    int
    Tk_CanvasPsStipple(interp, canvas, bitmap)
  引数 ARGUMENTS
    Tk_Canvas canvas (入力in)
    double canvasY (入力in)
    Tcl_Interp *interp (入出力in/out)
    Pixmap bitmap (入力in)
    int x (入力in)
    int y (入力in)
    int width (入力in)
    int height (入力in)
    XColor *colorPtr (入力in)
    Tk_Font tkFont (入力in)
    double *coordPtr (入力in)
    Tcl_Size numPoints (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_CanvasPsY, Tk_CanvasPsBitmap, Tk_CanvasPsColor, Tk_CanvasPsFont, Tk_CanvasPsPath, Tk_CanvasPsStipple — 画布の為のポストスクリプト生成の為の便益手続函数　 utility procedures for generating Postscript for canvases

### SYNOPSIS

#include <tk.h>
double
Tk_CanvasPsY(canvas, canvasY)
int
Tk_CanvasPsBitmap(interp, canvas, bitmap, x, y, width, height)
int
Tk_CanvasPsColor(interp, canvas, colorPtr)
int
Tk_CanvasPsFont(interp, canvas, tkFont)
Tk_CanvasPsPath(interp, canvas, coordPtr, numPoints)
int
Tk_CanvasPsStipple(interp, canvas, bitmap)

### 引数 ARGUMENTS

Tk_Canvas canvas (入力in)
  生成されるポストスクリプトの為の画布部品を識別する符牒語｡ A token that identifies a canvas widget for which Postscript is being generated.

double canvasY (入力in)
  画布の空間内のY-座標｡　 Y-coordinate in the space of the canvas.

Tcl_Interp *interp (入出力in/out)
  Tcl 解釈実行機能; その結果にポストスクリプトが追記されるか､結果が不都合伝言文で置換えられるかもしれない｡ A Tcl interpreter; Postscript is appended to its result, or the result may be replaced with an error message.

Pixmap bitmap (入力in)
  生成するポストスクリプトの為に使う点地図｡　 Bitmap to use for generating Postscript.

int x (入力in)
  出力すべき領域の左縁の点地図内のX-座標 X-coordinate within bitmap of left edge of region to output.

int y (入力in)
  出力すべき領域の左縁の点地図内のY-座標 Y-coordinate within bitmap of top edge of region to output.

int width (入力in)
  出力すべき点地図の領域の画素単位の巾｡ Width of region of bitmap to output, in pixels.

int height (入力in)
  出力すべき点地図の領域の画素単位の高さ｡ Height of region of bitmap to output, in pixels.

XColor *colorPtr (入力in)
  ポストスクリプト内に設定する為の色の値に関する情報｡ Information about color value to set in Postscript.

Tk_Font tkFont (入力in)
  生成されるポストスクリプトの為のフォント Font for which Postscript is to be generated.

double *coordPtr (入力in)
  画布座標内に指定された一つ或いはそれ以上の点に関する座標の配列への指示子｡coordPtr内の値の順は x1, y1, x2, y2, x3, y3, 以下同様｡　 Pointer to an array of coordinates for one or more points specified in canvas coordinates. The order of values in coordPtr is x1, y1, x2, y2, x3, y3, and so on.

Tcl_Size numPoints (入力in)
  coordPtrに於ける点の個数｡ Number of points at coordPtr.

### 説明 DESCRIPTION

これ等の手続函数は画布型管理譜から呼ばれポストスクリプトを生成することに関連する通常の機能を実行する｡大部分の手続函数は canvas 引数をとる､それはポストスクリプトが生成される為の画布部品を参照する｡ These procedures are called by canvas type managers to carry out common functions related to generating Postscript. Most of the procedures take a canvas argument, which refers to a canvas widget for which Postscript is being generated.

Tk_CanvasPsY は引数として画布空間内の y-座標をとり､ canvas の為に現在生成されているポストスクリプト内の点に使われるべき値を返す｡y-座標は翻訳を要求する､理由はポストスクリプトは左下隅の原点を使い､そこで X は左上隅の原点を使うから｡画布の x 座標は直接翻訳なしにポストスクリプト内で使用できる｡ Tk_CanvasPsY 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 canvas. 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.

Tk_CanvasPsBitmap は点地図の領域を記述する為にポストスクリプトを生成する｡ポストスクリプトはポストスクリプトの為の適切な影像データ内に生成される､即ち､画素につき１ビット､角括弧間のデータとして｡ポストスクリプトは解釈実行機能 interp の結果に追記され､不都合が生じない限り TCL_OK が返される､不都合では TCL_ERROR が返され解釈実行機能 interp の結果は不都合伝言文により上書きされる｡ Tk_CanvasPsBitmap 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 the result of interpreter interp and TCL_OK is returned unless an error occurs, in which case TCL_ERROR is returned and the interpreter result is overwritten with an error message.

Tk_CanvasPsColor は､ postscript 命令内に指定された､どの色の対応をも考慮に入れて､その colorPtr 引数に相当する現在の色を設定してポストスクリプトを生成する｡ポストスクリプトは解釈実行機能 interp の結果に追記され､不都合が生じない限り TCL_OK が返される､不都合では TCL_ERROR が返され､解釈実行機能の結果は不都合伝言文により上書きされる｡ Tk_CanvasPsColor generates Postscript to set the current color to correspond to its colorPtr argument, taking into account any color map specified in the postscript command. It appends the Postscript to the interpreter interp's result and returns TCL_OK unless an error occurs, in which case TCL_ERROR is returned and the interpreter's result is overwritten with an error message.

Tk_CanvasPsFont は可能な限り tkFont に合致する現在の文字形状を設定しポストスクリプトを生成する｡ Tk_CanvasPsFont は postscript 命令内に指定されたどの文字形状の対応をも考慮にいれ､ X 文字形状からポストスクリプト文字形状への対応に可能な最善を行う｡ポストスクリプトは解釈実行機能 interp の結果に追記され､不都合が生じない限り TCL_OK が返される､不都合では TCL_ERROR が返され､解釈実行機能の結果は不都合伝言文により上書きされる｡ Tk_CanvasPsFont generates Postscript that sets the current font to match tkFont as closely as possible. Tk_CanvasPsFont takes into account any font map specified in the postscript command, and it does the best it can at mapping X fonts to Postscript fonts. It appends the Postscript to interpreter interp's result and returns TCL_OK unless an error occurs, in which case TCL_ERROR is returned and the interpreter's result is overwritten with an error message.

Tk_CanvasPsPath は coordPtr and numPoints によって与えられる点位置の組への現在の経路を設定してポストスクリプトを生成する｡結果のポストスクリプトは解釈実行機能 interp の結果に追記される｡ Tk_CanvasPsPath generates Postscript to set the current path to the set of points given by coordPtr and numPoints. It appends the resulting Postscript to the result of interpreter interp.

Tk_CanvasPsStipple は点描の様式で現在の経路を満たしポストスクリプトを生成する｡ bitmap と現在のポストスクリプトの色を点描紋様として使い; 点描の点地図内の１は現在の色で描かれ､零は全く描かれない｡ポストスクリプトは解釈実行機能 interp の結果に追記され､不都合が生じない限りTCL_OK が返される､不都合では TCL_ERROR が返され､解釈実行機能の結果は不都合伝言文により上書きされる｡ Tk_CanvasPsStipple generates Postscript that will fill the current path in stippled fashion. It uses bitmap 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 interpreter interp's result and TCL_OK is returned, unless an error occurs, in which case TCL_ERROR is returned and the interpreter's result is overwritten with an error message.

### KEYWORDS

bitmap, canvas, color, font, path, Postscript, stipple
Copyright © 1994-1996 Sun Microsystems, Inc.