## Tcl9.0.3/Tk9.0.3 Documentation > Tk Commands > bitmap

### 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
    bitmap — ２色を展示する画像 Images that display two colors
  構文 SYNOPSIS
  説明 DESCRIPTION
  点地図創生 CREATING BITMAPS
    -background color
    -data string
    -file name
    -foreground color
    -maskdata string
    -maskfile name
  映像命令 IMAGE COMMAND
    imageName cget option
    imageName configure ?option? ?value option value ...?
  KEYWORDS

### NAME

bitmap — ２色を展示する画像 Images that display two colors

### 構文 SYNOPSIS

image create bitmap ?name? ?options?
imageName cget option
imageName configure ?option? ?value option value ...?

### 説明 DESCRIPTION

点地図は画像であり､その画素は二つの色か透明性で展示できる｡点地図画像は次の四つの事柄により定義される: 背景の色と､前景の色と､資源と篩と呼ばれる二つの点地図｡それぞれの点地図は矩形の画素の配列について 0/1 値で指定され､その二つの点地図は同じ寸法を有しなければならない｡画素に関しては､篩が零の処は画像は何も展示せず､透明の効果を産む｡他の画素については､原資データが１であれば画像は前景の色を展示し､原資データが0であれば背景色を展示する｡ A bitmap is an image whose pixels can display either of two colors or be transparent. A bitmap image is defined by four things: a background color, a foreground color, and two bitmaps, called the source and the mask. Each of the bitmaps specifies 0/1 values for a rectangular array of pixels, and the two bitmaps must have the same dimensions. For pixels where the mask is zero, the image displays nothing, producing a transparent effect. For other pixels, the image displays the foreground color if the source data is one and the background color if the source data is zero.

### 点地図創生 CREATING BITMAPS

全ての画像の様に､点地図は image create 命令を使って作成される｡点地図は次の指示項目を運営する: Like all images, bitmaps are created using the image create command. Bitmaps support the following options:

-background color
  画像の背景色を指定する､Tk に受入可能などの標準的方法でもよい｡もし､この指示項目が空文字に設定されると､背景の画素は透明になる｡この効果は､どの -maskdata や -maskfile 指示項目も無視し､源資の画素を篩の画素として使用することで達成される｡ Specifies a background color for the image in any of the standard ways accepted by Tk. If this option is set to an empty string then the background pixels will be transparent. This effect is achieved by using the source bitmap as the mask bitmap, ignoring any -maskdata or -maskfile options.

-data string
  源資画素を文字列として指定する｡その文字列は､ X11 点地図書式に忠実でなければならない(譬えば､bitmap 譜により生成された如く)｡もし､ -data 指示項目と -file 指示項目の両方が指定されると -data 指示項目が優先する｡ Specifies the contents of the source bitmap as a string. The string must adhere to X11 bitmap format (e.g., as generated by the bitmap program). If both the -data and -file options are specified, the -data option takes precedence.

-file name
  name はその内容が源資画素を定義するファイル名を与える｡ファイルは X11 点地図書式に忠実でなければならない(譬えば､bitmap 譜により生成された如く)｡ name gives the name of a file whose contents define the source bitmap. The file must adhere to X11 bitmap format (e.g., as generated by the bitmap program).

-foreground color
  画像の前景色を指定する､Tk に受入可能などの標準的方法でもよい｡ Specifies a foreground color for the image in any of the standard ways accepted by Tk.

-maskdata string
  篩の内容を文字列として指定する｡ファイルは X11 点地図書式に忠実でなければならない(譬えば､bitmap 譜により生成された如く)｡もし､ -maskdata 指示項目と -maskfile 指示項目の両方が指定されると -maskdata 指示項目が優先する｡ Specifies the contents of the mask as a string. The string must adhere to X11 bitmap format (e.g., as generated by the bitmap program). If both the -maskdata and -maskfile options are specified, the -maskdata option takes precedence.

-maskfile name
  name はその内容が篩を定義するファイル名を与える｡ファイルは X11 点地図書式に忠実でなければならない(譬えば､bitmap 譜により生成された如く)｡ name gives the name of a file whose contents define the mask. The file must adhere to X11 bitmap format (e.g., as generated by the bitmap program).

### 映像命令 IMAGE COMMAND

点地図の画像が作成された時､Tk はその画像と同じ名前の命令を作成する｡この命令は画像上の種々の操作の起動に使用できる｡それは次の一般式を有する: When a bitmap image is created, Tk also creates a new command whose name is the same as the image. This command may be used to invoke various operations on the image. It has the following general form:

    imageName option ?arg ...?

option と arg は命令の正確な振舞いを定める｡次の命令が点地図の画像について可能である: Option and the args determine the exact behavior of the command. The following commands are possible for bitmap images:

imageName cget option
  option で与えられる構成設定指示項目の現在の値を返す｡ option はimage create bitmap 命令によって受入られたどのような値を有していてもよい｡ Returns the current value of the configuration option given by option. Option may have any of the values accepted by the image create bitmap command.

imageName configure ?option? ?value option value ...?
  画像の構成設定指示項目を問合せ又は指定する｡もし､ option が指定されないと､ imageName についての､全ての利用可能な指示項目を記述したリストが返る(このリストの書式の情報は Tk_ConfigureInfo を参照されたい)｡ value なしで option を指定すると､その名前の指示項目を記述したリストが返る(このリストは､ option を指定しない時に返るリストの部分リストになっている)｡もし､一つ或はそれ以上の option-value 対が指定されると､命令は､与えられた指示項目を与えられた値に修正する; この場合､命令は空文字列を返す｡ option はimage create bitmap 命令が受入れるどの値を有していてもよい｡ Query or modify the configuration options for the image. If no option is specified, returns a list describing all of the available options for imageName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the image create bitmap command.

### KEYWORDS

bitmap, image
Copyright © 1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.